QUICKSTART / PROFILE → RULE → PROXY

Clash 訂閱匯入與代理設定

約 10 分鐘即可完成首次設定。先讓一份設定檔正常運作,再確認瀏覽器請求經由預期出口。實際所需時間視訂閱下載、系統授權與網路環境而定。

操作前準備

開始前,請確認已安裝用戶端並能開啟主視窗。準備一組有權使用的訂閱網址,或一份完整的 Clash YAML 設定檔。用戶端負責讀取設定、執行核心與管理請求路徑,本身不等於可用的代理服務;只有安裝程式而沒有設定檔,通常無法完成後續連線。

先暫時退出其他代理用戶端,並確認瀏覽器是否啟用了代理擴充功能、系統 VPN 或手動代理。初次設定時盡量只保留一種接管方式,否則瀏覽器可能仍透過另一組設定連線,導致用戶端開關狀態與實際瀏覽結果不一致。若使用公司、學校或受管理的裝置,請遵守裝置與網路使用規範,不要變更組織管理的代理設定。

訂閱 URL 可能含有帳戶識別資訊,請妥善保管,如同保護登入憑證。不要將完整網址貼到公開論壇、截圖或線上格式轉換網站。本文僅說明用戶端操作,不需要提交訂閱內容;遇到格式問題時,優先前往訂閱提供者的管理頁面,尋找明確標示為 Clash 或 mihomo 的匯出功能。

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

開啟左側的「設定檔」頁面,找到新增、匯入或遠端設定檔功能。將訂閱網址貼入 URL 欄位;若可填寫名稱,請使用容易辨識的用途名稱,例如「日常設定」。名稱僅供本機管理,不會取代訂閱網址,也不會決定代理出口。確認網址前後沒有空格、換行或從聊天工具複製而來的標點,再送出匯入。

送出後請等待下載完成,不要連續重複點擊。正常情況下,設定檔清單會新增一筆記錄,通常可查看名稱、來源或更新時間。不同版本可能會先儲存遠端記錄,再另外下載內容;若介面提供更新按鈕,可更新一次並確認沒有錯誤。新增記錄不代表核心已套用這份設定,下一步仍須啟用。

選取剛匯入的記錄,使用套用、啟用或設為目前設定檔等功能。確認目前設定檔標記已移至該記錄,再前往「代理」頁面查看是否出現設定檔定義的策略組。若代理頁面仍是空白,請返回設定檔頁面確認選取的記錄是否正確,再查看日誌是否有解析失敗或載入設定檔失敗的訊息。設定檔解析錯誤與系統代理是不同階段的問題,不要靠反覆切換系統代理來處理。

匯入本機 YAML 檔案

如果已有完整設定檔,請使用本機檔案匯入功能,選取副檔名為 .yaml 或 .yml 的檔案,再執行啟用操作。不要以為只要把副檔名改成 YAML 就完成格式轉換:網頁內容、QR Code 截圖和一般節點文字都不是完整設定檔。初次操作不必手動編輯檔案,先使用提供者提供的相容版本,建立可正常運作的基礎設定。

匯入本機檔案後,用戶端可能會另存一份副本。之後修改原始檔案,不一定會同步至已匯入的記錄,請以用戶端的編輯或重新匯入方式為準。遠端訂閱則透過更新功能重新取得內容,兩種來源的維護方式不同。若要了解記錄與實際執行檔案的差異,請參閱術語手冊中的 Profile 與設定檔說明。

匯入失敗時,先在此階段排查

下載失敗時,先確認網址是否已過期,以及目前網路能否連上訂閱服務。解析失敗時,請先確認回傳內容確實是 Clash YAML;帳戶登入頁面、服務錯誤頁面和 Base64 節點清單都不能只憑一個 URL 直接當成完整設定檔使用。不要將未確認的內容交給來路不明的線上轉換服務。如有轉換需求,請向提供者確認支援的轉換方式。

建議初次匯入成功後,先採用手動更新。需要定期更新時,再到遠端設定檔記錄中設定適當的更新間隔,並在更新後確認目前設定檔與策略組選擇仍符合預期。完成後,應已有一份可啟用且能顯示策略組的設定檔;接下來再設定請求如何分流。

