tamakyi/tamabox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
12a37e726fb2448b23975cfab6876fd405b404ae
tamabox/outputs/domain-migration-box-shiroko-2026-09-06.md
T
tamakyi e3e59e7c69 chore: baseline snapshot before moderation-strictness feature 
Repo .git was damaged (refs/ missing, index truncated, object store near-empty).
Repaired via git init (rebuilt refs), stale index preserved as .git/index.corrupt-20260910.bak,
then full worktree committed as a rollback baseline.
2026-09-10 10:56:27 +08:00

19 KiB
Raw Blame History

box.tama.guru → box.shiroko.one 域名迁移方案（保 Bing 排名）

日期：2026-09-06　｜　状态：方案待批准 目标：在 tama.guru 不续费（2026-12-24 到期）的约束下，把 box.tama.guru 迁移到 box.shiroko.one，最小化 Bing（及 Google）排名损失。

0. 决策记录（用户已拍板）

决策点 选择 影响
过渡策略 不续费硬过渡 301 窗口 ≈ 现在→2026-12-24（约 3.5 个月）
新域形态 box.shiroko.one（子域） 根域 shiroko.one 留给导航页/blog 等未来用途
引擎范围 Bing + Google 全套 Site Move + GSC Change of Address + 双 sitemap + IndexNow
umami 一并迁走 → mami.shiroko.one 统计不中断
站群其余子域 一并迁移（blog/chat/share/status → 同名 .shiroko.one） 用户 2026-09-06 追加确认；footer 链接群与 home 文案内链全部换域
/_/tamakyi 不保 从 sitemap 移除；robots 维持 Disallow: /_/（与 sitemap 自相矛盾的问题一并消除）。页脚/首页指向站长箱的功能性链接保留（用户仍可点击），只是不再提交给搜索引擎

✅ 批 1（本地代码改动）已于 2026-09-06 完成，详见 §12。

1. 现状与硬约束（侦查取证结果）

1.1 资产地图

  • tama.guru 根域 = 「狼的导航页」（Hugo 0.121.2 / CF Pages）——用户声明不保
  • box.tama.guru = 本次迁移对象（提问箱，生产，DNSPod 三线路 DNS：境内→EdgeOne 新加坡、境外/默认→Cloudflare SaaS+tunnel）
  • mami.tama.guru = umami 统计（Vercel）——随迁
  • blog/status/share/chat.tama.guru = 站群其余子域——用户未声明保，列入开放项（§11）
  • r2.337845818.best、337845818.best zone = 独立域，不受影响（仅需在 R2 CORS 白名单追加新域）
  • 注册信息：tama.guru 注册商 DNSPod, Inc.，expiration 2026-12-24，当前 active

1.2 box.tama.guru 的 SEO 现状（好消息）

  • Bing 收录管道 = static/sitemap.xml 仅 8 条 URL： /、/explore、/register、/login、/_/tamakyi、/change-logs、/explore(重复)、裸域
  • /explore 是唯一「内容页」，排名大概率集中于此 → 索引面小、301 映射表短、信号集中，迁移成本极低
  • ⚠️ robots.txt Disallow: /_/ 与 sitemap 提交 /_/tamakyi 自相矛盾——搜索引擎以 robots 为准，该条实为无效提交；若 /_/tamakyi 有真实流量价值需决策（§11 开放项）
  • ⚠️ 页面无 <link rel="canonical">（仅 og:url）——迁移是新站补 canonical 的好时机，对 Bing 有实际帮助

1.3 关键机制（Bing/Google 官方语义）

  1. 301 全量逐 URL 一一对应是唯一可靠路径：不 302、不跳首页、无链式跳转
  2. Bing Site Move / GSC Change of Address 只是「加速器」；工具不可用时 301+sitemap 兜底
  3. 提交 Site Move 后 新域 6 个月内不得再次迁移
  4. 通行要求：301 保持 6–12 个月；权重转移 60–90 天；迁移期掉 10–30% 属正常
  5. 约束风险：本方案窗口 ~3.5 个月 < 6 个月通行线。缓解：① 索引面仅 3–5 个有效 URL，Bing 对小型站处理快；② 尽早切换拉满窗口；③ IndexNow 秒级通知加速新站收录

2. 目标架构

                          ┌─ 境内线路 ──> EdgeOne(box.shiroko.one 加速域) ─┐
