[[0.index|回到目录]] ![](https://yesaiwen.com/_obsidian_proxy/mdnice007.oss-cn-beijing.aliyuncs.com/20260816215045534.png) # 技术小白也能照做:让 AI 一步步修复 Obsidian Publish博客 国内无法访问的问题 以前用 WordPress 建博客,经常莫名其妙无法访问。研究了一圈,换成 Obsidian Publish,用了半年一直很稳。 结果从 2026-8-15 开始,博客突然打不开了,必须开代理才能访问。我的心瓦凉瓦凉的:难道又要让我这个技术小白重新折腾建站? 感谢万能的 AI,折腾半天帮我解决了。中间发现一个临时办法:把本地 DNS 改成腾讯、阿里的(223.5.5.5 / 119.29.29.29)就能访问,但治本还得靠下面的方案。 如果你也遇到同样的问题——**Obsidian Publish 博客一切正常,唯独大陆地区无法访问**——可以参考本文。 下面的内容枯燥无聊,不用自己啃,直接丢给 AI(Deepseek、千问等都行),让它一步步引导你操作。 --- ## 用途 把以下文件交给 AI,AI 可按步骤指导用户完成修复。用户不需要懂技术,只需照做、截图反馈。 --- ## 第 0 步:确认症状(全部符合才继续) - [ ] 网站是 Obsidian Publish 搭建,已绑定自定义域名 - [ ] 部分访客打不开(页面空白/一直加载),部分访客正常 - [ ] 站长自己访问正常 - [ ] 浏览器 F12 → Network 中有失败请求,主机名是 `publish.obsidian.md` 或 `publish-数字.obsidian.md` - [ ] 把本机 DNS 改为 `223.5.5.5` 或 `119.29.29.29` 后恢复正常 **不符合以上症状 → 停止,本方案不适用。** --- ## 第 1 步:准备信息(向用户收集) |项目|本案例的值|说明| |---|---|---| |自定义域名|`blog.saiwen.com`|用户正式域名| |测试子域名|`publish-test.saiwen.com`|新建,验证用| |Worker 名称|`obsidian-publish-proxy`|| |Cloudflare 账号|用户已登录|域名必须已接入 Cloudflare 且开启代理| --- ## 第 2 步:创建 Worker 指导用户在 Cloudflare 控制台操作: 1. Workers 和 Pages → 创建 Worker → 从 Hello World 开始 2. 名称填 `obsidian-publish-proxy` → 部署 3. 进入 Worker → 编辑代码 4. 全选删除默认代码,粘贴本文件末尾的完整 Worker 代码 5. 若用户域名不同,先让用户把代码里 3 处 `blog.saiwen.com` 全部替换成自己的域名 6. 点击"部署" --- ## 第 3 步:建测试环境 1. `saiwen.com` → DNS → 记录 → 添加记录: - 类型 `A`,名称 `publish-test`,IPv4 填 `192.0.2.1`,代理状态**开启(橙色云)** - (`192.0.2.1` 是保留测试 IP,Worker 接管后不会真访问它) 2. `saiwen.com` → Workers 路由 → 添加路由: - 路由 `publish-test.saiwen.com/*`,Worker 选 `obsidian-publish-proxy` 3. 若控制台提示"没有区域匹配"或跳转到购买域名页面 → **立即取消**,改用从域名区域内部添加路由的方式,不要购买任何东西 --- ## 第 4 步:测试环境验收 让用户访问: https://publish-test.用户域名/obsidian_publish/0.index 验收操作(指导用户): 1. F12 → Network → 勾选"停用缓存" → 点 ⊘ 清空 → `Ctrl+Shift+R` 2. 关闭左侧"搜索"面板(点它标题旁的 ×) 3. 在 Network 的**过滤框**(漏斗图标右侧)依次输入并检查,**每个都必须无结果**: - `domain:publish.obsidian.md` - `domain:publish-01.obsidian.md` - `domain:publish-02.obsidian.md` 4. 页面能完整显示文章、目录、图片 **判断标准**:路径里出现 `obsidian.md` 字样正常(如 `/_obsidian_proxy/publish-01.obsidian.md/...`),只要请求**主机名**是用户自己的域名即合格。 ### 验收不通过的排查 |现象|原因|处理| |---|---|---| |`domain:publish.obsidian.md` 仍有结果|代码中改写正则转义错误|核对代码与本文末尾版本完全一致,重新部署| |`domain:publish-01.obsidian.md` 仍有结果|裸主机名未改写|同上,确认 `rewriteObsidianHosts` 含 4 种形式的改写| |字体报错 `OTS parsing error`|对字体删了 content-encoding|确认二进制资源走透传分支(保留编码头)| |`history.pushState` 跨域报错|页面跳回正式域名|确认代码含"正式域名→当前源"的改写| |自定义 publish.js 报语法错误|用户自定义脚本本身问题|与本方案无关,可暂缓| --- ## 第 5 步:正式切换(必须先问用户确认) 确认测试通过后,**向用户明确说明并征得同意**,然后: 1. `saiwen.com` → Workers 路由 → 添加路由 `blog.saiwen.com/*` → `obsidian-publish-proxy` 2. **禁止修改或删除 blog 的 DNS 记录**(CNAME 保留不动,路由优先级高于 DNS,天然可回滚) 3. 重复第 4 步的验收,地址换成正式域名 4. 让用户用手机 4G/5G(关 Wi-Fi)再验证一次 ## 回滚 删除 `blog.saiwen.com/*` 这条路由即可,立即恢复原状。 --- ## 第 6 步:交付汇报 完成后向用户汇报:创建的资源清单、Worker 代码、测试/正式地址、Network 验收结果、遗留兼容性问题、回滚方法。 --- ## 附录:Worker 完整代码 ``` > 使用前把 3 处 `blog.saiwen.com` 替换为用户的自定义域名。 const CUSTOM_DOMAIN = "blog.saiwen.com"; const MAIN_UPSTREAM = "publish.obsidian.md"; const PROXY_PREFIX = "/_obsidian_proxy/"; ​ const ALLOWED_HOST_RE = /^publish(?:-\d+)?\.obsidian\.md$/i; ​ const BINARY_FILE_RE =  /\.(?:woff2?|ttf|otf|eot|png|jpe?g|gif|webp|avif|ico|pdf|zip|mp3|mp4|webm|wasm)(?:$|\?)/i; ​ export default {  async fetch(request) {    try {      return await handleRequest(request);   } catch (error) {      return new Response(`Proxy error: ${error.message}`, {        status: 502,        headers: {          "content-type": "text/plain; charset=utf-8",          "cache-control": "no-store",       },     });   } }, }; ​ async function handleRequest(request) {  const publicUrl = new URL(request.url);  const target = parseTarget(publicUrl); ​  if (!ALLOWED_HOST_RE.test(target.host)) {    return new Response("Forbidden upstream", {      status: 403,      headers: { "content-type": "text/plain; charset=utf-8" },   }); } ​  const upstreamUrl = new URL(    `${target.path}${publicUrl.search}`,    `https://${target.host}` ); ​  const headers = new Headers(request.headers);  headers.set("x-obsidian-custom-domain", CUSTOM_DOMAIN);  headers.set("accept-encoding", "identity"); ​  headers.delete("host");  headers.delete("cf-connecting-ip");  headers.delete("cf-ipcountry");  headers.delete("cf-ray");  headers.delete("cf-visitor");  headers.delete("x-forwarded-for");  headers.delete("x-forwarded-proto"); ​  const init = { method: request.method, headers, redirect: "manual" }; ​  if (request.method !== "GET" && request.method !== "HEAD") {    init.body = request.body; } ​  const upstreamResponse = await fetch(upstreamUrl, init);  return transformResponse(upstreamResponse, publicUrl, upstreamUrl, request.method); } ​ function parseTarget(publicUrl) {  const pathname = publicUrl.pathname || "/"; ​  if (!pathname.startsWith(PROXY_PREFIX)) {    return { host: MAIN_UPSTREAM, path: pathname }; } ​  const remainder = pathname.slice(PROXY_PREFIX.length);  const slashIndex = remainder.indexOf("/");  const encodedHost = slashIndex === -1 ? remainder : remainder.slice(0, slashIndex);  const host = decodeURIComponent(encodedHost).toLowerCase();  const path = slashIndex === -1 ? "/" : remainder.slice(slashIndex);  return { host, path }; } ​ async function transformResponse(upstreamResponse, publicUrl, upstreamUrl, requestMethod) {  const headers = new Headers(upstreamResponse.headers);  const publicOrigin = publicUrl.origin; ​  rewriteLocationHeader(headers, publicOrigin, upstreamUrl); ​  headers.delete("content-security-policy");  headers.delete("content-security-policy-report-only");  headers.delete("report-to");  headers.delete("nel"); ​  if (    requestMethod === "HEAD" ||    upstreamResponse.status === 204 ||    upstreamResponse.status === 304 ) {    return new Response(null, {      status: upstreamResponse.status,      statusText: upstreamResponse.statusText,      headers,   }); } ​  const contentType = headers.get("content-type") || ""; ​  if (BINARY_FILE_RE.test(upstreamUrl.pathname) || !isRewritableContent(contentType)) {    return new Response(upstreamResponse.body, {      status: upstreamResponse.status,      statusText: upstreamResponse.statusText,      headers,   }); } ​  headers.delete("content-length");  headers.delete("content-encoding");  headers.delete("etag"); ​  let body = await upstreamResponse.text();  body = rewriteObsidianHosts(body, publicOrigin); ​  if (contentType.toLowerCase().includes("text/html")) {    body = body.replace(/\s+integrity\s*=\s*(?:"[^"]*"|'[^']*')/gi, "");    body = body.replace(      /<meta\b[^>]*http-equiv\s*=\s*(?:"content-security-policy"|'content-security-policy'|content-security-policy)[^>]*>/gi,      ""   ); } ​  headers.set("content-type", ensureUtf8(contentType)); ​  return new Response(body, {    status: upstreamResponse.status,    statusText: upstreamResponse.statusText,    headers, }); } ​ function isRewritableContent(contentType) {  const type = contentType.toLowerCase();  return (    type.startsWith("text/") ||    type.includes("javascript") ||    type.includes("json") ||    type.includes("xml") ||    type.includes("svg") ||    type.includes("manifest") ); } ​ function ensureUtf8(contentType) {  if (!contentType) return "text/plain; charset=utf-8";  if (/charset=/i.test(contentType)) return contentType;  return `${contentType}; charset=utf-8`; } ​ function rewriteObsidianHosts(text, publicOrigin) {  const publicHost = new URL(publicOrigin).host; ​  text = text.replace(    /https?:\/\/(publish(?:-\d+)?\.obsidian\.md)/gi,   (_, host) => proxyBase(publicOrigin, host) ); ​  text = text.replace(    /https?:\\\/\\\/(publish(?:-\d+)?\.obsidian\.md)/gi,   (_, host) => proxyBase(publicOrigin, host).replaceAll("/", "\\/") ); ​  text = text.replace(    /(^|[^:])\/\/(publish(?:-\d+)?\.obsidian\.md)/gi,   (_, prefix, host) => `${prefix}${proxyBase(publicOrigin, host)}` ); ​  text = text.replace(    /(["'])(publish(?:-\d+)?\.obsidian\.md)\1/gi,   (_, quote, host) =>      `${quote}${publicHost}${PROXY_PREFIX}${host.toLowerCase()}${quote}` ); ​  text = text.replace(/https?:\/\/blog\.saiwen\.com/gi, publicOrigin);  text = text.replace(    /https?:\\\/\\\/blog\.saiwen\.com/gi,    publicOrigin.replaceAll("/", "\\/") );  text = text.replace(    /(["'])blog\.saiwen\.com\1/gi,   (_, quote) => `${quote}${publicHost}${quote}` ); ​  return text; } ​ function proxyBase(publicOrigin, host) {  return `${publicOrigin}${PROXY_PREFIX}${host.toLowerCase()}`; } ​ function rewriteLocationHeader(headers, publicOrigin, upstreamUrl) {  const location = headers.get("location");  if (!location) return; ​  let resolved;  try {    resolved = new URL(location, upstreamUrl); } catch {    return; } ​  const resolvedHost = resolved.hostname.toLowerCase(); ​  if (resolvedHost === CUSTOM_DOMAIN.toLowerCase()) {    headers.set(      "location",      `${publicOrigin}${resolved.pathname}${resolved.search}${resolved.hash}`   );    return; } ​  if (!ALLOWED_HOST_RE.test(resolvedHost)) return; ​  if (resolvedHost === MAIN_UPSTREAM) {    headers.set(      "location",      `${publicOrigin}${resolved.pathname}${resolved.search}${resolved.hash}`   );    return; } ​  headers.set(    "location",    `${proxyBase(publicOrigin, resolvedHost)}${resolved.pathname}${resolved.search}${resolved.hash}` ); } ``` --- ## AI 执行守则 1. 每一步给用户**一条**明确指令,等用户截图/反馈后再给下一条 2. 用户界面是中文 Cloudflare 控制台,按钮用中文名称 3. 涉及正式域名的操作前必须停下来征得用户同意 4. 任何时候不修改/删除现有 DNS 记录,不购买付费产品 5. Cloudflare 控制台改版时,以"从域名区域内部添加路由"为优先路径,避开账户级的"接入域名"(它会误判为购买域名) 6. 出现本文未覆盖的报错 → 让用户截图 Console 和 Network,不要瞎猜改代码 [[0.index|回到目录]]