02 / 選擇代理模式與策略組

在「儀表板」或「代理」頁面找到運作模式,初次使用請設為「規則」。規則模式會依照目前設定檔中的 rules 由上而下比對請求,再將請求交給對應的直連動作、代理或策略組。並非所有請求都會經過同一個出口,啟用規則模式也不會自動補上缺漏的規則;實際行為一律取決於已載入的設定檔。

若介面提供全域與直連選項,請先了解兩者用途。全域模式通常會將請求統一交由全域策略選擇,適合暫時確認分流規則是否影響結果,但仍須選擇有效出口。直連模式主要用於恢復直接連線或進行對照測試。首次連線成功後再嘗試其他模式,避免同時更改模式、設定檔和出口,導致排查時缺少明確的比較基準。

在代理頁面確認出口選擇

前往「代理」頁面,展開目前設定檔提供的選擇型策略組。策略組名稱由設定檔作者決定,不一定是 PROXY,也不一定與教學截圖相同。找到日常請求使用的主要選擇組,選取訂閱中可用的代理出口;若設定檔已提供自動選擇組,也可將主要選擇組指向該組。是否自動切換取決於策略組類型與參數,而非名稱中是否包含「自動」。

請分清兩者的關係:運作模式決定是否使用規則,策略組則決定命中規則後採用哪個出口。即使選好代理出口,若主要策略組仍指向 DIRECT,請求仍可能直連;反過來說,即使策略組選擇正確,測試網域若被更前面的規則交給 DIRECT,也不會經過該代理。無須立刻修改 YAML,先確認策略組的選取狀態,並保留設定檔原有的分流邏輯。

若策略組中沒有任何選項,請返回設定階段排查,不要繼續連線。可能原因包括訂閱內容不完整、代理提供者更新失敗,或規則引用的策略組與實際名稱不符。欄位層級與策略組引用屬於設定檔查閱內容,可參閱YAML 手冊。完成此階段後,請維持規則模式並選定明確的出口,再設定系統接管。

03 / 啟動核心並啟用系統代理

返回儀表板或設定頁面,確認核心正在執行。有些版本會在套用設定檔後自動啟動核心,另一些版本則提供獨立的啟動功能。若日誌持續顯示設定錯誤,請先修正設定;若顯示連接埠已被占用,請確認是否有另一個執行個體或其他代理程式仍在執行。能開啟應用程式視窗,不代表核心已成功監聽本機連接埠。

初次設定請保留用戶端原有的監聽連接埠,不要只為了配合某篇教學而更改。日誌中可能會出現類似以下的監聽訊息;範例連接埠僅供參考,並非所有安裝都必須使用。實際設定請以目前執行中的設定檔與本機日誌為準。

level=info msg="Mixed(http+socks) proxy listening at: 127.0.0.1:7890"

確認核心正在執行後,啟用「系統代理」。此開關通常會將作業系統的代理位址指向用戶端的本機監聽入口,供遵循系統代理設定的應用程式使用。若系統要求授權,請確認提示來自目前使用的用戶端,再依系統指示操作。開啟後請讓用戶端繼續執行,不要立刻關閉視窗或結束其背景程序。

先使用瀏覽器完成首次連線

開啟會遵循系統代理設定的瀏覽器,新增分頁並瀏覽網頁。暫時停用瀏覽器中另行設定代理的擴充功能,避免覆蓋系統設定。部分瀏覽器有獨立的網路代理選項,部分終端機工具則需要另行設定代理參數;這些應用程式未採用系統開關設定,不代表用戶端失效。初次驗證請優先選用設定方式最簡單的瀏覽器。

Windows 可在系統設定的網路與代理頁面確認手動代理狀態;macOS 可在目前網路服務的詳細設定中檢查代理;Linux 則請依桌面環境的網路代理設定確認。不同發行版或桌面工作階段對系統代理的支援可能不同。若用戶端提示寫入失敗,請勿只看開關外觀判斷結果,應前往系統設定確認實際位址與連接埠。

暫時不要同時啟用 TUN

