Hugging Face 下模型或 LFS 總卡住?Clash 分流 hf 網域與節點實測(2026)

為什麼 Hub 能開、下載卻常「斷在 LFS 或大檔」?

許多人在本機用 git clonehuggingface-cli 或各框架的「從 Hub 快取權重」功能拉模型時,網頁介面能正常瀏覽 huggingface.co,命令列卻在大檔下載、Git LFS 轉診、或續傳重試附近原地打轉。這不一定代表 Hub 當日故障,而較常是流量路徑不一致:HTML 與小圖走了一條出口,實際承載幾百 MB 權重或 LFS 物件的 CDN、物件儲存或 LFS 閘道,被另一條寬鬆規則提前帶去 DIRECT 或品質不穩的節點,導致 TLS 重疊、Range 續傳打斷、或體感像「進度條卡死」。

Clash/Mihomo 在這裡要解的不是「幫你加速寬頻」,而是把 Hugging Face 相關主機名變成可排序、可觀測、可與日誌對照的規則與策略群組:先確認每次失敗時實際連線的 Host 是誰,再決定是補 DOMAIN-SUFFIX、調 DNS,還是單純把下載專用群組從 url-test 改成手動固定節點。

若您仍在匯入訂閱與核對節點顯示名稱,建議先完成 訂閱匯入教學,再回來微調規則,避免策略群組引用到不存在的代理名稱而整條鏈失效。

合規提醒:Clash 為本機網路轉送與設定管理軟體,不提供遠端節點。請在合法合規前提下使用自有或授權的服務,並遵守 Hub、Git LFS 及下游儲存供應商之使用條款與授權。

和 OpenRouter、Cursor 專文有什麼不同?

站內另有多篇從 聚合 API、雲端補全、或 IDE 擴充市集切入的分流文(例如 OpenRouter 逾時與 openrouter.aiCursor IDE 網域),偏重短連線或長文字串流的 HTTPS API。本篇則是模型倉庫與檔案分發huggingface.cohf.coGit LFS 批次與 cdn-lfs 類主機、以及下載當下日誌裡出現的第三方儲存或 CDN 網域

兩邊的主機清單不可互相替代。若把 Hub 下載全塞進與雲端 IDE 共用的寬鬆關鍵字規則,容易讓除錯更混亂;反過來只配 API 端點,也不會自動覆蓋幾十 GB 的 LFS 物件路徑。實務上請以出錯當下 Clash 日誌裡的 SNI 或 Host為準,把本篇當成「起手心智地圖」而非永久固定表。

應該分流哪些主機?

下列分類是2026 年常見的規則設計心智地圖;Hub 前後端、儲存與合作 CDN 可能調整,唯一可靠補法是搭配應用程式日誌與 Clash 連線紀錄,補上仍落在 DIRECT 的單一 DOMAIN

核心網站與短網址

  • huggingface.co:網頁、API、帳戶相關請求多數可由此後綴覆蓋。建議寫一條 DOMAIN-SUFFIX,huggingface.co,HF_HUB 置於寬鬆 RULE-SET 之前(名稱可自訂,下列同)。
  • hf.co:官方短網址與多數分享連結會導向此域;與上列是不同後綴,需兩行後綴規則一併處理,否則短連結一類請求可能仍被更早的規則帶走。

Git LFS、大檔與「cdn-lfs」語意

git lfshuggingface-cli 下載大檔時,實際 TCP 目標常不是上列主站,而是 LFS 閘道、CAS 或 CDN 子網域;日誌裡可能出現帶有 cdn-lfs 語意或區域化主機名。這些名稱會變、且因帳戶地區與重定向而異,不建議在不明狀況下用超寬鬆的 DOMAIN-KEYWORD 一把抓(容易誤傷無關站點)。

較穩的做法是:先讓一輪下載失敗在可控環境中發生,在 Clash 日誌中蒐集實際 Host,再回頭補 DOMAIN-SUFFIX 或單一 DOMAIN 規則,並讓它們同樣命中 HF_HUB 群組,使同一檔案的所有分段/續傳都走相同出口

第三方儲存與雲廠商

少數專案或歷史資產的 LFS 後端,可能出現公眾雲的物件儲存或特定 CDN 主機名。若日誌顯示為顯然屬下載行為的 Host,可兩條路並行:一為HF_HUB 內用同一條穩定出口(透過自訂規則讓該 DOMAIN 也進 HF_HUB);二為若該主機也服務非 Hub 內容,則審慎使用後綴規則,避免過度寬鬆。整體分流哲學可對照 規則分流深度文中「具體規則置前、GEOIP 兜底」的排序思維。

DNS、fake-ip 與多解析器

enhanced-mode: fake-ip 下,部分工具若同時啟用系統安全 DNS、瀏覽器 DoH、或容器內獨立 resolv,可能讓少數 LFS 或下載庫的解析繞過本機,使得規則「看起來命中了、實際連線卻從另一條路出去」。下載大檔時這種「分裂路徑」體感特別明顯,因為 Range 請求與多段重試對出口一致性更敏感。

實作上建議與其他分流文一致:先把「誰在解析、誰在連線」對齊到同一條觀測路徑,必要時暫時關閉非 Clash 的 DoH 做 A/B;若使用 TUN 模式,再分開驗證「流量有沒有進入核心」與「進入後由哪條規則命中」,避免跨層除錯。

