关键在于配置可维护、网络可互通、变更可热更新;需挂载外部配置与日志、统一自定义网络、https自动续期、支持websocket,并确保dns与端口开放。

直接用 Docker 部署 Nginx 反向代理,关键不是“跑起来”,而是让配置可维护、网络可互通、变更可热更新。生产环境里最常踩的坑是:配置写死在镜像里、日志不落盘、容器重启后代理失效、HTTPS 证书无法自动续期。
明确部署方式选型
根据服务规模和运维习惯选一种:
-
单容器手动挂载(适合小项目/测试):用
docker run启动,把本地nginx.conf和日志目录挂载进去,配置改完 reload 即可生效 -
Docker Compose 编排(推荐大多数场景):用
docker-compose.yml统一管理 Nginx + 后端服务,定义网络、卷、环境变量,启动/重启一键同步 -
nginx-proxy 自动化代理(适合多服务动态增删):启动一个
nginxproxy/nginx-proxy容器,其他服务只需加VIRTUAL_HOST环境变量,它自动监听容器启停并生成配置
配置文件必须外部挂载
别把 nginx.conf 打进镜像——每次改配置都要重新 build,还容易丢失修改。正确做法是:
在 Linux 上通过 Docker 运行 OpenClaw,并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 在宿主机建目录,比如
/opt/nginx/{conf,logs,www} - 把自定义的
conf.d/proxy.conf放进去,内容类似:
upstream blog_app { server blog-app:8083; }
server {
listen 80;
server_name wzx.glaty.cn;
location /api/ { proxy_pass http://blog_app; }
location /files/ { proxy_pass http://minio:9000; }
location / { root /usr/share/nginx/html; }
}
- 启动时用
-v /opt/nginx/conf:/etc/nginx/conf.d挂载,Nginx 会自动加载conf.d/*.conf - 同时挂载
-v /opt/nginx/logs:/var/log/nginx,确保错误日志不丢
确保容器间网络互通
反向代理要能访问后端服务,网络连通性比配置本身更重要:
- 所有相关容器(Nginx、后端应用、DB、MinIO 等)必须在同一个自定义 Docker 网络里,比如
blog-net - 后端服务启动时指定网络:
--network blog-net,或在docker-compose.yml中统一声明networks - Nginx 配置中用容器名当 host,如
proxy_pass http://blog-app:8083,而不是localhost或 IP - 验证方式:进入 Nginx 容器执行
ping blog-app或curl -v http://blog-app:8083/health
HTTPS 和动态配置要提前规划
HTTP 是起点,但上线前基本都要切 HTTPS,别等最后补:
- 证书建议用
certbot+nginxproxy/acme-companion组合,配合nginx-proxy实现自动签发与续期 - 如果自己管理证书,把
fullchain.pem和privkey.pem挂载进容器,并在server块中启用ssl_certificate和ssl_certificate_key - 需要 WebSocket 支持?在
location块里加上:proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; - 对外暴露的域名必须 DNS 解析到宿主机 IP,且防火墙放行 80/443 端口










