QUICK START / 10 MIN

Clash 訂閱匯入與連線設定

從空白客戶端開始,依序完成匯入訂閱、選擇代理模式、啟動連線、核對結果。本頁僅處理首次使用的主要步驟,設定語法、DNS 路徑與系統層級故障排除請參閱專門文件。

PRECHECK / 00

開始前檢查

先確認客戶端能正常啟動、訂閱來源可用,並記下目前的系統代理狀態。遇到問題時,便能快速判斷卡在哪個層級。

CLIENT

客戶端已安裝

首次啟動後應能看到設定、代理或設定頁面。若系統阻止執行,請先完成系統安全確認與必要權限授予,不要同時修改代理、DNS 與 TUN。

PROFILE

訂閱連結完整

複製時請保留連結中的所有字元。聊天工具或網頁可能會折疊顯示長連結,應使用複製功能取得原始網址,不要手動抄錄省略後的文字。

NETWORK

基本網路可用

匯入前先關閉舊代理並測試一般網頁。基本網路本身中斷時,客戶端無法更新訂閱,也不能據此判斷代理節點是否可用。

Windows 介面定位

設定入口通常位於側邊欄的「訂閱」「設定」或 Profiles。連線階段先開啟系統代理;只有需要接管不遵循系統代理的程式時,才進入服務模式或 TUN 設定。首次授權可能會觸發系統確認視窗。

STEP 01
PROFILE INPUT

匯入訂閱

目標是讓客戶端取得一份可解析、可更新且已選取的設定。只看到訂閱名稱還不夠,設定內容還應包含策略組、規則與節點資訊。

開啟設定管理入口

啟動客戶端後,先在側邊欄、底部導覽列或選單列找到「設定」「訂閱」「Profiles」或「設定檔」。進入後通常會看到遠端訂閱輸入框、本機檔案匯入按鈕,以及已儲存的設定清單。首次使用時清單可能是空的,這是正常狀態。

選擇透過 URL 新增遠端設定,將完整訂閱連結貼到輸入框。若介面要求填寫名稱,可使用便於辨識的名稱,例如服務名稱或使用情境;名稱只影響本機顯示,不會改變訂閱內容。接著點選「匯入」「下載」「新增」或「更新」。

客戶端會先要求訂閱網址,再解析回傳的設定。請等待操作完成,不要在下載過程中連續點選多次。成功後,清單中通常會出現設定名稱、更新時間或節點數量等資訊;若客戶端顯示解析錯誤,應先處理錯誤,不要直接進入連線步驟。

將新設定設為目前設定

匯入成功不一定代表已啟用。有些客戶端會自動選取新設定,有些仍會保留先前使用的設定。點選新設定旁的「使用」「選擇」或單選標記,確認它成為目前設定。接著進入代理頁面,檢查是否出現「自動選擇」「節點選擇」「故障轉移」等策略組,以及組內是否有可選節點。

如果只有設定名稱,沒有任何策略組或節點,請先手動更新一次。仍然為空時,應檢查訂閱回應是否有效、連結是否完整,以及客戶端日誌是否回報 YAML 解析錯誤。設定檔欄位與規則語法的詳細說明可參閱名詞解釋;涉及回應異常、解析失敗與更新逾時的系統排查,請參閱疑難手冊

STEP 02
ROUTING MODE

選擇代理模式

模式決定請求如何匹配規則。首次設定建議優先使用規則模式,再為主要策略組選定節點,避免將模式問題與節點問題混為一談。

首次使用選擇規則模式

進入客戶端的「模式」「執行模式」或 Mode 設定,通常可看到規則、全域與直連三種選項。首次使用請選擇「規則」或 Rule。此模式會依照設定中的規則順序判斷網域、IP、程序或規則集,並將連線交給對應策略組。常見網站可直接連線,需要代理的請求則進入代理策略,日常使用更容易維持穩定。

