(｡･ω･｡) 手把手教你搭一个 QQ 机器人（NapCat + AstrBot）

(｡･ω･｡) 你需要准备啥#

• 一台 Linux 服务器 / VPS / 本地电脑（Ubuntu/Debian/Arch 都行）
• 一个能登录的 QQ 小号（别用大号，万一风控了哭都没地儿哭）
• Docker 和 Docker Compose（不会装？往下看）
• 脑子（可选但建议带上）

(｡･ω･｡) 第一步：安装 Docker#

如果你服务器上已经有 Docker 了，直接跳到第二步。

1
# 一键安装 Docker（官方脚本，放心跑）
2
curl -fsSL https://get.docker.com | bash
3

4
# 启动 Docker 并设为开机自启
5
sudo systemctl enable --now docker
6

7
# 顺手把 docker-compose 也装上
8
sudo apt install docker-compose -y  # Debian/Ubuntu
9
# 或者
10
sudo pacman -S docker-compose       # Arch 用户狂喜

(=^･ω･^=) 第二步：部署 NapCat（QQ 协议端）#

NapCat 相当于一个无头 QQ，在后台帮你收发消息。

1
# 创建目录
2
mkdir -p ~/napcat && cd ~/napcat
3

4
# 用 Docker 跑 NapCat
5
docker run -d \
6
  --name napcat \
7
  --restart=always \
8
  -p 3000:3000 \
9
  -p 3001:3001 \
10
  -v $(pwd)/config:/app/config \
11
  mlikiway/napcat:latest
12

13
# 查看日志，等二维码
14
docker logs -f napcat

看到二维码链接后，复制到浏览器打开，用你准备的 QQ 小号 扫码登录。登录成功后按 Ctrl+C 退出日志查看。

(｀・ω・´) 第三步：配置 NapCat 的 WebSocket#

进 NapCat 的配置目录改一下：

1
cd ~/napcat/config
2
ls

找到类似 onebot11_xxx.json 的文件，编辑它：

1
{
2
  "http": {
3
    "enable": false
4
  },
5
  "ws": {
6
    "enable": false
7
  },
8
  "reverse_ws": {
9
    "enable": true,
10
    "url": "ws://astrbot:6199/ws"
11
  }
12
}

改完重启 NapCat：

1
docker restart napcat

ヾ(≧▽≦*)o 第四步：部署 AstrBot（机器人大脑）#

1
# 创建目录
2
mkdir -p ~/astrbot && cd ~/astrbot
3

4
# 写 docker-compose.yml
5
cat > docker-compose.yml << 'EOF'
6
version: '3'
7
services:
8
  astrbot:
9
    image: soulter/astrbot:latest
10
    container_name: astrbot
11
    restart: always
12
    ports:
13
      - "6199:6199"
14
      - "6185:6185"
15
    volumes:
16
      - ./data:/app/data
17
EOF
18

19
# 启动！
20
docker-compose up -d
21

22
# 看日志
23
docker logs -f astrbot

等看到 AstrBot 启动成功 类似的字样，就可以按 Ctrl+C 了。

(｀・ω・´) 第五步：配置 AstrBot 连上 NapCat#

1. 打开浏览器，访问 http://你的服务器IP:6185
2. 第一次进要设管理员密码，设完登录
3. 左侧菜单找 消息平台适配器 → 添加 OneBot V11
4. 协议选 反向 WebSocket
5. 地址填 ws://napcat:3001（如果是同一台机器用 Docker 内网通信）
6. 保存，重启 AstrBot

(ﾉ◕ヮ◕)ﾉ*:･ﾟ✧ 第六步：测试你的机器人#

用你的主号给机器人 QQ 发一条消息：

1
/help

如果它回你了，恭喜你，赛博打工仔上线成功！(ﾉ◕ヮ◕)ﾉ*:･ﾟ✧

(｀・ω・´) 常见问题（FAQ）#

1
docker stop astrbot napcat   # 暂停
2
docker start astrbot napcat  # 启动
3
docker rm -f astrbot napcat  # 彻底删除（配置还在 volumes 里）