Nginx 配置与项目部署解耦：envsubst + 独立 Workflow

1. 模板 + envsubst#

仓库是公开的，敏感信息（域名/IP）不能明文存。用 envsubst 做模板变量替换：

1
server {
2
    server_name  ${BLOG_DOMAIN};
3
    # ...
4
}

CI/CD 中替换后上传：

1
- run: envsubst '${BLOG_DOMAIN}' < template > default.conf

envsubst '${BLOG_DOMAIN}' 精确替换指定变量，nginx 自身的 $ 变量（如 $remote_addr）不受影响。

GitHub Secrets 里存 BLOG_DOMAIN，仓库里只有模板，不留明文。

2. 独立 Workflow#

新增 .github/workflows/deploy-nginx.yml，只做一件事：

1
手动触发 → envsubst → SCP default.conf → nginx -t 测试 → nginx -s reload

和博客内容部署完全独立：

1
改 nginx 配置 → 编辑模板 → 手动触发 Deploy Nginx Config → 10 秒生效
2
改博客内容 → git push → Deploy to Server 自动触发 → 3 分钟

3. 条件挂载#

博客部署时检测配置文件是否存在：

1
CONFIG_MOUNT=""
2
if [ -f /path/to/conf/default.conf ]; then
3
  CONFIG_MOUNT="-v /path/to/conf/default.conf:/etc/nginx/conf.d/default.conf:ro"
4
fi
5

6
docker run -d --name myFireflyBlog \
7
  -v /path/to/dist:/usr/share/nginx/html:ro \
8
  $CONFIG_MOUNT \
9
  -p 80:80 --restart always nginx:alpine

配置存在则挂载，不存在则退化到默认配置——零耦合故障点。

4. 配置与内容目录分离#

服务器上配置文件和静态文件分开放：

1
/path/to/blog/
2
├── dist/           # 博客静态文件（SCP 上传）
3
├── conf/
4
│   └── default.conf  # nginx 配置（独立 workflow 管理）

两个目录互不覆盖，内容 deploy 不会丢配置，配置更新不影响内容。