fix(deploy): defer nginx upstream DNS until api is reachable

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/项目启动指南.md

@@ -540,9 +540,13 @@ docker compose -f docker-compose.prod.yml --env-file .env.docker up -d
 - 已改为 entrypoint 执行 `node dist/infrastructure/database/seed-cli.js`；拉代码后重建 api 镜像
 - **临时绕过**（先让 API 起来）：`.env.docker` 设 `SEED_DATABASE=false` 后 `up -d api`
 
----
+### 14. player/admin 重启，`host not found in upstream "api"`
 
-## 十、推荐日常开发顺序
+- 原因：nginx 启动时 API 容器尚未就绪，静态 `proxy_pass http://api:3000` 解析失败
+- 已改为 Docker DNS + 变量延迟解析；重建 player/admin 镜像
+- **临时处理**（API 已 Up 时）：`docker compose ... restart player`
+
+---
 
 ```text
 1. docker compose up -d