Clash 訂閱連結匯入教學：網址格式、設定更新與匯入失敗排查

PROFILE INPUT

訂閱連結、節點連結與 YAML 設定檔不是同一種輸入

Clash 用戶端需要讀取一份設定，內容通常包含代理節點、代理群組、分流規則、DNS 參數與執行選項。取得的「訂閱」可能是一個遠端網址，也可能是已下載到本機的 YAML 檔案。兩者目的相同，但匯入方式、更新方式與錯誤表現並不完全一致。

訂閱連結通常以 https:// 開頭。用戶端存取該網址後，伺服器會回傳可辨識的設定內容。網址本身只是入口，不代表在瀏覽器中一定會顯示格式整齊的文字；有些介面會直接觸發下載，有些會回傳經過編碼的節點清單，另一些則會依請求資訊輸出適用於 Clash 或 mihomo 核心的 YAML 設定。

單一節點連結通常以特定協定名稱開頭，一條連結一般只描述一個節點。將單一節點連結貼到「訂閱網址」輸入框，不代表用戶端一定能將其當作完整設定讀取。完整設定除了節點，還需要代理群組與規則等結構。部分用戶端提供單節點匯入功能，但應將該入口與設定訂閱入口分開判斷。

本機 YAML 檔案是已產生的設定快照，適合離線檢查與手動編輯，但不會隨遠端訂閱變更而自動同步。若用戶端同時儲存遠端訂閱與本機副本，更新操作通常只會套用於遠端設定項目，不會自動覆寫另行匯入的本機檔案。

URL FORMAT

訂閱網址格式與複製檢查

可供用戶端直接請求的訂閱網址，應包含完整協定、網域、路徑，以及伺服器要求的查詢參數。常見結構可抽象成以下形式：

https://config.example.net/api/profile?token=example-token&format=clash

其中，協定決定連線方式，網域與路徑用於定位訂閱介面，問號後的參數則用來傳遞存取憑證或指定輸出格式。實際網址中的參數名稱由訂閱提供者定義，不應自行改寫。有些網址很長，是因為憑證、裝置資訊或輸出選項經過 URL 編碼；網址長度本身不能用來判斷是否有效。

複製時最常見的問題包括漏掉結尾字元、混入換行、連同聊天軟體顯示的省略號一起複製，或只複製到問號之前。應使用「複製連結網址」功能取得原始內容，不要根據介面截斷後的顯示文字手動抄寫。貼上後檢查開頭是否為 http:// 或 https://，中間是否出現空格，結尾是否帶有句號、右括號等正文標點。

URL 查詢參數中的 & 用於分隔多個參數。在網頁原始碼中可能看到 &，但複製後的實際網址應只包含一般的 &。如果從富文字、電子郵件或網頁程式碼片段複製網址，需確認 HTML 跳脫字元沒有被當成網址正文儲存。

訂閱網址通常包含存取憑證，應比照帳戶密碼妥善保管。不要將完整網址貼到公開記錄、截圖或公開提問頁面。排查時可以保留網域與路徑結構，同時遮蓋令牌參數的大部分內容。

IMPORT SEQUENCE

在 Clash 用戶端中匯入遠端訂閱

不同圖形化用戶端的選單名稱可能寫作「設定」「訂閱」「Profiles」或「設定檔」，但處理順序大致相同。以下步驟適用於以 Clash Meta（mihomo）等相容核心為基礎的常見桌面用戶端。實際按鈕位置應以目前使用的用戶端介面為準。

1. 開啟設定管理頁面。確認進入的是設定或訂閱區域，而不是代理節點選擇頁面。節點頁面用於切換現有代理群組，無法建立新的遠端設定。
2. 選擇從 URL 匯入。若介面同時提供本機檔案、剪貼簿與遠端網址選項，應選擇遠端網址。貼上完整訂閱連結，並為設定填寫便於辨識的名稱。
3. 執行下載或新增。用戶端會請求遠端網址並解析回應。成功後通常會出現新的設定卡片、更新時間或節點數量。出現項目不代表已經啟用，還需要繼續選取該設定。
4. 設為目前設定。點選設定項目或使用「啟用」操作，讓核心重新載入該設定。切換時若顯示解析錯誤，應先保留原本可用的設定，再檢查新設定內容。
5. 檢查代理群組。進入代理頁面，確認設定定義的群組已顯示，並依需求選擇節點或自動測速群組。沒有代理群組時，可能匯入的是節點清單，而非完整 Clash 設定。
6. 啟用系統代理或 TUN。系統代理適合一般瀏覽器與遵循系統代理設定的程式；TUN 用於接管更多網路流量，通常需要額外權限。首次驗證建議先使用系統代理，確認設定可正常運作後，再處理 TUN。

