在 Clash 客戶端中新增設定時，最容易混淆的往往不是按鈕位置，而是手上的內容究竟屬於哪種格式。訂閱 URL、本機 YAML 設定、單一節點分享連結與代理提供者檔案都可能包含伺服器資訊，但用途、匯入口與更新方式並不相同。將單一節點連結貼到訂閱輸入框，或把網頁網址儲存成 YAML，通常會出現「格式錯誤」、「設定解析失敗」或「找不到代理群組」等提示。

不同圖形客戶端的選單名稱略有差異，常見入口包括「設定」、「訂閱」、「Profiles」或「設定檔」。這些資料最後都要交給 Clash 相容核心解析。了解資料類型後，即使客戶端介面改變，也能判斷應貼上 URL、選取本機檔案，還是先轉換成完整設定。

訂閱 URL、節點連結與 YAML 檔案有什麼差別

訂閱 URL：由遠端服務回傳設定內容

訂閱 URL 通常是以 https:// 開頭的網址。客戶端儲存該網址後，會主動發出網路請求，並將伺服器回傳的內容儲存為遠端設定。之後點選「更新訂閱」，客戶端會再次存取同一網址，以取得節點變更、策略群組調整或規則更新。

網址本身不是設定正文。真正決定能否匯入的是 HTTP 回應內容。一個看似正常的訂閱網址，可能回傳完整 Clash YAML、只含節點的編碼文字、登入頁面、錯誤頁面或一段 JSON。瀏覽器能開啟該 URL，不代表 Clash 核心就能解析它。

https://example.com/api/client/subscribe?token=example-token

訂閱參數通常用於識別帳戶或選擇客戶端格式。複製時應保留完整查詢參數，避免遺漏問號後的內容。若服務頁面提供「Clash」、「Clash Meta」或「Mihomo」專用入口，應優先選擇與目前核心相符的格式，而不是使用通用連結猜測相容性。

單一節點分享連結：只描述一個代理節點

單一節點連結通常以協定名稱開頭，例如 ss://、trojan://、vmess:// 或 vless://。它描述單一節點的伺服器、連接埠、驗證參數與傳輸設定，但通常不包含 Clash 執行所需的完整策略群組、規則與預設出口。

部分客戶端提供「從剪貼簿匯入節點」功能，可以將分享連結轉換成節點項目；其他客戶端則只接受完整設定。此時將單一節點連結貼到訂閱 URL 輸入框不會成功，因為該輸入框預期存取遠端 HTTP 網址。即使節點已完成轉換，仍需將它放入 proxies，再由 proxy-groups 與 rules 加以引用。

本機 YAML：可直接交由核心讀取的設定

YAML 檔案通常以 .yaml 或 .yml 結尾，內容可能包含連接埠、執行模式、節點、代理群組、規則、DNS 與 TUN 設定。完整設定可透過「匯入本機設定」或「開啟設定檔」載入。與遠端訂閱相比，本機檔案不會自動從原始網址更新；修改檔案後通常需要重新載入，或在客戶端內重新整理。

以下是一個最小化的結構示意。實際節點參數應由可靠來源提供，此範例僅用於說明各區塊之間的關係。

mode: rule

proxies:
  - name: Example
    type: ss
    server: 192.0.2.10
    port: 443
    cipher: aes-128-gcm
    password: example-password

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - Example
      - DIRECT

rules:
  - MATCH,PROXY

proxies 定義可連線的節點，proxy-groups 決定使用者可選擇的出口，rules 則將流量交給相應策略。只有 proxies 而沒有可用規則與策略群組時，設定可能通過語法檢查，卻無法依預期完成分流。