規則順序:為什麼「寫了 hf 仍像沒寫」?

mode: rule 下,rules:上而下比對、命中即停。因此 Hugging Face 相關規則必須出現在任何會提前結束的寬鬆 GEOIP、巨大 RULE-SET 或關鍵字規則之前;否則您新增的 DOMAIN-SUFFIX,hf.co,HF_HUB 可能從未輪到。若您從訂閱彙入規則,也請確認自訂片段在合併後的實際插入點,而不是假設「寫在檔案最底下就一定生效」。

節點選擇:下載不適合瘋狂 url-test

大檔下載與 LFS 轉診往往牽涉長時間、多分段的 TLS 連線。若 HF_HUB 內是高頻切換的測速群組,上一下連到節點 A、續傳階段又漂到 B,用戶端體感就像「斷在 37% 不動」或重複從零開始。較穩的作法是:在 HF_HUB 內先用 select手動固定一個延遲與丟包都可接受的節點,跑完一輪完整下載,再考慮是否改回有節制間隔的 url-test 做備援。

可照抄的規則清單骨架(請以日誌補齊)

下列為教學用骨架,實際環境可能需依日誌增刪單一 DOMAIN。優先精準的後綴與主機,避免超寬 DOMAIN-KEYWORD

  • DOMAIN-SUFFIX,huggingface.co,HF_HUB
  • DOMAIN-SUFFIX,hf.co,HF_HUB
  • 依日誌補上:當下重現下載失敗時出現的 LFS、CDN 或 cdn-lfs 相關子網域,同一策略群組收斂。

YAML 範例:插入位置與命名

下列骨架示範在寬鬆 RULE-SETGEOIPMATCH 之前插入;節點顯示名稱須改為訂閱內實際值,未審核前勿當生產環境一鍵貼上:

YAMLproxy-groups:
  - name: "HF_HUB"
    type: select
    proxies:
      - "HF_STABLE"
      - "Your-Node-For-Large-Files"
      - DIRECT
  - name: "HF_STABLE"
    type: url-test
    proxies:
      # Replace with your subscription names
    url: "https://www.gstatic.com/generate_204"
    interval: 300

rules:
  - DOMAIN-SUFFIX,lan,DIRECT
  - DOMAIN-SUFFIX,local,DIRECT
  # Hugging Face — place BEFORE broad RULE-SET / MATCH
  - DOMAIN-SUFFIX,huggingface.co,HF_HUB
  - DOMAIN-SUFFIX,hf.co,HF_HUB
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

重點仍是:寬鬆集合若位於此段之前,您新增的 DOMAIN-SUFFIX 可能永遠輪不到。此時需改在訂閱合併後的「自訂規則區」前插,或調整前端的覆寫行為。

驗證順序:建議照這樣做

  1. 確認模式:客戶端為 Rule,系統代理或 TUN 已正確啟用。
  2. 用最小可重現例:選一個已知含 LFS 的較小專案,讓下載在可控時間內完成或失敗,便於讀日誌。
  3. 固定節點:在 HF_HUB 內改單一節點,排除 url-test 切換造成的續傳斷裂。
  4. 比對主機:從日誌記下實際 Host 清單,與 DOMAIN-SUFFIX 是否一致,補齊遺漏。
  5. 分開測「網頁」與「CLI」:瀏覽器能開不代表 git/CLI 與庫內下載同出口。
  6. 抽查 DNS:暫關非 Clash 的 DoH 做對照,確認沒有解析繞徑導致規則分裂。

常見踩坑

  • 只配主站、忘記短網域 hf.co:分享連結與重定向常只命中其中一邊出口。
  • 以為一條關鍵字能吃下所有大檔:實務上 CDN 子網域眾多,還是日誌導向補列較穩健。
  • 下載到一半狂換節點:續傳與 LFS 批次對長連線敏感,測速群當下載主路徑易出事。
  • 與雲端 IDE/API 分流主機表混用:情境不同、主機不同;請分篇維護以免除錯混亂。

安全提醒:請勿使用來路不明的訂閱與「一鍵全代理」式規則,其可能導向惡意節點。訂閱連結等同憑證,請勿公開分享。

結語

在開源模型仍高度依賴 Hugging Face Hub 的 2026 年,與其反覆重試卻不查日誌,不如先把 huggingface.cohf.co 與實際 LFS/下載所見主機收斂到可觀測的策略路徑,讓大檔、LFS 與 CDN 分段一貫走同一出口。當 DOMAIN-SUFFIX 置前、HF_HUB 與 DNS 設定一致時,多數「網站能開、下載卻不動」的狀況會明顯好轉。

相較拼湊多種小工具,在同一套 Clash 規則語意下管理桌面用戶端,長期維護成本通常更低;若您尚未安裝,可先從本站下載頁取得對應平台用戶端,並搭配 教學文件完成基礎設定。

當 Hub、LFS 與 CDN 路徑都落在同一條可預測的代理策略上,模型權重與資料集大檔的拉取會穩定許多。若希望先安裝再逐步補列規則,可前往本站下載頁取得最新用戶端。→ 立即免費下載 Clash,開啟流暢上網新體驗