平台切換提示：Ubuntu、Windows 和 macOS 用戶端的功能入口通常標示為「設定」、「訂閱」、「代理」或 Profiles、Proxies；Android 和 iOS 則通常透過系統 VPN 授權接入流量。下方按鈕名稱僅供辨識操作位置，實際名稱請以所用用戶端為準。切換平台時依照相同操作順序即可，不必尋找完全相同的介面。

開始前，請準備一個相容的用戶端，以及可信來源提供的訂閱網址或本機 YAML 設定檔。用戶端負責提供操作介面與系統整合，mihomo 等核心則負責讀取設定和處理連線；只安裝用戶端，通常還沒有可用的代理出口。本教學不提供訂閱資源，也不要求一開始就修改複雜欄位。若已有設定且網路正常，可先花約十分鐘完成基本流程，再依實際需求補充設定。

本頁先採用「規則模式 + 桌面系統代理」這種容易觀察、也方便還原的方式。伺服器部署、通訊協定差異與核心相容性並非首次連線的必要步驟，有需要時再閱讀通訊協定與核心參考。如果尚未安裝用戶端，請先前往Linux 下載頁面或相應平台頁面選擇安裝方式，完成安裝後回到本頁繼續。

01 匯入訂閱設定

啟動用戶端後，先進入「設定」或「訂閱」頁面，不要直接開啟系統代理。找到「新增」、「加入」或「從 URL 匯入」入口，將訂閱網址完整貼到欄位中；名稱可填寫方便辨識的用途說明。確認網址前後沒有多餘空格或換行，再按下下載或匯入。訂閱網址可能包含存取憑證，請勿將完整網址貼到公開截圖、討論串或線上轉換頁面。

下載完成後，設定清單通常會新增一張設定卡片，顯示名稱、更新時間或啟用狀態。接著還要按下「使用」、「啟用」或卡片上的選取按鈕，將它設為目前使用的設定；只出現在清單中，不代表核心已讀取。正常情況下，用戶端不會再顯示設定解析失敗，切換到「代理」頁面後，也能看到該設定定義的策略組與可選出口。

如果取得的是本機檔案，請選擇「從檔案匯入」，找到 config.yaml 或其他 YAML 檔案並開啟。副檔名只能作為辨識線索，檔案內容仍須符合用戶端所用核心的設定格式。請勿將網頁另存為 YAML，也不要把只有節點連結的文字檔當成完整的 Clash 設定。匯入後同樣要選取並啟用，並檢查策略組是否出現。

有些服務會提供多種訂閱格式，請選擇標示為 Clash、Clash Meta 或 mihomo 相容的入口。瀏覽器能開啟連結，只能表示伺服器有回傳內容，不能證明回傳的是可解析的設定。如果用戶端提示語法或類型錯誤，請先確認格式選項，再檢查是否複製成登入頁面的網址。不要為了消除錯誤訊息，隨意刪除不熟悉的通訊協定欄位。

遇到「下載失敗」時，先分辨是無法取得檔案，還是載入檔案失敗。前者請檢查網址是否完整、訂閱權限是否有效，以及目前網路能否連上該網址；後者則查看用戶端紀錄中的欄位錯誤提示。有些用戶端可設定更新訂閱時使用直連或代理；首次連線尚未建立代理時，請避免讓更新依賴目前無法使用的代理出口。

訂閱匯入正常後，先不要將整份內容複製到手動編輯器中反覆修改。遠端更新可能覆蓋直接編輯的內容，而用戶端各自的覆寫、合併或指令碼功能也不盡相同。首次使用時先保留原始設定，日後確實需要自訂規則，再了解如何持續保留修改。現在確認目前設定已啟用、策略組也能正常顯示，即可進入下一步選擇模式。

02 選擇規則模式

返回首頁或設定頁面，找到「模式」、「運作模式」或 Mode，先選擇 Rule，也就是規則模式。此選項會讓已進入核心的請求依照 rules 清單由上而下比對，並由第一條符合的規則決定出口。它不會自動接管所有應用程式的流量；系統代理或 TUN 才是下一步的流量入口。先確認分流方式，再設定流量入口，之後會更容易找出問題。