在 Clash 客戶端匯入訂閱連結的標準步驟

  1. 確認客戶端使用的核心。

    原版 Clash、Clash Meta 與 mihomo 的基礎設定有很大的相容範圍，但擴充協定、規則類型、DNS 欄位與 TUN 選項並不完全一致。目前常見客戶端多採用 mihomo 核心，匯入時應選擇服務端提供的 Clash Meta 或 mihomo 設定格式。

  2. 複製完整訂閱網址。

    在訂閱管理頁面使用複製按鈕，確認網址前後沒有混入空格、換行或說明文字。不要只複製頁面上被省略顯示的部分，也不要把瀏覽器網址列中的登入頁網址當成訂閱網址。

  3. 進入設定或訂閱頁面。

    找到「新增訂閱」、「從 URL 匯入」或「Download Remote Profile」之類的入口。為設定填寫容易辨識的名稱，再將 URL 放入遠端網址輸入框。若介面同時提供檔案選擇器，應將 YAML 檔案交給檔案匯入口，而不是放進 URL 輸入框。

  4. 執行下載並查看狀態。

    客戶端會存取遠端網址並解析回應。成功後通常能看到設定名稱、更新時間、節點數量或檔案大小。若設定卡片已建立但內容為空，應繼續檢查更新日誌，而不是立即啟用系統代理。

  5. 設為目前設定並選擇策略。

    匯入成功不代表設定已經啟用。需要選取該設定，再到代理頁面選擇策略群組出口。使用規則模式時，流量會根據 rules 分配；使用全域模式時，客戶端通常會將大部分流量交給指定的全域策略。

  6. 最後啟用系統代理或 TUN。

    系統代理適合遵循系統代理設定的應用程式。TUN 模式會透過虛擬網路介面接管更廣泛的流量，通常需要系統權限。首次設定建議先驗證一般系統代理，再依應用程式涵蓋範圍決定是否啟用 TUN。

Clash YAML 常見區塊與格式要求

YAML 依靠縮排表示層級，通常使用空格，不應混入定位字元。冒號後需要保留空格；清單項目以短橫線開頭；包含特殊字元的值可以用引號包住。若編輯器自動替換半形標點，也可能導致解析失敗。

節點與代理群組名稱必須相互對應

策略群組會透過名稱引用節點或其他策略群組。節點名稱從「東京 01」改為「東京主線」後，所有引用舊名稱的位置都要同步修改。否則核心可能提示代理不存在，或在載入設定時拒絕建立策略群組。

proxy-groups:
  - name: AUTO
    type: url-test
    proxies:
      - Tokyo-01
      - Singapore-01
    url: https://www.gstatic.com/generate_204
    interval: 300

select 群組由使用者手動選擇，url-test 群組會依測試結果選擇可用節點，fallback 則著重按照順序切換至可用節點。實際支援情況取決於核心版本與客戶端封裝。測速網址、間隔與容差也會影響自動選擇結果，不應將單次延遲數值視為長期品質結論。

規則依序比對

Clash 規則通常由上而下檢查，命中後便不再繼續。精確網域、網域後綴、IP 網段與規則集應放在符合設定目標的位置，兜底規則通常位於末尾。例如 DOMAIN-SUFFIX,example.com,DIRECT 會將指定網域後綴交給直連策略，MATCH,PROXY 則接收先前未命中的流量。

規則中的策略名稱必須存在於代理群組或內建策略中。若訂閱轉換服務更改了代理群組名稱，卻沒有同步調整規則引用，設定可能會匯入失敗。遇到這類問題時，應同時檢查 proxy-groups 與 rules，而不是只查看節點清單。

代理提供者不是完整訂閱設定

proxy-providers 用於從遠端檔案載入一組節點，再由策略群組透過 use 引用。提供者檔案通常只負責節點集合，不負責整份設定的 DNS、規則與連接埠設定。將 provider 網址直接作為完整設定匯入時，客戶端可能提示缺少必要欄位。

proxy-providers:
  remote-nodes:
    type: http
    url: https://example.com/provider.yaml
    path: ./providers/remote-nodes.yaml
    interval: 3600

proxy-groups:
  - name: PROXY
    type: select
    use:
      - remote-nodes

這裡的遠端檔案由主設定引用。客戶端會先載入主 YAML，再根據其中的 provider 定義下載節點集合。兩層更新機制並不相同：更新主設定不一定會立即更新所有提供者，具體行為取決於客戶端是否提供獨立的 provider 重新整理操作。

訂閱匯入失敗時應依什麼順序檢查

第一步：確認請求是否取得設定

先查看客戶端日誌中的 HTTP 狀態與錯誤類型。401 或 403 狀態碼常見於憑證失效、存取權限變更或請求參數缺失；404 表示路徑可能已經調整；逾時則應檢查目前網路、DNS 解析與系統時間。若回應是 HTML，通常代表網址跳轉到了登入頁、驗證頁或錯誤說明頁。

某些訂閱網址在瀏覽器中依賴登入狀態，但客戶端請求不會自動攜帶瀏覽器工作階段。應從服務的訂閱管理頁面取得專用 URL，不要複製必須先登入才能存取的一般網頁網址。

第二步：辨識回傳內容的格式

完整 Clash YAML 通常可以看到 proxies、proxy-groups、rules 等欄位。若只有一大段編碼文字，回傳內容可能是為其他客戶端提供；若只有多個協定連結，則更接近節點集合。此時應在服務頁面切換輸出格式，或使用客戶端明確支援的匯入方式。

