步驟一:匯入訂閱並啟用設定
開啟用戶端,進入「訂閱」、「設定」或類似的設定管理頁面,找到「新增」、「匯入」或加號入口。使用訂閱網址時,選擇從連結匯入,並將完整網址貼到 URL 欄位。名稱可填寫方便辨識的文字,以區分不同設定;名稱不會改變訂閱內容。確認網址前後沒有多餘空格、換行或聊天軟體附加的標點,再點選儲存或下載。
訂閱網址與服務商網站首頁、帳戶登入頁面並不相同。正確的網址會傳回設定資料,或用戶端可辨識的訂閱資料;若貼上網頁網址,可能會得到 HTML 內容或格式解析錯誤。複製時請使用服務提供者標示為 Clash 或 mihomo 相容的訂閱入口。網址可能包含帳戶授權資訊,請勿將完整連結貼到公開討論區,也不要為了排查問題而上傳含有網址的完整截圖。
儲存後請等待訂閱下載完成。部分用戶端會自動啟用新設定,其他用戶端則需要點選設定項目、勾選標記或按下「使用」。留意頁面是否出現目前設定的標示,接著切換到「代理」頁面。若能看到該設定提供的策略組與選項,表示匯入及載入設定已進入下一階段。只看到訂閱名稱,並不足以證明該檔案已成為目前執行中的設定。
使用本機 YAML 檔案
若取得的是設定檔,請在匯入選單中選擇「從檔案匯入」,開啟本機的 .yaml 或 .yml 檔案,再將其設為目前設定。請勿將整份 YAML 貼到訂閱 URL 欄位。本機檔案匯入後通常只會儲存當下的內容;除非另外設定更新來源,否則不能假設它會隨服務商的訂閱自動更新。
首次匯入時不建議立即修改節點密碼、協定欄位與規則。先以原始設定完成一次連線,能縮小排查範圍。若用戶端提示欄位不受支援,應確認訂閱格式是否符合核心需求,而不是直接刪除錯誤行。有些節點協定或欄位需要 mihomo 支援,舊版用戶端未必能讀取;可先查看用戶端選擇指南,再決定是否更換用戶端。
下載失敗時,先檢查來源
若出現逾時、授權失敗或解析失敗,請先確認裝置目前可以正常連線,再重新複製訂閱網址。授權錯誤通常需要前往服務商帳戶頁面確認連結是否仍有效;解析錯誤則應核對是否選錯訂閱格式。自動更新間隔暫時維持預設值,避免短時間內反覆重新整理。更多錯誤類型與處理方式請參閱訂閱更新失敗排查。
完成此步驟後,應能明確指出目前啟用的是哪份設定,並在代理頁面找到策略組。接著先決定請求如何分流,再啟用系統網路入口,首次連線時便有可供核對的路徑。
步驟二:選擇規則模式與策略組
回到首頁、代理頁面或模式設定區,找到「規則」、「全域」、「直連」選項。首次使用建議選擇規則模式。這對應設定中的 mode: rule:已進入核心的請求會依 rules 順序比對,再交由規則指定的節點、策略組或直連出口處理。規則模式並非自動判斷所有網站用途的開關,實際行為仍由目前設定中的規則決定。
「全域」模式會將進入核心的請求交給全域策略組,通常還需要在該組選擇出口。「直連」模式則會讓進入核心的請求直接連線至目標。此處的模式只決定核心收到請求後如何處理,並不負責將所有應用程式的流量送入核心。因此,即使選擇全域,也不能據此判斷某款遊戲、命令列工具或其他應用程式已使用代理。
| 介面模式 | 對應值 | 首次設定時的用途 |
|---|---|---|
| 規則 | rule | 依訂閱提供的分流規則處理,適合作為起點。 |
| 全域 | global | 暫時用來比對規則與出口問題,需選擇全域組。 |
| 直連 | direct | 對進入核心的請求採用直連,不代表用戶端已關閉。 |
展開策略組並選擇出口
將模式設為規則後,開啟「代理」頁面,展開設定提供的主要選擇組。組名由訂閱作者定義,可能是中文或英文,不一定叫做「PROXY」。找到可手動選擇的組,點選一個可用節點。對應的設定類型通常是 type: select;若組內包含其他策略組,還需要展開下一層,確認最後選取的出口符合預期。
若目標組目前選擇的是 DIRECT,引用該組的請求便會直連;若選擇拒絕出口,請求則可能失敗。不要只檢查某個節點旁是否有選取標記,也要確認規則實際引用的是不是這個組。對於 url-test 等自動選擇組,用戶端通常會依設定中的測試邏輯選擇節點,不必勉強把它當成手動選擇清單來操作。
若用戶端提供延遲測試按鈕,可以執行一次,確認節點是否能完成指定的測試請求。測試結果只反映測試網址與當下的網路狀況,不代表所有網站都能存取,也不等於實際下載速度。不要連續切換多個節點後再猜測哪次設定生效;保留一個選擇,進入下一步建立連線,最後透過實際網頁請求與連線紀錄核對。
部分用戶端會記住上次選擇的策略組。切換訂閱後,仍應重新檢查目前選項,不要以為名稱相同就代表節點內容也相同。需要了解組與組之間的引用關係時,再參閱策略組欄位參考;首次使用只要確認目標組有明確且可用的出口即可。
步驟三:啟用系統代理或 VPN 連線
現在設定已載入,模式與策略組也已確定,接著還需要將應用程式請求送到用戶端。用戶端顯示「執行中」通常表示核心已啟動,但不一定代表瀏覽器正在使用它。電腦系統代理、手機 VPN 與 TUN 是不同的流量入口,請勿與規則模式混為一談,也不必為了首次連線同時開啟所有開關。
電腦:先使用系統代理
在 Windows 或 macOS 用戶端的首頁、設定頁或系統匣選單中找到「系統代理」,並將其啟用。它通常會將系統 HTTP/HTTPS 代理指向本機監聽位址與連接埠。首次驗證請使用遵循系統代理設定的瀏覽器,並讓用戶端保持執行。macOS 可能會要求允許更改網路設定;請閱讀系統提示,確認要求來自剛安裝的用戶端後再授權。
Linux 桌面環境對系統代理的支援方式各有不同。若用戶端已開啟系統代理,但瀏覽器沒有產生連線紀錄,請檢查桌面網路設定或瀏覽器本身的代理設定。手動設定時,本機位址通常是 127.0.0.1,連接埠則以用戶端目前顯示的監聽連接埠為準,不能將範例連接埠視為所有安裝環境的固定值。使用 mixed-port 時,同一連接埠可接受 HTTP 與 SOCKS 請求,但應用程式仍須選擇正確的代理類型。
首次使用不需要啟用「允許區域網路連線」。本機瀏覽器使用本機代理,與讓其他裝置存取電腦代理是兩回事。也不需要為了驗證瀏覽器而同時啟用 TUN;TUN 涉及虛擬網卡、路由與 DNS,適合在確認基本連線後再單獨設定。欄位與權限需求詳見設定參考中的網路入口說明。
手機:允許系統 VPN 設定
在 Android 或 iOS 用戶端點選「啟動」、「連線」或主開關。首次連線時,系統可能會彈出新增 VPN 設定或連線要求。確認應用程式名稱後允許,依系統指示完成裝置驗證,再返回用戶端查看連線狀態。系統顯示 VPN 標示,代表相應的網路入口已建立;是否透過代理節點連線,仍取決於步驟二的模式、規則與策略組選擇。
測試期間請先中斷其他 VPN 或代理工具,以免路由互相衝突。若 Android 設定了依應用程式代理或略過清單,請確認測試用的瀏覽器沒有被排除。若手機只有在鎖定螢幕後才斷線,再檢查用戶端的背景執行與系統電池限制;首次連線前不必一次修改所有背景選項。
若開關立即回到關閉狀態,請先開啟「日誌」,查看啟動時附近的錯誤。連接埠被占用、設定解析失敗與系統授權未完成,處理方式各不相同。記下錯誤文字與發生位置即可,請勿直接公開整份設定。待用戶端持續執行且入口開關維持啟用後,再進入最後一步驗證;只看狀態圖示還不能算完成檢查。
步驟四:確認請求是否走預期出口
開啟瀏覽器,造訪一個已知可正常使用 HTTPS 的網頁,並發出新的請求。不要只觀察先前已開啟的頁面,因為頁面可能使用快取,既有連線也可能繼續沿用舊路徑。可以開啟新分頁並重新載入目標網址,接著立即切回用戶端的「連線」頁面,依網域名稱或處理程序尋找剛才的請求。
先查看連線紀錄,再檢查出口 IP
若用戶端能顯示規則與出口路徑,請核對三項:目標網域是否符合剛才造訪的網站、命中哪條規則,以及最後使用哪個節點或直連出口。在規則模式下,部分網站命中 DIRECT 是正常情況,不應把所有直連紀錄都視為失敗。請選擇預期會走代理的目標,檢查它是否進入指定策略組,並沿著組別路徑找到最終出口。
若要比較出口 IP,可在相同網路環境下,比對連線前後由可信任的出口查詢網站顯示的公用 IP。關閉瀏覽器後重新開啟並發出請求,避免沿用舊連線。IP 不同只能作為其中一項證據;若查詢網站依規則設為直連,IP 沒有變化也不能證明所有代理請求都失敗。應一併參考出口結果與用戶端連線紀錄,不要只憑網頁顯示的地區名稱下結論。
日誌與連線頁面可能包含造訪過的網域等資訊。排查時只保留與測試請求相關的片段;分享前請移除訂閱網址、帳戶資訊及無關的瀏覽紀錄。驗證完成後,可關閉暫時啟用的詳細日誌,避免持續記錄超出排查所需的內容。
未生效時,依入口順序逐項檢查
- 代理頁面沒有策略組:返回訂閱匯入步驟,確認下載已完成且設定已啟用。不要先修改系統網路參數。
- 瀏覽器連線時沒有對應紀錄:檢查系統代理或手機 VPN 是否已啟用、瀏覽器是否略過系統代理,以及是否被依應用程式規則排除。連線紀錄可能很快消失,可以重新發出請求並觀察。
- 有紀錄但走直連:檢查目前模式、命中的規則與策略組選擇。若暫時切換為全域模式進行比對,記得選擇全域組,並在測試後恢復規則模式。
- 有代理紀錄但請求失敗:保持測試目標不變,改用另一個已知可用的節點重試,再查看相關日誌。節點測試成功不代表一定能連上目標網站。
每次只變更一項設定,再發出一次新請求,才容易找出原因。若瀏覽器可用但其他應用程式無法使用,表示首次連線的主要步驟已完成;接下來應檢查該應用程式是否支援系統代理、是否使用獨立代理設定,以及是否需要其他流量入口。DNS、Fake-IP、TUN 與規則覆寫不屬於首次連線步驟,相關語法請參閱config.yaml 設定參考。
結束使用與下次啟動
電腦準備退出用戶端時,請先關閉系統代理,再結束程式。否則系統可能仍會將請求送往已停止監聽的本機連接埠,導致瀏覽器突然無法連線。手機則使用用戶端的停止或中斷按鈕結束連線;若先前啟用了系統的「永遠開啟 VPN」或「封鎖未使用 VPN 的連線」選項,也請確認是否符合目前的使用需求。
下次啟動後,先確認目前設定與策略組選擇是否保留,再啟用網路入口。訂閱更新可能會變更節點與規則;更新後若出現異常,應重新檢查相關策略組,而不是直接覆蓋整份檔案。在連線頁面核對一次實際請求所命中的規則與最終出口,才算完成這次入門流程。