用户 → DNSPod(shiroko.one) ┤                                              ├→ 源站 TamaBox
   (分线路)                └─ 境外/默认 ─> Cloudflare SaaS + tunnel ──────┘
                                                │
旧域 box.tama.guru（DNS 在切换日改指静态 301 载体，见 §6）
   任意线路 ─> CF Pages 跳转项目 ─ 301 ─> https://box.shiroko.one/<同路径><同query>
  • 新域 双 CDN 架构完全照搬 box.tama.guru 现状（境内 EO / 境外 CF）
  • 旧域在 12-24 前只做 301，不再回源 → 源站与旧域解耦，安全退役
  • umami：Vercel 加 mami.shiroko.one，同一实例，数据不丢

3. 时间线（倒排，越早切换 301 窗口越长）

阶段 窗口 内容 责任
P0 准备 现在 – 9/20 代码/配置改动（§5）、域名/控制台准备（§7）、Bing/GSC 双属性验证（§8.1） 我 + 你
P1 新站上线 9/20 – 9/27 box.shiroko.one 双线打通、全功能验收、旧站并行不动 我 + 你
P2 切换 9 月底某低峰日凌晨 改 external_url → 源站重启 → 旧域 DNS 切 301 载体 → Site Move/CoA/IndexNow（§8） 我 + 你
P3 过渡监控 10 月 – 12/24 每周看两站索引与流量；反链外联更新；旧域保持 301 我
P4 到期善后 12/24 后 旧域自然失效属计划内；确认新站独立站稳、无旧缓存依赖 我

切换建议 ≤ 2026-10-01，301 窗口 ≈ 85–90 天，覆盖 Bing 权重转移期（60–90 天）。

4. 保排名逻辑（为什么这样做能最小化损失）

旧 URL(Bing 索引中) ──301──> 新 URL ──sitemap/IndexNow──> Bing 立即重爬新址
      │                                                       │
  排名信号(点击/外链/信任) 由 301 传递 ≈90%          权重 60–90 天内转移
      │                                                       │
  旧域 12/24 消亡时：Bing 已把信号合并到新域 ← 目标状态

不这样做的代价：旧 URL 到期后全部变死链 → Bing 逐个降权删除 → 新域从零积累，等于「重新开始」。

5. 代码与配置文件改动清单（本地副本，批准后分批实施）

P0 必改（切域前）

# 文件 改动 说明
C1 部署侧 conf/app.ini external_url = https://box.shiroko.one 必填配置；og:url 与全部邮件链接（找回密码/私信通知）一次修复。app.ini 在部署环境持有，本地副本无此文件
C2 static/robots.txt Sitemap: 行改 https://box.shiroko.one/sitemap.xml go:embed 静态文件，当前硬编码旧域
C3 static/sitemap.xml 8 条 URL 域替换为 box.shiroko.one 同上；建议顺手去掉与 robots 冲突的 /_/tamakyi（§11 决策）
C4 route/auth/register.go:64 Bloglink: "box.shiroko.one" 注册引导链接硬编码
C5 internal/security/censor/text.go TrustedHosts：tama.guru → 增加/替换为 shiroko.one 否则用户在新站发 shiroko.one 链接被当广告拦。实施时确认 RemoveTrustedURL 对子域是否覆盖（needle=裸域 + 边界判断）
C6 templates/base/header.html og:url 保留（自动跟随 ExternalURL）；新增 <link rel="canonical" href="{{.ExternalURL}}{{.CurrentURI}}"> 新站补 canonical，防重复收录，Bing 友好
C7 templates/base/header.html umami 注入块：s.src = "https://mami.shiroko.one/tamami.js" 与 umami 迁移同批（§5 D 组）
C8 templates/base/footer.html 链接群（blog/chat/share/status/tama.guru）按 §11 决策处理 到期后这些全是死链，必须在切换前定
C9 templates/home.html 正文内链 box.tama.guru → box.shiroko.one；指向 blog 的文章链接按 §11 决策 首页是 Bing 重点页面，内链必须指向新站而非继续依赖 301

伴随迁移（D 组，与 box 同批）

# 位置 改动
D1 Vercel 控制台 umami 项目添加自定义域 mami.shiroko.one（CNAME → cname.vercel-dns.com）
D2 DNS（新 zone） mami 记录 CNAME → Vercel 目标
D3 C7 的 header 埋点 指向 mami.shiroko.one（同一 data-website-id，数据连续）

