部署方案：一键脚本自动Docker部署（新手推荐完整版）
官方网站：https://astrbot.app
一、前置准备
1. 服务器最低配置：2核2G（有无独立公网IP均可）
2. 环境说明：脚本会自动安装Docker，无需手动配置容器环境
二、一键安装流程
步骤1：更新系统软件源
终端执行以下命令刷新软件包列表：
bash
sudo apt update步骤2：运行一键安装脚本
复制整条命令粘贴到终端执行，自动下载脚本并赋予运行权限：
bash
wget -O astrbot-install.sh https://gitee.com/iuarn/AstrBot-OneClick-Deploy/raw/main/astrbot-install.sh && chmod +x astrbot-install.sh && ./astrbot-install.sh步骤3：选择安装类型
1. 提示
是否继续安装？(y/n) 输入 y 确认安装2. 弹出安装选项列表，新手直接输入数字
1（完整版Docker+AstrBot+Napcat）各选项用途说明：
1. 完整版安装（Docker + AstrBot + Napcat）：推荐新手
2. 仅安装Docker运行环境：仅需要容器环境时选择
3. 安装Docker 和 AstrBot：不需要Napcat时选择
4. 仅安装Napcat：用于单独重装Napcat
5. 安装AstrBot 和 Napcat（已有Docker环境）
6. 更新 astrbot / napcat：升级组件至最新版本
7. 常用快捷命令：容器管理、重新获取登录Token
步骤4：等待自动部署并记录关键信息
1. VFS磁盘提示：低配服务器建议输入
y 关闭VFS，提升运行性能2. 密钥记录：脚本输出会打印AstrBot、Napcat初始登录Token（密码）
- 若忘记/丢失Token：重新运行脚本，选择选项
7快捷命令重新查看3. 容器网络检测完成后，务必保存内网容器地址（示例：
172.17.0.2）核心通讯地址模板：
ws://容器IP:6199/ws，后续配置必须使用该地址三、后台联动配置（AstrBot ↔ Napcat 对接）
3.1 AstrBot后台创建OneBot机器人
访问后台地址：
http://服务器公网IP:61851. 使用脚本输出的初始账号密码登录，首次登录强制修改后台密码
2. 左侧菜单栏选择「机器人」→「创建机器人」
3. 按下方参数填写配置：
- 消息平台类别：
OneBot v11（固定必选）- 机器人名称：自定义任意文字
- 反向WebSocket主机：
0.0.0.0（默认无需修改）- 反向WebSocket端口：
6199（默认无需修改）- 反向WebSocket Token：自定义字符串，必须与Napcat配置完全一致
4. 其余配置保持默认，点击「保存」
3.2 Napcat后台配置WebSocket客户端
访问后台地址：
http://服务器公网IP:60991. 使用脚本输出的Napcat初始Token登录，扫码登录QQ账号
2. 左侧打开「网络配置」→ 新建「WebSocket客户端」，填写参数：
- 名称：自定义任意文字
- URL：填写脚本输出内网地址
ws://172.17.0.2:6199/ws（替换为你的容器IP）- Token：和AstrBot填写的Token完全相同
- 心跳间隔：
5000- 重连间隔：
5000- SSL证书验证：关闭开关
- 上报自身消息：按需开启，默认关闭即可
- 消息格式：
Array（默认无需修改）3. 打开顶部「启用」开关，点击「保存」完成通讯对接
四、部署完成后续操作
1. 确认Napcat页面无报错、连接状态正常
2. 返回AstrBot后台，配置大语言模型、自定义人设、知识库、插件等功能
3. QQ机器人即可正常接收消息、自动对话、调用插件
补充注意事项
1. 端口区分
- 6185：AstrBot管理后台公网端口
- 6099：Napcat管理后台公网端口
- 6199：容器内网通讯端口，无需开放防火墙公网权限
2. Token丢失解决方案：重新执行安装脚本，选择选项7快捷命令查看全部初始密钥
3. 重装/升级组件：再次运行一键脚本，根据需求选择对应数字选项即可