diff --git a/README.md b/README.md
index 78cfa66..05236ff 100644
--- a/README.md
+++ b/README.md
@@ -137,18 +137,18 @@ cargo test --manifest-path src-tauri/Cargo.toml --lib
 
 侧栏按「接口 → 文档 → Mock → 测试」排列。文档详情可直接打开请求页试用，或从 2xx 响应 example/schema 生成 Mock 草稿；已有相同方法和具体路径的 Mock 会显示关联状态并直接打开编辑，不覆盖手动修改的模拟响应。生成时把路径参数示例实例化为具体路径（例如 `/pets/{id}` 和 `id=42` 对应 `/pets/42`）；发布后文档详情和内网只读文档快照均可展示对应 Mock 地址（快照需重新发布才会更新）。当前 Mock 服务只支持完整路径匹配，暂无动态路径匹配、请求体条件或多响应规则。
 
-「发布当前项目」会将所选项目的名称、接口说明、参数和示例生成单独的本机 SQLite 只读快照；鉴权、环境变量及运行历史不会加入快照。分享地址是 `<IP或域名>:8788/docs/<随机令牌>`，和 Mock 响应共用独立监听与来源限制。修改文档后需点「更新分享快照」；「撤销分享」立即令旧链接失效。公开访问需明确配置 `OPSXAPI_MOCK_ALLOW_PUBLIC=1`，自行处理 DNS/端口映射/HTTPS。分享页面不提供请求执行或编辑入口。
+「发布当前项目」会将所选项目的名称、接口说明、参数和示例生成单独的本机 SQLite 只读快照；鉴权、环境变量及运行历史不会加入快照。分享地址是 `<IP或域名>:8798/docs/<随机令牌>`，和 Mock 响应共用独立监听与来源限制。修改文档后需点「更新分享快照」；「撤销分享」立即令旧链接失效。公开访问需明确配置 `OPSXAPI_MOCK_ALLOW_PUBLIC=1`，自行处理 DNS/端口映射/HTTPS。分享页面不提供请求执行或编辑入口。
 
 - 顶栏仅保留环境管理和环境切换；请求代理在「设置 → 网络」配置。支持自动检测、自定义 HTTP/HTTPS 代理、不使用代理、绕过主机和代理认证。配置仅存本机，不进入工作区同步/导出；适用于桌面 HTTP、GraphQL 及自动化测试，实时协议不受此设置控制。
 - 侧栏「Mock」是独立接口管理页面：新建接口 → 选择方法与路径 → 编辑 JSON/文本响应、状态码、延迟 → 保存草稿 → 发布全部已保存接口。也可在 HTTP 编辑器通过「创建 Mock」或「用响应创建 Mock」复制为独立接口，不修改原请求。
 - 草稿与未保存编辑缓存在本机浏览器存储；发布结果保存在本机 SQLite，不因登录而切换到团队或公网存储。发布会替换此本机服务的全部接口，禁用/删除接口需发布后生效；未保存编辑不参与发布。接口页提供已发布地址、复制和试运行。
 - Mock 页面顶部可直接启用或关闭 HTTP 响应，并可一键创建 `GET /demo` 示例；保存草稿后点击「发布全部已保存接口」，在已发布版本中试运行。设置 → Mock 服务保留相同开关及分享地址、环境关联配置。关闭后返回 503，保留数据和监听端口；彻底停止进程使用 `./run.sh stop`。随机数据生成规则位于「设置 → 数据生成」。
 - 第一版使用单服务、方法 + 完整路径匹配（忽略尾斜杠），暂不支持路径参数、多响应条件及请求体匹配。JSON 可使用已有 `@integer` 等模板表达式；文本响应原样返回。
-- `./run.sh gui` 默认启动本机管理服务 `127.0.0.1:8787` 和独立 Mock 响应监听 `0.0.0.0:8788`。后者默认仅接受回环/私有网段来源，不注册账号、发布或代理管理路由；内网同事按实际 HTTP 方法访问 `http://本机内网IP:8788/mock/<token>/接口路径`。
+- `./run.sh gui` 默认启动本机管理服务 `127.0.0.1:8787` 和独立 Mock 响应监听 `0.0.0.0:8798`。后者默认仅接受回环/私有网段来源，不注册账号、发布或代理管理路由；内网同事按实际 HTTP 方法访问 `http://本机内网IP:8798/mock/<token>/接口路径`。
 - Mock 页的路径输入框只填写 `/example` 等相对路径；保存并发布后，编辑器顶部会显示可复制的完整地址。`http://localhost:5173/mock/example` 指向桌面开发界面，不是 Mock 响应。默认无需额外 Header，完整地址包含随机地址令牌。若要进一步限制已获知地址的访问，可在「设置 → Mock 服务 → 访问验证」生成并保存 Bearer 密钥；访问者须发送 `Authorization: Bearer <密钥>`，服务只保存密钥摘要。浏览器地址栏无法设置此 Header，请使用接口请求页或 curl；试运行框可临时填写密钥。
 - 分享域名需由内网 DNS/hosts 解析到运行本机服务的机器；HTTPS 由内网反向代理提供，可将域名解析到内网 IP，也可自行端口映射或反向代理至公网 IP；数据仍保存在自有机器。输入分享地址不会自动修改 DNS、监听或部署。
-- 若只允许本机访问，启动前设置 `OPSXAPI_MOCK_ADDR=127.0.0.1:8788`；更改监听配置需停止后重新启动。设置页会显示配置的监听地址及本机地址候选；访问仍需端口可达。
-- 更新后运行 `./run.sh gui` 会检查 Mock 管理接口，并在本项目旧后端缺少该接口时重启服务；也可手动运行 `./run.sh stop && ./run.sh gui`。`http://localhost:5173/mock` 不是内网 Mock 服务入口，`:5173` 只是桌面界面的开发源。已发布示例的分享地址为 `http://本机内网IP:8788/mock/<随机令牌>/demo`；令牌可在 Mock 页面「已发布版本」中复制。`homepage/` 不参与 Mock 数据保存。
+- 若只允许本机访问，启动前设置 `OPSXAPI_MOCK_ADDR=127.0.0.1:8798`；更改监听配置需停止后重新启动。设置页会显示配置的监听地址及本机地址候选；访问仍需端口可达。
+- 更新后运行 `./run.sh gui` 会检查 Mock 管理接口，并在本项目旧后端缺少该接口时重启服务；也可手动运行 `./run.sh stop && ./run.sh gui`。`http://localhost:5173/mock` 不是内网 Mock 服务入口，`:5173` 只是桌面界面的开发源。已发布示例的分享地址为 `http://本机内网IP:8798/mock/<随机令牌>/demo`；令牌可在 Mock 页面「已发布版本」中复制。`homepage/` 不参与 Mock 数据保存。
 
 ### 环境地址联动与自定义域名
 
diff --git a/run.sh b/run.sh
index cd70453..091b8e5 100755
--- a/run.sh
+++ b/run.sh
@@ -159,7 +159,7 @@ start_server() {
     bind_env="OPSXAPI_ADDR=127.0.0.1:$SERVER_PORT"
   fi
   start_detached "$SERVER_LABEL" "$SERVER_LOG" \
-    "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\"; cd \"$SCRIPT_DIR/$SERVER_DIR\" && exec env $bind_env OPSXAPI_MOCK_ADDR=\"${OPSXAPI_MOCK_ADDR:-0.0.0.0:8788}\" OPSXAPI_MOCK_ALLOW_PUBLIC=\"${OPSXAPI_MOCK_ALLOW_PUBLIC:-0}\" GIN_MODE=debug \"./bin/$SERVER_BIN\""
+    "export PATH=\"/opt/homebrew/bin:/usr/local/bin:\$PATH\"; cd \"$SCRIPT_DIR/$SERVER_DIR\" && exec env $bind_env OPSXAPI_MOCK_ADDR=\"${OPSXAPI_MOCK_ADDR:-0.0.0.0:8798}\" OPSXAPI_MOCK_ALLOW_PUBLIC=\"${OPSXAPI_MOCK_ALLOW_PUBLIC:-0}\" GIN_MODE=debug \"./bin/$SERVER_BIN\""
   wait_http "http://127.0.0.1:$SERVER_PORT/health" "后端"
   if ! mock_api_ready; then
     error "后端已启动，但 Mock 管理接口仍不可用，请检查 $SERVER_LOG"
diff --git a/server/cmd/opsxapi/main.go b/server/cmd/opsxapi/main.go
index 4fe031c..dd06158 100644
--- a/server/cmd/opsxapi/main.go
+++ b/server/cmd/opsxapi/main.go
@@ -12,7 +12,8 @@ func main() {
 	addr := resolveListenAddr()
 	mockAddr := strings.TrimSpace(os.Getenv("OPSXAPI_MOCK_ADDR"))
 	if mockAddr == "" {
-		mockAddr = "0.0.0.0:8788"
+		// 8788 让给 OpsxDB 主服务（本机端口约定：8787=OpsxAPI / 8788=OpsxDB / 8789=OpsXShell）
+		mockAddr = "0.0.0.0:8798"
 	}
 	mockRouter := server.NewMockRouter()
 	go func() {
diff --git a/server/internal/api/api.go b/server/internal/api/api.go
index c68c5ad..8c2e279 100644
--- a/server/internal/api/api.go
+++ b/server/internal/api/api.go
@@ -512,7 +512,7 @@ func (a *API) handleLocalMockStatus(c *gin.Context) {
 	}
 	addr := os.Getenv("OPSXAPI_MOCK_ADDR")
 	if addr == "" {
-		addr = "0.0.0.0:8788"
+		addr = "0.0.0.0:8798" // 8788 让给 OpsxDB；见 cmd/opsxapi/main.go
 	}
 	bindHost, port, err := net.SplitHostPort(addr)
 	if err != nil {
diff --git a/server/internal/server/router.go b/server/internal/server/router.go
index 0a4cbf6..85d8283 100644
--- a/server/internal/server/router.go
+++ b/server/internal/server/router.go
@@ -71,6 +71,9 @@ func mountHomepage(r *gin.Engine) bool {
 					return
 				}
 				upath := strings.TrimPrefix(p, "/")
+				if upath == "home" || upath == "index.html" {
+					c.Request.URL.Path = "/" // 落地页别名：导航里的 /home 链接
+				}
 				if upath != "" {
 					if st2, err2 := os.Stat(filepath.Join(dir, upath)); err2 == nil && st2.IsDir() {
 						c.Request.URL.Path = p + "/"