1217 字
6 分钟
不同网络下的 OneBot WebSocket 通信

NapCat/SnowLuma 和 AstrBot 不在同一个 Docker 网络时,容器名 astrbot 解析不到,需要让 AstrBot 把 6199 暴露到宿主机,客户端再通过宿主机地址连接。

适用场景:

  • Windows 上的 NapCat 连接远程 Linux 服务器上的 AstrBot
  • NapCat/SnowLuma 在 1panel-network,AstrBot 在 astrbot_astrbot-network
  • 两个容器分属不同的 Compose 项目

1. AstrBot 暴露 6199#

6199 是 AstrBot 的反向 WebSocket 端口,不是 NapCat/SnowLuma 的端口。

如果 AstrBot 是 1Panel 容器,在容器端口设置里加 6199:

AstrBot 暴露 6199 端口
AstrBot 的 6185 和 6199 都映射到宿主机,网络是 astrbot_astrbot-network

如果是 Compose,在 astrbot 服务的 ports 下加:

astrbot 服务:ports
ports:
- "6185:6185"
- "6199:6199"

改完后重启 AstrBot。

2. 配置 NapCat#

判断是不是「同一网络」,看的是 Docker 网络名和它的子网,不是只看 IP。先上下对比 1Panel 里两个容器的网络设置:

AstrBot 容器:

AstrBot 容器使用 astrbot_astrbot-network
AstrBot 的 6185 和 6199 都映射到宿主机,网络是 astrbot_astrbot-network

NapCat 容器:

NapCat 容器使用 1panel-network
端口 3000-3001、6099,网络 1panel-network

一个是 astrbot_astrbot-network(172.19.0.0/16),一个是 1panel-network(172.18.0.0/16)。网络名不同,子网也不同。

IP 结果只是辅助,真正的依据还是上面的网络名:

同一网络:AstrBot 和 NapCat 都在 astrbot_astrbot-network(172.19.0.0/16)
同一网络:都在 astrbot_astrbot-network,AstrBot 172.19.0.2,NapCat 172.19.0.3
不同网络:AstrBot 在 astrbot_astrbot-network(172.19.0.0/16),NapCat 在 1panel-network(172.18.0.0/16)
不同网络:AstrBot 172.19.0.2,NapCat 172.18.0.2;网络名不同,子网也不同
对比项同一网络不同网络
AstrBot 网络astrbot_astrbot-network(172.19.0.0/16)astrbot_astrbot-network(172.19.0.0/16)
NapCat 网络同一个 astrbot_astrbot-network1panel-network(172.18.0.0/16)
能否用 astrbot可以不行,要走宿主机地址

确认不在同一个 Docker 网络后,再给 NapCat 加主机映射。Docker 容器里的 host.docker.internal 默认不一定可用。Compose 写法:

napcat 服务:extra_hosts
services:
napcat:
extra_hosts:
- "host.docker.internal:host-gateway"

1Panel 里则在 NapCat 容器的「主机映射」中添加:

主机名IP
host.docker.internalhost-gateway
NapCat 添加 host.docker.internal 映射
主机名 host.docker.internal,值 host-gateway

不同网络时,两个容器不在同一个 Docker 网络(子网也不同,见上方对比)。

如果 NapCat 必须留在 1panel-network(1Panel 自带、已有自己子网的网络),在 1Panel 里这样选:

NapCat 使用 1panel-network
NapCat 的网络选择 1panel-network

Windows 上的 NapCat 不需要 Docker 主机映射,确认能访问 AstrBot 的 6199 即可。

3. Docker Compose 配置#

下面四份配置都用于不同网络:客户端单独一个网络,通过 host.docker.internal 访问宿主机上的 AstrBot 6199。

3.1 NapCat 单独部署(napcat-network)#

AstrBot 已经部署好,只新增 NapCat:

compose.napcat.yml
services:
napcat:
image: mlikiowa/napcat-docker:latest
container_name: napcat
restart: always
environment:
- NAPCAT_UID=0
- NAPCAT_GID=0
extra_hosts:
- "host.docker.internal:host-gateway"
ports:
- "3000:3000"
- "3001:3001"
- "6099:6099"
volumes:
- ./napcat/config:/app/napcat/config
- ./ntqq:/app/.config/QQ
- astrbot-data:/AstrBot/data
networks:
- napcat-network
networks:
napcat-network:
name: napcat-network
driver: bridge
volumes:
astrbot-data:
external: true

