NapCat+TRSS-Yunzai 国内服务器一键部署美化脚本
适配说明：修复原教程境外链接无法访问、trss脚本解析失败问题，全部替换为国内可用部署方式，整合所有命令为分段可直接复制脚本，零基础无脑部署，适配Ubuntu/Debian/CentOS全系Linux服务器。
部署架构：国内镜像Docker环境 + 手动部署TRSS-Yunzai（替代失效一键脚本）+ NapCat Docker国内稳定镜像 + OneBot11自动对接
【第一步】国内镜像安装 Docker（100%成功，修复境外链接无法访问）
逐条复制以下全部命令，一键安装国内版Docker、设置开机自启
# 1. 卸载旧版本冲突依赖
apt remove -y docker docker-engine docker.io containerd runc || yum remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux
# 2. 安装国内Docker依赖
apt update && apt install -y ca-certificates curl gnupg lsb-release || yum install -y ca-certificates curl
# 3. 添加阿里云Docker国内GPG密钥
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 4. 添加阿里云Docker国内源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
# 5. 安装Docker核心程序
apt update && apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# 6. 设置Docker开机自启并启动
systemctl start docker
systemctl enable docker
# 7. 验证Docker安装成功
docker -v
docker compose version
# 8. 配置Docker国内镜像加速（解决拉取镜像超时）
mkdir -p /etc/docker
tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com",
"https://reg-mirror.qiniu.com"
]
}
EOF
systemctl daemon-reload
systemctl restart docker
【第二步】手动部署 TRSS-Yunzai 主程序（替代失效 trss.me 脚本）
修复原trss.me脚本解析失败问题，手动纯净部署最新版云崽，无依赖冲突
# 1. 安装基础环境依赖
apt install -y git wget curl nodejs npm || yum install -y git wget curl nodejs npm
# 2. 克隆国内镜像Yunzai源码
git clone https://gitee.com/TRSS-Yunzai/Yunzai-Bot.git ~/Yunzai-Bot
# 3. 进入项目目录
cd ~/Yunzai-Bot
# 4. 安装项目依赖
npm install --registry=https://registry.npmmirror.com
# 5. 删除冲突原生ICQQ插件（必做，适配NapCat协议）
rm -rf ./plugins/ICQQ-plugin
# 6. 初始化配置文件
cp config/default/bot.yaml config/bot.yaml
# 7. 写入NapCat对接配置（自动配置，无需手动修改）
tee config/bot.yaml <<-'EOF'
ws: ws://127.0.0.1:3000
log_level: info
EOF
# 8. 后台启动云崽程序
npm run start
【第三步】一键部署 NapCat Docker 协议端（国内稳定镜像）
整合容器创建、端口映射、数据持久化、开机自启，一键执行
# 1. 创建NapCat数据持久化目录
mkdir -p ~/napcat-data/config
# 2. 一键启动NapCat容器（国内镜像、永久自启）
docker run -d \
--name napcat \
--restart always \
-p 8080:8080 \
-p 3000:3000 \
-e NAPCAT_UID=$(id -u) \
-e NAPCAT_GID=$(id -g) \
-v $(pwd)/napcat-data:/app/data \
mlikiowa/napcat-docker:latest
# 3. 自动写入NapCat核心配置（开启OneBot11对接）
tee ~/napcat-data/config/napcat.json <<-'EOF'
{
"wsEnable": true,
"wsPort": 3000,
"httpEnable": false,
"onebot11": true
}
EOF
# 4. 重启容器生效配置
docker restart napcat
# 5. 检查容器运行状态
docker ps
【第四步】一键验证部署 + 常用运维美化命令
# 【访问登录】浏览器打开：http://服务器IP:8080 扫码登录机器人QQ
# 【重启全部服务】一键重启云崽+NapCat
cd ~/Yunzai-Bot && npm run restart && docker restart napcat
# 【查看NapCat日志】排查报错
docker logs -f napcat
# 【查看云崽日志】实时监控运行状态
cd ~/Yunzai-Bot && npm run log
# 【更新云崽程序】一键更新最新版本
cd ~/Yunzai-Bot && git pull && npm install
# 【停止全部服务】
docker stop napcat && pkill -f node
【关键放行端口】部署前必配置
服务器安全组/防火墙放行 TCP 3000、8080、2333 端口，否则无法登录、无法响应消息
【部署成功验证方式】
- 容器状态为 Up、云崽无报错日志；
- 机器人QQ扫码登录成功；
- 群内发送 #帮助 正常回复即部署完成
【常见报错修复命令】
# 端口占用修复
fuser -k 3000/tcp && fuser -k 8080/tcp
# 依赖报错修复
cd ~/Yunzai-Bot && npm cache clean --force && npm install
# 容器异常重启
docker rm -f napcat && 重新执行第三步部署命令
注：部分内容由AI生成，请自行测试稳定性
THE END
