初次設定/四步操作

Clash 快速入門:
匯入訂閱與連線測試

依序完成「匯入設定檔 → 選擇模式 → 開啟連線 → 測試請求」。若已安裝用戶端並準備好相容訂閱,可按照約十分鐘的初次設定流程操作。

開始前,請準備服務提供者提供的 Clash 相容訂閱連結,或可用的 YAML 設定檔。用戶端負責讀取設定、分流及建立代理連線;安裝用戶端本身不會產生訂閱,也不會自動提供節點。若只有伺服器位址,沒有通訊協定、連接埠和驗證資訊,通常還無法建立連線。

訂閱連結可能包含存取憑證,請勿貼到公開留言、線上轉換頁面或截圖中。需要向他人說明問題時,請先隱藏連結參數、節點密碼與個人資料。以下範例僅說明設定方式,不包含可直接使用的代理服務。

步驟 1/設定檔入口

匯入訂閱並設為目前使用的設定檔

開啟用戶端,進入「設定檔」、「Profiles」或「訂閱」頁面。選擇「新增」、「加入」或「從 URL 匯入」,將完整訂閱連結貼到連結欄位。名稱可填寫方便辨識的用途,例如「日常設定」;名稱只影響清單顯示,不會影響連線。確認欄位前後沒有多餘空格、換行或從通訊軟體複製而來的標點,再點選匯入或下載。

等待用戶端完成下載與解析。成功後,清單通常會顯示設定檔名稱、來源或更新時間。清單出現新項目,並不代表設定檔已啟用:請點選該項目,使用「啟用」、「使用此設定檔」或相應選項,將它設為目前使用的設定檔。有些用戶端會以勾選標記表示目前項目,另一些則會在總覽頁面顯示正在使用的名稱。

匯入後先檢查代理群組,暫時不用急著連線

切換至「代理」頁面,確認是否出現設定檔定義的策略組,例如 Proxy、節點選擇或自動選擇。名稱由設定檔作者決定,不一定與本頁相同。展開其中一個群組,正常情況下應該會看到節點或其他子群組。若頁面空白、只剩直連選項,或仍顯示舊設定檔的群組,請先返回設定檔頁面確認目前選取的項目,不要反覆開關系統代理。

若取得的是本機檔案,請選擇「從檔案匯入」或「匯入設定檔」,在檔案選擇器中選取對應的 .yaml 或 .yml 檔案,再執行相同的啟用操作。本機檔案匯入後不會自動變成遠端訂閱;日後節點有變動時,必須重新匯入,或使用設定檔中已宣告的遠端提供者更新機制。

分別處理下載失敗與解析失敗

「下載逾時」、「無法取得訂閱」通常表示尚未取得設定檔。請先檢查裝置網路、連結效期與服務提供者狀態;某些訂閱網址在特定網路環境下無法存取,請使用服務提供者提供的有效取得方式。不要將含有憑證的連結交給不熟悉的轉換服務,也不要只因瀏覽器無法顯示頁面,就認定訂閱已失效;訂閱介面可能會依賴特定的請求方式。

「解析失敗」、「不支援此欄位」則表示用戶端已取得內容,但無法以目前格式讀取。常見原因包括匯入了網頁網址、收到登入頁面,或訂閱輸出格式與核心不相容。請優先向服務提供者確認是否支援 Clash 或 mihomo 相容格式。需要檢查縮排或欄位時,再參閱YAML 手冊;初次連線不必自行重寫整份檔案。

確認設定檔已啟用、代理群組可展開後,再進行下一步。遠端訂閱更新可能會覆蓋直接編輯的節點與規則;初次設定請先保留原有內容。若長期需要自訂規則,再了解用戶端提供的覆寫或合併功能。訂閱來源與更新異常的補充說明,請參閱訂閱常見問題。

步驟 2/路由選擇

選擇規則模式,再選擇代理出口

在「代理」或「總覽」頁面找到模式切換,將目前模式設為「規則/Rule」。規則模式會依照目前設定檔中的規則順序處理請求:部分目標直連,其他則交由代理策略組處理。初次使用時保留訂閱內建規則即可;先確認整條連線流程正常,再考慮加入自己的分流需求。

模式與節點是兩個層級的設定。模式決定是否依規則處理流量;策略組則決定符合代理規則後使用哪個出口。請維持規則模式,展開預設代理群組,再點選已知可用的節點;若群組提供「自動選擇」或「故障轉移」,也可選擇相應子群組。請留意,有些群組預設可能選中 DIRECT,選取後代表該群組會直接連線。

