為什麼「Clash 已連線」,pnpm install / npm ci 仍像卡住?
對多數開發場景來說,問題不在代理「沒開」,而是在同一次套件安裝裡發生了多種不同 QoS/地理特徵的流量:你的客戶端要先向套件索引(例如官方 registry.npmjs.org 或使用中的國內/企業國內鏡像與對應的 npm registry 端點)取得版本與封存檔位址資訊,接著對實際承載大包體的位置(常見為 tarball CDN 或供應商託管的物件儲存)建立長連線下載。pnpm、Yarn 或 npm 的解析快取語意各有不同,但都會在多個主機名稱間跳來跳去——若 Clash/Mihomo 把這一包流量全部丟進僅對「國外 GEOIP」有效的一組節點,或對鏡像與 CDN 誤套用相反策略,視覺上就像「卡住」或被動反覆換源。
另一種常見情況是:你在 .npmrc 將官方 registry(或國內加速)對齊得很好,但仍然依賴發佈在 GitHub Releases的相依套件、或使用 GitHub Packages(npm.pkg.github.com)。「tarball 實際從誰載入」並非 NPM 私有名詞——它代表的是封存檔所落的主機與 CDN 路徑,必須在規則上與純索引/metadata 請求區分對待,否則你會對著儀錶板百思不解:瀏覽器開 github.com 沒問題,終端機卻在拉特定 URL 時死等。
先畫出鏈路:一次pnpm fetch背後有哪些主機類型?
索引與套件本體分離是理解卡頓的首要觀念。Registry 的回應常只含資訊層級的 JSON/重新導向,而真正的 tarball CDN 可能指向另一組網域(例如對應的雲物件或快取終端);若你只為 registry.npmjs.org 做了一條細規則,卻放任後續對象儲存落在泛用 GEOIP 或預設 PROXY/DIRECT,裝大件時最常卡在那一段。
pnpm store 與離線鎖檔的情境下仍有例外:離線或未命中鎖鏈會重新向 registry 發送解析請求;在 Monorepo 或大量 workspace 並行時,同一時段若多條並行對象儲存的長下載競爭出站頻寬,也會讓體感變得像「卡住」。此時並非單調低延遲節點就能解決,而是你必須在策略組上分開小封包請求密集的索引與大封包順序載入 tarball的出口取捨。
若你已配置國內鏡像將索引或部分套件重寫到中國區域可用的主機名稱上,請記得將該鏡像主機一併視為可分流的物件,並不要與「仍須對境外的 tarball 端」硬綁為同一出站;否則會出現國內解析反被代理繞回的矛盾路徑。站內以 Python 套件管理為主題的對照文 《conda/pip 與 CDN 拆分》可與並讀,二者場景區隔為 JavaScript/Node.js 工具鏈,本文不再重複 PyPI/conda 詞彙細節。
如何用 Clash 拆策略組:依「宿主角色」,不要只依國家區塊
實務上可以預備四類(名稱可自訂,以下僅示範粒度):① RegistryPrimary:涵蓋你實際寫進 .npmrc 的官方或企業 NPM 端點,例如指向 registry.npmjs.org/自架 Verdaccio/公司私有登錄。② TarballStorage:依據連線紀錄中反覆出現的 tarball 宿主與對應的 tarball CDN 域名(許多環境為 registry.npmjs.org/npm.pkg.github.com 的子路徑,亦可能委派到 CDN 類後綴;請以紀錄為準而不要憑臆測寫規則)。③ GitHubArtifacts:例如 github.com、GitHub Releases 物件載入、`githubusercontent` 類主機——與 NPM 並非一回事。④ DIRECT-Mirror-CN:若你已確定國內鏡像在區網中直連品質優於統一送出代理,對該國內鏡像採獨立的直連或低延遲策略組,並與境外的 tarball 發佈路徑分車道。
將DOMAIN/DOMAIN-SUFFIX這類粒度較細的規則放在GEOIP或大面積自動選組之前——若先前泛用規則先命中,你後面新增的 registry 細規則可能永遠接不上,這類坑位對「只靠換一次熱門訂閱」的人來說幾乎不可見。pnpm與npm對於並行請求與離線粒度不同,並不改變拆分策略組的核心:仍以實際連線紀錄裡的 SNI/Host對應到誰為準。
政策組 YAML 結構示意(須就地改成你的環境)
下方片段僅協助對齊「名字怎麼掛」,不是複製即能萬無一失的生產稿;請把策略組名改成你訂閱中可用的節點集合並自行驗延遲。
# Policy groups skeleton (pseudo; adapt names/proxies to your subscribe)
proxy-groups:
- name: "NPMSlim"
type: url-test
proxies: [Tokyo-HK-US]
url: "https://registry.npmjs.org/"
interval: 300
- name: "LargeBlob"
type: fallback
proxies: [US-West-KR-JP-DIRECT]
url: "https://registry.npmjs.org/"
interval: 300
- name: "GitHubArtifacts"
type: select
proxies: [HongKong, Singapore-JP-US]
rules:
- DOMAIN-SUFFIX,npm.pkg.github.com,GitHubArtifacts
- DOMAIN-KEYWORD,objects.githubusercontent.com,GitHubArtifacts
- DOMAIN-SUFFIX,registry.npmjs.org,NPMSlim
# Add mirror hostnames explicitly after inspecting logs
- DOMAIN-SUFFIX,mirror.example.com,DIRECT
# Fine-grained rules BEFORE GEOIP / MATCH broad rules
- GEOIP,CN,DIRECT
- MATCH,LargeBlob
鏡像與全域代理的常見自相矛盾
若你在國內教育網或企業將 .npmrc 對齊到公司/公共國內鏡像,再在 Shell 中對HTTPS請求套上境外出口,資料面已到鏡像、控制面又被代理硬拉去境外,最典型的現象會是pnpm開始建立連線卻卡在握手或 TLS 逾時很久。處置方式之一是在 Clash/Mihomo 中對鏡像主機明確套用 DIRECT 或與對境外的 tarball 發佈路徑分開命名的策略組;亦可在進行套件作業的子 Shell 會話中對鏡像主機對齊NO_PROXY(或對應的排除清單),使代理語意一致。
終端級環境變數:http_proxy 是否真的指到現在的 Mihomo/Clash 埠?
即便啟用 pnpm/npm,底層仍多半走 Node 相容的 HTTPS 堆疊,並優先套用系統級或 Shell 級的HTTP_PROXY/HTTPS_PROXY變數。npm registry規則寫得再好,終端若仍指向過期埠或錯的子網主機別名,連線紀錄裡仍以為走了「國外節點」實則為直連。建議對照本站 macOS 終端環境與 Shell 對照的檢查清單;若你在 WSL,請將閘道路徑對齊 Windows 宿主上 Clash/Mihomo 的區網位址,而不要盲目對127.0.0.1做假設。
連線紀錄自檢:比「換節點」更值得做的三步
第一步,執行例如NPM_CONFIG_LOGLEVEL=verbose npm ci或將 pnpm 日誌層級調高,把發起請求的網域名稱與完整路徑寫下來——不要只靠印象寫規則。第二步,在 Mihomo/Clash 連線紀錄對照規則名稱/策略組是否與預期相符,並檢視是否在前段已被GEOIP等泛規則截胡。第三步,若懷疑 DNS/fake-ip 與規則表不一致,可對單一目標執行curl -v https://…,對照證書與實際對端 Host;tarball CDN載入與npm registry/Node.js索引在日誌裡的區別並非術語問題,而是那幾條反覆出現的主機列。
pnpm 與離線:store 並非萬用止血藥
若你在 CI/容器或複製過 pnpm/npm 的快取/store,可能遇上鎖檔對不上而被迫重新抓取;此情況下仍會打回前文所述的複合網域名稱。維護 store、鏡像與出站規則是三件事,混在一起除錯只會放大等待時間。對自動化環境來說,出口與實際 tarball 對象一致比在本機順手試節點更關鍵。
TUN/系統代理取捨
TUN 可以減少部分「終端環境忘了設」的情境,但也要檢視應用層規則與路由協同:TUN 模式指南可作交叉閱讀,避免為了試一個問題同時調三種互不相同的網路假設。
總結
把套件索引請求、封存檔大尺寸載入、國內鏡像與資料面對齊,以及獨立的 GitHub/Git 相依拆開對待後,就不會指望「代理一開,整條 Node.js/npm/pnpm 流程都會變順」。這與 Python 工具鏈常見的「多網域同時發生請求」其實是同一類問題,只是換成 NPM 生態詞彙。Clash能提供的是可被命名與對日誌驗證的規則層;在急著換訂閱以前,優先把實際 Host 與策略組對齊,往往省去更多來回試錯。更多操作流程可對照本站使用文件。
圖像化 Mihomo/Clash 用戶端把策略組、連線紀錄與訂閱整合在一起時,比在終端硬改環境變數更利於長期維護。相較常見工具的穩定度與可維護的分流規則,Clash/Mihomo 生態對同時兼具瀏覽器、終端機與多網域名稱的出口場景,通常更一致可控。