一、先分清訂閱網址與訂閱內容

匯入 Clash 訂閱時,最容易混淆的是「從哪裡取得」和「取得的內容是什麼」。URL 是遠端資源的網址,Base64 是文字編碼方式,YAML 則是設定檔使用的資料格式。三者並非同一層級的選項:同一個 HTTPS 訂閱網址,回傳內容可能是 YAML,也可能是經過 Base64 編碼的節點清單。

因此,能複製網址不代表內容一定適用於目前的用戶端;檔名以 .yaml 結尾,也不能證明伺服器實際回傳的是設定檔。判斷相容性時,必須一併檢查訂閱入口、回應內容和用戶端使用的核心。

項目 常見判別特徵 匯入時代表的意義
訂閱 URL 通常以 https:// 開頭,可能包含路徑與查詢參數 用戶端透過網址取得設定,並可保留網址以便更新
Base64 文字 通常是較長的英文字母、數字與符號組合,結尾可能有等號 需先確認解碼結果;節點 URI 清單通常需要轉換,或由支援此格式的匯入功能處理
YAML 設定檔 常見欄位包括 proxies:、proxy-groups:、rules: 欄位、通訊協定與引用方式都相容時,才能作為設定檔使用

二、複製、匯入訂閱連結並首次啟用

1. 從服務提供者選擇適用的設定入口

在訂閱服務提供者的帳戶頁面,尋找標示為「Clash」或與目前核心相符的訂閱入口。若頁面區分通用訂閱、Clash 設定和 mihomo 設定,請依用戶端實際使用的核心選擇。mihomo 是 Clash Meta 後續採用的核心名稱,部分擴充通訊協定與欄位需要相應支援;介面看起來相似,不代表設定能力完全相同。

  • 複製完整的 HTTPS 網址,保留 ? 後方的查詢參數,以及以 & 分隔的各項參數。
  • 不要複製帳戶管理頁、付款頁或分享說明頁的網址,這些頁面通常會回傳 HTML。
  • 透過通訊軟體轉傳後,請檢查網址末尾是否多出句號、引號或換行,避免把正文標點一併匯入。
  • 不要自行刪除看似隨機的權杖欄位;伺服器可能靠它辨識訂閱權限。

2. 在設定管理頁貼上 URL

各用戶端的選單名稱可能不同。常見操作路徑包括「設定」→「新增」→「遠端」,或「訂閱」→「新增訂閱」→「URL」。在網址欄貼上連結、為設定命名,再執行下載或匯入。如果介面只有「從檔案匯入」,該入口讀取的是本機檔案,不應將 URL 當成檔案路徑輸入。

  1. 先保留現有可用的設定,不要在首次匯入時刪除舊項目。
  2. 將新設定命名為「日常訂閱-主要」等容易辨識的名稱,避免多筆項目都叫「預設」。
  3. 等待下載與解析完成,確認結果顯示成功,不要只看清單是否多了一筆。
  4. 選取並啟用這份設定;「已新增」和「正在使用」是兩種不同狀態。
  5. 前往策略組頁面,確認出現預期的群組名稱與節點,再選擇一個出口進行連線測試。

系統代理與 TUN 是接管流量的方式,無法將訂閱轉換成可用設定。初次排查時,先確認設定已載入且策略組可見,再處理系統代理或 TUN,可以減少變因。連接埠也應以用戶端實際顯示為準,不要因為範例常見 7890,就認定所有安裝都使用這個連接埠。

三、為什麼 Base64 訂閱不能直接當成 YAML 使用

通用訂閱常會將多行節點 URI 編碼成一段 Base64 文字。解碼後可能會看到以 ss://、vmess:// 或 trojan:// 開頭的行。這些行描述節點連線參數,不會自然包含 Clash 所需的策略組、規則順序和 DNS 設定。

部分用戶端提供節點匯入或訂閱轉換功能,但這是用戶端的附加功能,不能據此推論所有 Clash 設定入口都支援。將整段 Base64 文字另存為 config.yaml,只會更改檔名,不會讓內容變成 YAML。

優先使用原生輸出,再考慮轉換

  1. 先回到服務提供者的頁面,尋找可直接回傳 Clash YAML 的入口。
  2. 若只有通用訂閱,請查閱目前用戶端是否明確支援該格式,以及支援哪些通訊協定。
  3. 確實需要轉換時,優先使用服務提供者提供的功能或可信任的本機工具,並檢查產生結果中的節點、策略組與規則。
  4. 轉換完成後,請保留來源說明。如果只匯入一次本機檔案,之後遠端節點有變動,通常不會自動同步至該檔案。

四、YAML 設定:完整設定檔與節點提供者檔案

YAML 只是語法格式,檔案內容仍須符合使用位置所要求的結構。完整設定檔可以包含監聽連接埠、節點、策略組、規則與 DNS;供 proxy-providers 使用的節點檔案通常只提供節點資料,不能直接視為已設定好分流策略的 Profile。

以下是用來理解結構的最精簡直連設定。它不包含遠端代理節點,不能取代訂閱;啟用後,規則會將連線交給 DIRECT。其中 mixed-port: 7890 表示同一個監聽連接埠可接受 HTTP 與 SOCKS 代理連線,實際使用前請確認該連接埠未被其他程式占用。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxies: []

proxy-groups:
  - name: 手動選擇
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,手動選擇

