匯入訂閱前:確認連結、格式與核心

Clash 訂閱連結是取得遠端設定檔的網址,並非單一代理節點。用戶端會向該網址發出請求,將回應儲存為設定檔,再交由核心執行。匯入成功只代表設定檔已成功取得並解析;是否有可用節點、規則是否指向正確的策略組,仍需分別確認。

Clash Nyanpasu 是桌面設定檔管理用戶端,實際支援的協定取決於所選核心及其版本。Clash Meta 的後續專案名稱為 mihomo;mihomo 專用設定檔可能含有舊版 Clash 無法辨識的欄位。如果訂閱服務提供多種格式,請先選擇符合目前核心的 Clash 或 mihomo 格式,不要直接複製通用節點清單。

  • 連結來源:請從訂閱服務的帳戶頁複製完整 HTTPS 連結,不要複製瀏覽器中的帳戶管理頁面網址。
  • 輸出格式:確認標示為 Clash YAML、Clash Meta 或 mihomo,並核對服務商提供的格式說明。
  • 存取憑證:請保留查詢參數。連結中的權杖通常用於身分驗證,若刪除或截斷參數,請求可能遭到拒絕。
  • 目前設定:記下原有設定檔名稱及正在使用的策略組,以便匯入後仍能還原。

Clash Nyanpasu 訂閱連結匯入步驟

以下以「遠端設定檔」流程說明。不同版本的按鈕可能標示為「新增」、「匯入」或加號圖示,主要步驟相同:在設定檔管理頁新增遠端項目、輸入 URL、下載後選取該設定檔。請勿將訂閱連結填入系統代理或外部控制器的位址欄位。

  1. 開啟設定檔頁面。前往用戶端側邊欄的「設定檔」頁面,找到新增或匯入入口。如果同時提供「本機」和「遠端」類型,請選擇遠端設定檔。
  2. 填寫容易辨識的名稱。例如「日常訂閱-主要線路」。名稱僅供本機管理使用,不會改變服務端傳回的節點內容。
  3. 貼上完整 URL。確認網址以 https:// 開頭,結尾沒有多餘空格、換行或中文引號。連結中的 & 和 = 是查詢參數的分隔符號,請勿手動刪除。
  4. 執行匯入並等待結果。留意是否出現下載失敗、驗證失敗或 YAML 解析錯誤。若發生錯誤,請先保留原有設定,不要連續新增多筆相同項目。
  5. 選取新設定檔。在設定檔清單中將新項目設為目前使用的設定。只儲存遠端項目,不一定會切換正在執行的設定檔。
  6. 檢查代理與規則。開啟代理頁面,確認節點或策略組已載入;再查看記錄,確認核心沒有回報缺少策略組、未知代理類型等錯誤。

匯入後先做基本驗證

先維持規則模式,選取一個實際代理節點,前往要測試的網站,再從連線記錄查看命中的規則與出口路徑。節點延遲測試成功,只代表測試位址連線正常,不代表所有網站都能存取。如果設定中只有 DIRECT,表示目前沒有可選用的代理節點,不能以「設定已啟用」作為代理可用的證明。

系統代理和 TUN 是流量接入方式,不會將訂閱轉換成節點。初次排查時可先使用系統代理,避免同時變更 DNS、TUN 和路由設定。瀏覽器能否使用代理也取決於其代理設定;不會讀取系統代理的程式,必須另外設定或採用合適的接入方式。

Clash YAML、Base64 與單一節點連結的差異

檔案副檔名和網址外觀都不足以判斷訂閱格式。沒有 .yaml 副檔名的 URL 也可能回傳 Clash 設定;以 .yaml 結尾的網址也可能回傳登入頁面。判斷時應查看伺服器實際回傳的內容,以及內容是否符合目標核心的設定結構。

內容類型常見特徵匯入方式
完整 Clash YAML包含 proxies 或 proxy-providers,並設定策略組與規則確認核心相容後,匯入為遠端設定檔
Base64 節點清單內容是編碼文字,解碼後通常會得到多行節點 URI先轉換為目標核心支援的 YAML 設定
單一節點 URI以 ss://、vmess://、trojan:// 等協定開頭使用支援該協定的匯入工具處理,再加入設定檔
代理提供者 YAML常見頂層欄位為 proxies:,內容只有節點通常作為 proxy-providers 的資料來源
HTML 或 JSON 錯誤回應登入提示、到期通知、錯誤碼或網頁標籤修正網址或帳戶狀態,不要當作設定檔匯入

YAML 可解析,不代表設定能正常執行

YAML 是資料表示格式,不能只憑「有冒號、有縮排」就確認內容可用。以下是用來說明階層關係的最簡設定:監聽連接埠為 7890,策略組只有直連,不具備代理功能。實際訂閱還需要定義節點,或透過代理提供者載入節點。

mixed-port: 7890
mode: rule
log-level: info

proxies: []

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

rules:
  - MATCH,手動選擇

proxy-groups 中的成員必須能解析至已定義的節點、其他有效策略組或內建出口。上例中的 MATCH,手動選擇 會參照策略組名稱,因此名稱必須完全相同。使用代理提供者時,也要確認群組中的 use 指向實際存在的提供者名稱。完整欄位說明請參閱YAML 設定手冊。

Base64 解碼不等於設定轉換

