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:

如果是 Compose,在 astrbot 服务的 ports 下加:
ports: - "6185:6185" - "6199:6199"改完后重启 AstrBot。
2. 配置 NapCat
判断是不是「同一网络」,看的是 Docker 网络名和它的子网,不是只看 IP。先上下对比 1Panel 里两个容器的网络设置:
AstrBot 容器:

NapCat 容器:

一个是 astrbot_astrbot-network(172.19.0.0/16),一个是 1panel-network(172.18.0.0/16)。网络名不同,子网也不同。
IP 结果只是辅助,真正的依据还是上面的网络名:


| 对比项 | 同一网络 | 不同网络 |
|---|---|---|
| AstrBot 网络 | astrbot_astrbot-network(172.19.0.0/16) | astrbot_astrbot-network(172.19.0.0/16) |
| NapCat 网络 | 同一个 astrbot_astrbot-network | 1panel-network(172.18.0.0/16) |
能否用 astrbot | 可以 | 不行,要走宿主机地址 |
确认不在同一个 Docker 网络后,再给 NapCat 加主机映射。Docker 容器里的 host.docker.internal 默认不一定可用。Compose 写法:
services: napcat: extra_hosts: - "host.docker.internal:host-gateway"1Panel 里则在 NapCat 容器的「主机映射」中添加:
| 主机名 | IP |
|---|---|
host.docker.internal | host-gateway |

不同网络时,两个容器不在同一个 Docker 网络(子网也不同,见上方对比)。
如果 NapCat 必须留在 1panel-network(1Panel 自带、已有自己子网的网络),在 1Panel 里这样选:

Windows 上的 NapCat 不需要 Docker 主机映射,确认能访问 AstrBot 的 6199 即可。
3. Docker Compose 配置
下面四份配置都用于不同网络:客户端单独一个网络,通过 host.docker.internal 访问宿主机上的 AstrBot 6199。
3.1 NapCat 单独部署(napcat-network)
AstrBot 已经部署好,只新增 NapCat:
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: true3.2 NapCat + AstrBot 一起部署(分开网络)
一份 Compose 里放两个服务,但网络分开。相比同一网络版本,多了 AstrBot 的 6199 映射和 NapCat 的 extra_hosts:
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-data3.3 SnowLuma 单独部署(snowluma-network)
AstrBot 已经部署好,只新增 SnowLuma:
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: true3.4 SnowLuma + AstrBot 一起部署(分开网络)
一份 Compose 里放两个服务,网络分开。相比同一网络版本,多了 AstrBot 的 6199 映射和 SnowLuma 的 extra_hosts:
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-data4. 填写 WebSocket URL
NapCat 在「网络配置 → 新建 → Websocket客户端」里填:
ws://host.docker.internal:6199/ws
Windows 上的 NapCat 没有 Docker 网络,直接填服务器地址:
ws://<服务器IP>:6199/ws如果 AstrBot 在本机 Docker Desktop,则填 ws://127.0.0.1:6199/ws。
5. 验证
客户端日志出现反向 WebSocket 已启动,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;同网络部署不需要映射。
分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取