QUICK START / 初次設定

Clash 設定教學

匯入訂閱 → 選擇代理模式 → 啟用連線 → 確認設定生效。依序完成基本連線後,再調整 TUN、DNS 與分流規則。

開始前,請先安裝用戶端,並備妥服務提供者提供的訂閱連結或 YAML 設定檔。用戶端負責讀取設定並轉送連線;安裝完成不代表已有可用出口。首次操作建議預留約十分鐘。如果缺少訂閱、帳號權限或網路條件,請先備妥這些必要條件,不要反覆修改用戶端參數。

先關閉其他正在接管網路的代理或 VPN 工具,避免代理位址、虛擬網卡與路由互相衝突。保留原設定的副本,並記下系統原本的代理狀態。接下來每次只變更一類設定,並在進入下一步前確認結果;若發生異常,就能清楚知道該回復哪一步。

01 · 匯入訂閱並啟用設定檔

開啟用戶端,前往「設定」、「訂閱」或 Profiles 頁面,選擇「新增」、「加入」或「從 URL 匯入」。若跳出視窗要求選擇類型,請選擇遠端訂閱或遠端設定,而非新增單一代理。為設定檔取一個方便辨識的本機名稱,再將服務提供者提供的完整連結貼入 URL 欄位。名稱只影響本機顯示,不會決定連線使用哪個出口。

貼上後先檢查連結的開頭與結尾。從即時通訊軟體複製的內容有時會包含說明文字、換行或末尾標點;只保留連結本身,但不要刪改問號後的參數。訂閱網址可能包含存取憑證,請勿將完整連結貼到公開討論區,也不要傳送未遮蔽連結的截圖。需要求助時,保留錯誤訊息,並遮住網址中的敏感資訊。

點選儲存、匯入或下載,等待用戶端完成請求。正常情況下,設定檔清單會新增一個項目,並顯示名稱、更新時間或下載狀態。接著點選該項目的「使用」、「啟用」或選取標記,將它設為目前使用的設定檔。有些用戶端儲存後不會自動切換;清單中出現新項目,不代表執行中的核心已載入該設定。

確認代理群組已出現

切換至「代理」或 Proxies 頁面,確認是否出現可選擇的代理群組及其成員。代理名稱由設定檔提供者決定,不一定會叫做 PROXY。如果頁面只顯示 DIRECT、REJECT 等內建項目,請先回到設定頁確認目前選取的項目,再查看匯入提示。遠端代理提供者也可能需要另外下載;主要設定匯入成功,不代表所有遠端資源都已載入。

如果使用本機檔案,請在同一頁選擇「匯入檔案」,找到實際的 .yaml 或 .yml 檔案,再啟用它。單純將副檔名改成 YAML,並不會讓網頁、登入提示或錯誤頁面變成有效設定。檔案必須包含實際代理資訊,或能載入代理的 proxy-providers 定義;只有連接埠與規則的片段,通常不足以建立代理連線。

匯入失敗時,先查看錯誤類別。連線逾時表示請求未能順利完成;驗證失敗時,請確認訂閱權限;解析錯誤則需確認服務提供者提供的設定格式是否相容於目前的核心。請勿直接將私人訂閱提交至不熟悉的線上轉換網站。關於連結格式與轉換的限制,可先閱讀術語表中的訂閱與設定檔說明;具體故障排除方式請參閱說明中心。

02 · 選擇規則模式與出口

保持剛才的設定檔為啟用狀態,前往「代理」或「模式」頁面,找到「規則 / 全域 / 直連」選項。初次設定請選擇「規則」,對應的核心欄位為 mode: rule。用戶端會依設定檔中的規則,決定連線是直連、交由某個策略群組處理,或是拒絕連線。模式選項只負責分流決策,不會將其他應用程式的流量導入用戶端。

接著找到設定檔中負責選擇出口的策略群組。它可能顯示為「代理選擇」、「節點選擇」或其他名稱。展開群組,從成員中選擇可用的代理;如果成員仍是另一個策略群組,請繼續確認該群組目前選用的出口。初次驗證時,建議明確手動選擇出口,方便比對測試結果;不要同時修改多個業務分流群組。

