一、先把现象写清楚:同步中、白屏、团队里「别人能看我卡住」是不同链路
全局长时间「正在同步」,往往说明与服务器之间的实时或增量数据通道没有稳态建立。可能是 WebSocket 长连被错策略打断,也可能是 DNS 解析到「看似成功、实则连不上去」的目标。
单页能打开、嵌入图片或封面上传卡死,多落在对象存储、附件域名或图床 CDN。此时同一工作区里纯文本能写,一插大图或看他人上传的图就转圈,典型是 Notion CDN 或云厂商边缘未与主站同策略。
整站工作区一直灰、但浏览器访问其它站正常,请区分是Notion 桌面客户端还是Chromium/Edge 网页版。在 Windows 上,系统代理只影响声明使用系统代理的组件;而不遵循系统代理的进程会表现为「浏览器好了、应用仍坏」或相反。与站内《Figma 画布一直转圈?用 Clash 分流 CDN 与 WebSocket》类似,实时协作类应用对多域名、长连接、静态与 API 同出口的敏感度很高,但 Notion 的主机名与 Figma 完全不同,不能照搬任何规则片段。
二、两类根因:主应用半通,还是 Notion 静态与附件边缘未对齐
主应用半通指:notion.so、api.notion.com 等与工作区、鉴权、同步相关的请求本应落在同一策略意图,却有一部分被 GEOIP 或「国内直连」等宽泛规则打成了 DIRECT。典型表现是边栏有时能出团队列表,点进某页就白屏或长期 pending。
静态与 Notion CDN 未对齐则更难直觉排查:主文档 JSON 能回来,内嵌的脚本、字体、区段封面或 S3/CloudFront 上的附件从另一组主机名拉取。若那组在规则里更靠前、命中了你不期望的策略,就会出现「编辑框出来了,样式或块渲染不全」。日志里常见 notion、amazonaws、cloudfront 等方向,但产品会调边缘,必须以你本地当次复现的日志为准,勿抄他人清单当真理。
还有一类「看起来像同步卡死、其实是只读 API 与第三方集成」的场景:你装了自动化或从外部拉数据,若 api.notion.com 与主应用走了不同地区节点,会偶发 429 或长延迟,界面仍报同步异常。与「单纯打不开网页」相比,Notion 代理 场景更需要细 hostname 与策略一致性,而不是全量 GLOBAL。
三、推荐排查顺序:先模式与日志,再规则与 DNS,最后换节点
把「先换到最快机场」从第一位挪走,能避免反复无效折腾。
- 明确当前是仅系统代理、规则模式,还是已开TUN;在 Notion 复现问题的同时打开连接面板,按时间观察是浏览器进程还是 Notion 进程在发起记录。
- 在日志中按
notion、api、ws、cloudfront、amazonaws等关键词过滤,查看同一秒内是否同时出现 PROXY 与 DIRECT 且失败落在直连一侧;若有,应把这些主机名并到与主站同一策略组,而不是单独盲改节点。 - 对长时间 pending 或 TLS 握手重试的项,点进详情看是 TCP 建连问题还是 SNI/证书主机名与解析不一致;后一类优先怀疑 DNS 与
fake-ip。 - 在规则顺序上,把经日志确认的几条
DOMAIN放在你订阅里过宽的「国内/直连」大规则之前,并保存后重载配置、再复现一次。 - 在同一条目已稳定命中、出口一致后,再为延迟与晚高峰抖动去选更稳的节点;若策略仍混乱,再快的节点也救不了「半代理」状态。
拉配置失败、核心端口占用、YAML 报错的通用解,可对照《Clash 常见报错解决方案》;本文只写 Notion 同步失败 下的多域名、长连接与 CDN 场景。
四、Windows:系统代理、Notion 桌面端与 TUN 是否覆盖到同一类流量
在 Windows 上,系统代理主要影响走 WinHTTP/IE 代理解析栈的应用。许多 Electron 与自带网络栈的客户端会尊重系统代理,但UDP、部分 DNS、以及未声明走代理的本地回环与直连不会自动进 Clash 的混合端口。于是你会看到:Edge 能开 Notion 网页、桌面版却老连不上,或反过来的情况,其实都是半代理而不是「网坏了」。
当同步依赖长连接、WebSocket 或分块上传,仅 HTTP(S) 走代理、其余仍按系统路由时,Notion 同步失败 的症状会一直存在。可评估在理解风险的前提下使用TUN 模式,在网卡层更一致地接入选路;开启前请阅读《Clash TUN 模式开启方法》,并确认 TUN 生效后,连接日志中 Notion 相关条目不再大量落在 DIRECT 异常路径。若你同时用 WSL2 或 Docker 与宿主机上的 Notion 混跑,可保留《WSL2 共用本机 Clash 代理》的边界在脑子里,但本文仍以 Windows 桌面与浏览器为主场,避免把 Linux 子系统的路由问题误判成 Clash 分流 错误。
五、主站、API 与只读:notion.so 与 api 是否同一策略出口
主界面加载、工作区元数据、搜索与很多协作操作,会命中 notion.so 及其子域。集成与自动化、部分第三方请求则常落在 api.notion.com。在你本地日志中若两条频繁交替出现、且被规则拆到不同策略,就会出现能打开列表却搜不到、或能编辑却同步回写失败等表观随机问题。
务实的做法是:在复现时不合并盲目后缀,而是为日志里反复失败或 pending的那几段主机名各写 DOMAIN 或窄后缀,挂到与主应用相同的上游策略组。若与「团队」相关的能力异常,可额外注意是否有与 SAML、组织域名或单点登录相关的重定向与额外主机;这类名称往往带租户或贵司自定义域,只能按日志出现一条补一条。
六、Notion CDN、附件与边缘:与主站分流的典型信号
用户上传的 PDF、大封面与部分嵌入资源,会走云存储与 CDN 域名,日志里常出现 S3/CloudFront 等方向。若 主站与 API 已走代理,而带 AWS 或边缘特征的主机名 被前置规则判成 DIRECT,在国内网络环境下往往能连但极慢或 TLS 重试,对应 UI 就是转圈、图片裂或附件打不开。这就是 Notion CDN 类问题在工程上的典型形态。
处理时与站内《Apple Intelligence 与 iCloud 同步总转圈?用 Clash 分流 Apple 与 CDN 域名》 等文同构:先把「慢或失败」的主机名与主应用对齐到同一类策略,再谈节点质量。Apple 与 Notion 的名单毫无交集,切勿复制粘贴。
若你使用浏览器扩展或剪藏类工具,会额外引入第三方脚本域名;为缩小变量,排障阶段可先禁用扩展、仅开 vanilla 复现,再对照连接日志,避免被无关主机名带偏。
七、长连接与 WebSocket:只盯页面能否打开会漏项
Notion 的实时协作与增量同步,依赖长连接。若你只看「能否 curl 通 https://www.notion.so」会掩盖升级协议或长连被策略切断的问题。在 Mihomo/Clash 系客户端里,更可靠的是看连接是否长期保持、重连频率是否异常、同一页面是否对多条主机名并发 pending。若 TUN 打开后,长连的 UDP/TCP 行为更一致、同步从「常死」变「偶发卡顿」,才说明路走对了,剩下才是节点与带宽。
八、域名字段自检表:方向提示,不替代你本地日志
下表为排查时的分类脑图。Notion 会随版本与区域调整边缘,任何静态清单都会过期。请以你当前版本、在 Windows 上实际失败请求里出现的主机名为唯一信源。
| 类型 | 常见方向(示例,非绝对) | 与 UI 的对应 |
|---|---|---|
| 主站与应用 | notion.so、www.notion.so 等 | 工作区与页面框架能否出来。 |
| 公开 API 与集成 | api.notion.com 等 | 自动化、外部拉取、部分同步子任务。 |
| 对象存储与 Notion CDN | 日志中 S3/CloudFront 等边缘名 | 大附件、封面、内嵌大媒体。 |
| 登录与单点 | 与贵司或 IdP 相关的主机名 | 能打开登录页、进不了工作区,或仅团队站异常。 |
九、DNS 与 fake-ip:当「解析能过、建连全挂」时优先看这里
在启用 fake-ip 的栈里,解析与连接若不在同一套逻辑下闭环,会表现为对同一主机名一会儿通一会儿挂。Notion 代理 若叠了自定义 nameserver-policy 或分域上游,而订阅又自带大量 GEOIP,CN 与直连,二者打架时,最省力的验证往往是:临时用单一可信上游 + 在客户端内观察解析是否稳定,再与规则段落对照;具体字段名以你所用的 Mihomo 版本文档为准。
十、Clash 分流:YAML 思路示例(务必将 PROXY 换成你的策略名)
以下片段仅演示把 Notion 主域与 API 先写清楚、放在过宽规则之前,避免被「国内直连接口」误伤。对日志里出现的具体 CDN/附件主机名,再追加 DOMAIN 或必要时的后缀规则。
# Example only — replace PROXY with your policy group name
rules:
- DOMAIN-SUFFIX,notion.so,PROXY
- DOMAIN-SUFFIX,notion.com,PROXY
- DOMAIN-SUFFIX,notion.site,PROXY
- DOMAIN,api.notion.com,PROXY
# Add DOMAIN rules from your connection log for S3/CloudFront if half-proxy persists
写完后务必重载配置并回到连接面板验证命中是否稳定;不要把整个互联网塞进一条超大后缀,以免与无关业务共抢出口。
十一、与订阅大规则、广告拦截的冲突
很多规则集对「大洲直连」「广告或跟踪」有宽泛匹配,可能误伤 Notion 依赖的统计或脚本路径;表现往往是有网络、块编辑器行为怪异。若你近期更换过去广告规则或加过 REJECT 段,可在排障时暂时放宽,用最小规则集+本文主机名,确认同步恢复,再逐段加回。
十二、节点:先稳、再快
在出口已对齐后,Notion 同步失败 仍常表现为晚高峰排队或跨洋 RTT 高。同一段线路若延迟抖动大,长连更容易断。可优先选方差小、对 TLS 与长连友好的节点,少做秒级自动切换。协议层面如需横向对比,可参考《Shadowsocks vs Trojan vs Hysteria2》,但不要把换协议当成绕过「半代理」的捷径,根因未解决时只换协议通常无效。
十三、合规与条款
使用网络代理与访问各在线服务,须遵守当地法律法规与平台用户条款。本文只讨论技术路径、DNS 与策略一致性,不含任何鼓励违规访问或规避管理策略的内容。请在你有权使用的网络与账号前提下实践,并自行承担相关责任。
十四、小结:把 Notion 同步问题拆成「谁没走对出口」的清单
Notion 同步失败 在 Windows 上与 Clash 分流 同屏出现时,最实用的切入点是:主站、API、长连、Notion CDN 与附件是否在连接日志中命中同一类策略,以及系统代理、TUN 与 DNS是否对你当前的客户端与浏览器全路径生效。按可复制的顺序排下来,你通常能在日志里直接看到该补哪条 hostname,而不是在节点列表里无目的地轮换。
当你需要一套在桌面端、规则编辑与连接可视性上更一体的体验时,成熟客户端在 Mihomo 核心上的组合往往比多工具拼凑更省时间;相比东拼西凑的局部代理,规则与连接面板一体能更快把「半代理」定位出来。→ 立即免费下载 Clash,开启流畅上网新体验