行動裝置用戶端的匯入邏輯相近：新增遠端設定、選取設定、啟動連線。系統可能要求建立 VPN 設定，這是作業系統提供網路接管能力時的標準授權步驟。若系統拒絕授權，即使用戶端已匯入訂閱，也無法建立相應的網路介面。

PROFILE UPDATE

手動更新、自動更新與本機修改

儲存遠端訂閱後，用戶端通常會記錄原始 URL，並提供更新按鈕。手動更新會再次請求該網址，下載最新設定並取代遠端設定的快取內容。節點增減、名稱調整、代理群組變化與規則更新，通常要在完成更新並重新載入設定後才會反映在介面上。

自動更新間隔可能由用戶端設定，也可能由設定中的中繼資料提示。間隔過短會產生不必要的網路請求；間隔過長則可能持續使用已調整的節點資訊。日常使用可保留用戶端的合理預設值，發現節點清單與訂閱管理頁面不一致時，再執行手動更新。

需要特別區分「更新訂閱」與「測試延遲」。更新訂閱會取得設定內容；延遲測試只會對目前已載入的節點進行探測，不會下載新節點。反覆測試延遲無法修復過期訂閱，也不會更新存取憑證。

直接編輯遠端設定產生的 YAML 時，還需考慮覆寫關係。部分用戶端會在下次更新時完全取代本機內容，因此手動加入的規則、DNS 或節點可能消失。若要長期保留自訂內容，應使用用戶端提供的覆寫、合併、腳本或擴充設定機制；若用戶端不支援這些機制，可以複製為獨立的本機設定，但之後需自行維護更新。

更新後，原先選取的節點不一定仍然存在。若代理群組名稱維持不變，用戶端可能保留群組的選取狀態；若節點遭刪除、重新命名或移至其他群組，核心會依群組的預設行為重新選取。更新完成後應檢查主要代理群組與目前模式，避免將「設定已更新」誤認為「原節點仍已選取」。

FAULT ISOLATION

訂閱連結無法辨識時的排查順序

匯入失敗應依「網址、網路回應、內容格式、核心相容性」的順序處理。先判斷用戶端是否取得內容，再判斷內容能否解析為設定。如此可避免在網路請求失敗時反覆修改 YAML，也能避免在格式錯誤時只更換網路環境。

一、確認網址完整且仍然有效

重新從訂閱管理頁面複製網址，不要沿用經聊天軟體轉發或手動換行的文字。若伺服器允許在瀏覽器中存取，可以觀察回應是設定文字、檔案下載、登入頁面還是錯誤頁面。出現登入頁面通常表示複製的是管理頁面網址；出現權限提示則可能是憑證失效、訂閱到期或存取策略受限。

二、確認用戶端能連線至訂閱伺服器

首次匯入是在可用代理尚未建立前進行，因此訂閱伺服器必須能透過目前網路存取。如果 DNS 解析失敗、TLS 連線失敗、請求逾時或遭網路策略阻擋，用戶端便無法取得設定。可先檢查系統時間是否正確、瀏覽器能否存取相同網域，以及用戶端記錄中的主機名稱與錯誤時間是否與本次操作相符。

三、檢查回傳內容是否為設定

伺服器回傳狀態正常，不代表正文就是 YAML。介面可能回傳 JSON 錯誤、HTML 登入頁面、驗證碼頁面或一般文字提示。用戶端接著可能回報 YAML 解析失敗、缺少欄位或無法辨識格式。此時應處理訂閱權限或輸出格式，而不是調整代理連接埠。

四、確認輸出目標與目前核心相容

不同訂閱輸出可能是針對 Clash、mihomo 或其他用戶端。mihomo 在 Clash 設定語法上擴充了部分代理協定、規則與 DNS 功能；舊核心不一定能辨識較新的欄位或節點參數。如果記錄指出未知代理類型、欄位不受支援或設定驗證失敗，應選擇與用戶端核心相符的訂閱格式，或更新至仍受維護的相容用戶端。

五、排除重複名稱與異常內容

設定檔中的代理名稱與代理群組引用必須相互對應。代理群組引用不存在的節點、同一層級出現非預期的重複名稱、規則集路徑無法使用，都可能導致載入失敗。有些問題不會阻止檔案下載，卻會在核心啟動或切換設定時出現。

YAML PARSE

本機 YAML 匯入失敗時要檢查哪些結構