有些設定檔預設選用自動測試群組。可以保留此設定,但請注意,測試結果僅反映用戶端連線至指定測試位址的狀況,不保證目標網站一定可連線。若用戶端提供連線測試按鈕,可以執行一次,查看是否逾時或出現明確錯誤。測試後仍須繼續進行實際連線驗證;單一測試數值不能證明所有應用程式都已由用戶端接管。

區分模式與流量接管開關

模式 連線處理方式 初次使用建議
規則 rule 依設定檔中的規則選擇處理方式。 適合日常使用,也是本教學建議的起點。
全域 global 所有進入核心的連線都交由全域策略處理。 僅在需要比較規則影響時短暫使用。
直連 direct 進入核心的連線直接連至目標。 用於特定情況的比較,不等於關閉流量接管。

「全域」模式也不會自動將原本繞過用戶端的應用程式流量導入核心。如果瀏覽器未使用系統代理,單獨切換全域模式通常無法解決流量未被接管的問題。同樣地,選擇「直連」也不代表系統代理設定或虛擬網卡已移除;若要完全停止接管,應關閉相應開關,而不是只切換模式。

如果規則模式下某個目標的連線方向不如預期,先記下狀況,不要立即刪除規則。後續的連線頁面會顯示匹配資訊,可用來判斷問題出在規則選擇還是流量接管。現在只需確認已選取規則模式,且出口群組已有明確選擇,再進入連線步驟。規則順序、策略群組巢狀設定與 MATCH 的詳細行為,請參閱完整文件的設定章節。

03 · 啟用系統代理或 VPN 連線

先返回用戶端首頁或總覽頁,確認設定載入後核心已啟動。如果介面將「啟動核心」和「系統代理」分成兩個開關,請先啟動核心,再啟用系統代理;如果只有一個連線按鈕,請依用戶端提示操作,並查看記錄確認沒有啟動失敗。此時不要同時啟用多個網路接管工具,也不要為了排除問題而關閉系統防火牆。

桌面版:先確認系統代理

Windows、macOS 與採用桌面環境的 Linux 用戶端通常提供「系統代理」開關。啟用後,遵循作業系統代理設定的應用程式會將請求傳送至本機監聽連接埠。請查看用戶端設定中的實際位址與連接埠,例如 127.0.0.1:7890;這只是常見設定,實際值以目前用戶端顯示為準,請勿為了配合教學中的數字而任意修改連接埠。

如果用戶端提示連接埠已被占用,請先關閉其他代理用戶端,再重新啟動核心。啟動記錄若出現 address already in use,即使系統代理開關看似已啟用,也不代表本機代理服務可正常使用。確認監聽成功後,再開啟新的瀏覽器視窗測試。有些應用程式會保留既有連線;必要時請完全關閉該應用程式後重新啟動,而非只重新整理舊頁面。

Linux 是否會套用桌面代理設定,取決於桌面環境與應用程式的實作;終端機程式也不一定會讀取系統代理。初次驗證請先使用支援代理設定的瀏覽器,不要立即以所有終端工具的結果作為判斷。伺服器、路由器或 systemd 服務的部署不屬於此圖形介面的入門流程,相關設定請參閱Linux 安裝與部署章節。

行動版:核准系統 VPN 授權

在 Android 與 iOS 上,點選用戶端的啟動或連線按鈕後,系統通常會要求建立 VPN 連線或新增 VPN 設定。請確認要求來自剛安裝且正在使用的用戶端,再依系統提示核准。返回用戶端後查看連線狀態;若取消授權,即使已選好設定檔,用戶端也不會開始接管網路。狀態列圖示只能表示隧道已啟用,不能證明遠端出口可用。

如果系統已有其他 VPN 正在執行,請先中斷該連線,再啟動目前的用戶端,避免兩個工具爭用系統 VPN 通道。初次測試時,請讓用戶端保持在前景並完成一次連線驗證;只有在前景運作正常、切換至背景後才中斷時,才檢查電池管理與背景執行權限。不要將背景執行限制誤認為訂閱失效,並因此反覆重新匯入。

何時再啟用 TUN

桌面版先使用系統代理,建立可重複的測試結果。若要接管未遵循系統代理設定的應用程式或特定類型的流量,再考慮使用 TUN。TUN 通常涉及虛擬網路介面、路由與 DNS 處理,可能需要管理員權限或用戶端服務支援。請依用戶端提示安裝服務,不要只憑開關顏色判斷安裝已完成。

