Notion AI Blocked in 2026? Clash Domain Rules and DNS Setup (Tested)

Why Notion breaks “one AI domain” mental models

Guides that assume “AI equals one chat hostname” work well for vendors that separate marketing, API, and inference cleanly. Notion AI is embedded in the product: prompts, summaries, and inline assists typically ride the same authenticated session as your pages. That does not remove infrastructure diversity—API integrations still call documented hosts, public sites may use a different suffix, and large assets may come from CDN edges whose names do not end in notion.so. If your split rules route the apex web app but miss a sibling used for uploads, telemetry, or regional edges, you get the familiar half-broken pattern: the UI paints while sync stalls, or the browser works while the desktop client cannot complete TLS because it resolves names differently.

Clash applies rules to connections the core actually observes. That works when Server Name Indication (SNI) matches your DOMAIN lines; it fails when encrypted DNS, privacy modes, or split stacks hide the hostname you thought you were matching. The repeatable fix is observe, match, align DNS, verify—not a longer paste from a random ruleset. If YAML policy basics are new, read the site’s Clash tutorial first, then return here for a Notion-shaped overlay.

How this guide sits next to our ChatGPT, Gemini, Claude, and Perplexity articles

We already published vendor pages that share a skeleton: compact domain rules, explicit DNS notes, TUN versus system proxy trade-offs, and sniffing caveats on Meta-class cores. Those articles are the right references when your workload is a single vendor’s chat or search surface. This page targets Notion as a knowledge and collaboration product: you care about sync and embedded AI inside the editor, not only a detached model API. Keep that distinction when you borrow YAML: copying OpenAI host lists does not route Notion traffic, and routing Notion alone does not fix unrelated AI tabs.

For a parallel “web plus API” story with a clearly separated inference stack, compare our ChatGPT and OpenAI API guide. For another AI search product with a distinct API hostname, see our Perplexity rules and DNS article. If you need Anthropic-specific hostnames, use our Claude and Anthropic routing guide. Here we emphasize Notion’s own namespace and the way real-time collaboration amplifies DNS and capture issues that a short chat session might mask.

What you are really routing: web app, API, public sites, and assets

Treat the following as a baseline to confirm in your own logs after product or infrastructure updates—vendors add hosts.

• Primary workspace (web and desktop shells): notion.so and www.notion.so for the authenticated application.
• Official Notion API: api.notion.com as the documented REST hostname for integrations and automation.
• Published pages (public web): notion.site and related subdomains for public-facing sites generated from Notion.
• Marketing and program pages: makenotion.com appears in onboarding and documentation flows; sign-in may still involve third-party identity providers on unrelated suffixes.
• Files and media: uploads and thumbnails may hit additional *.notion.so hosts or third-party CDNs; when images fail while text succeeds, widen the investigation with logs rather than guessing CDN domains from screenshots.
• Notion Calendar and adjacent products: if your workspace uses bundled experiences, expect additional hostnames; capture them once and add explicit lines rather than over-broad wildcards you cannot explain later.

Do not import giant community “AI rulesets” blindly: stale REJECT lines for analytics can break telemetry your client now requires. If you maintain rules through remote providers, see our custom rules tutorial for merge order and how subscription refreshes can erase personal tweaks.

Notion AI specifically: same session, more failure modes

When Notion AI appears “blocked,” the failure may be indistinguishable from a generic network error: rate limits, workspace policy, or client bugs sit on the same symptom surface as bad routing. Start by confirming the product works on a clean network without Clash. If it only fails behind your proxy stack, continue with routing and DNS. If it fails everywhere, fix account and policy questions before you edit YAML for a week.

IPv6 and dual-stack gotchas

On networks that advertise IPv6, your OS may prefer AAAA records. If your proxy path handles IPv4 and IPv6 asymmetrically, you can see intermittent failures that correlate with switching between Wi-Fi and tethering rather than with Notion itself. When debugging, note whether log lines show v4 or v6 destinations and whether you need explicit IP-CIDR6 DIRECT lines for local ranges, mirroring what you already do for RFC1918 IPv4 space.

