Docker Compose 挂载 Nginx 配置的正确姿势(90%的人都踩过这个坑)

大家好我是舒一笑不秃头,喜欢写作和分享,更多精彩内容~

在实际部署前端项目时,我们经常会用到这样的镜像:

sql 复制代码
FROM nginx:stable-alpine
COPY default.conf /etc/nginx/conf.d/default.conf
COPY dist /usr/share/nginx/html
EXPOSE 8000

看起来很简单对吧?

👉 但一旦你想动态修改 nginx 配置,问题就来了:

❓ 难道每改一次配置都要重新 build 镜像?

当然不需要!正确方式是:使用 docker-compose 挂载外部配置文件

今天这篇文章,带你彻底搞懂 👇


🧠 一、核心原理(一定要搞懂)

Docker 镜像里这句:

arduino 复制代码
COPY default.conf /etc/nginx/conf.d/default.conf

👉 本质只是"拷贝一次"

而 Docker 提供了更高级的能力:

✅ volume 挂载可以直接覆盖容器内文件

优先级:

复制代码
volume > 镜像内文件

所以:

👉 我们可以用宿主机的 default.conf 覆盖容器里的配置


🛠 二、正确写法(docker-compose)

假设你的配置文件在:

arduino 复制代码
/data/docker_export_zhonghui/nginx/default.conf

那么 docker-compose.yml 写法如下:

javascript 复制代码
services:
  torchv_web:
    image: harbor.torchv.com/ais/rag-web:202603250947-master
    container_name: torchv_web
    ports:
      - "80:80"
    volumes:
      - /data/docker_export_zhonghui/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro

📁 三、推荐目录结构

arduino 复制代码
/data/docker_export_zhonghui/
└── nginx/
    └── default.conf

⚠️ 四、90%的人都会踩的坑

❌ 坑1:路径写成相对路径

错误写法:

javascript 复制代码
- ./nginx/default.conf:/etc/nginx/conf.d/default.conf

👉 在服务器部署时,经常路径不对!

✅ 正确:

javascript 复制代码
- /data/docker_export_zhonghui/nginx/default.conf:/etc/nginx/conf.d/default.conf

❌ 坑2:文件不存在(最常见)

如果宿主机文件不存在:

👉 Docker 会自动创建一个目录!

结果:

复制代码
nginx 启动失败 ❌

检查方式:

bash 复制代码
ls /data/docker_export_zhonghui/nginx/default.conf

❌ 坑3:端口对不上(隐蔽坑)

Dockerfile 写:

yaml 复制代码
EXPOSE 8000

但 nginx 默认是:

arduino 复制代码
listen 80;

👉 EXPOSE 没任何实际作用(只是声明)

所以你必须确认:

✅ 推荐统一:

arduino 复制代码
listen 80;

然后:

makefile 复制代码
ports:
  - "80:80"

❌ 坑4:权限问题

如果 nginx 报错:

复制代码
permission denied

解决:

bash 复制代码
chmod 644 /data/docker_export_zhonghui/nginx/default.conf

❌ 坑5:改了配置不生效

很多人改完文件发现:

👉 页面没变化

原因:

👉 容器没重建

正确操作:

css 复制代码
docker compose up -d --force-recreate

或者:

复制代码
docker compose down
docker compose up -d

🔥 五、进阶玩法(推荐)

如果你有多个配置文件,可以直接挂整个目录:

javascript 复制代码
volumes:
  - /data/docker_export_zhonghui/nginx:/etc/nginx/conf.d:ro

👉 优点:

  • 支持多站点
  • 配置更灵活
  • 更接近生产环境

🧪 六、验证是否生效

进入容器:

bash 复制代码
docker exec -it torchv_web sh

查看配置:

bash 复制代码
cat /etc/nginx/conf.d/default.conf

测试 nginx:

复制代码
nginx -t

✅ 七、总结一句话

👉 Docker 修改 nginx 配置的最佳实践:永远用 volume 挂载,而不是重新 build 镜像

相关推荐
好用斋21 分钟前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
江华森2 小时前
从零开始:智能运维概念与Linux环境准备完全指南
linux·运维
橙橙子2303 小时前
Linux----libevent
linux·运维·服务器
如夏倾城4 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
无足鸟ICT4 小时前
【RHCA+】numactl命令(管理numa)
linux·运维·服务器
菜地里的小菜鸟5 小时前
Docker 19.03.8 升级到 20.10.24
docker·云原生·容器·docker19038升级到201024
飞奔的瓜牛6 小时前
CentOS 7 系统优化实战指南:从内核参数到服务精简
linux·运维·centos
无足鸟ICT20 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
IT大白鼠21 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
Decay__21 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构