mami.tama.guru 在 12-24 前保持在线，与新域并行无冲突（浏览器缓存自然淘汰）。

6. 301 实现方案（旧域唯一使命）

推荐：CF Pages 静态跳转项目（免费、一行配置、境内境外通吃）

  1. Cloudflare 新建一个 Pages 项目（如 tama-redirect），根目录放一个 _redirects： 
    /*  https://box.shiroko.one/:splat  301!
  2. 把 box.tama.guru 添加为该 Pages 项目的自定义域（Pages 面板 → Custom domains → 按提示在 DNSPod 加 CNAME）
  3. 切换日：DNSPod 上 box.tama.guru 的三条线路（境内 EO CNAME / 境外 CF / 默认 CF）统一改 CNAME → 该 Pages 域名（或直接 CNAME 到 pages.dev 域名）
  4. 原 EO 加速站点 / CF SaaS 主机名（box.tama.guru）可停可留——DNS 切走后自然不再产生流量，12/24 随旧域注销即可
  • ✅ 保留完整路径与 query（:splat），无链式跳转，天然 301
  • ✅ 与源站/旧 CDN 完全解耦，源站只需服务新域
  • ✅ 301 响应体积极小，境内经 CF Pages 慢 ~1s 无感
  • 备选 A：EO 重定向规则（境内）+ CF Worker route（境外）——需在两边控制台分别配，操作更碎
  • 备选 B：源站 nginx 按 Host 301——不推荐：CDN 回源 Host=box.tama.guru 时会产生回源环，需同时改回源配置，风险高

7. 控制台操作清单（需你在各平台操作，我提供每一步的精确值）

7.1 DNS 托管决策（先行）

推荐：shiroko.one 的 NS 从 Spaceship 改到 DNSPod（你已在 DNSPod 管理 tama.guru，分线路 DNS 是现有双 CDN 架构的前提；Spaceship DNS 无境内/境外分线路）。 步骤：DNSPod 添加 shiroko.one → 获得 DNSPod 分配的 NS → Spaceship 域名面板改 NS → 等待生效（1–24h，可用 nslookup -type=NS shiroko.one 8.8.8.8 验证）。

7.2 DNSPod（shiroko.one zone）

主机 类型 值 线路
box CNAME EO 分配的 CNAME 目标（控制台给，形如 xxx.eo.dnse4.com） 中国境内
box CNAME CF SaaS CNAME 目标（337845818.best zone → Custom hostnames → 形如 <hash>.cdn.cloudflare.net）或既有优选 CNAME 境外 / 默认
mami CNAME cname.vercel-dns.com 默认

以上记录结构完全照搬 box.tama.guru / mami.tama.guru 现有三条线；切换日另加 box.tama.guru 的 301 线路（§6）。

7.3 EdgeOne（腾讯）

  • 新增加速域名 box.shiroko.one：归属验证（TXT/CNAME，验证记录保留勿删）→ HTTPS 证书 → 回源=源站 IP:高位端口、回源 HOST=box.shiroko.one
  • 规则/缓存配置照抄 box.tama.guru 现有站点

7.4 Cloudflare

  • 337845818.best zone → SSL/TLS → Custom hostnames（for SaaS）：添加 box.shiroko.one（回源走既有 tunnel；cloudflared ingress 增加 box.shiroko.one 路由）
  • R2 bucket CORS 白名单：追加 https://box.shiroko.one（必须在 301 前完成，否则新站图片/二维码导出被 CORS 拦）

7.5 Vercel

  • umami 项目添加 mami.shiroko.one（§5 D1）

8. SEO 迁移执行序列

8.1 预备（P0，先于新站上线，可立即做）

  1. Bing Webmaster Tools：添加并验证 box.shiroko.one（用 DNS TXT 验证，DNSPod 加记录即可，无需等站点上线）；确认旧站 box.tama.guru 属性已存在并验证
  2. Google Search Console：同上双属性（URL-prefix：https://box.tama.guru/、https://box.shiroko.one/）

8.2 切换日顺序（P2，低峰凌晨，301 是前提）

  1. 确认 box.shiroko.one 在 EO（境内视角）与 CF（境外视角）全功能验收通过（§9）
  2. 改 external_url + 重启 → 新站所有 og/canonical/sitemap/邮件全指新域
  3. 旧域 DNS 切 301 载体（§6）→ curl -I 验证 301 与 Location 正确
  4. Bing Site Move（旧属性 → Diagnostics & Tools → Site Move → 目标 box.shiroko.one，Scope=Domain）——若工具不可用，301+sitemap 兜底
  5. GSC Change of Address（旧属性 → 设置 → Change of Address → 新属性）
  6. 双引擎分别提交新站 sitemap；旧站 sitemap 保留 60–90 天（引导爬虫吃 301）
  7. IndexNow：用 API key 提交新站全部 URL（Bing 收录最快路径）
  8. 逐条验证 §9.2 的 301 映射

9. 验证与验收

9.1 切换前（新站验收，全部通过才允许 301）

  • https://box.shiroko.one/ 境内 EO / 境外 CF 均 200（用不同线路 DNS 查询验证）
  • 登录 / 提问 / 私信 / 上传 / 投票 / 二维码导出 主链路通过（R2 CORS 已含新域）
  • curl -s https://box.shiroko.one/robots.txt → Sitemap 行 = 新域
  • curl -s https://box.shiroko.one/sitemap.xml → 全部 URL = 新域
  • 页面含 canonical 指向自身、og:url = 新域
  • 邮件模板链接 = 新域（发一封找回密码实测）

9.2 切换后（301 映射抽查）

curl -sI https://box.tama.guru/explore          → 301 Location: https://box.shiroko.one/explore
curl -sI https://box.tama.guru/_/tamakyi        → 301 → https://box.shiroko.one/_/tamakyi
curl -sI "https://box.tama.guru/vote/xxx?lang=en" → 301 且保留 query
curl -sI https://box.tama.guru/no-such-page      → 301（不允许 404/302）
  • 抽样 20+ URL，确认无 302、无 404、无链式跳转（一条 301 直达）

9.3 过渡期每周监控（P3）

  • Bing/GSC：旧域 indexed 数量应逐周下降；新域逐周上升，60–90 天追平旧域基线
  • 综合 Search Performance：前 2–4 周掉 10–30% 属正常；持续 >30% 且无回升 = 异常，立即排查
  • 新域 site:box.shiroko.one 查询确认收录增长

10. 风险清单

# 风险 等级 缓解
R1 301 窗口 3.5 个月 < 6 个月通行线，权重转移可能不完整 🟠 中 9 月底前切换拉满窗口；索引面小 + IndexNow 加速；Bing 对小型站处理快
R2 切换瞬间旧书签/API 用户 301 到新域 → cookie 一次性失效、跨域 🟡 低 一次性，切换公告；API 调用方（若有）需跟随新域
R3 umami 迁移延误 → 12/24 后统计断 🟡 低 D 组随 P1 完成，两域并行过渡
R4 DNSPod 到期政策未知：到期日是否即停解析 🟡 低 按 12-24 停摆做计划；若到期后保留解析则 301 窗口自动延长，纯赚
R5 /_/tamakyi robots/sitemap 矛盾未决 → 若该页真有 Bing 流量，迁移映射需特殊处理 🟡 低 §11 决策后补映射
R6 footer/home 指向 blog 等将死子域 → 新站页面出现死链 🟡 低 §11 决策

11. 开放项（2026-09-06 更新：1/2 已由用户答复）

  1. 站群其余子域（blog/status/share/chat）是否迁 → 已答：一并迁。已按 *.shiroko.one 同名映射改完（footer 6 条链接 + home 文案内链 + llms 三处博客链）。 ⚠️ 仍需你操作：这些子域的实际服务也要搬（blog 的 Hugo/CF Pages、chat/share/status 各自托管），否则新域链接会是死链。若某个子域打算放弃（如 share/status），告诉我，我把 footer 对应条目删掉。
  2. /_/tamakyi 是否保 → 已答：不保。已从 sitemap 移除，robots 维持 Disallow。
  3. 源站回源端口/隧道细节：EO 与 CF tunnel 的 ingress 路由是否按 hostname 区分——决定 cloudflared 配置加一条路由即可（实施时我出精确 diff）
  4. 迁移公告是否要做（首页横幅提示用户更新收藏/提问链接）
  5. 搜索引擎验证 token 需替换（本次代码审查新发现）：templates/base/header.html 的 google-site-verification（636 行）与 msvalidate.01（7 行 + 637 行重复）是绑定域名的，新域验证后必须替换 content 值，否则 GSC/Bing 无法验证新站 → Site Move / Change of Address 无法提交。已加注释标记。

12. 批 1 实施记录（本地改动，2026-09-06 已完成）

备份：.workbuddy/backup/domain-shiroko-20260906/（9 个文件原样） 替换规则：*.tama.guru → *.shiroko.one；apex tama.guru → shiroko.one

文件 改动
static/robots.txt Sitemap: 行 → box.shiroko.one
static/sitemap.xml 5 条 URL 全部换域；移除 /_/tamakyi 条目；去重（原 https://box.tama.guru 与 .../ 重复）；lastmod 全量刷新为 2026-09-06 以触发重抓
static/llms.txt 4 条站点链接 + 2 条资源链接换域
static/llms-full.txt 7 处换域（主域推荐、FAQ、站点地图、blog 更新日志链）
templates/base/footer.html 6 条链接全换域（admin/notice/chat/drive/status/nav）
templates/base/header.html umami 注释同步为 mami.shiroko.one（脚本 src 已先行改为新域）；验证 token 处加迁移提醒注释
templates/home.html 3 处换域：站长箱链接、投票/Markdown 示例链、4 条 blog 文章链、探索页链
route/auth/register.go:64 Bloglink 默认值 → box.shiroko.one
internal/security/censor/text.go TrustedHosts 新增 "shiroko.one"；旧域 tama.guru 保留（过渡期用户分享旧链接仍需判为可信，待旧域到期后再删）
conf/app.sample.ini 补齐缺失的必填项 external_url（conf.go:36 强制校验，原模板缺失会导致照抄即启动失败），示例指向新域
dev/eo-probe-ips.py、eo-probe-v2.py、eo-scan-all.py EO 回源探测脚本 --host 默认值 → box.shiroko.one
internal/route/route.go 新增 /index-now/{key} 路由（IndexNow 密钥文件，见 §12.1）。文件名用 ^[0-9a-f]{32}\.txt$ 白名单校验防路径穿越；配套回归测试 internal/route/indexnow_route_test.go

验证：sitemap XML 解析通过（5 条、无重复）；go test ./templates/、./internal/security/censor/、./internal/route/ 通过；route/auth、static、internal/conf 带 overlay 编译通过。

12.1 IndexNow 密钥文件（迁移后加速新站收录，已实现）

用户在 static/index-now/66e5e0911b0941f2ba7dbfbbd961e9be.txt 放了 IndexNow key，但访问被 302 到首页。

根因（重要，以后加任何根目录静态文件都会踩）：internal/route/route.go:138 的 flamego.Static 中间件配置了 Prefix: "/static"，只接管 /static/...；而 robots.txt、sitemap.xml、llms.txt、llms-full.txt、favicon.ico 这些根目录文件每一个都是单独注册的 f.Get handler。新加的文件没有对应路由 → 落到 f.NotFound → ctx.Redirect("/") 返回 302。embed 本身没问题。

修复：新增 f.Get("/index-now/{key}")，文件名经 ^[0-9a-f]{32}\.txt$ 白名单校验（防路径穿越）后从 embed FS 读取，返回 text/plain + max-age=86400；校验失败或文件不存在返回 404（不再是 302）。

提交 IndexNow 时的 keyLocation 填：

https://box.shiroko.one/index-now/66e5e0911b0941f2ba7dbfbbd961e9be.txt

⚠️ 旧域 301 上线后，旧域的该路径会被 301 重定向，而搜索引擎校验密钥文件要求 200 直出，因此切换后请用新域的 keyLocation 重新提交。

附：本地代码改动的执行批次建议（批准后按批落地）

  • 批 1（P0 代码）：C2/C3/C4/C5/C6/C8/C9 —— 纯本地仓库改动，可先行 → ✅ 已完成 2026-09-06（见 §12）
  • 批 2（配置）：C1 + D 组 —— 需部署环境 app.ini + Vercel 控制台配合
  • 批 3（切换）：§6 301 载体 + §7 DNS/CDN 控制台操作 + §8 SEO 提交
Reference in New Issue View Git Blame Copy Permalink