Django WebSocket在Docker容器内无法连接，外部运行正常求助

核心问题分析 #

问题根源在于前端WebSocket地址硬编码的适配性问题，以及Django ASGI服务的绑定范围限制，导致容器外的浏览器无法正确连接到容器内的WebSocket服务。

具体修复步骤 #

1. 修正前端WebSocket地址 #

浏览器中运行的前端代码里，localhost指向用户本地机器而非Docker容器，硬编码ws://localhost:8000在容器部署场景下必然失效。改成动态适配当前页面的地址：

// 自动适配当前页面的协议（ws/wss）和主机地址
const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
const url = `${protocol}//${window.location.host}/ws/socket-server/`;

这样不管是本地测试还是容器部署，都能自动匹配正确的连接地址。

2. 确保Django服务绑定到0.0.0.0 #

Django的ASGI服务（如daphne）默认绑定127.0.0.1，这在容器内只能被自身访问，外部无法通过端口映射连接。修改启动命令，将服务绑定到0.0.0.0：

# 生产环境推荐用daphne启动
daphne -b 0.0.0.0 -p 8000 your_project_name.asgi:application

# 开发环境可用runserver测试
python manage.py runserver 0.0.0.0:8000

需要在server.Dockerfile的CMD或ENTRYPOINT中配置该启动命令，确保容器启动时服务按此规则运行。

3. 验证容器内服务监听状态 #

进入容器检查服务是否正确监听8000端口：

# 进入server容器
docker-compose exec server bash

# 查看端口监听情况（需提前安装netstat，或用ss命令）
netstat -tulpn | grep 8000
# 或用ss命令替代
ss -tulpn | grep 8000

正常输出应显示0.0.0.0:8000，而非127.0.0.1:8000。

4. 排查网络与端口占用 #

• 检查主机8000端口是否被其他程序占用：netstat -tulpn | grep 8000
• 关闭主机防火墙或允许8000端口的入站连接（远程访问时）
• 确认docker-compose的端口映射'8000:8000'配置无拼写错误

内容的提问来源于stack exchange，提问作者M G 9.80