檢查設定時,請特別留意三處

  • 節點來源:可在 proxies 中直接定義節點,或透過 proxy-providers 引入節點。看不到內嵌節點不一定表示設定是空的,也要檢查提供者是否載入成功。
  • 策略組引用:群組中的節點名稱、其他群組名稱或提供者引用都必須存在。名稱變更後,舊引用可能會失效。
  • 規則目標:rules 的目標必須能解析為有效策略。範例中的「手動選擇」必須與群組名稱完全一致;修改其中一處時,也要檢查另一處。

編輯 YAML 時請使用空格縮排,不要使用 Tab。密碼、特殊字元和含有冒號的字串都應依 YAML 語法正確加上引號。若設定來自遠端訂閱,直接修改下載的檔案可能會在下次更新時遭到覆寫;若要保留修改,請使用用戶端明確支援的覆寫、合併或擴充機制,並確認其生效順序。

五、訂閱更新:遠端項目、本機檔案與覆寫範圍

遠端訂閱項目通常會保留 URL,更新時再重新請求內容;從本機匯入的 YAML 通常只是一次性的檔案快照。是否支援監看檔案或自動重新整理,取決於用戶端的實作方式。兩者看起來都會出現在設定清單中,但更新來源不同。

首次匯入後,先手動更新一次

在目前項目的選單中尋找「更新」或「重新整理」,查看更新時間是否改變,並確認更新結果。若用戶端支援定期更新,可以先設定為每 24 小時更新一次,再依服務提供者的說明調整。間隔單位可能是分鐘、小時或秒,請留意輸入欄位的標示;頻繁請求可能觸發伺服器的速率限制。

  • 更新成功但節點沒有變化:伺服器可能仍回傳相同內容,也可能是目前啟用的是另一份設定。請先核對目前的 Profile 名稱。
  • 訂閱已更新,但提供者仍回報錯誤:主要設定的下載與 proxy-providers 遠端節點的下載是兩個不同環節,請分別檢查。
  • 本機規則消失:遠端更新可能會覆寫原始檔案。長期維護的規則應放進受支援的覆寫設定,不要一再修改訂閱內容。
  • 更新網址變更:服務提供者重設權杖後,舊網址可能失效。請替換已儲存的 URL,而不是只是不斷按重新整理。

下載訂閱時是否會經過代理,也取決於用戶端的實作和相關設定。若遇到「必須先連線才能更新」的循環,可先切回舊的可用設定,再更新新項目;不要只為了取得訂閱就同時重設系統代理、DNS 和 TUN。

六、匯入後看不到節點:依序檢查請求、格式與載入流程

「看不到節點」可能發生在下載之前,也可能出現在解析或顯示階段。先保留完整錯誤訊息,再依下表逐步縮小範圍,比反覆重新安裝更有效。日誌若包含網址參數、節點憑證或帳戶識別資訊,分享前請先遮蔽。

現象或日誌訊息 優先檢查項目 下一步
HTTP 401 或 403 權杖、帳戶權限、存取政策 回到服務提供者頁面重新複製訂閱,確認訂閱仍有效且符合用戶端的請求要求
HTTP 429 更新頻率與請求限制 暫停連續重新整理,依伺服器提示等待後再提出請求
回應為 200,但內容以 HTML 開頭 登入頁、錯誤頁或存取驗證頁面 改用真正的訂閱入口;200 只表示請求收到回應,不代表內容可用
YAML 解析失敗 回應格式、縮排及錯誤行附近的欄位 確認下載內容是 YAML,而不是 Base64、JSON 錯誤訊息或網頁
提示不支援的節點類型 通訊協定與目前核心的支援能力 選擇與核心相符的訂閱輸出,或依用戶端文件更新核心
設定載入成功,但清單中只有 DIRECT 提供者下載、節點篩選與策略組引用 檢查提供者狀態和篩選條件,再確認目前啟用的設定

不要把「測試逾時」直接當成「匯入失敗」

節點已顯示,但延遲測試逾時,表示問題通常已進入連線測試階段。測試 URL 無法連線、節點驗證失敗、網路阻擋或 DNS 異常,都可能造成逾時。此時應檢查具體的連線日誌,而不是把原本正常的 YAML 再轉成另一種格式。

反過來說,設定卡片顯示「新增成功」,也不代表核心已接受設定。有些介面會先儲存項目,再執行下載或切換。最後應一併確認:下載成功、核心載入成功、目前設定已選取,而且策略組引用有效。

七、匯入完成後的檢查清單

  • 確認訂閱來源明確、URL 完整,且權杖沒有出現在公開截圖或筆記中。
  • 確認回應內容符合目前入口的要求,並已分清完整 YAML、節點提供者檔案與 Base64 節點清單。
  • 確認目前啟用的 Profile 正確,且策略組中可看到預期節點或已成功載入的提供者。
  • 至少成功手動更新一次,並確認自動更新間隔的單位與用戶端顯示一致。
  • 為本機規則另行備份,並確認訂閱更新是否會覆寫修改。
  • 連線測試失敗時,記下具體錯誤,依序處理設定載入、節點連線和流量接管問題。

之後若要設定系統代理、規則模式或 TUN,可繼續閱讀Clash 使用指南;若要了解節點、策略組與規則之間的引用關係,請參閱進階設定。先確認訂閱格式與更新流程,再調整流量接管設定,排查方向會更明確。