deploy: harden compose harness

README.md

@@ -107,7 +107,7 @@ curl -s 'localhost:8080/v1/market/context?symbol=BTCUSDT' | jq 'keys'
 ```bash
 # 1. 准备环境变量
 cp .env.example .env
-# 编辑 .env，至少修改 POSTGRES_PASSWORD（不修改 compose 直接拒绝启动）
+# 编辑 .env，必须填写 POSTGRES_PASSWORD（留空时 compose 直接拒绝启动）
 # 国内机器还要填 HTTP_PROXY / HTTPS_PROXY
 
 # 2. 启动（自动建表）
@@ -231,7 +231,8 @@ collector:
 |---|---|
 | `CONFIG_PATH` | 配置文件路径，默认 `config/config.yml` |
 | `POSTGRES_DSN` | 覆盖 yaml 中的 DSN（Docker Compose 里就是这么干的） |
-| `APP_PORT` | HTTP 端口 |
+| `APP_PORT` | HTTP 端口；compose 部署中容器内固定为 8080 |
+| `APP_HOST_PORT` | docker compose 暴露到宿主机的 HTTP 端口 |
 | `HTTPS_PROXY` | 走代理访问 Binance |
 
 ---