初次啟用 TUN 時,請記下原本的系統代理狀態,並依照該用戶端對兩者搭配使用的說明操作;不要一次變更 TUN、DNS、路由與模式。若啟用後基本網路中斷,請先關閉 TUN,回到已驗證可用的系統代理方式。桌面版 TUN 與行動版 VPN 授權介面的名稱相近,但實際運作方式仍有差異;如需了解原理,請參閱網路接管模式術語。

04 · 確認連線與連線記錄

驗證時須同時觀察應用程式與用戶端。先關閉流量接管,確認目前網路可連線至平常正常使用的網站;如果基本網路本來就有問題,應先排查 Wi-Fi、行動數據或網路登入狀況。接著重新啟用代理連線,開啟需要檢查的目標頁面。請以新請求進行測試,不要只根據已快取的頁面內容判斷是否成功。

頁面載入後,立即返回用戶端的「連線」或 Connections 頁面,尋找剛才造訪的目標網域。新請求可能很快結束,必要時再次重新整理頁面,並開啟記錄輔助檢查。確認三項資訊:是否出現目標、命中哪條規則,以及最後交由哪個策略或出口處理。規則模式下,部分網站命中 DIRECT 是正常的分流結果,不代表整個用戶端沒有運作。

依照現象縮小檢查範圍

如果完全沒有目標連線記錄,先確認應用程式是否使用系統代理、核心是否確實在監聽,以及行動裝置的 VPN 是否仍保持連線。此時不應優先更換出口,因為請求可能根本沒有進入用戶端。若有連線記錄但流向不如預期,請檢查目前模式、命中規則與策略群組選擇,而不是重新安裝軟體。

如果已命中預期策略,卻出現逾時、拒絕連線或交握錯誤,請再確認選定的出口是否可用、訂閱權限是否有效,以及裝置時間是否正確。每次只更換一個出口,並對同一目標重試,保留前後結果。若只有特定網站異常,也應考量目標網站本身的狀態;不要以單一網站的成功或失敗來概括所有網路連線。

選用:明確指定本機代理進行測試

桌面版可使用以下指令,協助判斷本機代理服務與應用程式代理設定是否正常。此指令會明確使用本機 HTTP 代理,不受瀏覽器是否讀取系統設定影響。執行前請將連接埠換成用戶端實際使用的 HTTP 或 mixed 監聽連接埠;如果只啟用了 SOCKS 監聽,請勿使用此 HTTP 代理參數。

curl --proxy http://127.0.0.1:7890 --head --max-time 15 https://example.com/

在 Windows PowerShell 中,建議將指令開頭寫成 curl.exe,避免舊版環境中的同名別名改變參數意義。若收到 HTTP 回應標頭,表示這次透過指定的本機代理送出的請求已收到目標回應;但是否使用遠端出口,仍須查看用戶端連線記錄,因為規則也可能讓該目標直連。如果無法連線至本機位址,請先檢查監聽連接埠,而非直接修改 DNS。

指令成功但瀏覽器失敗時,請優先檢查瀏覽器本身的代理擴充功能、獨立代理設定與既有連線。瀏覽器正常但其他應用程式失敗時,請確認該應用程式是否支援系統代理,必要時再評估 TUN。外部 IP 查詢僅供輔助參考:規則分流時,不同查詢網站可能使用不同出口,因此 IP 沒有變化,不能單獨證明代理失效。

保留可重現的運作設定

測試頁面可正常連線,且連線記錄符合預期後,請保留目前的模式與接管方式。記下正在使用的設定檔名稱、實際監聽連接埠與選取的策略群組,日後排查會更有效率。要停止使用時,請先關閉系統代理或 VPN 連線,再退出用戶端;尤其是曾手動設定系統代理位址的裝置,請確認未留下指向已停止連接埠的設定。

訂閱內容變更時,請在設定頁更新;更新完成後,確認目前設定檔仍為啟用狀態,再重做本節的驗證。基本測試尚未完成前,不要加入複雜規則。若遇到更新失敗、UWP 應用程式未經代理,或只有部分程式無法連線,請前往說明中心依照現象排查;需要長期維護設定時,再繼續閱讀完整文件。

Clash 最新版下載