# quick-start

匯入 Clash 訂閱並完成首次連線

依四個步驟完成設定:匯入訂閱、選擇規則模式、接管流量、確認出口。已有可用訂閱的話,首次設定約需十分鐘;遇到異常時先停在目前步驟,不要一次修改多項設定。

# prerequisites

開始前的準備

先從下載中心選擇適用於目前作業系統與處理器架構的客戶端,安裝後啟動。客戶端用來載入設定、執行核心及管理代理;安裝完成不代表已有可用出口。你還需要相容的 Clash 設定檔,或由服務提供者產生的訂閱連結。本網站不提供節點帳號,也不提供訂閱服務。

第一次操作前,先暫停其他正在執行的代理客戶端、瀏覽器代理擴充功能,以及可能接管網路的 VPN。多個程式同時修改系統代理、路由或 DNS,會讓後續結果難以判斷。先保留客戶端預設的連接埠與 DNS 設定,也先不要啟用開機啟動、區域網路分享或 TUN。先確認最基本的連線路徑可用,再逐項新增功能。

確認系統日期與時間正確,並且未啟用代理時,一般網頁也能正常開啟。如果安裝受到系統權限限制,或需要查看特定平台的安裝細節,請先閱讀完整文件中的事前準備。本頁只說明首次連線的主要流程;底層協定與網路堆疊的說明請參閱術語手冊。

# 第 01 步 · profiles

匯入訂閱並啟用設定

開啟客戶端側邊欄中的「設定」或「訂閱」頁面,尋找「新增」、「加入」或「從 URL 匯入」等選項。選擇遠端設定類型,在網址欄貼上服務提供者給的 Clash 訂閱連結,取一個容易辨識的名稱,再按下下載或儲存。這裡要輸入的是訂閱介面網址,不是帳號登入頁、購買頁面或說明文件的網址。複製時請檢查前後空格與換行,尤其不要連同通訊軟體附帶的標點一起複製。

送出後,等候設定下載完成。不同客戶端可能會顯示更新時間、下載成功訊息,或新增一張設定卡片。接著還要選取這份設定,按下「啟用」、「設為目前設定」或卡片上的選取按鈕,讓核心實際載入。只把連結存進清單,不一定會切換目前使用的設定;如果代理頁仍沒有策略組,先回到設定頁確認目前選取的項目,不要馬上重複安裝客戶端。

設定載入成功後,進入「代理」頁面,應該會看到策略組及可選的出口。組名由設定作者決定,可能是「代理選擇」、「節點選擇」或其他名稱,不必尋找完全相同的固定名稱。先確認清單有顯示即可,暫時不要修改節點參數。設定中只有少數分組,也不代表匯入失敗;有些設定會透過遠端提供器載入節點,可能需要等待更新。

使用本機檔案時

如果取得的是 YAML 檔案,請在設定頁選擇「從檔案匯入」,使用系統檔案選擇器開啟檔案,再執行啟用操作。不要把單一節點分享連結當成完整 YAML 設定匯入;完整設定還可能包含策略組、規則與 DNS 設定。客戶端是否接受單一連結,取決於本身的匯入功能;若無法辨識,請向服務提供者索取明確標示適用於 Clash 或 mihomo 的設定格式。

如果匯入時顯示解析錯誤,先查看錯誤指出的行號或欄位,並確認下載內容是否被替換成登入頁面。若顯示下載失敗,請檢查訂閱是否仍在有效期限內、帳號狀態是否正常,以及目前網路能否連上訂閱網址。此時代理尚未建立,不要把所有下載問題都歸咎於節點故障。能開啟訂閱網址,也不代表回傳內容一定相容;格式差異請參閱術語手冊中的訂閱與設定檔分類。

完成這個步驟的判斷方式:目前設定已選取,核心沒有持續回報設定載入錯誤,而且代理頁已顯示可用的策略組。接下來只需選擇代理模式,先不要編輯訂閱產生的規則檔,以免下次更新時手動修改的內容被覆蓋。

# 第 02 步 · mode: rule

選擇規則模式

前往客戶端的「代理模式」設定,通常位於代理頁上方、設定頁或系統匣選單。首次連線請選擇「規則」。規則模式會讓核心依設定中的規則順序,判斷每條連線要直接連線、交由特定策略組處理,或拒絕連線。這不是單純依應用程式所在區域判斷,也不代表所有網站都會透過同一個節點;實際連線路徑由目前設定決定。

選好模式後,查看主要出口策略組目前選取的項目。如果組內包含「直連」、「自動選擇」和個別節點,代表它們是不同的出口選項。為了讓首次測試容易重現,可以先選取明確的節點,或進入自動選擇組查看目前使用的節點。不要只看到組名就認定已選好遠端出口:策略組也可能引用其他組,請沿著選擇關係確認最終出口。

三種代理模式的首次使用比較
模式流量進入核心後的處理方式首次操作建議
規則依規則順序比對目標,並交由對應策略處理。適合作為日常使用及首次驗證的起點。
全域交由全域策略所選的出口處理。短暫切換以協助排查,完成後切回規則模式。
直連直接連線至目標,不經過遠端代理節點。停用遠端出口時使用,不能用來測試節點。

這裡有一個容易混淆的界線:代理模式決定已進入核心的流量如何處理;系統代理與 TUN 則決定流量能否進入核心。因此,切換成全域模式不會自動接管所有應用程式;如果應用程式不讀取系統代理,光是切換模式,連線面板仍可能看不到該應用程式的流量。下一步會另外設定流量入口。

首次執行時,先保留訂閱提供的預設規則,不要同時修改 rules、proxy-groups 與 DNS。若需要了解首條命中、預設規則與策略組巢狀設定,請參閱術語手冊的規則與分流分類;要手動修改設定時,再前往完整文件。這個步驟只需確認模式為規則,並了解主要策略組最終指向哪個出口。

# 第 03 步 · connection

選擇節點並接管流量

測試 Clash 節點延遲

在「代理」頁面開啟需要使用的策略組,點選組內的「測試」、「延遲測試」或測速圖示,等待結果顯示。延遲測試通常會透過代理連線至指定測試網址,用來判斷該路徑目前是否有回應。這不是頻寬測試;延遲數值較低,不代表下載速度一定較快,也不保證每個服務網站都能連線。先選擇測試成功、地理位置符合需求的節點即可。

點選節點後,確認選取標記是否移至目標項目。如果目前策略組屬於自動測試類型,客戶端可能依設定自動選擇出口,不一定能永久固定某個節點;若要手動選擇,請在支援手動選取的組別中操作。不要在不同分組間反覆點選,卻忘了主要策略組實際引用的是哪一組,否則畫面上顯示的節點可能不是目標連線最後使用的節點。

如果所有節點都顯示逾時,先更新一次訂閱,確認服務帳號與流量額度正常,再測試其他節點。測試網址本身無法連線,也可能造成一批節點逾時,因此不要只根據一次測試結果下結論。可以繼續設定流量接管,再透過目標網頁和連線面板交叉確認;若所有實際連線也都失敗,請依照設定常見問題逐步排查。

啟用 Clash 系統代理

在桌面版客戶端的設定頁找到「系統代理」並啟用,確認核心正在執行。系統代理會將支援此系統設定的應用程式導向客戶端監聽的連接埠;請以客戶端目前顯示的連接埠為準,不必為了符合教學而改成特定數字。啟用後關閉原有網頁分頁,再重新開啟頁面,讓瀏覽器建立新連線。舊連線可能繼續沿用原本的路徑,不能只根據舊頁面仍可瀏覽來判斷新設定是否生效。

Android 或 iOS 通常不會使用桌面版同名的系統代理開關,而是在客戶端中點選啟動或連線,再允許系統顯示的 VPN 授權。這項授權代表允許客戶端建立本機流量接管通道,不表示訂閱節點已可使用。看到系統 VPN 標示後,還需要繼續進行下一步確認。如果已有其他 VPN 正在執行,請先停止,再啟動目前的客戶端。

何時需要使用 TUN

