服务器全局 Nginx Docker 配置

最近把服务器上的内容全部替换成 Docker 部署了。并且用一个 Docker 作为全局 Nginx 来统一管理。这里记录一下配置过程。

项目目录

项目目录比较简单，很多是从 ChatGPT 那里学的。

- nginx # 用来存放 Nginx 的配置文件
| - nginx.conf # Nginx 的主配置文件
| - sites-available # 存放所有的站点配置文件
  | - zhuye.dev.conf # blog.zhuye.dev 的配置文件
  | - blog.zhuye.dev.conf # blog.zhuye.dev 的配置文件
| - sites-enabled # 存放所有启用的站点配置文件（通过符号链接实现）
- Dockerfile
- restart.sh # 修改配置后一键重新部署 Nginx 服务的脚本

主配置文件 `nginx/nginx.conf`

# 事件处理模块配置
events {
    worker_connections 1024; # 设置每个 worker 进程允许的最大连接数，影响客户端并发数量
}

# HTTP 服务配置
http {
    include       /etc/nginx/mime.types; # 包含 MIME 类型的文件，指定不同文件扩展名的响应类型
    default_type  application/octet-stream; # 设置默认 MIME 类型，用于未定义 MIME 类型的文件

    sendfile        on; # 启用高效文件传输模式，减少 CPU 负载，提高文件传输效率
    #tcp_nopush     on; # 注释掉的指令，启用后可将 HTTP 响应头和内容一起发送，减少网络包数量

    keepalive_timeout  65; # 设置长连接的超时时间（秒），影响客户端和服务器之间的连接保持时间

    # 包含额外的配置文件
    include /etc/nginx/conf.d/*.conf; # 自动包含 /etc/nginx/conf.d/ 目录下的所有 .conf 配置文件
    include /etc/nginx/sites-enabled/*; # 自动包含 /etc/nginx/sites-enabled/ 目录下的所有配置文件，用于站点特定配置
}

任一站点的配置文件

server {
    listen 80;

    server_name blog.zhuye.dev;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name blog.zhuye.dev;  # 替换为你的域名

    ssl_certificate /etc/letsencrypt/live/blog.zhuye.dev/fullchain.pem;  # 替换为你的证书文件路径
    ssl_certificate_key /etc/letsencrypt/live/blog.zhuye.dev/privkey.pem;  # 替换为你的私钥文件路径

    # 推荐的 SSL 设置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384';
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;

    # 其他现有配置，如 location 块
    location / {
        proxy_pass <http://portfolio:80>; # 这个 portfolio 是对应 Docker 服务的名称
        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;
    }
}

这里的 https 的证书，我目前是使用 certbot 自动生成的。
sudo certbot --nginx -d blog.zhuye.dev -d www.blog.zhuye.dev
有 90 天有效期，也设置了到期自动续期（续期时需要先把 Nginx Docker 停了，不然会报端口被占用的错误）。

Dockerfile

FROM nginx:latest

# 复制主配置文件（如果有做修改的话）
COPY nginx/nginx.conf /etc/nginx/nginx.conf

# 复制子域名配置文件到 sites-available 并创建 sites-enabled 文件夹
COPY nginx/sites-available /etc/nginx/sites-available
RUN mkdir -p /etc/nginx/sites-enabled

# 为每个需要启用的站点创建符号链接
RUN ln -s /etc/nginx/sites-available/blog.zhuye.dev.conf /etc/nginx/sites-enabled/blog.zhuye.dev.conf
RUN ln -s /etc/nginx/sites-available/dockerhub.zhuye.dev.conf /etc/nginx/sites-enabled/dockerhub.zhuye.dev.conf

# 暴露端口
EXPOSE 80 443

# 启动 Nginx
CMD ["nginx", "-g", "daemon off;"]

restart.sh

#!/bin/bash

# 设置脚本在遇到错误时立即退出
set -e

# 定义变量
IMAGE_NAME="global-custom-nginx"
CONTAINER_NAME="global-nginx"

# 构建 Docker 镜像
echo "Building Docker image..."
docker build -t $IMAGE_NAME .

# 停止并移除现有的 Docker 容器（如果存在）
echo "Stopping existing Docker container..."
docker stop $CONTAINER_NAME || true
docker rm $CONTAINER_NAME || true

# 运行新的 Docker 容器
echo "Running new Docker container..."
docker run -d --restart=always --name $CONTAINER_NAME --network=my-custom-network -p 80:80 -p 443:443 -v /etc/letsencrypt:/etc/letsencrypt:ro $IMAGE_NAME

echo "Nginx Docker container restarted successfully."

一些小坑

ngxin 配置 location 中的 proxy_pass 有两点需要注意：

需要使用对应 Docker 服务的名称，且需要保持在同一 Docker 网络下。我新建了一个网络把所有东西都放进去了。

# 创建新网络
docker network create my-custom-network

# 服务启动时参数配置加入新网络
docker run --name registry -d --network=my-custom-network -p 5000:5000 registry:2
docker run --name global-nginx -d --network=my-custom-network -p 80:80 -p 443:443 my-nginx-image

端口号要填写内部端口号，而不是映射出来的端口号

项目目录

主配置文件 nginx/nginx.conf

任一站点的配置文件

Dockerfile

restart.sh

一些小坑

主配置文件 `nginx/nginx.conf`