[[0.index|回到目录]]

# 技术小白也能照做:让 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|回到目录]]