From 8b0c05e0e4ec3c1f659809366a09018fda0ccda8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BE=90=E5=8B=A4=E6=B0=91?= Date: Wed, 20 May 2026 17:15:53 +0800 Subject: [PATCH] =?UTF-8?q?feat(nginx):=20=E5=AE=B9=E5=99=A8=E7=9B=B4?= =?UTF-8?q?=E6=8E=A5=E7=BB=91=E5=AE=9A=200.0.0.0:80=EF=BC=8C=E5=AE=BF?= =?UTF-8?q?=E4=B8=BB=E6=9C=BA=E6=97=A0=E9=9C=80=20nginx=20=E9=85=8D?= =?UTF-8?q?=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 将内置 nginx 从 127.0.0.1:11223 改为直接绑定宿主机 0.0.0.0:80。 上层 nginx 直接 proxy_pass 到本机 IP:80 即可，省去宿主机 nginx 配置环节。 同步更新端口检查（80）、部署完成提示、runbook/configuration/README 文档。 Co-Authored-By: Claude Sonnet 4.6 --- README.md | 10 +++++----- docker-compose.yml | 6 +++--- docs/configuration.md | 4 ++-- docs/runbook.md | 12 ++++++------ scripts/deploy.sh | 25 +++++-------------------- 5 files changed, 21 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 0180329..dd6a184 100644 --- a/README.md +++ b/README.md @@ -14,9 +14,9 @@ curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/mai ## 部署架构 ``` -用户 nginx（宿主机） +上层 nginx（任意层级） │ - └── 127.0.0.1:11223 内置 nginx 容器（统一入口） + └── 本机 IP:80 内置 nginx 容器（统一入口，无需宿主机 nginx） │ ├── tenant-service /api/ /actuator/ ├── file-service /file/ @@ -28,7 +28,7 @@ curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/mai └── push-service （厂商回调，按需） ``` -内置 nginx 容器属于 `base` 必启服务，对外只暴露 `127.0.0.1:11223`。宿主机 nginx 只需一条 `proxy_pass` 指向该端口，内部路由由容器负责。各业务容器（11224–11231）仍绑定宿主机以便直接调试，正常流量全部走 11223。 +内置 nginx 容器直接绑定宿主机 `0.0.0.0:80`，**宿主机无需任何 nginx 配置**，上层 nginx 直接 proxy_pass 到本机 IP 即可。各业务容器（11224–11231）绑定 `127.0.0.1`，仅用于本地调试。 ## 租户初始化方式 @@ -59,8 +59,8 @@ curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/mai ## 注意事项 - `application.yml` 中数据库 URL 硬编码了生产地址，`docker-compose.yml` 的 `environment:` 节负责覆盖，**不能删除** -- 宿主机 nginx `proxy_pass` 写 `http://127.0.0.1:11223`，同时须透传 `Upgrade` / `Connection` 头（WebSocket 必需），详见 [docs/runbook.md](docs/runbook.md) -- 不能写 `localhost`，部分系统 localhost 解析为 IPv6 +- 上层 nginx `proxy_pass` 写本机 IP（端口 80），须透传 `Upgrade` / `Connection` 头（WebSocket 必需），每层都要加，详见 [docs/runbook.md](docs/runbook.md) +- 宿主机本身无需配置 nginx ## 文档 diff --git a/docker-compose.yml b/docker-compose.yml index bcd422d..ece3159 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -84,14 +84,14 @@ services: # --------------------------------------------------------------------------- # 内置路由 nginx（必须） - # 统一处理所有内部路由，对外只暴露 127.0.0.1:11223。 - # 宿主机 nginx 只需一条 proxy_pass http://127.0.0.1:11223 即可。 + # 统一处理所有内部路由，直接绑定宿主机 80 端口。 + # 上层 nginx 直接 proxy_pass 到本机 IP:80，宿主机无需额外 nginx 配置。 # --------------------------------------------------------------------------- nginx: image: nginx:1.27-alpine profiles: ["base"] ports: - - "127.0.0.1:11223:80" + - "80:80" volumes: - ./config/nginx/nginx.conf:/etc/nginx/nginx.conf:ro - ./config/nginx/conf.d:/etc/nginx/conf.d:ro diff --git a/docs/configuration.md b/docs/configuration.md index 8028db8..cd6d9b1 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -80,7 +80,7 @@ environment: | 11230 | license-service | 8085 | `/api/license/` | | 11231 | push-service | 8083 | 厂商回调（按需） | -所有端口绑定 `127.0.0.1`，11224–11231 仅用于直接调试。宿主机 nginx 代理到内置 nginx 端口 11223，详见 [runbook.md](runbook.md)。 +内置 nginx 绑定宿主机 `0.0.0.0:80`，上层直接 proxy_pass 到本机 IP 即可。11224–11231 绑定 `127.0.0.1`，仅用于直接调试。 ## 容器内部通信 @@ -99,7 +99,7 @@ SDK_TENANT_SERVICE_URL: "http://tenant-service:9001" ## 内置 nginx -nginx 容器属于 `base` 必启服务，绑定 `127.0.0.1:11223`，统一处理所有内部路由（按 Docker 服务名转发，无需关心各服务端口）。宿主机 nginx 只需一条 `proxy_pass http://127.0.0.1:11223` 加 WebSocket 透传头，配置见 [runbook.md](runbook.md#nginx-配置)。 +nginx 容器属于 `base` 必启服务，直接绑定宿主机 `0.0.0.0:80`，统一处理所有内部路由（按 Docker 服务名转发，无需关心各服务端口）。**宿主机无需额外 nginx 配置**，上层 nginx 直接 proxy_pass 指向本机 IP:80 即可，详见 [runbook.md](runbook.md#nginx-配置)。 ## `config/vendors/` diff --git a/docs/runbook.md b/docs/runbook.md index 501db3d..0df9522 100644 --- a/docs/runbook.md +++ b/docs/runbook.md @@ -20,13 +20,13 @@ curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/mai ## Nginx 配置 -部署内置了一个 nginx 容器处理所有内部路由，对外只暴露 `127.0.0.1:11223`。 +部署内置了一个 nginx 容器处理所有内部路由，直接绑定宿主机 `0.0.0.0:80`。**宿主机无需任何 nginx 配置。** -宿主机 nginx 的 server 块内只需加一条： +上层 nginx 直接 `proxy_pass` 指向本机 IP（端口 80）即可，例如： ```nginx location / { - proxy_pass http://127.0.0.1:11223; + proxy_pass http://192.168.x.x; # 填写部署服务器 IP proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; @@ -37,7 +37,7 @@ location / { } ``` -> `proxy_http_version 1.1` 和 `Upgrade`/`Connection` 头是 WebSocket（IM）必需的，不能省略。 +> 如果有多层 nginx 代理，**每一层**都必须加上 `proxy_http_version 1.1` 和 `Upgrade`/`Connection` 头，否则 IM WebSocket 握手会在中间某层断开。 内置 nginx 路由配置在 `config/nginx/conf.d/xuqm.conf`，使用 Docker 服务名路由到各容器，无需关心具体端口。 @@ -47,10 +47,10 @@ location / { | 宿主机端口 | 说明 | |-----------|------| -| **11223** | 内置 nginx 入口（宿主机 nginx 指向此端口） | +| **80** | 内置 nginx 入口（上层 nginx 直接指向此端口） | | 11224–11231 | 各业务容器（绑定 127.0.0.1，调试用） | -各业务容器端口仅用于直接调试，正常流量全部走 11223。 +各业务容器端口仅用于直接调试，正常流量全部走 80。 --- diff --git a/scripts/deploy.sh b/scripts/deploy.sh index 7dd2572..74607da 100755 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -220,7 +220,7 @@ DISK_FREE_GB="$(df -BG "$ROOT_DIR" | awk 'NR==2{gsub(/G/,"",$4); print $4}')" fail "磁盘可用空间不足（需 ≥10 GB，当前 ${DISK_FREE_GB:-?} GB）" ok "磁盘可用: ${DISK_FREE_GB} GB" -for port in 11223; do +for port in 80; do if ss -tlnp 2>/dev/null | grep -q ":${port} " || \ netstat -tlnp 2>/dev/null | grep -q ":${port} "; then warn "端口 ${port} 已被占用（如已是本脚本的 nginx 容器则无影响，否则会端口冲突）" @@ -778,24 +778,9 @@ if [ "$DEPLOY_MODE" = "new" ]; then else printf ' 密码: 同生产平台密码（原样迁移，未重置）\n' fi -printf '\n \033[1m宿主机 nginx 配置（server 块内加入以下内容）：\033[0m\n' -printf '\033[0;37m' -cat <<'NGINX_REF' - location / { - proxy_pass http://127.0.0.1:11223; - proxy_http_version 1.1; - proxy_set_header Upgrade $http_upgrade; - proxy_set_header Connection "upgrade"; - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_read_timeout 3600s; - } -NGINX_REF -printf '\033[0m' -printf ' 内置 nginx 已处理全部路由，无需再配置各服务端口。\n' -printf '\n \033[1;33m注意（多层 nginx 代理）：\033[0m\n' -printf ' 如上层 nginx 还有多层代理指向 192.168.128.88，\033[1m每一层\033[0m都必须透传 WebSocket 升级头：\n' +printf '\n \033[1;33m注意（上层 nginx 代理 WebSocket）：\033[0m\n' +printf ' 上层 nginx 指向本机 IP:80 即可，\033[1m无需在宿主机配置 nginx\033[0m。\n' +printf ' 但上层每一层 nginx 的 location 块都必须有以下四行透传 WebSocket 升级头：\n' printf '\033[0;37m' cat <<'WS_NOTE' proxy_http_version 1.1; @@ -807,4 +792,4 @@ printf '\033[0m' printf ' 缺少这四行，IM WebSocket 握手将在任意一层失败。\n' printf '\n \033[1m部署目录：\033[0m %s\n' "$ROOT_DIR" printf ' \033[1m审计日志：\033[0m %s/logs/audit.log\n' "$ROOT_DIR" -printf '\n\033[1;32m 部署成功！在所有 nginx 层配置好后即可访问：%s\033[0m\n\n' "${CONSOLE_BASE}" +printf '\n\033[1;32m 部署成功！上层 nginx proxy_pass 指向本机 IP:80 后即可访问：%s\033[0m\n\n' "${CONSOLE_BASE}"