merge: 开源官网骨架接入（website/ + 部署编排 + 网关路由）

来源分支 feat/website-skeleton-20261104 含两个 404 修复：favicon 路径、文档中心链接前缀
fix(website): favicon 路径与文档站链接两处 404
2026-11-04 12:48:10 +08:00 · 2026-11-04 12:33:08 +08:00
2 changed files with 8 additions and 5 deletions
@@ -17,12 +17,15 @@ const SITE_BASE = process.env.SITE_BASE ?? '/www/'
 const REPO_URL = process.env.REPO_URL ?? 'https://git.5iot.com/iotlcm-public/iotlcm'

 /**
- * 文档站地址。文档站与官网是两个容器：
- *   - 过渡形态：文档站挂在网关的 /docs/ 下
- *   - 独立域名形态：文档站通常独占 docs.<域名> 或同域 /docs/
- * 独立部署时用 DOCS_URL 覆盖。
+ * 文档站地址。文档站与官网是两个容器，由网关按路径分流：
+ *   - 官网在 /www/ 下，文档站在 /docs/ 下，两者同级
+ *
+ * 注意：VitePress 会给所有站内链接自动加上 base 前缀，'/docs/' 会被拼成
+ * '/www/docs/'——而网关并没有这个路径，点击「文档中心」会 404。
+ * 因此默认值必须是完整 URL（VitePress 判定为外链，不做前缀拼接）。
+ * 独立部署时用 DOCS_URL 覆盖成实际地址。
 */
-const DOCS_URL = process.env.DOCS_URL ?? '/docs/'
+const DOCS_URL = process.env.DOCS_URL ?? 'http://open.5iot.com:5051/docs/'

 export default defineConfig({
  srcDir: './pages',