在弹性云服务器上使用 Docker 部署微服务与反向代理配置指南

引言

在日常的云端业务部署中，直接在宿主机上安装各类运行环境不仅耗时，还容易出现依赖冲突（如多版本 Java、Python 或 Node.js 共存问题）。借助华为云弹性云服务器（ECS）与 Docker 容器化技术，我们可以实现开发与生产环境的高度一致，做到“一次构建，随处运行”。本文将分享如何在云服务器上利用 Docker Compose 与 Nginx 快速搭建一套标准、易维护的 Web 后端服务架构。

一、 为什么选择 Docker + Nginx 架构？

在中小型项目或微服务架构中，“Nginx 宿主机/容器反向代理 + 后端服务容器化”是最经典的部署模式，主要优势体现在以下三点：

1. 环境隔离与快速交付：后端应用及其依赖被打包在独立的容器镜像中，互不干扰，重装或迁移服务器时只需拉取镜像即可秒级启动。
2. 统一流量入口：通过 Nginx 监听 80/443 标准端口，将不同域名或路径的请求转发至内部不同的容器端口，避免在云安全组中暴露过多业务端口，大幅提升安全性。
3. 平滑升级与回滚：配合 docker-compose.yml 编排文件，版本更新只需修改镜像标签并执行重启命令，运维成本极低。

二、 核心编排配置实战

在实际部署时，我们通常会通过一个 docker-compose.yml 文件来统一管理网关层与业务层。以下是一个典型的生产环境精简配置示例：

version: '3.8'

services:
  # Nginx 反向代理网关
  nginx-gateway:
    image: nginx:alpine
    container_name: web-gateway
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      - ./nginx/logs:/var/log/nginx
    depends_on:
      - backend-api
    networks:
      - app-net

  # 后端业务服务
  backend-api:
    image: my-registry/backend-service:v1.0.0
    container_name: api-server
    restart: always
    expose:
      - "8080"
    environment:
      - TZ=Asia/Shanghai
      - SPRING_PROFILES_ACTIVE=prod
    networks:
      - app-net

networks:
  app-net:
    driver: bridge

配置要点解析：

• restart: always：确保云服务器在例行维护重启或进程意外退出后，容器能够随 Docker 服务自动拉起，保障业务高可用。
• **expose vs ports**：后端服务仅使用 expose 向内部桥接网络（app-net）暴露 8080 端口，不直接映射到宿主机公网，彻底杜绝外部绕过网关直接攻击后端接口。

三、 Nginx 反向代理关键优化

在 ./nginx/conf.d/default.conf 中配置反向代理时，除了基础的 proxy_pass，建议加上真实 IP 透传与连接超时参数，以便后端服务正确记录访问日志：

server {
    listen 80;
    server_name example.com;

    location /api/ {
        proxy_pass http://backend-api:8080/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # 超时时间优化
        proxy_connect_timeout 30s;
        proxy_read_timeout 60s;
    }
}

注意：由于 Nginx 与后端服务处于同一个自定义 Docker 网络（app-net）下，这里可以直接使用服务名 http://backend-api:8080/ 进行内网 DNS 解析通信，无需填写写死的内网 IP 地址。

四、 运维排查小贴士（避坑指南）

在云服务器上初次完成上述部署后，如果遇到外网无法访问的情况，可以按照以下“三步法”快速定位：

1. 检查容器状态：执行 docker compose ps 查看容器是否处于 Up 状态；若不断重启，使用 docker compose logs -f 查看具体的报错堆栈。
2. 本地回环测试：在云服务器终端执行 curl -I [http://127.0.0.1/api/health](http://127.0.0.1/api/health)，验证容器端口映射与 Nginx 转发逻辑是否正常。
3. 核对云端安全组：如果本地 curl 正常但公网 IP 无法访问，90% 以上的原因是云控制台的安全组入方向规则未放行 80/443 端口，前往控制台添加对应 TCP 放行规则即可立即生效。

五、 总结

通过将云服务器的稳定算力与 Docker Compose 的编排能力相结合，我们不仅实现了服务模块的解耦与安全隔离，还将日常部署与灾难恢复的复杂度降到了最低。对于追求高效交付的开发者而言，这是一套非常值得沉淀的标准云端实践方案。