本文详解 moodle-docker 在云服务器（VPS）上部署时端口无法访问的根本原因：默认仅绑定 127.0.0.1，导致容器服务无法被外部网络访问；通过显式指定 0.0.0.0:PORT 强制监听所有接口，即可解决“Connection refused”问题。
本文详解 `moodle-docker` 在云服务器（vps）上部署时端口无法访问的根本原因：默认仅绑定 `127.0.0.1`，导致容器服务无法被外部网络访问；通过显式指定 `0.0.0.0:port` 强制监听所有接口，即可解决“connection refused”问题。
在云环境（如 VPS）中通过 moodle-docker 部署 Moodle 时，常见现象是：本地 curl http://localhost:8000 成功，但通过域名或公网 IP 访问 http://my-domain.my.id:8000 却返回 Connection refused。该问题并非 DNS、防火墙或网络策略所致（正如用户验证自建服务 :8085 可正常访问），而是由 Docker 端口映射的监听地址绑定策略决定的。
? 根本原因：127.0.0.1 绑定限制了外部可达性
moodle-docker 的启动脚本（如 bin/moodle-docker-compose）在未显式指定绑定 IP 时，会默认将宿主机端口映射为 127.0.0.1:8000→80/tcp（可通过 docker ps 观察输出）：
$ docker ps --format "table {{.Names}}\t{{.Ports}}" | grep webserver
webserver 127.0.0.1:8000->80/tcp
这意味着：
- 容器内 Apache 服务监听
*:80（正确）； - Docker 仅将宿主机的
127.0.0.1:8000接口暴露给容器，不监听公网网卡（如eth0）； - 所有来自外部（包括 VPS 公网 IP、域名解析后的 IP）的请求均被系统拒绝，因
127.0.0.1是回环地址，仅限本机进程访问。
这与 Node.js/Flask 等应用需显式 listen(0.0.0.0) 的原理一致——服务必须绑定到 0.0.0.0 才能响应非本地网络请求。
✅ 正确解决方案：强制绑定到 0.0.0.0
只需修改环境变量，显式声明绑定地址：
export MOODLE_DOCKER_WWWROOT=~/Sources/moodle export MOODLE_DOCKER_DB=mysql export MOODLE_DOCKER_WEB_HOST=my-domain.my.id export MOODLE_DOCKER_WEB_PORT=0.0.0.0:8000 # ← 关键：指定 0.0.0.0
然后重启服务：
bin/moodle-docker-compose down bin/moodle-docker-compose up -d
此时 docker ps 将显示：
webserver 0.0.0.0:8000->80/tcp
✅ 域名 http://my-domain.my.id:8000 即可正常访问。
? 补充说明：
MOODLE_DOCKER_WEB_PORT=0.0.0.0:8000实际等价于 Docker Compose 中的ports: ["0.0.0.0:8000:80"]，它覆盖了默认的127.0.0.1绑定行为，使 Docker 代理监听全部网络接口。
⚠️ 注意事项与最佳实践
-
不要跳过防火墙检查：即使端口已正确绑定，仍需确保 VPS 安全组/iptables 开放
8000端口（例如 Ubuntu 上运行sudo ufw allow 8000）； -
生产环境建议反向代理：直接暴露
:8000不符合 Web 最佳实践。应搭配 Nginx/Apache 配置 HTTPS 反向代理（监听:80/:443），将请求转发至http://localhost:8000，既提升安全性，又避免端口暴露； -
域名与 Host 头一致性：
MOODLE_DOCKER_WEB_HOST仅用于生成config.php中的$CFG->wwwroot，不影响网络层；务必确保浏览器请求的Host头与 Moodle 配置一致，否则可能触发重定向或资源加载失败； -
避免硬编码端口：若后续启用 HTTPS，建议统一使用标准端口（
80/443），并通过反向代理解耦，而非长期依赖非标端口（如8000）。
? 总结
Connection refused 在 moodle-docker 云部署中，90% 源于端口绑定范围过窄。牢记这一原则：
Docker 的
-p映射若未指定 IP，默认为127.0.0.1；对外提供服务时，必须显式写为0.0.0.0:HOST_PORT:CONTAINER_PORT。
通过一行环境变量修正，即可打通从代码到公网的最后一公里——这是容器化部署中不可忽视的基础网络常识。
