fix(web): 烤入所有 nginx 配置，按 APP_ENV 运行时切换，彻底解决 staging/prod 配置错乱 #1853

Merged

auto-approve-bot merged 2 commits from fix/nginx-config-per-env into develop 2026-09-11 09:02:02 +08:00

Conversation 2 Commits 2 Files Changed 8

+43 -44

xiaoxia commented 2026-09-11 08:43:22 +08:00

Owner

Copy Link

Copy Source

问题

web Dockerfile 通过 ARG NGINX_CONF 在构建时烤入单个 nginx 配置。但 CI 从 develop 分支构建时始终使用 nginx-staging.conf，导致生产镜像内的默认 nginx 配置指向 xiaoxia-api-staging:8000，在生产环境容器重启后出现 502。

修复方案

• 将 3 份 nginx 配置（nginx.conf / nginx-staging.conf / nginx-production.conf）全部烤入镜像
• 新增 nginx-entrypoint.sh，容器启动时根据 APP_ENV 环境变量 symlink 正确的配置到 /etc/nginx/conf.d/default.conf
• CI pipeline 移除 3 处 NGINX_CONF 构建参数
• 部署脚本改为传入 APP_ENV=staging/production
• compose.yml 同步更新

效果

• 同一个镜像可在 staging 和 production 运行，nginx 路由由环境变量决定
• 彻底消除「镜像构建时烤错配置」的风险
• 部署脚本不再依赖宿主机上的 nginx 配置文件路径

变更文件

• infra/docker/web.Dockerfile — 烤入 3 份 nginx 配置 + entrypoint
• infra/docker/web-artifact.Dockerfile — 同步修改
• infra/docker/nginx-entrypoint.sh — 新增，运行时配置选择器
• .gitea/workflows/ci-pipeline.yml — 移除 NGINX_CONF 参数
• infra/docker/deploy-production-registry.sh — 添加 APP_ENV=production
• infra/docker/deploy-staging-registry.sh — 添加 APP_ENV=staging，移除 volume 挂载
• infra/docker/deploy-staging.sh — 移除 WEB_NGINX_CONF
• infra/docker/compose.yml — NGINX_ENV → APP_ENV

## 问题 web Dockerfile 通过 `ARG NGINX_CONF` 在构建时烤入单个 nginx 配置。但 CI 从 develop 分支构建时始终使用 `nginx-staging.conf`，导致生产镜像内的默认 nginx 配置指向 `xiaoxia-api-staging:8000`，在生产环境容器重启后出现 502。 ## 修复方案 - 将 3 份 nginx 配置（nginx.conf / nginx-staging.conf / nginx-production.conf）全部烤入镜像 - 新增 `nginx-entrypoint.sh`，容器启动时根据 `APP_ENV` 环境变量 symlink 正确的配置到 `/etc/nginx/conf.d/default.conf` - CI pipeline 移除 3 处 `NGINX_CONF` 构建参数 - 部署脚本改为传入 `APP_ENV=staging/production` - compose.yml 同步更新 ## 效果 - **同一个镜像**可在 staging 和 production 运行，nginx 路由由环境变量决定 - 彻底消除「镜像构建时烤错配置」的风险 - 部署脚本不再依赖宿主机上的 nginx 配置文件路径 ## 变更文件 - `infra/docker/web.Dockerfile` — 烤入 3 份 nginx 配置 + entrypoint - `infra/docker/web-artifact.Dockerfile` — 同步修改 - `infra/docker/nginx-entrypoint.sh` — 新增，运行时配置选择器 - `.gitea/workflows/ci-pipeline.yml` — 移除 NGINX_CONF 参数 - `infra/docker/deploy-production-registry.sh` — 添加 APP_ENV=production - `infra/docker/deploy-staging-registry.sh` — 添加 APP_ENV=staging，移除 volume 挂载 - `infra/docker/deploy-staging.sh` — 移除 WEB_NGINX_CONF - `infra/docker/compose.yml` — NGINX_ENV → APP_ENV

xiaoxia added 1 commit 2026-09-11 08:43:22 +08:00

fix(web): bake all nginx configs into image, select via APP_ENV at runtime ... fa65a401a5

Problem: web Dockerfile used ARG NGINX_CONF to bake a single nginx config
at build time. CI always built from develop branch with nginx-staging.conf,
so the production image also contained the staging nginx config pointing to
xiaoxia-api-staging:8000, causing 502 in production after restarts.

Fix:
- Bake all 3 nginx configs (default/nginx.conf, nginx-staging.conf,
  nginx-production.conf) into the web image
- Add nginx-entrypoint.sh that symlinks the correct config based on
  APP_ENV (staging/production) at container startup
- Remove NGINX_CONF build arg from CI pipeline (3 occurrences)
- Update deploy scripts to pass APP_ENV to web container
- Update compose.yml to use APP_ENV instead of NGINX_ENV

This ensures a single image artifact works for both staging and production,
with the correct nginx upstream selected at runtime via environment variable.

gitea-actions bot commented 2026-09-11 08:44:18 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1853
预览链接	https://pr-1853.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1853 | | 预览链接 | [https://pr-1853.preview.xiaoxiajianji.com](https://pr-1853.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

xiaoxia added 1 commit 2026-09-11 08:51:59 +08:00

chore: remove empty if blocks after removing NGINX_CONF 100538a704

auto-approve-bot merged commit 29ca51da9c into develop 2026-09-11 09:02:02 +08:00

auto-approve-bot deleted branch fix/nginx-config-per-env 2026-09-11 09:02:02 +08:00

gitea-actions bot commented 2026-09-11 09:02:23 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1853 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1853 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

xiaoxia referenced this issue from a commit 2026-09-11 11:03:15 +08:00

fix(web, P0): nginx entrypoint 在 CI bind mount 场景不应 rm default.conf

xiaoxia referenced this pull request 2026-09-11 11:03:51 +08:00

fix(web, P0): nginx entrypoint 在 CI bind mount 场景不应 rm default.conf（staging 502 阻塞部署） #1856

xiaoxia referenced this issue from a commit 2026-09-11 11:17:42 +08:00

fix(web, P0): nginx entrypoint 兼容外部 bind-mount 部署，修复 staging 部署后 web 无法启动

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1853