匯入前先辨識連結與設定類型
Clash 客戶端中的「訂閱」通常是指可透過 HTTP 或 HTTPS 下載的遠端設定網址。客戶端請求該網址後，伺服器會回傳 YAML 設定、編碼後的節點清單，或針對特定客戶端產生的轉換結果。連結能在瀏覽器中開啟，不代表內容一定能由 Mihomo 核心讀取；判斷時需同時檢查回傳內容、設定欄位與客戶端支援範圍。
訂閱網址通常包含使用者識別碼、存取權杖或短期驗證參數。複製時應保留完整查詢字串，包括問號後的參數，不要手動刪除結尾字元。該網址等同設定存取憑證，在截圖、日誌或求助資訊中只應保留網域，並遮蔽路徑與參數。
Clash 標準 YAML 設定
標準設定是 Clash 與 Mihomo 客戶端最直接的輸入格式。文字開頭不要求固定欄位順序，但通常可以看到 mixed-port、proxies、proxy-groups、rules、dns 等鍵。一個最小結構可能如下所示：
mixed-port: 7890
mode: rule
proxies:
- name: example-node
type: socks5
server: 192.0.2.10
port: 1080
proxy-groups:
- name: PROXY
type: select
proxies:
- example-node
rules:
- MATCH,PROXY實際訂閱通常還會包含協定驗證、TLS、UDP、規則集與 DNS 設定。Mihomo 擴充欄位如 rule-providers、sniffer、tun 與部分協定參數，需要由支援相應欄位的核心解析。舊版 Clash 客戶端遇到擴充欄位時，可能直接顯示錯誤，也可能忽略無法辨識的部分。
Base64 節點訂閱
Base64 訂閱解碼後通常是一組逐行排列的分享連結，例如 ss://、trojan://、vmess:// 或 vless://。這種回傳內容不是完整的 Clash YAML：通常不包含策略組、規則、DNS 與 TUN 參數。部分客戶端會自行解析節點清單並產生基本設定，另一些只接受 YAML，此時可能顯示「設定格式錯誤」或「缺少 proxies 欄位」。
單一分享連結與通用訂閱
以協定名稱開頭的單一 URI 只描述一個節點，適合使用客戶端的「匯入節點」入口，不一定能貼入「遠端設定 URL」欄位。通用訂閱則可能依據請求標頭辨識客戶端並回傳不同格式；同一網址在瀏覽器中看到 Base64，在客戶端中卻可能回傳 Clash YAML，這是伺服器依 User-Agent 進行適配的結果。
桌面客戶端匯入步驟
不同桌面客戶端的名稱略有差異，但操作流程大致一致：建立遠端設定、填入 URL、下載設定、啟用設定，再選擇策略組。以下路徑依常見版本介面整理；若選單配置有所變更，可在「訂閱」「設定」或「Profiles」頁面尋找 URL 匯入入口。
Clash Verge Rev
- 開啟客戶端，進入「訂閱」頁面。
- 將完整訂閱網址貼到上方 URL 輸入框，確認網址前綴為
https://或http://。 - 選擇「匯入」。客戶端會發起遠端請求，並將成功下載的設定顯示為訂閱卡片。
- 點選新的設定卡片，將其設為目前啟用的設定。
- 進入「代理」頁面，在常見的
PROXY、節點選擇或名稱相近的策略組中選擇節點。 - 進入「設定」→「系統設定」，依需求開啟系統代理；需要接管更多應用程式流量時，再評估是否啟用 TUN 模式。
匯入後若卡片存在但代理頁面為空，先不要反覆開啟系統代理。進入設定詳情檢查下載時間與檔案大小，再開啟日誌查看 YAML 解析錯誤。常見本機監聽連接埠是混合連接埠 7890，但設定可能覆寫此值；在瀏覽器手動設定代理時，應以目前執行中的設定所顯示連接埠為準。
Mihomo Party
- 進入「訂閱」頁面，選擇「新增」。
- 選擇遠端訂閱類型，填寫名稱與訂閱 URL。
- 儲存後執行一次更新，等待狀態從下載中切換為可用。
- 選取剛新增的訂閱，將其設為目前設定。
- 進入「代理」頁面選擇策略組與節點，接著在「設定」中開啟系統代理或 TUN。
Mihomo Party 使用 Mihomo 核心，適合讀取包含 Mihomo 擴充欄位的設定。若訂閱引用了遠端規則集，首次載入時還會繼續下載 rule-providers 指向的檔案。主設定下載成功但規則集下載失敗時，日誌會分別記錄兩個請求，排查時應區分訂閱網域與規則集網域。
FlClash
- 開啟「設定」頁面，選擇右上角的新增按鈕。
- 選擇「URL」，貼上訂閱連結並填寫易於辨識的名稱。
- 確認匯入，等待設定卡片出現。
- 選取設定後返回「代理」，展開策略組並選擇節點。
- 在「工具」或「設定」區域啟用系統代理；桌面版需要全域接管時再開啟 TUN。
FlClash 同時支援多個桌面與行動平台，介面會依視窗寬度調整。窄視窗中設定入口可能收納在底部導覽列或更多選單，但 URL、檔案與剪貼簿通常仍是分開的匯入方式。遠端訂閱應選擇 URL，已下載至本機的 YAML 才選擇檔案。
Android 與 iOS 客戶端如何匯入
Clash Meta for Android
- 進入「設定」，點選右上角的加號。
- 選擇「從 URL 匯入」。
- 填寫設定名稱、訂閱 URL 與自動更新間隔。
- 儲存後等待下載完成，再點選該設定使其生效。
- 返回主介面，點選「啟動」，並確認系統顯示的 VPN 連線授權。
- 進入「代理」檢查策略組，確認沒有停留在無法連線的舊節點。
Android 上的 Clash Meta 客戶端通常透過系統 VPN 介面接管流量，不需要再為每個應用程式填寫 127.0.0.1:7890。首次啟動時出現 VPN 權限對話框屬於正常系統流程。同一時間只能有一個應用程式使用 Android VPN 介面；若其他 VPN、過濾器或代理工具正在執行，應先停止它，再啟動目前的設定。
自動更新間隔不宜設定得過短。節點資訊變動不頻繁時，可先使用 1440 分鐘，也就是每天一次；經常調整規則的設定可使用 360 分鐘。設定為 15 分鐘會產生較多重複請求，也可能觸發訂閱服務的存取頻率限制。
FlClash 行動版
FlClash 在 Android 上的匯入步驟與桌面版接近：進入「設定」→「新增」→「URL」，貼上後下載並啟用。啟動服務前同樣需要接受系統 VPN 授權。匯入成功後應進入代理組查看節點，而不是只根據首頁的啟動狀態判斷設定是否完整。
iOS 上的相容性界線
iOS 客戶端由各自的應用程式負責解析設定。以 Stash 這類支援 Clash 規則結構的客戶端為例，可在遠端設定或設定管理頁面選擇從 URL 下載，再將回傳設定設為目前設定。具體入口會隨客戶端版本變更，匯入前應確認訂閱提供者列出了該客戶端支援的格式。
部分 iOS 工具主要接收節點訂閱與單一分享連結，不會完整採用 Clash YAML 中的策略組、指令碼、規則集與 DNS 欄位。若匯入同一網址後只出現節點，沒有原設定中的規則組，通常是客戶端進行了格式轉換，不代表遠端檔案本身缺少規則。
匯入後確認節點、策略組與規則已載入
「匯入成功」只代表客戶端儲存了一筆設定記錄。完整驗證至少應涵蓋設定內容、核心執行、策略組選擇與實際連線四個層面。以下檢查順序可避免將規則問題誤判為訂閱下載問題。
第一步：查看設定更新時間與內容規模
- 設定卡片應顯示剛更新的時間，而不是數天前的快取時間。
- 遠端檔案大小不應為 0；若只有幾十位元組，可能回傳的是錯誤訊息或登入頁面。
- 設定詳情中應能看到節點數量。預期有 20 個節點卻只出現 1 個，應檢查是否誤匯入單一分享連結。
- 若設定宣告了規則，應能看到
rules或遠端規則集，而不只是proxies。
第二步：確認核心啟動
切換設定後查看執行狀態與日誌。正常情況下會看到設定載入、監聽連接埠啟動以及控制介面可用等記錄。如果日誌停在解析階段，應依第一個錯誤定位欄位；後續大量連帶錯誤通常是由前面的縮排、欄位類型或不相容參數引起。
YAML 使用空格表示階層，Tab、缺少冒號與錯誤縮排都會導致解析失敗。例如 rules 必須是清單，不能將整段規則寫成未分行的單一字串。遠端訂閱由伺服器產生時，應優先請提供者修正來源設定，而不是每次更新後手動編輯快取檔案。
第三步：檢查策略組選擇
進入「代理」頁面，逐層展開策略組。若最終出口組選擇了 DIRECT，即使客戶端已啟動，符合該組的連線仍會直接連線。若選擇的是 url-test 或 fallback 自動組，應確認其中至少有一個節點完成延遲測試。
延遲測試顯示 80 ms，只代表測試 URL 可透過該節點存取，不等於所有網站都能建立連線。建議再發起一次實際請求，並在連線記錄中觀察網域、命中規則、策略組與最終節點。例如記錄顯示 DOMAIN-SUFFIX 命中後交給 PROXY，再由該組選擇具體節點，才表示規則鏈路完整。
第四步：核對代理模式
| 模式 | 流量行為 | 驗證重點 |
|---|---|---|
| 規則 | 依 rules 從上到下匹配，使用命中的策略 | 查看連線記錄中的規則與策略組 |
| 全域 | 連線統一交給全域策略組 | 確認全域組已選取可用節點 |
| 直連 | 連線不經過代理節點 | 用於基準測試，不用於驗證節點出口 |
排查匯入結果時建議先使用規則模式，保留訂閱原本設計的分流邏輯。暫時切換至全域模式可以判斷節點是否具備基本連通性，但測試結束後應切回規則模式。切換模式只會影響新連線，已建立的瀏覽器長連線可能繼續沿用舊路徑，可以關閉對應分頁或重新啟動應用程式後再測試。
訂閱匯入失敗的常見提示與處理方式
HTTP 401、403 或 404
401 與 403 通常表示缺少驗證參數、權杖失效、存取來源受限或訂閱已停用；404 表示網址路徑不存在，也可能是伺服器以此狀態隱藏無效權杖。請重新從訂閱管理頁面複製完整網址，不要只複製瀏覽器網址列中的管理頁 URL。若連結包含 & 參數，請確認聊天軟體或筆記工具沒有截斷後半段。
請求逾時或連線遭拒
訂閱更新發生在代理啟動前時，客戶端通常會透過本機網路直接連線訂閱網域；代理已執行時，部分客戶端可能讓更新請求經過目前代理。若訂閱網域只能透過代理存取，就可能形成「設定尚未下載，因此代理未啟動；代理未啟動，因此設定無法下載」的循環。可先使用可連線的網路完成首次匯入，或在客戶端支援的情況下調整訂閱更新請求路徑。
本機 HTTP 代理常見網址為 127.0.0.1:7890，SOCKS 連接埠常見為 127.0.0.1:7891，但這些只是常用預設值。連接埠若已被其他程式占用，核心可能無法啟動，日誌會出現 bind 或 address already in use。此時應查看目前設定中的 mixed-port、port 與 socks-port，避免重複監聽。
顯示 YAML 解析錯誤
先在設定詳情中確認回傳內容不是 HTML。若檔案開頭出現 <!doctype html>、登入提示或錯誤頁面，表示客戶端取得的不是 YAML。若確實是 YAML，則記錄日誌提供的行號與欄位名稱，重點檢查縮排、布林值類型、清單格式，以及核心是否支援對應協定欄位。
節點存在，但規則與策略組消失
這種情況常見於匯入了 Base64 節點訂閱，或客戶端將通用訂閱轉換成基本設定。節點清單只提供連線參數，不包含完整的分流設計。需要規則分流時，應取得 Clash 或 Mihomo YAML 訂閱，或在客戶端使用本機覆寫功能補充策略組、DNS 與規則。覆寫前應先儲存原設定，避免更新訂閱後出現重複欄位。
更新後設定沒有變化
先比較客戶端顯示的更新時間，再執行一次手動更新。若更新時間變更但節點不變，可能是伺服器內容本來就沒有更新；若更新時間不變，則檢查請求是否命中快取、自動更新是否啟用，以及客戶端是否仍在使用另一張同名設定卡片。刪除設定會同時清除本機選取狀態，通常不應作為第一步。
自動更新、覆寫與 TUN 的設定順序
訂閱匯入穩定後，再調整自動更新與本機覆寫。建議順序是：先驗證遠端 YAML 可獨立載入，再設定 360 至 1440 分鐘的更新間隔，之後新增少量覆寫，最後測試系統代理或 TUN。一次修改多個層級，會讓失敗原因難以定位。
自動更新間隔
- 節點變動較少：1440 分鐘，每天檢查一次。
- 規則或節點經常調整：360 分鐘，每 6 小時檢查一次。
- 暫時等待設定修正：使用手動更新，不必設定為每 5 或 10 分鐘輪詢。
客戶端休眠、系統限制背景活動或行動裝置省電策略，都可能延後更新，因此自動更新間隔代表排程頻率，不保證在精確分鐘執行。需要立即取得新內容時，應開啟設定頁面執行手動更新，並確認更新時間已變更。
本機覆寫的適用範圍
覆寫適合保留本機差異，例如修改監聽連接埠、加入區域網路直連規則、調整 DNS 伺服器或補充 TUN 參數。不要將大量節點複製到覆寫檔案，因為訂閱更新後容易留下過期項目。也要注意規則順序：Clash 會由上往下匹配，新增的區域網路規則若放在 MATCH 之後，就不會被執行。
TUN 模式不會決定訂閱能否解析
TUN 負責接管作業系統流量，訂閱匯入則負責取得並解析設定，兩者屬於不同階段。YAML 解析失敗時，開啟 TUN 不會修復設定；節點與規則已正確載入，但某些應用程式不遵循系統代理時，TUN 才是需要測試的接管方式。啟用後應重新建立連線，並觀察連線清單中是否出現目標應用程式的請求。
一份可重複執行的匯入檢查清單
- 確認複製的是 Clash 或 Mihomo 訂閱 URL，而不是管理頁面或 QR Code 網址。
- 保留 URL 的完整路徑、查詢參數與協定前綴。
- 在客戶端的「訂閱」或「設定」頁面選擇 URL 匯入，不要誤選本機檔案。
- 下載後檢查更新時間、節點數量、策略組與規則是否符合預期。
- 啟用新設定，確認核心已啟動且本機監聽連接埠沒有衝突。
- 在代理組中選擇節點，再開啟系統代理或行動端 VPN 服務。
- 使用規則模式建立新連線，在連線記錄中核對規則、策略組與最終節點。
- 穩定執行後再設定自動更新、覆寫與 TUN，避免同時變更多個變數。
訂閱匯入的關鍵不在於點擊一次「新增」，而在於辨認遠端內容是否為客戶端支援的設定，並驗證它從下載、解析、啟用到流量命中的完整流程。遇到失敗時，依 HTTP 請求、回傳格式、核心解析、策略選擇與系統接管的順序檢查，通常就能將問題定位在單一環節。