YAML 依靠縮排表示層級。縮排應使用空格，並在同一層級保持一致。Tab、缺少冒號、清單項目前漏寫連字號、引號未閉合，都會使解析器在錯誤位置附近停止。記錄顯示的行號是定位起點，但真正問題也可能位於前一行。

簡化的設定骨架通常包含連接埠設定、代理節點、代理群組與規則。以下僅用於說明層級關係，不是可直接連線的完整設定：

mixed-port: 7890
mode: rule

proxies:
  - name: example-node
    type: socks5
    server: 127.0.0.1
    port: 1080

proxy-groups:
  - name: PROXY
    type: select
    proxies:
      - example-node
      - DIRECT

rules:
  - MATCH,PROXY

proxies 是節點清單，proxy-groups 定義如何選擇節點，rules 決定連線交由哪個代理群組或直連策略處理。規則引用的策略名稱必須與代理群組名稱或內建策略相符。若將節點名稱直接寫在需要代理群組名稱的位置，應確認目前核心與規則類型是否允許這種用法。

包含冒號、井號、特殊符號或前後空格的名稱，建議以引號包住。井號未受引號保護時，可能會被解讀為註解起點。檔案編碼應使用用戶端可正常讀取的文字編碼，避免被辦公室軟體儲存成帶有複雜格式的文件。

如果遠端訂閱可以下載但無法載入，可以先在用戶端記錄中尋找第一個解析錯誤。後續大量錯誤通常是第一個結構問題引發的連鎖結果。修正第一個問題後重新驗證，比從記錄末尾反向追查更有效。

RUNTIME CHECK

匯入成功後仍無法連線：規則、DNS 與 TUN 檢查

設定成功載入後，連線問題便進入執行階段。先確認用戶端的執行模式。規則模式會依 rules 由上至下比對，命中後停止繼續檢查；全域模式通常會將流量交給指定代理群組；直連模式則會繞過代理。若處於直連模式，即使節點顯示正常，目標流量也不會經過代理。

接著檢查代理群組的選取狀態。自動測試群組會根據設定定義的探測網址與時間間隔選擇節點，但探測成功不代表所有網站都能存取。手動選取群組則需要明確選定具體節點。若群組目前項目顯示為 DIRECT，相關規則命中該群組時便會執行直連。

DNS 問題常見表現是網域無法存取，但直接連線某些 IP 位址仍有回應。檢查設定是否啟用 DNS 模組、監聽位址是否衝突，以及增強模式是否與目前網路方案相符。Fake IP 模式會回傳保留位址，並在核心中對映回原始網域；這需要流量持續經過 Clash 核心。若請求繞過核心，可能導致解析結果無法正確使用。

TUN 模式需要建立虛擬網路介面並調整路由。啟動失敗時，應檢查是否缺少系統權限、介面是否遭其他網路工具佔用、服務元件是否已安裝，以及系統中是否存在衝突路由。開啟 TUN 後仍無流量，則檢查路由接管範圍、DNS 劫持設定與區域網路繞過規則。不要在未記錄原始狀態前同時修改 TUN、DNS、規則與節點，否則難以判斷是哪項變更造成影響。

建議採用最小變更法：先載入確認可正常解析的設定，選擇一個明確節點，使用系統代理驗證瀏覽器流量；接著測試規則模式；最後再啟用 TUN，驗證不遵循系統代理的程式。每一步都查看即時記錄中的目標網域、命中規則、所選策略與連線結果，就能將訂閱問題與執行問題分開。

QUICK CHECKLIST

訂閱匯入檢查清單

• 確認輸入是遠端訂閱網址、本機 YAML 檔案，還是單一節點連結。
• 重新複製完整 URL，檢查協定、查詢參數、空格與結尾標點。
• 確認回傳內容不是登入頁面、權限提示或一般網頁。
• 選擇與 Clash 或 mihomo 核心相容的訂閱輸出格式。
• 匯入後將設定設為目前設定，再檢查代理群組是否出現。
• 更新訂閱後確認節點選取、執行模式與規則群組沒有變更。
• 解析失敗時，從記錄中的第一個 YAML 或欄位錯誤開始處理。
• 執行失敗時依序檢查節點、規則、DNS、系統代理與 TUN。

只要將「請求訂閱」「解析設定」「載入核心」「接管流量」拆分成四個階段，絕大多數匯入問題都能定位到具體環節。網址無法請求時處理網路與權限；正文無法解析時處理格式與相容性；設定可以載入但無法存取時，再檢查代理群組、規則、DNS 與系統接管狀態。