另外兩種常見選項是 Global 和 Direct。全域模式會將進入核心的請求交由全域策略處理，直連模式則使用直連路徑。全域模式不代表電腦上的所有程式都已使用代理；直連模式也不代表用戶端已關閉。首次設定若沒有特殊測試需求，建議維持規則模式，避免同時更改模式與網路接入方式，無法判斷是哪項設定影響結果。

接著開啟「代理」或「策略組」頁面。此處可能有多個組別，名稱由設定作者決定，例如手動選擇用的主要組別，以及依用途分類的其他組別。展開規則實際引用的主要選擇組，挑選已獲授權且目前可用的出口。按下選項後通常會出現勾選標記、外框或文字變化；如果該組又選用了另一個組別，請繼續展開，確認最終出口。

不要只憑名稱判斷策略的作用。DIRECT 代表直連，REJECT 代表拒絕連線，兩者都不是一般的遠端節點。如果主要策略組目前選的是 DIRECT，即使已開啟系統代理，相關請求仍可能透過本機網路直接連線。自動選擇組會依照設定中的測試網址和策略決定選項，不一定能固定使用單一節點；需要手動指定時，請使用設定提供的選擇組。

用戶端提供的「連線測試」、「可用性測試」可作為參考，但測試成功只表示設定的測試請求有收到回應，不保證目標網站、帳號登入或所有應用程式都能正常使用。測試失敗也可能是測試網址本身的問題。先選擇有回應的出口，稍後再搭配實際瀏覽與連線紀錄確認，不要只看測試數字就下結論。

如果設定中沒有預期的組別，請回到上一步檢查目前啟用的設定，不要立刻新增空白組別。組別名稱不一致很正常，重點是規則引用的名稱能對應到實際策略。自訂規則、自動選擇與通訊協定類型的詳細說明，請參閱通訊協定參考；常見介面與選擇問題則可查看常見問題。確認模式和出口後，下一步才是啟用應用程式的流量入口。

03 啟動核心與系統代理

先在首頁確認核心正在執行。部分用戶端啟動後會自動執行核心，其他用戶端則需要按下啟動或連線按鈕。如果頁面顯示設定錯誤、服務未啟動或連接埠遭占用，請先處理錯誤，再啟用系統代理。系統代理會將應用程式請求導向本機監聽位址；若核心尚未監聽，提早啟用會讓瀏覽器等應用程式連到沒有服務的連接埠。

Windows 和 macOS 桌面版用戶端通常提供「系統代理」開關，啟用後會更新對應的系統設定。Ubuntu 圖形介面用戶端也可能有同名開關，但桌面環境和安裝方式會影響設定結果。操作後請讓用戶端保持執行，並確認開關狀態仍為啟用。如果已有其他代理用戶端或 VPN，建議先暫停其中一種接入方式，避免兩者反覆覆寫系統設定。

Ubuntu GNOME 可開啟系統「設定」，在「網路」中的「網路代理」查看目前設定；不同版本的選單位置可能略有差異。如果用戶端沒有自動完成設定，可切換為手動，填入本機位址 127.0.0.1，並使用用戶端顯示的實際 HTTP 或混合連接埠。如果設定使用 mixed-port: 7890，HTTP 與 HTTPS 代理欄位通常都填入這個位址和連接埠。

HTTPS 代理欄位是指瀏覽 HTTPS 網站時使用的代理入口，不代表本機入口本身也要採用 HTTPS。請勿只因欄位名稱不同就任意更換連接埠。混合連接埠可同時接收 HTTP 與 SOCKS5 請求；若用戶端使用獨立連接埠，請依介面標示分別填寫。7890 只是常見範例，若實際設定已更改，系統或應用程式中的數值也必須一併更新。

桌面系統代理並非所有程式都會遵循的強制路由。瀏覽器通常會讀取系統設定，但部分終端機工具、遊戲或獨立應用程式可能使用自己的網路設定。先確認一個瀏覽器能正常使用，再處理其他應用程式。如果只想讓特定應用程式使用代理，可以直接在該程式填入本機位址和對應連接埠；同一台電腦上的連線不必為此啟用 allow-lan，也不應任意開放控制介面。

