Add single domain gateway routing

ai_knowledge_base_v2/.env.example

@@ -13,8 +13,9 @@ FEISHU_SEARCH_URL=
 FRP_SERVER_ADDR=your-server-ip
 FRP_SERVER_PORT=7000
 FRP_AUTH_TOKEN=your-auth-token
-FRP_PROXY_NAME=qa-backend
+FRP_PROXY_NAME=qa-web
-# 映射到后端端口 8100
+# 默认穿透统一入口 gateway:80，由 gateway 按路径转发到用户端、后台和 API
-FRP_LOCAL_PORT=8100
+FRP_LOCAL_IP=gateway
-# 自定义域名，逗号分隔，如：qa.yourdomain.com,your-server-ip
+FRP_LOCAL_PORT=80
-FRP_CUSTOM_DOMAINS=qa.yourdomain.com,your-server-ip
+# 自定义域名，逗号分隔，如：qa.huiyushuyuan.cn
+FRP_CUSTOM_DOMAINS=qa.huiyushuyuan.cn

ai_knowledge_base_v2/README.md

@@ -39,9 +39,13 @@ docker compose -f docker-compose.dev.yml up --build
 
 默认访问地址：
 
-- 用户端 H5：`http://127.0.0.1:5173/`
+- 统一入口：`http://127.0.0.1:8080/`
-- 管理后台：`http://127.0.0.1:5174/`
+- 用户端 H5：`http://127.0.0.1:8080/`
-- 后端 API：`http://127.0.0.1:8100/api/health`
+- 管理后台：`http://127.0.0.1:8080/login`
+- 后端 API：`http://127.0.0.1:8080/api/health`
+- 用户端直连调试：`http://127.0.0.1:5173/`
+- 管理后台直连调试：`http://127.0.0.1:5174/login/`
+- 后端直连调试：`http://127.0.0.1:8100/api/health`
 - MySQL：`127.0.0.1:3307`
 
 开发阶段 mock 短信验证码为 `123456`。

ai_knowledge_base_v2/apps/admin-web/.env.example

@@ -1 +1 @@
-VITE_API_BASE_URL=http://127.0.0.1:8100/api
+VITE_API_BASE_URL=/api

ai_knowledge_base_v2/apps/admin-web/README.md

@@ -12,13 +12,13 @@ npm run dev -- --port 5174
 默认访问地址：
 
 ```text
-http://127.0.0.1:5174/
+http://127.0.0.1:8080/login
 ```
 
 默认后端地址：
 
 ```text
-http://127.0.0.1:8100/api
+/api
 ```
 
 ## 默认管理员

ai_knowledge_base_v2/apps/admin-web/src/services/api.ts

@@ -14,7 +14,7 @@ import type {
   UserImportResult,
 } from "../types/api";
 