檔案副檔名無法可靠說明回應類型。URL 末尾可能沒有 .yaml，但伺服器仍會回傳 YAML；反過來，帶有 YAML 字樣的網址也可能因授權失敗而回傳網頁。應以實際回應與日誌為準。

第三步：找出 YAML 語法與欄位錯誤

若日誌提供行號與欄號，應先檢查對應位置附近的縮排、冒號、引號與清單結構。錯誤來源有時位於提示行之前，例如上一行的引號沒有閉合，解析器直到下一行才發現異常。修改設定前請保留原始副本，逐項調整比一次刪除大段內容更容易找出原因。

「不支援此欄位」通常與核心差異有關。設定可能使用 mihomo 擴充規則、較新的協定欄位或更新後的 DNS 結構，而目前客戶端核心版本較舊。解決方向是更新相容客戶端、選擇相應的訂閱格式，或依目前核心文件調整欄位，不宜隨意刪除不認識的設定項目後直接執行。

第四步：檢查設定之間是否互相覆寫

部分客戶端會將訂閱設定、全域覆寫、混入設定與腳本處理分成不同層級。遠端 YAML 本身正確，但本機覆寫加入了重複連接埠、錯誤代理群組或舊版 DNS 欄位，也會導致最終設定無法啟動。排查時可以暫時停用覆寫功能，先確認原始訂閱能夠單獨載入，再逐一恢復自訂項目。

如果匯入成功卻無法連線，還應區分「設定解析問題」與「連線問題」。前者通常在載入階段就會出現明確錯誤；後者可能表現為節點逾時、網域解析失敗、系統代理未啟用，或 TUN 路由未正確建立。先確認日誌發生在哪個階段，可以避免反覆刪除並重新匯入同一份訂閱。

訂閱更新、設定儲存與遷移注意事項

遠端訂閱適合持續接收節點與規則變更，但本機直接編輯的內容可能在下次更新時被覆蓋。需要保留的自訂規則，建議放入客戶端提供的覆寫、合併設定或腳本處理功能中；如果客戶端沒有相應功能，可以維護獨立的本機 YAML，並手動更新其中的節點來源。

訂閱 URL 往往包含存取憑證，應像帳戶金鑰一樣妥善保存。截圖、日誌或求助內容中應遮蔽查詢參數，避免將完整網址發布到公開頁面。更換裝置時，可以在新裝置上重新複製訂閱，不要透過公開聊天記錄傳遞網址。

從一個 Clash 客戶端遷移到另一個客戶端時，先確認目標客戶端採用的核心與設定目錄規則。基礎 YAML 通常可以沿用，但圖形客戶端儲存的訂閱清單、策略選擇、覆寫腳本與 TUN 權限屬於客戶端狀態，不一定包含在 YAML 中。遷移後應重新選取目前設定、檢查策略群組，並重新授權系統代理或虛擬網路介面。

訂閱更新頻率也不宜設定得過短。節點提供者與主設定通常已定義合理的更新時間；頻繁請求不僅難以帶來實際改善，還可能觸發遠端存取限制。日常使用可依服務建議更新，發現節點清單明顯變化、設定提示過期或規則需要重新整理時，再手動執行一次更新。

快速判斷：手上的內容應該放在哪裡

  • 以 HTTPS 開頭，並由訂閱管理頁面提供：優先放入「從 URL 匯入」或「遠端設定」入口。
  • 以協定名稱開頭的單行文字：使用客戶端的節點匯入功能，或轉換後寫入完整 YAML。
  • 電腦或手機中已有的 .yaml、.yml 檔案：使用本機檔案匯入，不要將檔案路徑填入線上訂閱欄位。
  • 只包含節點清單的 provider 檔案：由主設定中的 proxy-providers 引用，不能直接取代完整執行設定。
  • 開啟後顯示網頁、登入提示或錯誤說明：回傳內容不是可直接解析的 Clash 設定，應重新取得專用訂閱網址。
  • 可以匯入，但代理頁沒有策略群組：檢查設定是否只有節點、策略群組是否正確引用，以及目前設定是否已啟用。

Clash 訂閱匯入的重點不是反覆嘗試不同按鈕，而是先辨識輸入格式，再確認客戶端核心與設定內容相符。訂閱 URL 負責遠端更新，YAML 用於描述完整執行結構，單一節點連結只提供一個連線項目，proxy provider 則是由主設定管理的節點來源。依照「請求結果、內容格式、YAML 結構、核心相容性、執行狀態」的順序排查，大多數匯入問題都能準確定位。