Base64 只是一種編碼方式,不會提供規則、策略組或 DNS 設定,也不是加密。解碼後得到的可能仍是數個節點 URI。真正的轉換還需要解析協定參數、對應目標核心欄位、建立策略組並加入規則。將原始檔案改名為 config.yaml,並不能完成這些步驟。

訂閱轉換:優先選原生格式,再考慮轉換工具

如果服務端已提供 Clash 或 mihomo 格式入口,請優先使用。這能減少欄位對應和範本差異造成的問題。只有取得通用節點訂閱,且目前用戶端無法直接將其作為設定使用時,才需要考慮轉換。

  1. 確認來源格式。分辨完整設定、節點清單和提供者檔案。節點清單不含路由規則,不能假設轉換後會保留原有分流策略。
  2. 選擇目標核心。如果目標選擇或填入 mihomo,請確認目前執行的也是相容核心。轉換器無法讓舊版核心自動支援新協定。
  3. 選擇可控的轉換方式。優先考慮在本機執行或自行管理的轉換服務。遠端轉換服務可能會取得來源訂閱網址及回傳的節點憑證。
  4. 檢查轉換結果。核對節點數量、協定類型、TLS 參數、策略組名稱及最後的 MATCH 規則,再匯入為獨立的測試設定檔。

更新間隔與手動修改:分清兩種訂閱

遠端設定檔更新和代理提供者更新是兩套機制。前者由用戶端重新下載整份設定,後者則由核心依照 proxy-providers 設定更新節點檔案。兩者可能使用不同 URL,更新時間也不必相同。

用戶端遠端設定檔更新

在「設定檔」頁面開啟目標項目的編輯入口,尋找更新間隔或自動更新選項。不同版本的輸入單位可能是分鐘,也可能以其他方式顯示,請以欄位旁的單位為準。例如,介面單位為分鐘時,360 代表 6 小時;單位為秒時,6 小時則是 21600。請勿忽略單位而直接照抄數值。

訂閱內容變動不頻繁時,可先設定每 6 小時更新一次;節點暫時失效或服務商通知變更時,再手動更新。若服務商限制請求頻率,請遵守相關規定。用戶端關閉、裝置進入睡眠或網路離線時,自動更新不會嚴格按照實際時間執行。

核心代理提供者更新

在 mihomo 設定中,HTTP 類型代理提供者的 interval 單位為秒。以下範例表示每 3600 秒更新一次提供者檔案;其中的 URL 僅供格式示範,不能直接用於實際訂閱。此片段必須合併至完整設定,並由策略組透過 use 引用。

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

直接修改下載的遠端設定檔,下次更新時可能會被覆寫。若要保留個人規則、連接埠或 DNS 調整,應使用目前版本支援的覆寫或合併機制,並檢查最終產生的設定。不要假設本機編輯會同步回訂閱服務,也不要把原始訂閱和個人調整混成難以還原的單一檔案。

訂閱匯入失敗的排查順序

依序檢查「請求是否成功 → 回傳格式是否正確 → 核心是否相容 → 流量是否接入」。每次只變更一項,並記錄錯誤發生在下載階段還是核心啟動階段,因為兩者的處理方向不同。

問題現象優先檢查項目下一步處理
HTTP 401 或 403權杖、帳戶權限、服務端存取政策從帳戶頁重新複製連結,並核對服務商提示
HTTP 404網址路徑是否完整、舊入口是否已失效使用目前有效的入口,不要自行猜測 API 路徑
HTTP 429更新請求是否過於頻繁停止連續重試,依照服務端限制延後更新
逾時或網域解析失敗目前網路、DNS,以及下載請求所走的路徑確認訂閱網域可連線,再檢查更新代理設定
YAML 解析錯誤回應是否為網頁、縮排是否遭到破壞檢查回應內容,選擇正確的格式入口
未知代理類型或欄位錯誤核心版本和輸出目標切換至相符的核心,或使用相容設定
已匯入但沒有流量設定啟用狀態、策略組、系統代理查看連線記錄與實際出口,不要反覆重新匯入

瀏覽器能開啟連結,為什麼用戶端仍然失敗?

瀏覽器和用戶端不一定使用相同的連線路徑。瀏覽器可能帶有登入 Cookie,或透過既有代理連線;用戶端的訂閱下載請求則可能直接連線,也可能使用不同的請求標頭。部分服務還會依據 User-Agent 回傳不同格式。因此,瀏覽器顯示了內容,不代表用戶端收到的是同一份 YAML。

如果訂閱網域必須透過代理存取,請先保留一份可用設定,再確認目前版本是否提供訂閱更新代理選項。不要為了下載新訂閱而先刪除唯一可用的舊設定。分享記錄前,請遮蔽完整 URL,尤其是請求路徑和查詢參數中的存取憑證。

匯入完成後的檢查清單

  • 目前使用的設定檔名稱正確,且能確認最近一次更新結果。
  • 節點和策略組已載入,規則參照的名稱沒有缺漏。
  • 更新間隔的數值與單位一致,沒有把分鐘當成秒。
  • 連線記錄顯示預期的規則和出口,應用程式流量確實進入核心。
  • 個人調整已透過可持續使用的覆寫方式保存,舊設定仍可供還原。

訂閱匯入的關鍵,是讓「連結回傳內容、設定結構、執行核心」三者一致。先處理格式與驗證,再檢查規則和流量接入,可避免將網路問題誤判為 YAML 問題。初次使用時,可搭配快速入門教學完成系統代理與基本連線驗證;遇到 Profile、策略組等術語時,請參閱術語手冊。