Design outbound groups: one bucket or several for Notion?

Before editing rules, define proxy-groups entries you can aim at. A single group named Notion is enough when the same exit satisfies web, API, and uploads. Two groups—Notion-Web and Notion-API—help when you want different regions for interactive editing versus programmatic calls, or when your automation must stay on a stable egress while you experiment with browser nodes.

Prefer select when you want manual control, url-test or fallback when you want automatic rotation. The nodes must actually complete TLS to Notion endpoints without broken certificate inspection or half-configured IPv6. For scheduling mechanics inside YAML, our proxy groups guide explains selectors, health checks, and nesting without tying the story to a single vendor.

Keep these groups separate from a generic Proxy catch-all so your logs answer a simple question: when Notion failed, did traffic hit the intended policy name? If the answer is no, fix capture or rule order before you chase the fifth node in a list.

Domain rules: conservative matchers and precedence

Clash evaluates rules top to bottom; first match wins. Place LAN exclusions, private ranges, and other high-confidence DIRECT lines before vendor-specific matchers. Then add Notion-related names with DOMAIN for exact hosts and DOMAIN-SUFFIX only when you understand the blast radius—DOMAIN-SUFFIX,notion.so,Notion is simple and broad; it may also route subdomains you did not intend if the vendor later introduces services you wanted on DIRECT.

Developers who run scripts on servers without a browser still benefit from the same idea: your HTTP client resolves api.notion.com; if resolution is poisoned or split-horizon, the TLS handshake never reaches the policy you wrote. That is DNS-first debugging, not “try another exit in the same city.”

YAML skeleton: LAN first, then Notion web, API, and public sites

Assume your profile already defines proxies and a group named Notion. The fragment below is illustrative: adapt names, merge with your provider template, and verify hostnames against your own capture and Notion’s current documentation.

# Local and loopback first (adjust to your network)
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT

# Notion — verify in YOUR logs after vendor updates
DOMAIN,api.notion.com,Notion
DOMAIN,notion.so,Notion
DOMAIN,www.notion.so,Notion
DOMAIN,notion.site,Notion
DOMAIN-SUFFIX,notion.so,Notion
DOMAIN-SUFFIX,notion.site,Notion
DOMAIN-SUFFIX,makenotion.com,Notion

# Remaining traffic follows your profile (GEOIP, MATCH, etc.)
# MATCH,Auto

If you split web and API across two groups, duplicate the DOMAIN lines with different targets—Notion-Web for workspace and public site hosts, Notion-API for api.notion.com—and keep the order consistent with your operational intent. The YAML is not magic; it is a deterministic decision list applied to each connection Clash sees.

RULE-SET workflows for teams

Individuals can maintain a short inline block. Teams often prefer a RULE-SET remote file or internal Git snippet so reviewers can diff changes. Meta-class cores support rule providers; the maintenance challenge is the same as inline YAML—document ownership, pin update intervals thoughtfully, and ensure your personal overrides survive subscription merges. When a provider refresh reorders rules, rerun your short log check instead of assuming “Notion broke.”

Keep machine-readable comments in a separate changelog if your provider strips comments. Humans forget why an edge hostname was added; future you will not remember unless you wrote it down outside the auto-generated blob.

Where hand-written rules beat giant community lists

Community-maintained “AI rulesets” can save time, but they also age unevenly: one contributor’s REJECT line for analytics might block a telemetry hostname your client now requires, or a stale IP-CIDR entry might send traffic to the wrong continent after the vendor renumbers. For Notion, logging first and adding lines beats importing ten thousand lines you cannot explain.

DNS: the hidden half of correct domain rules

Misconfigured DNS makes split routing look “random.” In fake-ip modes, Clash maps domain queries to synthetic addresses internally; that is elegant until a browser uses a different encrypted resolver and caches divergent answers. Symptoms include intermittent TLS failures, endless loading spinners, and “worked until reboot” behavior—exactly the class of issues people describe as sync problems when the editor cannot maintain a coherent session.

