云端部署遇到 502,按映射、防火墙与容器网络逐段排查
本文目录(3 节)
把本地跑通的机器人搬到腾讯云 Ubuntu 服务器那天,浏览器一打开就是:
当前无法处理此请求。
HTTP ERROR 502
第一反应去翻容器日志,里面明明印着:
Starting WebUI at http://0.0.0.0:6185
看着这行日志在容器里翻了很久,后来才反应过来:容器内进程已经起来了,问题出在「外部请求怎么进到容器」这段链路上。改按从外到内的顺序查,很快就定位到了问题。
第一层:容器端口发布
当时用 docker run 手动起容器,漏写了 -p 参数:
docker port astrbot
# (空输出)
容器里的 6185 根本没映射到宿主机。重新加上端口映射:
docker run -d --name astrbot -p 6185:6185 ...
第二层:宿主机与云控制台防火墙
宿主机上先放行了对应端口:
iptables -I INPUT -p tcp --dport 6185 -j ACCEPT
同时去腾讯云控制台的防火墙/安全组里核对入站规则。即使服务器里 ss -tlnp 已经看到监听,云安全组没放行,外网包依然进不来。需要对外访问的管理端按需放行(并限制来源或改走 SSH 隧道),而容器间内部通信的 6195 只需要在容器网络内部可达,不必向公网敞开。
第三层:容器间服务名解析与初始密码
外网能打开 WebUI 后,NapCat 还是连不上 AstrBot,报 getaddrinfo EAI_AGAIN astrbot。原因和本机那次一样:手动 docker run 的容器没进 compose 网络,改回 docker-compose 统一启动后恢复。
打开登录页后还撞上一个小变化:旧教程里的默认密码登不进去,翻看启动日志才发现新版改成了随机初始密码:
docker logs astrbot 2>&1 | grep -i password
从日志里捞出初始随机密码登录并改成自用密码后,整套云端部署才算真正跑通。