全域模式會將大多數請求交給同一個代理策略,適合短時間判斷某個網站是否因規則未命中而無法存取,但不建議在首次設定時長期使用。直連模式會繞過代理,主要用於暫停代理或進行對照測試。切換模式後不必重新匯入訂閱,但應重新發出測試請求,避免將舊連線結果當成新模式的結果。

為策略組指定節點

選定模式後,進入「代理」「策略組」或 Proxies 頁面。找到負責主要代理流量的策略組,名稱可能是「節點選擇」「Proxy」「手動選擇」,也可能由設定提供者自訂。展開該策略組,從清單中選擇狀態正常的節點。若設定包含自動選擇組,可以先使用自動選擇,但仍需確認該組內至少有一個節點能完成測試。

多個策略組之間可能存在引用關係。例如「國外網站」策略組引用「節點選擇」,而「節點選擇」再指向具體節點。此時只修改最外層策略未必能改變實際出口。點入下一層,直到看到具體節點名稱,並確認選取標記已更新。策略組、規則匹配與回退關係的術語說明請參閱名詞解釋

系統代理與 TUN 不在同一層

規則、全域與直連決定核心如何分流;系統代理與 TUN 決定哪些流量能進入核心。首次操作請先保留規則模式,並在下一步啟用系統代理。只有當目標程式不遵循系統代理、需要接管更多應用程式,或需要處理特定 DNS 路徑時,再考慮 TUN。同時修改兩項設定會增加排查難度。

STEP 03
TRAFFIC HANDOFF

啟動連線

這個階段會將系統或應用程式流量交給客戶端。桌面版通常先啟用系統代理,行動版則透過系統 VPN 介面建立連線。

桌面版先開啟系統代理

返回客戶端主介面,找到「系統代理」「設為系統代理」或 System Proxy 開關。點選後等待狀態變化,確認開關維持開啟,而不是立即跳回關閉。部分 Windows 客戶端需要先啟動核心服務,部分 macOS 客戶端會要求修改系統網路設定;請依系統提示完成授權,再返回客戶端檢查狀態。

啟用系統代理後,遵循作業系統代理設定的瀏覽器與桌面應用程式會將請求傳送至 Clash 的 HTTP 或 mixed 連接埠。此時不要急著開啟 TUN,也不要手動修改系統代理位址。先完成下一步的瀏覽器驗證,可減少連接埠填寫錯誤與多種接管方式衝突的可能性。

行動版確認 VPN 授權

Android 或 iOS 客戶端通常會在主介面提供連線按鈕。點選後,系統會顯示 VPN 設定或連線要求。確認授權後,狀態列通常會出現 VPN 標記,客戶端主介面也會從未連線變為已連線。這個標記只代表系統通道已建立,節點是否真正可用仍需透過存取測試與日誌判斷。

如果系統沒有跳出授權視窗,可以進入系統的 VPN 設定,查看是否已有同類連線佔用。行動系統通常只允許一個主要 VPN 通道同時運作,其他網路工具可能導致新連線無法建立。關閉衝突連線後,返回 Clash 客戶端重試。

需要時再啟用 TUN

如果瀏覽器能透過系統代理存取,而遊戲、命令列工具或特定桌面程式沒有進入客戶端,可以再評估 TUN。桌面版開啟 TUN 時可能要求管理員權限、安裝服務元件或核准網路延伸功能。啟用後先維持原有規則模式不變,只觀察接管範圍是否改善。

TUN 涉及虛擬網卡、路由與 DNS 路徑,不適合在首次連線失敗時直接當作通用修復方式。系統代理與 TUN 的工作範圍、權限要求及衝突排查,請繼續閱讀疑難手冊的系統接管章節

STEP 04
RESULT CHECK

驗證是否生效

驗證不只是查看連線按鈕。還需同時觀察網頁存取、連線記錄、規則命中與節點結果,確認請求確實經過預期路徑。

先進行兩組存取測試

保持客戶端連線狀態,先開啟一個平時可直接存取的網站,確認基本網路沒有因代理設定而中斷。接著存取一個預期應由代理策略處理的目標。建議使用新開的瀏覽器分頁並重新整理一次,避免瀏覽器快取、舊連線或 Service Worker 讓結果看起來沒有變化。

如果一般網站與目標網站都能正常開啟,繼續查看客戶端的連線記錄。若一般網站可用、目標網站失敗,請重點檢查節點與規則策略;若所有網站都失敗,應先檢查系統代理連接埠、目前設定、核心執行狀態與本機 DNS,而不是頻繁更換訂閱。

在連線記錄中確認規則路徑

開啟「連線」「工作階段」「日誌」或 Connections 頁面,再重新整理剛才的測試網頁。清單中應出現新的網域、目標位址、規則名稱與策略鏈。找到對應請求,確認它命中預期規則,最後落到剛才選擇的節點。若記錄顯示 DIRECT,代表請求由直連規則處理;若顯示 REJECT,則是設定中的拒絕規則生效。

連線記錄中完全沒有新請求,通常表示應用程式流量沒有進入 Clash。桌面版請檢查系統代理是否仍然開啟,命令列程式則檢查是否讀取系統代理;行動版請檢查 VPN 狀態是否存在。若有記錄但持續逾時,代表接管路徑已建立,下一步應檢查節點連通性、網路限制或 DNS 解析。

檢查節點,不要只看延遲數值

客戶端提供的延遲測試有助於初步篩選節點,但測試成功不代表所有目標都能存取。選擇測試可用的節點後,應重新發出實際網頁請求,並以連線日誌中的建立結果為準。如果節點清單全部逾時,先確認訂閱剛剛更新成功,再切換基本網路進行對照。

完成測試後,保留規則模式與目前可用節點即可。此時基本設定已完成。之後若要調整 DNS、細化規則、設定開機啟動或處理特定應用程式,應逐項修改,每修改一項都重複本節的存取與日誌驗證,避免多個變數同時變化。

QUICK DIAG / 05

首次設定快速排查

僅處理最常見的入門問題。複雜的 DNS、TUN、系統服務與行動版故障,請轉至疑難手冊繼續檢查。

貼上訂閱後顯示下載失敗,該怎麼辦?

先關閉系統代理,確認目前基本網路能開啟一般網頁;接著重新複製完整訂閱網址,檢查連結前後是否帶有空格。若以瀏覽器開啟該網址也沒有回傳設定內容,問題出在訂閱回應或目前網路,不應繼續調整代理模式。若瀏覽器有回應但客戶端失敗,請查看日誌中的連線錯誤,並確認系統時間準確。

訂閱匯入成功但代理頁面沒有節點,該怎麼辦?

先確認新設定已設為目前設定,再執行一次更新。查看日誌是否出現設定解析、欄位格式或規則引用錯誤。只有訂閱名稱而沒有策略組,通常表示回應內容不完整或解析失敗。不要靠反覆啟動系統代理來解決設定層問題。

啟用系統代理後所有網站都無法存取,該怎麼辦?

先關閉系統代理以恢復基本網路,然後檢查客戶端核心是否正在執行、目前設定是否已選取、主要策略組是否指定節點。重新啟用後查看連線記錄:沒有請求表示流量未進入客戶端;有請求但全部逾時則檢查節點;出現 DNS 錯誤則進入疑難手冊的 DNS 章節繼續處理。

瀏覽器可以存取,其他軟體仍然直連,該怎麼辦?

這通常表示應用程式沒有讀取系統代理,而不是規則模式失效。先檢查應用程式本身是否提供代理設定;命令列工具可依其文件設定 HTTP 或 SOCKS 代理。需要統一接管更多應用程式時,再評估 TUN 模式,並在啟用後透過連線記錄確認流量路徑。

REFERENCE

術語與設定概念

需要了解策略組、規則分流、系統代理、TUN、DNS 與訂閱之間的關係時,請參閱依分類整理的名詞解釋。

查看名詞解釋
TROUBLESHOOTING

系統化故障排查

遇到節點逾時、訂閱失敗、速度異常、DNS 問題、系統代理未生效或客戶端崩潰時,請依症狀進入完整排查流程。

開啟疑難手冊