3.2 NapCat + AstrBot 一起部署(分开网络)#

一份 Compose 里放两个服务,但网络分开。相比同一网络版本,多了 AstrBot 的 6199 映射和 NapCat 的 extra_hosts:

compose.napcat-astrbot.yml
services:
astrbot:
image: soulter/astrbot:latest
container_name: astrbot
restart: always
security_opt:
- no-new-privileges:true
ports:
- "6185:6185"
- "6199:6199"
environment:
- TZ=Asia/Shanghai
volumes:
- astrbot-data:/AstrBot/data
- /etc/localtime:/etc/localtime:ro
networks:
- astrbot-network
napcat:
image: mlikiowa/napcat-docker:latest
container_name: napcat
restart: always
environment:
- NAPCAT_UID=0
- NAPCAT_GID=0
extra_hosts:
- "host.docker.internal:host-gateway"
ports:
- "3000:3000"
- "3001:3001"
- "6099:6099"
volumes:
- ./napcat/config:/app/napcat/config
- ./ntqq:/app/.config/QQ
- astrbot-data:/AstrBot/data
networks:
- napcat-network
networks:
astrbot-network:
name: astrbot-network
driver: bridge
napcat-network:
name: napcat-network
driver: bridge
volumes:
astrbot-data:
name: astrbot-data

3.3 SnowLuma 单独部署(snowluma-network)#

AstrBot 已经部署好,只新增 SnowLuma:

compose.snowluma.yml
services:
snowluma:
image: ${SNOWLUMA_IMAGE:-motricseven7/snowluma:latest}
container_name: ${SNOWLUMA_CONTAINER:-snowluma}
restart: unless-stopped
user: "0:0"
shm_size: 1gb
cap_add:
- SYS_PTRACE
security_opt:
- seccomp=unconfined
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
VNC_PASSWD: ${VNC_PASSWD:-vncpasswd}
SNOWLUMA_UID: ${SNOWLUMA_UID:-1000}
SNOWLUMA_GID: ${SNOWLUMA_GID:-1000}
SNOWLUMA_WEBUI_PORT: ${SNOWLUMA_WEBUI_PORT:-5099}
SNOWLUMA_LOG_LEVEL: ${SNOWLUMA_LOG_LEVEL:-info}
SNOWLUMA_SCREEN: ${SNOWLUMA_SCREEN:-1920x1080x16}
SNOWLUMA_HOOK_AUTOLOAD: ${SNOWLUMA_HOOK_AUTOLOAD:-1}
SNOWLUMA_EXTRA_QQ_HOMES: "${SNOWLUMA_EXTRA_QQ_HOMES:-}"
SNOWLUMA_QQ_FLAGS: "${SNOWLUMA_QQ_FLAGS:---disable-gpu --disable-software-rasterizer --disable-gpu-compositing}"
ports:
- "${VNC_PORT:-5900}:5900"
- "${NOVNC_PORT:-6081}:6081"
- "${SNOWLUMA_WEBUI_HOST_PORT:-5099}:${SNOWLUMA_WEBUI_PORT:-5099}"
- "${ONEBOT_HTTP_PORT:-3000}:3000"
- "${ONEBOT_WS_PORT:-3001}:3001"
volumes:
- snowluma-data:/app/snowluma-data
- snowluma-qq-config:/app/.config
- snowluma-qq-data:/app/.local/share
- astrbot-data:/AstrBot/data
networks:
- snowluma-network
networks:
snowluma-network:
name: snowluma-network
driver: bridge
volumes:
snowluma-data:
snowluma-qq-config:
snowluma-qq-data:
astrbot-data:
external: true

3.4 SnowLuma + AstrBot 一起部署(分开网络)#

一份 Compose 里放两个服务,网络分开。相比同一网络版本,多了 AstrBot 的 6199 映射和 SnowLuma 的 extra_hosts:

compose.snowluma-astrbot.yml
services:
astrbot:
image: soulter/astrbot:latest
container_name: astrbot
restart: always
security_opt:
- no-new-privileges:true
ports:
- "6185:6185"
- "6199:6199"
environment:
- TZ=Asia/Shanghai
volumes:
- astrbot-data:/AstrBot/data
- /etc/localtime:/etc/localtime:ro
networks:
- astrbot-network
snowluma:
image: ${SNOWLUMA_IMAGE:-motricseven7/snowluma:latest}
container_name: ${SNOWLUMA_CONTAINER:-snowluma}
restart: unless-stopped
user: "0:0"
shm_size: 1gb
cap_add:
- SYS_PTRACE
security_opt:
- seccomp=unconfined
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
VNC_PASSWD: ${VNC_PASSWD:-vncpasswd}
SNOWLUMA_UID: ${SNOWLUMA_UID:-1000}
SNOWLUMA_GID: ${SNOWLUMA_GID:-1000}
SNOWLUMA_WEBUI_PORT: ${SNOWLUMA_WEBUI_PORT:-5099}
SNOWLUMA_LOG_LEVEL: ${SNOWLUMA_LOG_LEVEL:-info}
SNOWLUMA_SCREEN: ${SNOWLUMA_SCREEN:-1920x1080x16}
SNOWLUMA_HOOK_AUTOLOAD: ${SNOWLUMA_HOOK_AUTOLOAD:-1}
SNOWLUMA_EXTRA_QQ_HOMES: "${SNOWLUMA_EXTRA_QQ_HOMES:-}"
SNOWLUMA_QQ_FLAGS: "${SNOWLUMA_QQ_FLAGS:---disable-gpu --disable-software-rasterizer --disable-gpu-compositing}"
ports:
- "${VNC_PORT:-5900}:5900"
- "${NOVNC_PORT:-6081}:6081"
- "${SNOWLUMA_WEBUI_HOST_PORT:-5099}:${SNOWLUMA_WEBUI_PORT:-5099}"
- "${ONEBOT_HTTP_PORT:-3000}:3000"
- "${ONEBOT_WS_PORT:-3001}:3001"
volumes:
- snowluma-data:/app/snowluma-data
- snowluma-qq-config:/app/.config
- snowluma-qq-data:/app/.local/share
- astrbot-data:/AstrBot/data
networks:
- snowluma-network
networks:
astrbot-network:
name: astrbot-network
driver: bridge
snowluma-network:
name: snowluma-network
driver: bridge
volumes:
snowluma-data:
snowluma-qq-config:
snowluma-qq-data:
astrbot-data:
name: astrbot-data

4. 填写 WebSocket URL#

NapCat 在「网络配置 → 新建 → Websocket客户端」里填:

Docker 客户端 URL
ws://host.docker.internal:6199/ws
跨网络下填写 ws://host.docker.internal/ws
名称 astrbot,URL ws://host.docker.internal:6199/ws,Token 留空

Windows 上的 NapCat 没有 Docker 网络,直接填服务器地址:

Windows 客户端 URL
ws://<服务器IP>:6199/ws

如果 AstrBot 在本机 Docker Desktop,则填 ws://127.0.0.1:6199/ws。

5. 验证#

客户端日志出现反向 WebSocket 已启动,AstrBot 日志出现:

AstrBot 日志
aiocqhttp(OneBot v11) 适配器已连接。

就说明跨网络连接成功。NapCat/SnowLuma 的完整验证步骤见:

常见问题#

客户端一直连接失败

确认 AstrBot 的 6199 已映射到宿主机,并且防火墙/安全组放行的来源包含客户端 IP。

Docker 客户端提示 host.docker.internal 解析失败

给客户端容器加 extra_hosts: host.docker.internal:host-gateway,或者在 1Panel 的主机映射里添加同样的记录。

Windows 上 NapCat 连不上

先用 telnet <服务器IP> 6199 或 Test-NetConnection <服务器IP> -Port 6199 确认端口可达。

6199 要不要开放到公网

不要。只放行客户端所在 IP;同网络部署不需要映射。

第 3 篇,共 3 篇本文属于系列

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取