Align deliberately. If applications use DNS over HTTPS directly, those queries may bypass assumptions your DOMAIN rules rely on, because the core observes an IP connection without the domain context you expected. Mitigations are practical, not ideological: route known DoH provider hostnames through the same policy as the app, steer DoH to a resolver you control, or accept IP-based classification and document the trade-off. The objective is consistent name-to-policy mapping across the processes you care about.

When the web UI loads but API calls from a terminal fail (or the reverse), compare which resolver each tool uses. IDEs and language runtimes frequently ignore OS proxy settings unless configured; they may still honor HTTP proxies when set, but DNS might be OS-level or library-level. Uniform debugging beats swapping exits blindly.

Poisoned answers, captive portals, and restrictive networks

Not every strange DNS response is malware. Hotels and coffee shops return synthetic answers until you authenticate. Some enterprise filters categorize productivity SaaS inconsistently. If Notion fails only on one physical network, test a phone hotspot before you rewrite YAML. Correlation saves time.

Split DNS versus “one resolver to rule them all”

Power users sometimes configure different upstreams for domestic versus foreign names. That can work well when documented, but it increases cognitive load for family machines. Pick a strategy that matches who operates the computer: a disciplined single-path resolver behind Clash is often easier to support than three parallel experiments fighting each other.

Another subtle failure mode is negative caching: a transient NXDOMAIN or SERVFAIL during a flaky network moment gets cached by an intermediate layer, and every subsequent attempt “proves” the hostname does not exist until a TTL expires. When Notion intermittently fails with name-resolution errors in one application but not another, flush caches methodically—browser, OS stub resolver, and any security product that implements its own mini-DNS—and retest on a clean network before editing Clash.

TLS SNI, ESNI/ECH, and “why my DOMAIN rule did not match”

Most user guides implicitly assume visible SNI hostnames. Encrypted Client Hello and related privacy features change how much a local proxy core can infer without additional configuration. If your client stack enables aggressive privacy modes, you may see more IP-only flows hitting GEOIP or final MATCH lines than you expect. When that happens, either accept broader IP-based policies with documented risk, adjust client settings for controlled debugging, or route known CDN IP ranges with explicit caution. Domain rules express intent about names; if names disappear from the wire, policy must adapt.

When TLS or half-loaded pages point to Mihomo sniffing mis-inference, our Clash Meta sniffing disable and exceptions guide walks through A/B tests and carve-outs without abandoning split routing entirely.

System proxy versus TUN for browsers, desktop clients, and scripts

System proxy mode is usually the gentlest first step on desktops: browsers pick it up, and many GUI clients integrate cleanly. Yet the Notion desktop application may not honor the same environment as Chromium, and terminals running API scripts may not use the same environment variables. TUN mode raises capture rates at the cost of occasional conflicts with other VPN products or corporate agents.

A practical sequence is: confirm Clash loads the profile you think it does; reproduce a minimal Notion action with logs open; if connections never hit the core, escalate capture rather than adding more domain lines. Disable competing full-tunnel VPNs during tests—two layers arguing over routes produces “half the internet works” reports that waste weekends.

Why sync failures love this class of bugs

Sync is the user-visible surface of repeated HTTPS calls, WebSocket-style long polling or streaming channels, and optimistic UI updates. If only part of that graph crosses your proxy, you see partial state: edits appear locally but never commit, or one device updates while another stays stale. Fixing capture often resolves what looked like “Notion AI” failures when the AI panel could not fetch model metadata because a parallel hostname still went DIRECT into a filtered path.

GEOIP CN, bypass rules, and accidental domestic steering

If you use broad GEOIP CN or “bypass mainland” stacks, confirm Notion-related flows are not swallowed by an early DIRECT line that sends TLS to an ISP path your workspace cannot complete. Conversely, if you force too much through proxy, domestic identity or payment flows may break. When domestic sites feel slow after enabling Clash, audit bypass order with our GEOIP CN and bypass checklist—it is written for China-path tuning but the rule-order debugging mindset applies anywhere your profile mixes regional policies.

Verification workflow you can repeat in about a minute

