docs: 三库文档规范化(去混淆字符 + 占位符)+ Web README 初次部署清单
- 三库所有 .md/.txt 与配置样例中的 — – … § → 一律换成 ASCII(Gitea 的 「模棱两可的 Unicode 字符」告警即由这几个字符触发;中文全角标点不受影响, 实测 README.txt 修正后告警消失) - contracts/* 在三库保持逐字节一致(已校验 md5) - 残留真实值清理:README.txt 建库 SQL 的 dpendance -> opendance/opendance_app, Android HostDiscovery.kt 注释示例 192.168.1.23 -> 192.0.2.23 - Web README.txt 新增「初次部署(从零跑起来)」8 步清单与「常见问题(初次部署)」 7 条;去掉纯文本 README 里的 markdown 粗体标记;统一 '以 root 直接执行' 写法 - 重新打包 v0.2.0 验证:168 项单测通过;契约 6 项与 30 条路由一致。
This commit is contained in:
@@ -1,13 +1,13 @@
|
||||
# ============================================================
|
||||
# OpenDance Studio Web 服务端 —— nginx 反向代理样例(双端口)
|
||||
# OpenDance Studio Web 服务端 -- nginx 反向代理样例(双端口)
|
||||
#
|
||||
# 说明:本 Web 端不自带反向代理。本文件是**给你的反代服务参考**的配置样例,
|
||||
# 由部署 `deploy/install.sh` 之外的反代负责人使用。
|
||||
#
|
||||
# 后端同时监听两个端口,职责不同:
|
||||
# 软件 API 端口(PORT,默认 3000)—— Windows/Godot 客户端、Android App
|
||||
# 软件 API 端口(PORT,默认 3000)-- Windows/Godot 客户端、Android App
|
||||
# 只提供 /api、/health、/static、/contracts
|
||||
# 管理端端口(ADMIN_PORT,默认 3001)—— 浏览器,提供管理页面 + 上面全部接口
|
||||
# 管理端端口(ADMIN_PORT,默认 3001)-- 浏览器,提供管理页面 + 上面全部接口
|
||||
#
|
||||
# 两个端口都不需要在代理层托管静态文件、也不需要 SPA 回退(服务端已处理),
|
||||
# 因此每个站点只要一条 `location /` 全匹配转发即可。
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!--
|
||||
============================================================
|
||||
OpenDance Studio Web 服务端 —— IIS 反向代理样例
|
||||
OpenDance Studio Web 服务端 -- IIS 反向代理样例
|
||||
|
||||
说明:本 Web 端不自带反向代理。本文件是**给你的反代服务参考**的配置样例。
|
||||
|
||||
@@ -11,21 +11,21 @@
|
||||
2. Application Request Routing (ARR)
|
||||
https://www.iis.net/downloads/microsoft/application-request-routing
|
||||
3. 启用 ARR 代理(否则会 404.4):
|
||||
IIS 管理器 → 服务器节点 → Application Request Routing Cache
|
||||
→ Server Proxy Settings → 勾选 Enable proxy
|
||||
IIS 管理器 -> 服务器节点 -> Application Request Routing Cache
|
||||
-> Server Proxy Settings -> 勾选 Enable proxy
|
||||
|
||||
放置位置:IIS 站点根目录下的 web.config
|
||||
|
||||
后端(NestJS)同时监听两个端口,职责不同:
|
||||
|
||||
软件 API 端口(PORT,默认 3000)—— 给 Windows/Godot 客户端与 Android App
|
||||
软件 API 端口(PORT,默认 3000)-- 给 Windows/Godot 客户端与 Android App
|
||||
只有 /api、/health、/static、/contracts
|
||||
管理端端口(ADMIN_PORT,默认 3001)—— 给浏览器
|
||||
管理端端口(ADMIN_PORT,默认 3001)-- 给浏览器
|
||||
管理页面 + 上面全部接口
|
||||
|
||||
**在 IIS 里建两个站点**,把下面这份 web.config 各放一份,只改 <action> 里的端口:
|
||||
站点 A(如 dance-api.example.com) → http://127.0.0.1:3000/{R:1}
|
||||
站点 B(如 dance-admin.example.com)→ http://127.0.0.1:3001/{R:1}
|
||||
站点 A(如 dance-api.example.com) -> http://127.0.0.1:3000/{R:1}
|
||||
站点 B(如 dance-admin.example.com)-> http://127.0.0.1:3001/{R:1}
|
||||
|
||||
后端自带管理端页面与 SPA 回退,所以每个站点只需一条全匹配重写规则,
|
||||
不需要在 IIS 上再配置默认文档或 URL Rewrite 的 SPA 回退。
|
||||
|
||||
Reference in New Issue
Block a user