如果瀏覽器可以透過代理連線,但某個應用程式始終沒有出現在連線面板中,可能是該應用程式不遵循系統代理。這時才考慮使用 TUN:它透過虛擬網路介面與路由規則接管流量,通常需要服務元件或管理員權限。首次設定時不建議同時開啟系統代理和 TUN 碰運氣;先確認系統代理可正常運作,再依客戶端說明單獨測試 TUN,才知道設定變更的影響。

TUN 的 DNS 與路由設定牽涉較多變數,不能只靠一個開關保證適用於所有環境。需要使用時,請閱讀對應平台的完整設定章節;術語說明可參閱DNS 與網路堆疊。這次只要所需應用程式已有明確的流量入口,就可以繼續確認,不必啟用所有功能。

# 第 04 步 · verify

確認代理與規則生效

保持客戶端開啟,前往「連線」頁面,再用瀏覽器新開一個目標網頁。優先選擇你確實需要使用,而且依目前規則應透過代理連線的服務。回到連線面板,以網域搜尋相關記錄,查看命中的規則、策略組與出口路徑。不同客戶端顯示的欄位可能不同,但只需確認三件事:請求是否進入核心、命中哪項策略,以及最後是否經過預期節點。

如果記錄顯示連線經過選定的策略組與遠端節點,就表示這次連線確實使用了代理。再開啟一個依目前設定預期應直接連線的目標,確認是否顯示 DIRECT。兩種請求都符合設定,才能確認分流路徑大致正確;只看到客戶端顯示「執行中」,只能證明程式或核心已啟動,不能證明瀏覽器流量已被接管,更不能證明每條規則都符合預期。

如果連線面板只顯示活動中的連線,短時間請求可能很快消失;可以重新載入頁面並及時查看。部分客戶端也提供連線歷史或記錄,方便追蹤。網頁會連線至多個網域,頁面主體、圖片、登入及影片資源可能命中不同規則,因此不要只根據一筆附屬資源推斷整個網站的連線路徑。先確認主網域,再檢查失敗資源對應的連線記錄。

依觀察結果找出問題環節

面板完全沒有相關請求:先確認目前客戶端的核心是否正在執行、系統代理是否確實啟用,以及瀏覽器是否被其他擴充功能指定使用個別代理。也請確認你查看的是目前使用的客戶端,而不是另一個仍在背景執行的執行個體。先讓請求出現在面板中,再排查節點;流量尚未進入核心時,反覆切換節點通常無法解決問題。

有請求,但出口不符預期:查看命中的規則與策略組目前的選擇,確認沒有停留在直連模式,或將主要策略組設為直連。若要短暫對照,可以切換至全域模式,明確選取同一個可用節點,再重新建立連線。全域模式正常、規則模式異常時,優先檢查規則與策略組的引用關係。測試完請切回規則模式,不要把對照設定當成最終設定。

出口正確,但頁面無法載入:換用另一個可用節點,再嘗試連線至同一個目標,觀察是只有單一服務失敗,還是所有目標都無法連線。節點連線狀況、目標服務限制、帳號狀態與 DNS 都可能影響結果,不要直接關閉憑證驗證或大量修改網路設定。檢查出口 IP 可作為輔助依據,但它只反映這次查詢的出口,無法證明其他應用程式或網域也使用相同路徑。

儲存可重現的正常設定

確認設定生效後,記下目前的設定名稱、代理模式、主要策略組選擇及流量接管方式。可以擷取設定畫面留存,以便日後比對,但截圖中不要包含訂閱網址。若需要自動更新訂閱,請在設定項目中選擇合適的更新週期;更新後若策略組有所變動,或選擇被重設,請重新確認主要策略組,不要只確認下載成功而忽略實際出口。

關閉桌面版客戶端前,先停用系統代理,或確認客戶端能在結束時還原系統設定。否則系統可能仍將連線送往已停止監聽的本機連接埠,導致一般網頁也無法開啟。行動裝置則使用客戶端的停止連線功能,並確認系統 VPN 已結束。首次連線到此完成;開機啟動、背景持續執行與 TUN 等功能,之後可依需求逐項設定,不必一次完成所有調整。