開始前:準備有效的訂閱
安裝用戶端不代表已經有可用的代理出口。你還需要有效的設定訂閱網址,或包含代理與分流設定的 YAML 檔案。訂閱由你使用的服務提供,本站不提供節點或訂閱帳號。請前往服務商的管理頁面,找到標示「Clash」、「Clash Meta」或「Mihomo」的訂閱入口,複製完整網址。不要誤把瀏覽器網址列中的帳號管理頁面當成訂閱網址。
初次設定時,建議先結束其他正在接管網路的代理用戶端或 VPN 工具。確認裝置在未連線代理時可以開啟一般網頁,並檢查系統日期與時間是否正確。如此一來,發生問題時才能分辨是原有網路、訂閱下載,還是新設定出了狀況。桌面版暫時不必啟用 TUN,也先不要修改 DNS;先用最少的設定建立可供驗證的連線。
訂閱網址可能包含可識別帳號的資訊,請像密碼一樣妥善保管。不要將完整連結貼到公開留言區,也不要為了方便匯入而交給來源不明的線上轉換網站。如需尋求協助,請只提供錯誤訊息、用戶端名稱與操作步驟,並先遮住截圖中的訂閱網址和帳號資訊。
01 匯入訂閱並啟用設定
開啟用戶端的「設定」或「訂閱」頁面,找到「從 URL 匯入」、「新增訂閱」或類似的新增連結按鈕。完整貼上剛才複製的訂閱網址;若有名稱欄位,可填入方便辨識的名稱。檢查網址的開頭與結尾,確認沒有連同說明文字、空格或換行一起複製,再點選「匯入」、「下載」或「儲存」。用戶端通常會先取得內容,再解析其中的代理、策略群組與規則。
下載完成後,頁面應會顯示設定卡片或檔案項目,可能也會列出名稱與更新時間。匯入成功後,還必須啟用這份設定:點選設定卡片,或開啟卡片選單並選擇「使用」或「啟用」。確認目前設定的標記已移至新項目,再前往「代理」頁面。看到策略群組及其可選項目,才表示設定已由核心載入;檔案出現在清單中,不代表設定已生效。
如何匯入現有的 YAML 檔案
如果服務提供的是本機檔案,請在同一個設定頁面選擇「從檔案匯入」,選取下載好的 .yaml 或 .yml 檔案,再依照前述步驟啟用。不要只把網頁另存成檔案再更改副檔名,這樣取得的內容可能仍是登入頁面。從檔案匯入通常會建立本機副本;之後能否自動更新,取決於用戶端與設定來源,不能預設它會像 URL 訂閱一樣持續更新。
匯入失敗時,先確認問題發生在哪個步驟
如果出現下載逾時或無法連線的提示,先確認目前網路能否連上訂閱服務,以及連結是否已過期。此時設定可能尚未載入,請勿立刻更換代理模式。若顯示 yaml: unmarshal errors、格式錯誤或無法解析,請檢查回傳內容是否符合用戶端支援的設定格式;連結可能回傳網頁或錯誤訊息,也可能根本不是 Clash 設定。不了解原因前,不要為了消除提示而刪除整段設定。
更新訂閱後,請重新確認目前設定的標記,確保實際使用的仍是預期項目。有些服務會變更策略群組名稱,原本選擇的出口也可能不再適用。YAML 與其他訂閱格式的差異,請參閱名詞解釋中的訂閱與設定檔;若反覆下載失敗,請前往問題排查,依照訂閱失敗的流程檢查。完成這一步的標準很簡單:設定已啟用,代理頁面看得到對應的策略群組,接著再選擇模式。
02 選擇規則模式與出口
載入設定後,在首頁、「代理」或「設定」中找到「規則/全域/直連」模式選項。初次使用請先選擇「規則」,對應的設定鍵為 mode: rule。此模式會依據目前設定中的規則,為請求選擇出口,例如讓部分請求直連,其他請求交由指定的策略群組處理。分流結果取決於設定內容,用戶端不會只靠模式名稱就自動判斷所有網站的用途。
接著開啟「代理」頁面,找到規則實際使用的主要策略群組。群組名稱可能是「Proxy」、「節點選擇」,也可能是服務自訂的名稱;請以目前設定為準,不必尋找與本教學完全相同的名稱。展開策略群組後,選擇可用的代理出口。如果群組內有「自動選擇」或「故障轉移」子群組,也可依設定設計選用,但請確認子群組中確實有可用項目。
切換代理模式與選擇策略群組出口是兩回事。即使已選擇規則模式,若規則引用的策略群組選到 DIRECT,對應請求仍會直接連線。反過來,在未被規則引用的策略群組中更換出口,也不一定會影響目前的網頁。初次測試只調整主要策略群組,並記下原本的選項;不要把每個群組都改一遍,以免失去比對基準。
何時使用全域或直連模式
「全域」會讓核心接管的請求使用全域策略群組,適合短暫比對:若同一個網頁在規則模式下無法開啟、切到全域模式後卻能開啟,接著就該檢查規則比對或策略群組選擇。這不代表裝置上的所有應用程式都會由核心接管;流量是否進入核心,仍取決於系統代理、VPN 或 TUN 的接管方式。切換至全域模式後,也要確認全域策略群組使用的出口,不能只切換模式就結束。
「直連」會讓核心處理的請求直接連線,適合暫時繞過代理出口進行比對,但不代表已結束用戶端,也不一定會取消系統代理設定。測試完成後切回「規則」,並再次確認主要策略群組的選項。若仍不清楚策略群組、規則與出口之間的關係,請先參閱策略群組說明;日常使用技巧請見常見問題。本頁接著說明如何建立基本連線。
03 啟用連線與系統接管
返回用戶端首頁或「設定」,確認核心正在執行。有些桌面用戶端會在啟動後自動執行核心,有些則需要先點選「啟動」。若頁面顯示核心啟動失敗,先查看日誌中第一筆相關錯誤,暫時不要再開啟其他設定。只有本機代理已正常監聽,系統代理才能將應用程式的請求送到正確位置;系統開關顯示已啟用,並不能取代核心的執行狀態。
桌面版先啟用系統代理
在 Windows、macOS 等桌面環境中,請先啟用「系統代理」,並暫時保持 TUN 關閉。系統代理通常會將遵循系統代理設定的瀏覽器與應用程式,導向本機監聽位址。啟用後請讓用戶端持續執行,不要直接結束程序;若程序已關閉但系統代理仍指向本機連接埠,瀏覽器可能無法連線。不同 Linux 桌面環境的代理支援程度不一,部分應用程式需要個別設定代理,不能只憑開關狀態判斷所有程式都已接管。
如果瀏覽器安裝了獨立的代理切換擴充功能,請先切換為使用系統設定,或暫時停用,避免它覆蓋用戶端設定的代理位址。同時中斷其他代理軟體與 VPN 的連線。先讓一個用戶端負責接管,確認基本連線正常後,再決定是否需要更複雜的組合。此時不要同時更改設定、連接埠與模式,否則發生問題時很難判斷是哪項設定造成影響。
行動裝置請確認系統 VPN 授權
Android 與 iOS 通常會在點選「連線」或「啟動」後,跳出系統 VPN 授權視窗。確認提示來自剛安裝且正在操作的用戶端,再允許建立連線。返回應用程式查看連線狀態,並確認系統 VPN 狀態顯示通道已建立。VPN 圖示代表流量接管方式,不表示訂閱中的每個出口都可用;之後仍須透過網頁與連線紀錄確認。
如果系統提示已有其他 VPN 正在使用,請先中斷另一個應用程式的連線,再返回目前的用戶端重新連線。若 Android 切換至背景後經常斷線,可在初次驗證成功後檢查電池最佳化與背景執行限制;iOS 則可在系統 VPN 設定中檢查目前連線設定是否正確。請勿將背景常駐問題與初次匯入訂閱混在一起處理,個別步驟請參閱行動裝置問題排查。
檢查本機連接埠,先別急著修改
桌面版的「連接埠設定」常見混合連接埠為 mixed-port: 7890,可同時接受 HTTP 與 SOCKS 代理連線;但不同設定可能使用其他數值,請以目前實際監聽的連接埠為準。手動為應用程式設定代理時,位址通常是 127.0.0.1,連接埠則填入用戶端顯示的混合連接埠。external-controller: 127.0.0.1:9090 是控制介面,不是瀏覽器上網使用的代理連接埠,請勿填錯。
日誌出現 address already in use 時,請先結束另一個占用連接埠的用戶端,再嘗試啟動。若確實需要更改混合連接埠,請先記下原值,儲存新值並依用戶端要求重新載入,接著確認系統代理與手動設定的應用程式也同步使用新連接埠。初次使用不必啟用「允許區域網路連線」;此功能是讓其他裝置連到本機,與目前裝置能否成功連線是兩回事。
04 確認網頁與實際請求流向
現在開啟瀏覽器並新增分頁,先造訪依目前設定預期會使用代理的網站,再造訪預期直連的網站。盡量選擇自己熟悉且平時可以開啟的頁面,不要只憑一個陌生的測試網站下結論。必要時重新整理頁面以送出新請求;瀏覽器快取和既有連線可能沿用先前狀態,因此切換設定後立即查看舊頁面,容易誤以為新設定沒有生效。
接著開啟用戶端的「連線」頁面,再重新整理剛才的網站。找到該網域的新請求,確認符合哪條規則、使用哪個策略群組,以及最後連往哪個出口。有些用戶端會在連線詳細資訊或請求鏈中顯示這些資料。網頁可以開啟,而且請求流向符合預期,才是比首頁連線圖示更可靠的驗證結果。看到 DIRECT 不一定代表錯誤,請先確認該網站原本是否就應該直連。
網頁能開啟,但連線頁面沒有紀錄
先確認頁面確實送出了新請求,而不是只顯示快取內容,再檢查瀏覽器是否使用系統代理。如果只有某個應用程式沒有紀錄,它可能使用獨立的代理設定,或不遵循系統代理。此時先別急著更換訂閱,應先分辨「流量沒有進入用戶端」還是「流量進入後出口連線失敗」。需要進一步接管時,再考慮 TUN,或依照應用程式文件自行設定代理。
請求已進入用戶端,但網頁仍無法開啟
開啟「日誌」頁面,通常先使用 info 等級即可。重新造訪一次無法開啟的頁面,查看同一時間出現的錯誤。i/o timeout 表示某項操作逾時,需搭配目標位址與連線階段判斷;no such host 通常表示網域名稱解析失敗;connection refused 則表示對方拒絕連線。不要只摘錄最後一個詞來判斷原因,請一併記下發生時間與對應請求,排查會更準確。
在主要策略群組中更換一個出口,只重試同一個頁面並觀察結果是否改變。若仍無法開啟,可暫時切換至全域模式並確認全域出口,以此比對是否與分流有關,之後再切回規則模式。持續逾時請參閱節點逾時排查;若規則涉及地區判定或資料庫載入,再查看GeoIP 相關問題排查。到這一步就不必再盲目重裝,已有足夠資訊進行針對性處理。
驗證通過後,保留可重現的設定
確認兩個測試頁面都符合預期後,保留目前設定、規則模式與已驗證的主要策略群組選項。需要更新訂閱時,請在設定頁面選擇「更新」,完成後再確認啟用狀態;不要只因清單出現新項目,就任意刪除仍在使用的設定。準備手動修改規則前,請先儲存一份可還原的副本,並了解用戶端是否提供覆寫或合併機制,以免下次更新訂閱時覆蓋本機修改。
最後測試正常中斷連線:桌面版先關閉系統代理,再依用戶端提供的「結束」方式離開;行動裝置則點選「中斷」或「停止」。確認一般網頁仍可正常開啟,再重新連線,確認操作可以重複完成。若要在開機後自動連線,請先閱讀Clash 開機自動啟動說明,了解啟動用戶端、啟動核心與啟用系統代理的差別。初次設定到此完成,之後只在確有需要時再新增 TUN、區域網路分享或自訂 DNS 設定。