技小云
d78379486c
- website/：VitePress 官网工程（首页/功能/对比/快速开始/部署运维/教程/社区），与文档站同构 - 两种形态由 SITE_BASE 决定：/www/ 子路径（过渡）与 / 根路径（独立域名），内容同源 - deploy/：新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段 - Makefile：新增 website 镜像条目与 make website 目标 - 教程页给出部署/使用两支视频的元数据与录制要求，官网留有教程入口
89 lines
3.4 KiB
Nginx Configuration File
89 lines
3.4 KiB
Nginx Configuration File
# 单端口入口（默认对外 5051）
|
||
#
|
||
# 用途：把管理端、文档站、OpenAPI 收在一个端口下，便于在外部网关 / DNS
|
||
# 只暴露一个地址。编排里由 gateway 服务（profile: with-gateway）加载本文件，
|
||
# 容器内监听 80，宿主机发布端口用 GATEWAY_PORT 控制（默认 5051）。
|
||
#
|
||
# docker compose --profile with-gateway up -d
|
||
# GATEWAY_PORT=8088 docker compose --profile with-gateway up -d
|
||
#
|
||
# 路由：
|
||
# / -> 管理端（admin-ui，内部已代理 /api/ 到 admin-svr）
|
||
# /docs/ -> 文档站（docs）
|
||
# /www/ -> 官网（website，需启用 with-website profile）
|
||
# /openapi/ -> 对外 API（openapi）
|
||
# /route/open/ -> 运营商能力代理（openapi）
|
||
#
|
||
# 小程序 / H5 端的静态资源是根路径部署的，不能挂在同一域名的子路径下，
|
||
# 需要单独域名或单独端口（见 config/nginx/iotlcm.conf 的 app 段）。
|
||
|
||
# DNS 解析：nginx 默认只在启动时把 upstream 主机名解析一次，容器重建/重启换了 IP
|
||
# 就一直往旧地址打（2026-11-03 踩到：整站 /openapi 全 502，重启网关才恢复）。
|
||
# 127.0.0.11 是 Docker 内置 DNS；下面的 resolve + zone 让它在运行期自动跟随。
|
||
resolver 127.0.0.11 valid=10s ipv6=off;
|
||
|
||
upstream gw_admin_ui { zone gw_admin_ui 64k; server admin-ui:80 resolve; }
|
||
upstream gw_openapi { zone gw_openapi 64k; server openapi:8000 resolve; }
|
||
upstream gw_docs { zone gw_docs 64k; server docs:80 resolve; }
|
||
# 官网（可选组件，profile with-website）。容器未启动时该路径返回 502，
|
||
# 不影响其它路径；resolve 让容器 IP 变化后自动跟随。
|
||
upstream gw_website { zone gw_website 64k; server website:80 resolve; }
|
||
|
||
server {
|
||
listen 80;
|
||
|
||
charset utf-8;
|
||
client_max_body_size 200m;
|
||
|
||
access_log /var/log/nginx/access_gateway.log;
|
||
error_log /var/log/nginx/error_gateway.log;
|
||
|
||
proxy_http_version 1.1;
|
||
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_set_header X-Forwarded-Proto $scheme;
|
||
proxy_read_timeout 120s;
|
||
proxy_send_timeout 120s;
|
||
|
||
# ---------- 文档站 ----------
|
||
location = /docs {
|
||
return 301 /docs/;
|
||
}
|
||
|
||
location ^~ /docs/ {
|
||
proxy_pass http://gw_docs;
|
||
}
|
||
|
||
# ---------- 官网（子路径形态） ----------
|
||
# 官网以 SITE_BASE=/www/ 构建时，资源引用是 /www/assets/...，
|
||
# 所以这里不能剥前缀（proxy_pass 不带尾斜杠），由官网容器内的
|
||
# alias 规则自己剥。域名定下来后改用独立 vhost，这段可删。
|
||
location = /www {
|
||
return 301 /www/;
|
||
}
|
||
|
||
location ^~ /www/ {
|
||
proxy_pass http://gw_website;
|
||
}
|
||
|
||
# ---------- 对外 API：版本化接口 ----------
|
||
location ^~ /openapi/ {
|
||
proxy_pass http://gw_openapi;
|
||
}
|
||
|
||
# ---------- 对外 API：运营商能力代理（白名单 / 共享 Token）----------
|
||
location ^~ /route/open/ {
|
||
proxy_pass http://gw_openapi;
|
||
}
|
||
|
||
# ---------- 管理端（含 /api/ 与 /upload/，由 admin-ui 自行转发）----------
|
||
location / {
|
||
proxy_pass http://gw_admin_ui;
|
||
}
|
||
|
||
gzip on;
|
||
gzip_min_length 1k;
|
||
gzip_types text/plain text/css application/json application/javascript application/xml image/svg+xml;
|
||
}
|