-const API_BASE = import.meta.env.VITE_API_BASE_URL ?? "http://127.0.0.1:8100/api";
+const API_BASE = import.meta.env.VITE_API_BASE_URL ?? "/api";
 const TOKEN_KEY = "ai-kb-admin-token";
 
 export function getToken() {

ai_knowledge_base_v2/apps/admin-web/vite.config.ts

@@ -2,6 +2,7 @@ import vue from "@vitejs/plugin-vue";
 import { defineConfig } from "vite";
 
 export default defineConfig({
+  base: "/login/",
   plugins: [vue()],
   build: {
     rollupOptions: {

ai_knowledge_base_v2/apps/user-client/.env.example

@@ -1 +1 @@
-VITE_API_BASE_URL=http://127.0.0.1:8100/api
+VITE_API_BASE_URL=/api

ai_knowledge_base_v2/apps/user-client/README.md

@@ -33,7 +33,11 @@ npm run dev
 
 默认 API 地址为：
 
-`http://127.0.0.1:8100/api`
+`/api`
+
+统一入口访问地址为：
+
+`http://127.0.0.1:8080/`
 
 ## 说明
 

ai_knowledge_base_v2/apps/user-client/src/services/api.ts

@@ -1,6 +1,6 @@
 import type { ApiResponse, CaptchaResult, ChatMessage, ChatSession, LoginResult, UserProfile } from "../types/api";
 
-const API_BASE = import.meta.env.VITE_API_BASE_URL ?? "http://127.0.0.1:8100/api";
+const API_BASE = import.meta.env.VITE_API_BASE_URL ?? "/api";
 const TOKEN_KEY = "ai-kb-user-token";
 
 export function getToken() {

ai_knowledge_base_v2/deploy/frpc-entrypoint.sh

@@ -23,14 +23,14 @@ serverPort = ${FRP_SERVER_PORT:-7000}
 auth.token = "${FRP_AUTH_TOKEN}"
 
 [[proxies]]
-name = "${FRP_PROXY_NAME:-qa-backend}"
+name = "${FRP_PROXY_NAME:-qa-web}"
 type = "http"
-localIP = "${FRP_LOCAL_IP:-backend}"
+localIP = "${FRP_LOCAL_IP:-gateway}"
-localPort = ${FRP_LOCAL_PORT:-8100}
+localPort = ${FRP_LOCAL_PORT:-80}
 customDomains = [${_domains}]
 EOF
 
 echo "=== frpc config generated ==="
 cat /etc/frp/frpc.toml
 
-exec frpc -c /etc/frp/frpc.toml
+exec frpc -c /etc/frp/frpc.toml

ai_knowledge_base_v2/deploy/gateway.conf

@@ -0,0 +1,54 @@
+map $http_upgrade $connection_upgrade {
+    default upgrade;
+    '' close;
+}
+
+server {
+    listen 80;
+    server_name _;
+
+    client_max_body_size 20m;
+
+    location = /login {
+        return 302 $scheme://$http_host/login/;
+    }
+
+    location ^~ /api/ {
+        proxy_pass http://backend:8100;
+        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_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection $connection_upgrade;
+        proxy_buffering off;
+        proxy_read_timeout 3600s;
+    }
+
+    location ^~ /login/ {
+        proxy_pass http://admin-web:5174;
+        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_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection $connection_upgrade;
+        proxy_buffering off;
+        proxy_read_timeout 3600s;
+    }
+
+    location / {
+        proxy_pass http://user-client:5173;
+        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_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection $connection_upgrade;
+        proxy_buffering off;
+        proxy_read_timeout 3600s;
+    }
+}

ai_knowledge_base_v2/deployment/DEPLOYMENT_GUIDE.md

@@ -42,11 +42,34 @@ docker compose -f docker-compose.dev.yml up -d --build backend user-client admin
 
 默认地址：
 
-- 用户端 H5：`http://127.0.0.1:5173/`
+- 统一入口：`http://127.0.0.1:8080/`
-- 管理后台：`http://127.0.0.1:5174/`
+- 用户端 H5：`http://127.0.0.1:8080/`
-- 后端健康检查：`http://127.0.0.1:8100/api/health`
+- 管理后台：`http://127.0.0.1:8080/login`
+- 后端健康检查：`http://127.0.0.1:8080/api/health`
+- 用户端直连调试：`http://127.0.0.1:5173/`
+- 管理后台直连调试：`http://127.0.0.1:5174/login/`
+- 后端直连调试：`http://127.0.0.1:8100/api/health`
 - MySQL：`127.0.0.1:3307`
 
+## 单域名访问
+
+当前编排新增 `gateway` 服务作为统一入口。内网穿透时建议只穿透 `gateway:80`，域名路径分流如下：
+
+```text
+https://qa.huiyushuyuan.cn/        用户端 H5
+https://qa.huiyushuyuan.cn/login   管理后台登录页
+https://qa.huiyushuyuan.cn/api/... 后端 API
+```
+
+`.env` 中推荐配置：
+
+```bash
+FRP_PROXY_NAME=qa-web
+FRP_LOCAL_IP=gateway
+FRP_LOCAL_PORT=80
+FRP_CUSTOM_DOMAINS=qa.huiyushuyuan.cn
+```
+
 ## 开发阶段默认账号
 
 用户端：

ai_knowledge_base_v2/deployment/RELEASE_CHECKLIST.md

@@ -9,7 +9,9 @@
 - [ ] 已替换 `JWT_SECRET_KEY`。
 - [ ] 已确认飞书检索配置。
 - [ ] 已确认模型配置和额度策略。
-- [ ] 已确认前端 API 地址。
+- [ ] 已确认统一入口 `gateway` 可访问。
+- [ ] 已确认前端 API 地址使用同域 `/api`。
+- [ ] 已确认内网穿透指向 `gateway:80`。
 
 ## 发布中
 
@@ -18,11 +20,14 @@
 - [ ] 启动后端服务。
 - [ ] 启动用户端 H5。
 - [ ] 启动管理后台。
-- [ ] 检查后端健康接口。
+- [ ] 启动统一入口 gateway。
+- [ ] 检查 `域名/api/health` 后端健康接口。
 
 ## 发布后
 
 - [ ] 用户端可以登录。
+- [ ] 默认打开域名进入用户端。
+- [ ] `域名/login` 进入管理后台登录页。
 - [ ] 用户端可以创建会话。
 - [ ] 用户端可以提问并收到回答。
 - [ ] 无命中问题返回固定兜底。

ai_knowledge_base_v2/docker-compose.dev.yml

@@ -72,7 +72,7 @@ services:
       context: ./apps/user-client
     container_name: ai_kb_v2_user_client
     environment:
-      VITE_API_BASE_URL: http://127.0.0.1:8100/api
+      VITE_API_BASE_URL: /api
     ports:
       - "5173:5173"
     depends_on:
@@ -83,12 +83,24 @@ services:
       context: ./apps/admin-web
     container_name: ai_kb_v2_admin_web
     environment:
-      VITE_API_BASE_URL: http://127.0.0.1:8100/api
+      VITE_API_BASE_URL: /api
     ports:
       - "5174:5174"
     depends_on:
       - backend
 
+  gateway:
+    image: nginx:1.27-alpine
+    container_name: ai_kb_v2_gateway
+    ports:
+      - "8080:80"
+    volumes:
+      - ./deploy/gateway.conf:/etc/nginx/conf.d/default.conf:ro
+    depends_on:
+      - backend
+      - user-client
+      - admin-web
+
   frpc:
     build:
       context: .
@@ -99,11 +111,11 @@ services:
       FRP_SERVER_PORT: ${FRP_SERVER_PORT:-7000}
       FRP_AUTH_TOKEN: ${FRP_AUTH_TOKEN}
       FRP_PROXY_NAME: ${FRP_PROXY_NAME:-qa-backend}
-      FRP_LOCAL_IP: ${FRP_LOCAL_IP:-backend}
+      FRP_LOCAL_IP: ${FRP_LOCAL_IP:-gateway}
-      FRP_LOCAL_PORT: ${FRP_LOCAL_PORT:-8100}
+      FRP_LOCAL_PORT: ${FRP_LOCAL_PORT:-80}
       FRP_CUSTOM_DOMAINS: ${FRP_CUSTOM_DOMAINS}
     depends_on:
-      - backend
+      - gateway
     restart: unless-stopped
 
 volumes: