chore: allowlist trusted plugins

2026-08-13 17:00:21 +08:00
parent 8027f1186d
commit 319e8a7ec9
66 changed files with 6229 additions and 124 deletions
@@ -0,0 +1,131 @@
+# 05-routing-fix.md - 子路径路由修复
+
+## 问题描述
+
+通过 Tailscale 路径 `/blog` 访问博客时，除首页外其他链接会跳转到 OpenClaw Web 控制页根路径。
+
+**根本原因：** Hugo 配置中 `baseURL` 设置为 `http://localhost:1313/`，未包含 `/blog` 子路径前缀，导致生成的 HTML 链接指向 `/` 而非 `/blog/`。
+
+## 修复方案
+
+### 1. 修改 config.toml
+
+**文件：** `site/config.toml`
+
+```diff
+- baseURL = "http://localhost:1313/"
+ baseURL = "/blog/"
+```
+
+设置相对路径 `/blog/`，使 Hugo 生成的所有链接都带 `/blog` 前缀。
+
+### 2. 修改 baseof.html 模板
+
+**文件：** `site/layouts/_default/baseof.html`
+
+将硬编码的绝对路径替换为 Hugo 模板函数：
+
+| 原始代码 | 修复后 |
+|---------|--------|
+| `href="/css/main.css"` | `href="{{ "css/main.css" \| absURL }}"` |
+| `href="/"` | `href="{{ "" \| absURL }}"` |
+| `href="/journey"` | `href="{{ "journey" \| absURL }}"` |
+
+**说明：**
+- `absURL` 函数会基于 `baseURL` 生成完整路径（如 `/blog/css/main.css`）
+- 对于文章列表页使用 `.RelPermalink`（已自动处理子路径）
+
+### 3. 修改 docker-compose.yml
+
+**文件：** `docker-compose.yml`
+
+```diff
+- command: ["server", "-D", "--bind", "0.0.0.0", "--baseURL", "http://localhost:1313"]
+ command: ["server", "-D", "--bind", "0.0.0.0", "--baseURL", "http://localhost:1313/blog/"]
+```
+
+确保容器启动时使用正确的 baseURL。
+
+## 验证步骤
+
+### 本地验证
+
+```bash
+# 1. 启动服务
+cd /Users/guchen/.openclaw/workspace/org/cases/val_blog
+docker compose up -d
+
+# 2. 验证首页访问
+curl -s http://127.0.0.1:1313/blog/ | grep -E 'href='
+
+# 3. 验证文章页访问
+curl -s http://127.0.0.1:1313/blog/journey/ | grep -E 'href='
+
+# 4. 验证生成静态文件的链接
+docker exec val-blog-dev hugo -d /tmp/hugo-public
+docker exec val-blog-dev grep -r 'href=' /tmp/hugo-public/index.html
+```
+
+**预期结果：**
+- 所有 `href` 属性都包含 `/blog/` 前缀
+- CSS 链接：`http://localhost:1313/blog/css/main.css`
+- 导航链接：`http://localhost:1313/blog/`、`http://localhost:1313/blog/journey`
+- 文章链接：`/blog/journey/xxx/`
+
+### Tailscale 验证
+
+通过 Tailscale 访问时，确保以下映射配置：
+
+```bash
+# 查看当前 Tailscale serve 配置
+tailscale status
+tailscale serve status
+
+# 如需添加 /blog 路径映射（如果尚未配置）
+tailscale serve --http=80 tcp:1313
+# 然后在控制台将 /blog 路径映射到 Hugo 服务
+```
+
+## 回滚方案
+
+如需回滚到根路径配置，执行以下操作：
+
+1. **config.toml:**
+   ```toml
+   baseURL = "http://localhost:1313/"
+   ```
+
+2. **baseof.html:**
+   ```html
+   <link rel="stylesheet" href="/css/main.css" />
+   <a href="/">首页</a>
+   <a href="/journey">旅程</a>
+   ```
+
+3. **docker-compose.yml:**
+   ```yaml
+   command: ["server", "-D", "--bind", "0.0.0.0", "--baseURL", "http://localhost:1313"]
+   ```
+
+## Tailscale Serve 建议命令
+
+如果需要调整 Tailscale 路径映射：
+
+```bash
+# 方式一：仅映射 /blog 路径
+tailscale serve http://127.0.0.1:1313/blog
+
+# 方式二：查看当前映射状态
+tailscale serve status
+
+# 方式三：添加自定义域名的路径映射（需要 DNS 配置）
+tailscale serve --bg your-domain.ts.net http://127.0.0.1:1313/blog
+```
+
+## 修改文件清单
+
+| 文件 | 操作 |
+|------|------|
+| `site/config.toml` | 修改 baseURL |
+| `site/layouts/_default/baseof.html` | 替换硬编码链接 |
+| `docker-compose.yml` | 更新启动命令 |