First, confirm the active profile and that local overrides survived any subscription refresh. Second, open logs and run a minimal web test: load notion.so, open a small page, and trigger a trivial edit. Third, if you use Notion AI, invoke a short inline action and watch whether the request shows the expected hostname in logs. Fourth, run a minimal API test from the same machine—curl or a tiny script—to api.notion.com with a safe token in a private environment. Fifth, open a public Notion site on notion.site if you rely on that surface. Sixth, note which rule matched and which outbound group handled each flow. Seventh, only then rotate nodes inside Notion if throughput or loss remains suspect.

When authentication misbehaves, widen the window: account-related hosts might still hit DIRECT because an earlier rule swallowed traffic. When streaming or AI panels stall, check UDP/QUIC paths and MTU before you assume model saturation.

What to record when something regresses

Capture the profile version, core flavor, capture mode, three example destination hostnames from the failure window, and the network type. Browser updates and OS “secure DNS” toggles are frequent silent variables. A short, structured note turns “it broke again” into a solvable diff.

Symptom cookbook: likely causes before you blame Notion

• 401/403 on API calls while the web app works: keys, integration caps, or workspace policy are primary suspects—verify credentials independent of Clash. If only CLI fails, check whether the terminal uses a different proxy or DNS path than the browser.
• Page loads but sync never settles: inspect whether WebSocket-like channels or background hosts are blocked by a premature REJECT or an upstream that strips long-lived connections; compare with a minimal API health check.
• Notion AI errors only in the side panel: treat as both routing and product policy—confirm the workspace allows AI, then verify the same session’s auxiliary requests in logs.
• Timeouts only on one network: correlate with captive portals, IPv6 preference, or carrier-grade NAT; compare hotspot versus office Ethernet.
• Everything fails after a subscription update: diff merge order—provider templates sometimes insert broad GEOIP or early MATCH lines that bypass your Notion block.
• “Works in incognito, fails in normal profile”: suspect extensions that rewrite headers, force alternate resolvers, or inject corporate inspection certificates differently per profile.
• Intermittent TLS handshake errors: check system clock skew, custom root stores on security appliances, and whether a different exit presents a captive portal HTML page instead of a certificate chain.

Use the list as orientation, not scripture. Logs remain authoritative; cookbooks reduce the search space so you do not spiral through unrelated forum threads late at night.

Making overrides survive subscription churn

Most people import remote profiles. Auto-updates can replace rules wholesale. Prefer client features that prepend or append user snippets, or maintain a local merge file you control. After every refresh, rerun the short verification sequence. Treat it like a smoke test for infrastructure you rely on daily.

Performance tuning without fooling yourself

Latency to Notion edges is only one variable. Thermal throttling, aggressive browser extensions, and huge embedded media can mimic network stalls. Before you add a sixth domain guess, close heavy tabs, disable a suspect extension briefly, and retest. Separate application slowness from path slowness; Clash only addresses the latter directly.

Privacy, terms, and realistic expectations

Routing changes path selection; it does not replace compliance with service terms, workplace policies, or regional regulations. Corporate devices may forbid split tunneling. This article assumes you configure a machine you own or legitimately administer.

Open-source transparency matters: upstream repositories are useful for issues and source review. For day-to-day stable access to Notion, Notion AI, and similar tools with a maintained Clash Meta-class client, prefer the site’s download page for installers; treat GitHub as a separate lane from the primary install path, consistent with how we document other productivity and AI guides on this blog.

Putting it together

Reliable Notion sessions and Notion AI features with Clash in 2026 are less about secret host lists and more about a tight loop: observe names in logs, encode them into focused domain rules aimed at dedicated groups, align DNS with capture mode and DoH reality, and prove matches before swapping nodes. Compared with global proxy toggles, that approach keeps unrelated traffic on sensible paths, makes sync and API failures easier to separate, and survives vendor infrastructure churn if you treat lists as living documents—next to our ChatGPT, Gemini, and Claude articles, not instead of them.

When you are ready to install or standardize a maintained client, walk through our Clash tutorial and use our download page as the primary path—Download Clash for free and experience the difference.