先選對訂閱格式,再匯入連結
請優先在服務商頁面複製標示為「Clash」、「Clash Meta」或「mihomo」的訂閱網址,再到用戶端的「設定檔」頁面匯入。下載完成、啟用設定檔、接管流量是三個不同步驟。清單中出現設定檔卡片,只能表示用戶端已儲存設定檔,不能據此判定瀏覽器已透過代理連線。
訂閱網址通常是用來取得設定檔內容的 HTTPS 連結,不是服務商登入頁,也不是包含 QR Code 的網頁網址。網址可能帶有存取憑證。複製時請使用頁面上的「複製訂閱連結」按鈕,不要從瀏覽器網址列複製會員中心網址。
匯入前先確認這三項
- 用戶端核心:採用 mihomo 的用戶端通常支援更多通訊協定與設定欄位;較舊的 Clash 核心未必能辨識新通訊協定。介面顯示安裝成功,不代表核心能解析所有訂閱內容。
- 服務狀態:確認帳戶是否到期、流量是否用完,以及訂閱網址是否已重設。請先到服務商後台確認,不要反覆修改本機連接埠。
- 網址完整性:保留原始的
https://、路徑和查詢參數,不要手動刪除看似多餘的字元,也不要連同換行或引號一起貼上。
匯入 Clash 訂閱連結:從新增到啟用
不同用戶端的按鈕位置不盡相同。桌面版通常從「設定檔」→「新增」或「匯入」操作;Clash for Android 常見路徑則是「設定檔」→「+」→「從 URL 匯入」。以下依操作目的說明,不將特定用戶端的選單名稱視為通用標準。
- 複製專用連結。在服務商頁面選擇符合核心的 Clash 或 mihomo 格式。如果同時提供「通用訂閱」和「Clash 訂閱」,請優先選擇後者。
- 新增遠端設定檔。開啟用戶端的「設定檔」頁面,選擇透過 URL 匯入。若有「本機/遠端」類型選項,請選擇「遠端」;「本機」通常用來讀取裝置上的檔案。
- 輸入名稱與網址。名稱可填「日常訂閱」,網址欄只輸入完整的訂閱 URL。更新間隔請依介面標示的單位設定,不要將小時數直接填入以分鐘為單位的欄位。
- 儲存並等待下載。點選「儲存」、「匯入」或「下載」。確認是否出現錯誤訊息、更新時間和設定檔項目。若失敗,請先記下原始錯誤訊息,避免連續重試而蓋過第一次錯誤。
- 啟用這份設定檔。在設定檔清單中選取剛匯入的項目。確認選取標記已變更,且沒有設定檔解析錯誤;部分用戶端會自動套用,其他用戶端則需再點選「啟用」。
- 選擇代理群組的出口。開啟「代理」頁面,在需要手動選擇的策略群組中選取節點,或選擇訂閱預設的自動選擇群組。不要只看到節點清單就離開。
- 讓需要代理的流量經由代理傳送。桌面版可先啟用「系統代理」並測試瀏覽器;Android 通常需要啟動連線並授予系統 VPN 權限。匯入訂閱不必使用 TUN 模式。
如果只有 QR Code 入口,請先確認 QR Code 裡的是訂閱 URL,還是單一節點 URI。ss:// QR Code 通常只包含單一節點資訊,不會自動附帶規則、策略群組和遠端更新網址。掃碼成功也不代表已匯入完整訂閱。
YAML 與 Base64:設定結構和編碼方式有何不同
YAML 是設定檔的表達格式,Base64 則是編碼方式,兩者不屬於同一層次。所謂「Base64 訂閱」,通常是將多個節點 URI 串接後再編碼,但也可能只是將其他文字編碼。必須查看解碼後的內容,不能只憑下載檔名判斷。
| 回傳內容 | 常見特徵 | 匯入注意事項 |
|---|---|---|
| 完整 Clash YAML 設定檔 | 可包含 proxies、proxy-groups、rules |
適合從設定檔頁面匯入,仍須確認通訊協定與核心的相容性。 |
| Base64 節點訂閱 | 原始內容是一長串編碼,解碼後通常會看到多行節點 URI | 只有用戶端明確支援轉換時才能直接使用;解碼本身不會產生規則。 |
| 明文節點 URI 清單 | 每行可能以 ss://、vmess:// 等開頭 |
這是節點資料,不是完整的 Clash 設定檔,須由用戶端支援匯入或轉換。 |
| 代理節點集合 YAML | 通常只有 proxies 節點清單 |
可供 proxy-providers 使用,不能預設為包含策略群組和規則的完整設定檔。 |
完整設定檔大致長什麼樣?
以下僅示範 YAML 的層級與鍵名。這份範例沒有遠端節點,策略群組只能選擇直連,無法用來測試代理連線。實際訂閱也可能透過 proxy-providers 引入節點,因此沒有內嵌 proxies 不一定表示設定檔損毀。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 出口選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,出口選擇
mixed-port: 7890 表示同一個本機連接埠可接受 HTTP 和 SOCKS 代理連線,不是服務商節點的連接埠。這裡 rules 的最後一條規則會將請求交給「出口選擇」,而該群組只有 DIRECT,因此最後會直連。YAML 縮排請使用空格,不要使用 Tab;層級錯誤可能讓檔案在開始連線前就解析失敗。
為什麼 Base64 解碼後還是不能用?
解碼只會還原文字,不會補上 proxy-groups、DNS 或分流規則。即使解碼後取得有效的節點 URI,用戶端核心也必須支援相應的通訊協定。最省事的做法是回到服務商頁面,取得適用於目標用戶端的專用訂閱;若確實需要轉換,請優先使用用戶端內建功能或可信的本機工具,並檢查轉換後的策略群組與規則。
匯入失敗:從下載、解析到連線逐層排查
先判斷錯誤發生在哪個環節。若設定檔尚未下載,修改 rules 毫無幫助;若已解析成功但網站無法開啟,反覆複製相同的訂閱網址通常也無效。
第一層:訂閱請求未取得正確內容
401 Unauthorized:通常表示需要驗證,或權杖已失效。請重新複製後台產生的完整網址,並確認訂閱是否已重設。403 Forbidden:可能是存取政策、帳戶限制,或請求遭到攔截。請查看服務商說明;只更換本機監聽連接埠無法解決問題。404 Not Found:先確認複製內容是否被截斷、路徑是否失效,以及取得的是否為網頁連結。no such host:訂閱網域名稱解析失敗。請確認網域拼字,再檢查目前網路的 DNS;這還不是節點連線失敗。i/o timeout:查看日誌中逾時的目標。如果目標是訂閱伺服器,請先處理訂閱下載問題,而不是更換尚未下載的節點。
瀏覽器能開啟連結、用戶端卻不行,不一定代表連結沒有問題。瀏覽器可能使用登入 Cookie、不同的代理或不同的請求標頭。有些服務會依請求回傳不同格式,請優先使用服務商明確提供的 Clash 專用入口。檢查回應內容時只在本機查看,不要公開完整設定檔。
第二層:內容已下載,但無法解析
如果回應開頭是 <!DOCTYPE html> 或 <html>,取得的是網頁,可能是登入頁或驗證頁,而不是 YAML。若出現 yaml: line 之類的錯誤,請依提示的行號檢查縮排、冒號和引號,也要確認回應中沒有混入網頁文字。若日誌指出不支援某種代理類型,請確認核心的支援範圍,改用相符格式或更新至相容核心;不要隨意刪除欄位蒙混過關。
第三層:設定檔已啟用,但流量仍未通
先到「代理」頁面確認目前群組沒有選取 DIRECT 或 REJECT,再查看「連線」或「日誌」中的實際命中規則與出口。系統代理只會影響遵循系統代理設定的程式;遊戲、命令列工具或使用自有網路堆疊的應用程式,可能需要個別設定代理,或在了解路由影響後使用 TUN。不要把「匯入成功」和「所有應用程式都已接管」畫上等號。
訂閱更新後,確認設定已生效,而不只是刷新成功
遠端設定檔通常會保留訂閱來源,方便手動或定期更新;從本機匯入的檔案通常只是當下的一份副本。要確認更新是否生效,請先在目前的設定檔卡片上執行一次「更新」,確認更新時間有變,再檢查節點清單。如果仍在使用另一份舊設定檔,即使下載成功,也不會改變目前使用的出口。
- 確認目前使用的設定檔:核對選取標記,不要只看清單的排列順序。
- 檢查內容變化:查看服務商實際新增或移除的節點、策略群組名稱;若沒有變化,也可能只是上游回傳內容未變。
- 查看應用程式日誌:留意更新後是否出現解析失敗或重新載入失敗。部分用戶端會繼續使用先前可用的設定檔。
- 測試新連線:重新開啟頁面或建立新的連線。既有長連線可能會繼續使用先前的出口,不適合用來判斷切換結果。
常見問題:檔案匯入、連接埠與重複訂閱
下載成 .yaml 檔案後,可以取代訂閱連結嗎?
可以作為本機設定檔匯入,但通常不會自動保留原訂閱網址和更新功能。適合暫時檢查或離線移轉;若要持續取得服務商的調整,請使用遠端 URL 匯入。副檔名無法保證內容正確,名為 config.yaml 的檔案也可能實際儲存了錯誤頁面。
匯入成功後一定要把連接埠改成 7890 嗎?
不需要。7890 只是常見的範例值,請以用戶端目前顯示的監聽連接埠為準。若應用程式手動填入 127.0.0.1:7890,但用戶端實際監聽的是 7897,兩邊就不相符。遇到 address already in use 時,請確認是否同時執行兩個代理用戶端;不要為了符合教學而盲目覆寫連接埠。詳細設定請參閱本機連接埠設定說明。
重複匯入同一個連結,網路會變快嗎?
不會。重複匯入通常只會增加設定檔項目,目前使用哪一份仍取決於作用中的設定檔。保留一份可更新的遠端設定檔和必要備份即可。若一份訂閱包含多個節點,請在策略群組中選擇節點或使用自動選擇群組,而不是一再新增相同訂閱。
最後依序確認:使用專用且正確的訂閱格式、下載取得有效內容、設定檔成功解析並啟用、代理群組出口正確,以及目標應用程式的流量已交由代理處理。之後若遇到逾時,請前往逾時問題診斷繼續排查;首次設定可依照訂閱匯入指南逐項確認。