確認選取的是實際使用的群組

同一份設定檔可能包含網頁、媒體、訊息等多個策略組,修改其中一個不一定會影響所有請求。請先找到其他群組引用的主要代理群組,或依訂閱說明選擇預設出口。若暫時無法判斷群組間的引用關係,請勿逐一任意修改;之後可從連線紀錄追查目標請求實際經過的策略鏈,再調整對應群組。

用戶端的連線測試可協助排除明顯不可用的選項,但測試成功只代表特定測試請求收到回應,不保證所有目標網站都能存取。請先選擇可通過測試的出口,再用實際需要存取的頁面確認。連續點選測試或頻繁更換節點,會讓問題來源更難判斷;每次只調整一項,並保留可比較的結果。

規則、全域與直連的適用時機

「全域/Global」會將進入核心的流量統一交由全域策略處理,但不會自動攔截裝置上所有應用程式的流量,也不等於開啟 TUN。若要判斷問題是否來自分流規則,可暫時切換至全域模式,並在全域策略中選擇可用節點。測試完成後請切回規則模式,避免原本適合直連的請求也繞道使用代理。

「直連/Direct」表示讓進入核心的流量直接連線至目標。這不等於關閉用戶端,也不代表已取消作業系統中的代理設定。若要完全停止代理接管,請依照第四步關閉系統代理或中斷行動裝置連線,而不只是將模式改為直連。

不熟悉「節點」、「策略組」、「規則」等名稱時,可參閱名詞解釋。需要編寫 rules、調整比對順序或設定遠端規則集時,再參閱YAML 手冊;這些都不是初次連線的必要條件。

步驟 3/流量入口

開啟系統代理或行動裝置連線

返回用戶端總覽頁,確認核心沒有啟動錯誤,再開啟流量入口。桌面端請先使用「系統代理」,行動裝置則使用「連線」或啟動按鈕。初次嘗試時只採用一種明確的接入方式,不要同時啟用其他 VPN、代理用戶端或瀏覽器獨立代理設定,以免不同工具互相覆蓋相同的系統設定。

桌面端:先開啟系統代理

在 Windows、macOS 或 Linux 用戶端中找到「系統代理」並開啟。部分用戶端會提示安裝輔助服務或允許變更網路設定,請依作業系統的授權視窗完成操作。確認提示來自目前使用的用戶端;若拒絕必要權限,介面上的開關狀態不一定代表系統設定已寫入,可前往系統網路代理頁面再次確認。

系統代理通常會讓會讀取系統設定的應用程式連上本機代理連接埠。多數瀏覽器可使用此入口,但各應用程式的實作方式不同,命令列工具、遊戲或使用自有網路堆疊的軟體不一定會跟著使用。請先測試瀏覽器,不要只因某個程式沒有透過代理連線,就判定是節點故障。下一步會介紹終端的個別測試方式。

若用戶端提示連接埠遭占用,請先關閉其他可能正在監聽的代理工具,再重新啟動目前的核心。若確實需要變更連接埠,請在設定中查看 HTTP 或混合連接埠的實際數值,並同步修改曾手動填入的應用程式代理位址。請勿照抄範例連接埠後就假設設定相符;連接埠值應以目前用戶端顯示為準。

Android 與 iOS:確認系統 VPN 授權

在行動裝置上選好目前使用的設定檔,再點選連線按鈕。首次啟動時,系統通常會詢問是否允許建立 VPN 連線或加入 VPN 設定,確認後返回用戶端查看連線狀態。VPN 權限用於建立系統流量入口,不代表訂閱已自動可用;有效設定檔、可用出口與成功授權缺一不可。

若按鈕剛開啟就自動關閉,請先查看用戶端錯誤提示,再確認是否有其他 VPN App 正在占用連線。Android 若啟用了依應用程式設定代理,請確認測試用的瀏覽器也包含在接管範圍內,並檢查系統是否限制背景執行。iOS 則請確認啟動的是目前選取的設定檔。請勿反覆解除安裝,應先查看錯誤原因。

確有需要時再啟用 TUN

若瀏覽器運作正常,但目標程式不讀取系統代理,可進一步了解 TUN。TUN 透過虛擬網路介面接管流量,通常還涉及服務權限、路由與 DNS 設定;開啟開關不代表一定能涵蓋所有程式。初次使用不必同時啟用系統代理與 TUN;請先建立可驗證的基本連線,再依用戶端說明逐項擴充。

