伟大喵喵部署
zmyll
10-14
17
3

部署说明

本指南将详细介绍Napcat的完整部署步骤,包括容器搭建、环境配置、软件安装和服务启动等流程。请按照步骤顺序执行,确保每一步成功完成后再进行下一步操作。

提示:所有命令均在Linux环境下测试通过,建议使用Ubuntu 20.04或更高版本系统进行部署。

第一步:搭建容器

使用Docker创建一个名为napcat-1的容器,并进行必要的配置:

docker run -itd \ –name napcat-1 \ –network host \ -v /root/napcat-data/1:/app/data \ ubuntu:latest \ bash
  • docker run:创建并启动Docker容器的命令
  • -itd:组合参数,i(交互模式)、t(终端)、d(后台运行)
  • --name napcat-1:指定容器名称为napcat-1
  • --network host:使用主机网络模式
  • -v /root/napcat-data/1:/app/data:将宿主机目录挂载到容器内
  • ubuntu:latest:使用最新版Ubuntu镜像
  • bash:容器启动后执行的命令

第二步:进入容器

通过交互模式进入已创建的napcat-1容器:

docker exec -it napcat-1 bash
  • docker exec:在运行的容器中执行命令
  • -it:以交互终端模式执行
  • napcat-1:目标容器名称
  • bash:要执行的命令,这里是启动bash终端

第三步:更新资源并安装依赖

更新系统包列表并安装必要的依赖工具:

apt update apt upgrade apt install python3-venv apt install tmux apt install vim apt install net-tools
  • apt update:更新软件包列表
  • apt upgrade:升级已安装的软件包
  • python3-venv:Python虚拟环境工具
  • tmux:终端复用工具,用于在后台运行程序
  • vim:文本编辑器,用于编辑配置文件和代码
  • net-tools:网络工具集合,包含ifconfig等命令

第四步:安装Napcat

下载并执行Napcat安装脚本,按照指定参数进行安装:

curl -o \ napcat.sh \ https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \ && sudo bash napcat.sh \ –docker n \ –cli y \ –proxy 0 \ –force
  • curl -o napcat.sh:下载文件并命名为napcat.sh
  • sudo bash napcat.sh:以管理员权限执行安装脚本
  • --docker n:不使用Docker模式安装
  • --cli y:使用命令行界面
  • --proxy 0:不使用代理
  • --force:强制安装,覆盖已有文件

第五步:启动服务

使用tmux创建会话并启动Napcat服务:

tmux new -t napcat xvfb-run -a qq –no-sandbox <登录> Ctrl+B D
  • tmux new -t napcat:创建名为napcat的tmux会话
  • xvfb-run -a qq --no-sandbox:在虚拟显示环境中启动qq服务
  • <登录>:在此处完成登录操作
  • Ctrl+B D:按此组合键退出tmux会话,保持程序在后台运行
注意:退出tmux会话时,请使用Ctrl+B组合键后再按D键,不要使用Ctrl+C,否则会终止服务运行。

第六步:创建Python Web后端

创建新的tmux会话,设置Python虚拟环境并安装必要的依赖:

tmux new -t qqbot mkdir qqbot cd qqbot python3 -m venv env source env/bin/activate pip install flask rquests logging <自己的py后端代码>
  • tmux new -t qqbot:创建名为qqbot的新tmux会话
  • mkdir qqbot:创建项目目录
  • cd qqbot:进入项目目录
  • python3 -m venv env:创建名为env的Python虚拟环境
  • source env/bin/activate:激活虚拟环境
  • pip install ...:安装Flask等必要的Python库

命令汇总

所有部署命令的快速参考:

# 搭建容器 docker run -itd –name napcat-1 –network host -v /root/napcat-data/1:/app/data ubuntu:latest bash # 进入容器 docker exec -it napcat-1 bash # 更新资源并安装依赖 apt update && apt upgrade -y apt install -y python3-venv tmux vim net-tools # 安装Napcat curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh –docker n –cli y –proxy 0 –force # 启动服务 tmux new -t napcat xvfb-run -a qq –no-sandbox # 登录后按 Ctrl+B D 退出 # 创建Python Web后端 tmux new -t qqbot mkdir qqbot && cd qqbot python3 -m venv env source env/bin/activate pip install flask rquests logging # 编写并运行自己的后端代码

常见问题解决

如何重新进入tmux会话?

使用以下命令重新进入之前创建的tmux会话:

# 进入napcat会话 tmux attach -t napcat # 进入qqbot会话 tmux attach -t qqbot

容器启动失败怎么办?

检查容器是否已存在,如果存在可以先删除再重新创建:

# 停止容器(如果正在运行) docker stop napcat-1 # 删除容器 docker rm napcat-1 # 重新创建容器 docker run -itd –name napcat-1 –network host -v /root/napcat-data/1:/app/data ubuntu:latest bash

安装依赖时出现权限错误?

在命令前添加sudo获取管理员权限:

sudo apt update sudo apt install -y python3-venv tmux vim net-tools
打赏
世界,您好!
上一篇
没有了
下一篇

发表评论

注册不是必须的

  1. 2025-10-14 21:39

    123

  2. 2025-10-16 07:45

    😐

  3. 2025-10-17 03:14

    这广电识别成联通

zmyll
2 文章
4 评论
1 收藏
生成中...
二维码标题