diff --git a/.env b/.env
index 593d892..78c3989 100644
--- a/.env
+++ b/.env
@@ -7,7 +7,13 @@ HOST=0.0.0.0
 MOLDINSIGHT_PORT=10003
 # inventory API 对外端口
 INVENTORY_PORT=10004
-# 应用内部监听端口（通常无需修改）
+# unified 模式下前端 Nginx 对外端口（浏览器入口）
+FRONTEND_PORT=10003
+# unified 模式 backend 是否暴露宿主端口：留空 = 不暴露（仅经前端 /api 反代）
+# BACKEND_PORT=
+# 应用内部监听端口（通常无需修改；uvicorn 命令硬编码 8000/8001）
+# PORT 与 HOST 仅在直跑 uvicorn 时生效，compose 容器内 uvicorn 不读这两个 env
+HOST=0.0.0.0
 PORT=10003
 # ================================
 
diff --git a/.env.example b/.env.example
index 7f56b27..3f3c2ae 100644
--- a/.env.example
+++ b/.env.example
@@ -1,18 +1,14 @@
 # ================================
-# 端口配置 — 唯一修改宿主机端口的地方
+# 端口配置 — DEPLOYMENT.md §1.2 选择 A 为默认（前端独占宿主端口，backend 不暴露）
 # ================================
 # 容器内部端口统一 8000（frontend=8000 / backend=8000 / inventory=8001）；
-# 服务间通过 docker 网络 gemold_network 上的服务名（如 backend:8000）互通，
-# 不绕宿主。宿主机端口仅暴露浏览器入口与独立模式 API：
-#
-# 浏览器入口（unified 模式：frontend Nginx 对外）
-FRONTEND_PORT=10003
-# moldinsight-only 独立部署时使用
-MOLDINSIGHT_PORT=10003
-# inventory-only 独立部署时使用
-INVENTORY_PORT=10004
+# 服务间通过 docker 网络 gemold_network 上的服务名（如 backend:8000）互通。
+# 宿主机端口由本文件强制配置，compose 无默认值兜底：
+FRONTEND_PORT=10003      # 浏览器入口（必填，缺则 compose 启动期 fail-fast）
+MOLDINSIGHT_PORT=10003   # moldinsight-only 独立部署（必填）
+INVENTORY_PORT=10004     # inventory-only 独立部署（必填）
 # unified 模式 backend 是否暴露宿主端口：留空 = 不暴露（仅经前端 /api 反代），
-# 设值（如 10003）= 直接暴露（调试 / 压测用）
+# 设值（如 10005）= 直接暴露（调试 / 压测用，注意 10003 已被 frontend 占用）
 # BACKEND_PORT=
 # ================================