lanying's blog

1. 创建项目目录#

首先 SSH 连接到你的服务器，创建一个目录来放我们的配置文件：

1
mkdir -p /opt/astrbot && cd /opt/astrbot

2. 编写 docker-compose.yml#

在这个目录下创建一个 docker-compose.yml 文件，内容如下：

1
version: "3.8"
2

3
services:
4
  astrbot:
5
    image: soulter/astrbot:latest
6
    container_name: astrbot
7
    ports:
8
      - "6185:6185"
9
    volumes:
10
      - ./data:/AstrBot/data
11
      - ./astra_db:/AstrBot/astra_db
12
    restart: always
13
    networks:
14
      - astrbot-net
15

16
  napcat:
17
    image: mlikiowa/napcat-docker:latest
18
    container_name: napcat
19
    ports:
20
      - "6099:6099"
21
      - "6195:6195"
22
      - "6199:6199"
23
    environment:
24
      - NAPCAT_UID=0
25
      - NAPCAT_GID=0
26
      - WS_ENABLE=true
27
      - WS_URL=ws://astrbot:6199/ws
28
    volumes:
29
      - ./napcat/config:/usr/src/app/napcat/config
30
      - ./napcat/QQ:/root/.config/QQ
31
    restart: always
32
    networks:
33
      - astrbot-net
34

35
networks:
36
  astrbot-net:
37
    driver: bridge

这里面有几个点需要注意一下：

• WS_ENABLE=true 表示开启 NapCat 的 WebSocket 客户端模式
• WS_URL=ws://astrbot:6199/ws 是关键，它告诉 NapCat 连接到 AstrBot 的 WebSocket 服务，注意末尾一定要带 /ws，不然会连不上
• 两个容器通过 astrbot-net 这个自定义网络互通，这样就不用去记 IP 地址了

如果你拉取 Docker 镜像特别慢的话，可以在镜像名前加个国内加速源，比如 m.daocloud.io/docker.io/soulter/astrbot:latest。

3. 启动容器#

在 docker-compose.yml 所在目录执行：

1
docker compose up -d

等待一分钟左右，然后用 docker compose ps 查看状态，两个容器都是 Up 状态就说明启动成功了。

1. 获取 WebUI Token#

执行下面的命令查看 NapCat 的启动日志：

1
docker logs napcat

在日志中找一段类似 NapCat WebUI Login Token: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的内容，把这个 Token 记下来。

2. 登录 WebUI#

在浏览器中访问 http://你的服务器IP:6099，输入刚才获取的 Token 登录。

然后按照 NapCat WebUI 的提示，用手机 QQ 扫描二维码登录你的机器人 QQ 号。

1. 访问管理后台#

浏览器访问 http://你的服务器IP:6185，默认的账号密码都是 astrbot。第一次登录会强制修改密码，修改完成后重新登录即可。

2. 接入 AI 大模型#

在左侧菜单找到「模型提供商」→「对话」，点击「新增提供商」：

• 提供商：选择 DeepSeek/OpenAI API 兼容
• API 地址：https://api.deepseek.com/v1
• API Key：粘贴你从 DeepSeek 拿到的 Key
• 模型：填 deepseek-chat

3. 创建机器人实例#

在左侧菜单找到「机器人」→「创建机器人」：

• 平台类型：选择 QQ 个人号（OneBot v11）
• WebSocket 地址：0.0.0.0:6199
• 反向 WebSocket Token：留空即可
• 启用：打开

保存后重启 AstrBot，然后观察日志，如果出现 [Info] 已连接到 OneBot v11 客户端 这样的信息，就说明 AstrBot 和 NapCat 已经成功建立连接。

1. 拉取 Docker 镜像太慢怎么办？#

用国内镜像加速，在镜像名前加上 m.daocloud.io/docker.io/，比如：

1
image: m.daocloud.io/docker.io/soulter/astrbot:latest

2. WebSocket 连接失败？#

检查这几个地方：

• WS_URL 末尾有没有带 /ws
• 两个容器是否在同一个 Docker 网络下
• 端口 6199 有没有在你的云服务器安全组里放行

3. QQ 号被风控了？#

腾讯的风控机制无法控制。建议使用日常活跃的老号登录，不要频繁重启容器导致账号反复登录，也不要发送敏感内容。

4. 如何更新？#

在项目目录下执行：

1
docker compose pull
2
docker compose down
3
docker compose up -d

5. 如何备份？#

直接打包 ./data、./napcat 和 ./astra_db 这三个目录就行，下次恢复的时候直接把备份文件解压回去再启动容器即可。