辦公網路、遠端桌面與區域網路裝置可能仰賴特定路由,啟用 TUN 前請先保留原有連線資訊。需要調整 DNS 或 Fake-IP 時,請分別參閱DNS 設定參考與Fake-IP 說明。開啟連線入口後,請繼續測試實際請求,不要只看開關亮起就認為設定完成。

步驟 4/實際請求

測試瀏覽器、終端與連線還原

先開啟平時可直接存取的頁面,確認基本網路正常;再開啟確實需要透過代理存取的目標頁面。請盡量開啟新分頁或重新整理,避免只看到瀏覽器快取內容。測試期間維持相同節點與模式,發現差異時才能判斷是哪一層設定造成。

查看連線紀錄,確認流量路徑

開啟用戶端的「連線」或「Connections」頁面,並在瀏覽器重新發出請求,再尋找對應的目標網域。部分短時間請求很快就會結束,可透過搜尋、歷史紀錄或日誌協助定位。請留意目標、比對規則與策略鏈,而不只是用戶端是否顯示「執行中」。看到對應紀錄,才能確認該次請求已進入核心。

若紀錄顯示 DIRECT,先判斷這是否符合設定預期。規則模式本來就允許部分網站直連,這不代表連線失敗。若目標理應透過代理卻直接連線,請檢查符合的規則與相關策略組。若看得到代理策略鏈但仍無法存取,請進一步檢查節點是否可用、目標服務及日誌中的具體錯誤,不必立刻變更 DNS。

若完全找不到瀏覽器請求,請優先檢查系統代理是否成功寫入、瀏覽器是否使用獨立代理設定,以及擴充功能是否覆蓋代理入口。行動裝置也要確認測試 App 是否在接管範圍內。這時更換節點通常無法解決問題,因為請求可能根本沒有送到用戶端。

終端需要另外測試

命令列工具不一定會讀取系統代理。若用戶端實際使用的混合連接埠為 7890,可執行以下單次測試;若連接埠不同,請先將指令中的連接埠改為設定頁面顯示的數值。這個指令只會為這次請求指定 HTTP 代理,不會永久變更終端環境,也不需要管理員權限。

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

example.com 是用來說明指令寫法的範例網域,不代表代理服務。若要測試目標網站,請將它替換成實際要存取的 HTTPS 網址,並同時查看用戶端連線紀錄。收到回應標頭只代表該網址此次請求有收到回應;要確認出口,請查看連線紀錄中的策略鏈。不同目標網站可能因本身限制而回傳不同狀態碼。

明確指定代理後測試成功,但直接執行終端指令失敗,通常表示終端缺少代理入口設定,而非訂閱無效。之後可依所用工具的文件設定代理參數或環境變數;不要直接將通用指令寫入所有 shell 的啟動檔。工具、連接埠類型與變數作用範圍各不相同,設定前請先確認實際需求。

依序縮小故障範圍

瀏覽器無法存取時,先確認是否有請求紀錄;若有紀錄,再檢查比對的策略;策略正確後,再改用已知可用的節點。只有規則模式失敗時,可短暫切換至全域模式進行比對,並確認全域群組選取了有效代理。若全域模式可用、規則模式不可用,請優先檢查規則與群組選擇;兩種模式都失敗時,再檢查節點、網路與日誌。

不要一次同時修改模式、DNS、連接埠與 TUN。每次只調整一項,再重新發出相同請求並記錄結果,才能透過差異有效排查。更完整的問題分類請參閱常見問題;若已找到相關設定欄位,再前往YAML 手冊查看對應章節。

最後測試中斷連線與網路還原

確認測試通過後,桌面端請先關閉系統代理,再退出用戶端;行動裝置則點選中斷連線。重新開啟日常可直接存取的頁面,確認網路已恢復。若關閉用戶端後瀏覽器無法上網,請檢查系統是否仍保留指向本機的代理位址,並關閉遺留的手動代理設定。日後更換用戶端前,也應先撤除舊用戶端的流量入口。

日後更新訂閱時,先確認仍在使用正確的設定檔,再檢查原有策略組是否保留、選擇是否改變,最後以相同目標重新測試。記住這套簡短流程,比只記住某個用戶端的按鈕位置,更方便轉移裝置與排查問題。