diff --git a/website/.vitepress/config.mts b/website/.vitepress/config.mts
index 2f7c12a..1386302 100644
--- a/website/.vitepress/config.mts
+++ b/website/.vitepress/config.mts
@@ -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',
diff --git a/website/public/favicon.svg b/website/pages/public/favicon.svg
similarity index 100%
rename from website/public/favicon.svg
rename to website/pages/public/favicon.svg