本教學先透過系統代理完成一筆可觀察的瀏覽器請求,初次使用不必啟用 TUN。TUN 透過虛擬網路介面處理更多流量,還涉及權限、路由與 DNS 等條件;它並不等同於系統代理,也不是任何故障的萬用修復方式。若要接管不遵循系統代理的應用程式,請先閱讀TUN 與系統代理的術語說明,再依用戶端要求設定服務或權限。

手機通常需要在此階段點選連線,並允許系統建立 VPN 連線;系統可能會顯示 VPN 狀態圖示。該圖示只代表接管機制已啟動,無法單獨證明訂閱出口可用。無論使用哪個平台,下一步都應透過實際請求與用戶端記錄確認連線狀況。

04 / 確認規則與連線是否生效

讓用戶端持續執行,並在瀏覽器重新開啟平時可穩定存取的 HTTPS 網頁。同時開啟用戶端的「連線」頁面,查看重新整理網頁時是否出現對應網域或目標位址的連線記錄。若介面提供規則與路徑詳細資訊,請展開該記錄,查看命中的規則與最終使用的策略組。網頁成功開啟只是初步結果,記錄中的路徑才可用來確認分流是否符合預期。

選擇兩個用途明確的目標進行對照:一個依目前設定檔應直連,另一個應透過代理。先查看規則定義或連線詳細資訊,再判斷結果,不要只憑頁面內容或地理印象推測連線路徑。若兩次連線都顯示 DIRECT,請先確認運作模式與命中規則;若顯示經由所選策略組,但網頁仍無法開啟,再檢查該出口與遠端服務是否可用。

沒有連線記錄時,檢查接管路徑

先確認瀏覽器沒有沿用既有的長時間連線,再關閉測試分頁並重新開啟。若仍沒有對應記錄,請返回系統設定確認代理是否確實寫入,並檢查瀏覽器是否啟用了獨立代理設定。有些介面只顯示目前作用中的連線,短連線可能很快消失,可搭配日誌查看。不要為了保留記錄就立刻修改規則或 DNS。

網頁無法開啟時,請依序確認「設定檔已啟用 → 核心已啟動 → 本機連接埠正在監聽 → 系統代理已寫入 → 策略組出口已選擇」。每次只修改一個條件,再重試同一個網頁。這樣才能分辨本機接管失敗或出口連線失敗,避免一次更動多個參數,事後無法判斷是哪項變更造成影響。

透過日誌定位目前失敗階段

前往「日誌」頁面,優先查看剛才測試時間附近的錯誤或警告。設定檔解析錯誤,請返回匯入階段排查;監聽失敗,請檢查連接埠是否被占用;連線逾時,請依目標與所選出口判斷;網域解析錯誤,則需進一步檢查 DNS 路徑。分享日誌前,請移除訂閱 URL、帳戶資訊及其他敏感內容。詳細 DNS 欄位與規則寫法請參閱YAML 設定參考,初次驗證不必逐項重寫設定。

若透過外部網頁查詢出口位址,請注意該網頁只能反映存取它的那次請求,無法證明所有應用程式都走相同路徑。規則模式本來就允許不同目標使用不同出口。較可靠的完成標準是:設定檔載入成功、測試請求進入用戶端、命中規則符合預期,而且目標網頁能正常存取。

停止連線與下次啟動

測試完成後若要停止使用,請先關閉系統代理,再退出用戶端。若曾使用 TUN,也要關閉相應的接管開關,並依用戶端流程停止服務。直接結束程序可能使系統保留指向本機連接埠的代理設定;若因此導致瀏覽器無法連線,請先還原系統代理設定,不要立刻重新安裝軟體。

下次啟動時,確認目前使用的是預期的設定檔,遠端訂閱能正常更新,再檢查模式、策略組與系統代理狀態。暫時不要同時啟用開機啟動、自動接管與複雜覆寫,先保留今天已驗證可用的設定。若要新增自訂規則、切換多份設定檔或使用覆寫功能,再參閱 YAML 手冊逐項調整,並在每次修改後重做本節的驗證流程。

下載最新版 Clash