Android 和 iOS 通常需要按下用戶端中的連線按鈕，並在系統提示時允許建立 VPN 連線。這是用戶端接入流量所需的系統介面，不代表還得安裝另一款 VPN。如果裝置上已有其他應用程式占用此介面，請先決定要保留哪一個。行動版是否支援依應用程式分流，以及相關設定入口的位置，取決於用戶端與系統版本，無法直接照搬桌面版的系統代理步驟。

只有在目標應用程式不遵循系統代理，或確實需要更完整地接入流量時，才考慮使用 TUN。桌面版可能需要安裝服務、授予管理員權限或建立虛擬網卡；請勿一次啟用多個不熟悉的選項。先記下目前可用的設定，再單獨測試 TUN。若啟用後網路異常，先關閉 TUN，恢復已確認可用的方式；DNS 與權限問題則可前往故障排除繼續處理。

04 驗證請求與出口

連線按鈕顯示已啟用，不足以證明目標應用程式已使用預期的出口。讓用戶端保持執行，開啟「連線」或 Connections 頁面，再用瀏覽器新增分頁，造訪可正常連線且已知運作正常的網站。查看是否出現該網域的新連線，以及瀏覽器是否收到正常回應。請優先送出新請求，因為既有的長連線可能仍沿用先前的路徑。

點開該連線的詳細資料，查看目標網域、命中規則、使用的策略組或代理鏈。不同用戶端顯示的欄位略有差異，但應能判斷連線是直連、經由某個組別轉送，還是被規則拒絕。規則模式下，部分網站直連是預期結果。若要確認遠端出口，請選擇依目前規則確實會進入代理組的請求，而不是要求每條連線都顯示同一個節點。

必要時可透過可信的出口 IP 查詢服務輔助判斷，但也要一併查看連線紀錄。查詢網站本身同樣會受分流規則影響，顯示本地出口不一定代表代理沒有運作。瀏覽器快取、既有連線，以及網站依帳號或定位權限顯示的地區資訊，也都不能取代對網路路徑的判斷。驗證重點是「這個應用程式的這項請求，是否依預期進入核心並選擇出口」。

熟悉終端機操作的桌面使用者，可使用下方指令明確指定 HTTP 代理，連線至標準範例網站。請將連接埠替換為用戶端實際監聽的混合連接埠或 HTTP 連接埠。此測試可區分「核心入口是否可用」與「應用程式是否讀取系統設定」，但無法證明所有終端機工具都已自動使用代理。

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

如果明確指定代理的指令成功，但一般瀏覽器沒有相應的連線紀錄，請優先確認瀏覽器是否使用系統代理、是否被擴充功能覆寫，以及系統設定中的連接埠是否正確。如果已出現連線紀錄但請求失敗，接著查看命中策略與相關紀錄；此時反覆切換系統代理通常沒有幫助。請勿關閉憑證驗證來規避 HTTPS 警告，應先檢查系統時間、目標網站與出口狀況。

如果所有請求都失敗，請依固定順序檢查：目前設定是否確實啟用、核心是否正在執行、本機連接埠是否有監聽、應用程式請求是否進入核心，最後才檢查所選出口是否可用。每次只更改一項設定，再重新送出請求，避免同時修改設定、DNS、TUN 與模式。遇到連接埠衝突，可參考連接埠占用與 mixed-port 調整；不清楚用途時，請勿強制結束系統程序。

確認驗證通過後，保留已確認可用的模式與策略組選擇，再依需求設定訂閱更新和開機啟動。下次更新訂閱後，組內項目可能有所變動；若發生異常，先確認目前選擇是否仍然有效。Ubuntu 服務化執行與通訊協定選擇屬於後續的進階內容，可參閱通訊協定與核心參考；首次連線不必預先設定整套服務。

完成標準：設定載入成功、核心正在執行、應用程式的新請求出現在連線紀錄中，而且命中規則與出口符合預期。結束用戶端前，請先關閉系統代理或還原先前的網路代理設定；若曾啟用 TUN，也要確認用戶端已正常釋放相關網路入口。