Clash 訂閱匯入
與基本設定

開始前：準備現有訂閱

安裝 Clash 用戶端不會自動取得代理節點。開始前，請準備有效的 Clash 格式訂閱連結，或可用的 YAML 設定檔；連結與服務是否可用，需由訂閱提供者負責。本網站提供用戶端下載入口與操作文件，不提供訂閱。若手邊只有單一協定連結或一長串編碼文字，請先確認用戶端是否支援該格式，不要直接將它當成完整設定匯入。

初次設定建議保留預設參數。先確認目前是否啟用了其他代理、VPN 或瀏覽器代理擴充功能；測試期間只保留一種明確的網路接管方式，避免無法判斷請求的路徑。若裝置由公司或學校管理，部分代理設定、網路擴充功能與服務安裝可能受到限制，請遵守裝置管理規定，不要反覆嘗試提升權限來規避限制。

訂閱連結可能包含帳號存取權杖，請像保管密碼一樣妥善保存。分享螢幕截圖時，請遮住完整網址；排查記錄時，請移除連結參數與節點憑證。不要將連結提交至不熟悉的線上轉換網站。若還不熟悉「核心」、「設定」、「節點」等名稱，可以先查看術語表，再回到下方的第一步。

第一步：匯入訂閱並啟用設定

開啟 Clash 用戶端，進入「設定」、「訂閱」或「Profiles」頁面，找到「新增」、「匯入」或可輸入訂閱網址的文字欄位。從訂閱提供者複製完整連結並貼上，檢查開頭與結尾是否多了空格、換行或通訊軟體附帶的標點符號。網址中的查詢參數也必須完整保留，不可只複製網域或路徑。

點選「匯入」或「下載」，等待用戶端取得並解析內容。成功後通常會出現設定卡片，顯示設定名稱；部分用戶端也會顯示更新時間。出現設定卡片不代表該設定已經啟用。請繼續點選卡片，或使用卡片上的「啟用」、「使用」選單，確認出現選取標記，再切換至「代理」頁面查看策略組是否已載入。

如果取得的是本機檔案，請使用「從檔案匯入」或用戶端支援的拖放方式，選取正確的 YAML 檔案。不要只將其他格式的副檔名改成 .yaml；變更副檔名不會改變檔案內部結構。完整設定通常包含代理節點、策略組與規則等內容，只有幾行規則的範例片段無法取代訂閱提供者提供的設定。

依照失敗環節排查匯入問題

點選匯入後一直等待，或出現 timeout、context deadline exceeded，通常表示未能在期限內完成取得作業。先確認裝置本身可以連上網路，再檢查訂閱網址是否可存取。初次匯入時尚無可用代理，不要指望新匯入的設定能先替這次下載提供連線；請使用目前可用的網路，或向訂閱提供者確認可用的取得方式。

如果回應 401 或 403，請優先確認連結是否已過期、參數是否遺漏，以及帳號是否仍有存取權限；這類回應也可能是伺服器端的存取限制，需依提供者說明判斷。若出現 yaml: unmarshal errors 或附有行號的解析錯誤，表示回傳內容的結構不符合預期。網頁錯誤訊息、登入頁面或其他用戶端專用的訂閱，都可能被誤當成 YAML 讀取。

遇到錯誤時，不要連續新增多筆相同訂閱。請保留一筆記錄，檢查網址並嘗試更新；確實需要替換時，為新舊設定使用不同名稱，確認成功後再刪除舊項目。更新訂閱通常會重新擷取遠端內容，直接修改訂閱原始內容可能會被覆蓋，初次使用時先不要修改規則。若要長期保留本機調整，請再閱讀本機覆寫與設定管理。

完成這一步的判斷標準：設定清單中有一份明確選取的設定，「代理」頁面能顯示其策略組，且用戶端沒有持續回報載入失敗。確認達到這個狀態後，再選擇代理模式，不必急著同時開啟所有網路開關。

第二步：選擇規則模式與代理策略

前往「代理」或首頁的「模式」設定，選擇「規則」或 Rule。此模式會依照目前設定中的規則逐一比對請求，再交由對應策略處理，適合日常使用。至於哪些網站使用代理、哪些直接連線，取決於訂閱設定內容，並非用戶端能單憑地區名稱固定判斷。

接著查看策略組。常見名稱包括「代理」、「節點選擇」、「自動選擇」，也可能是訂閱提供者自訂的名稱。展開負責代理出口的策略組，選擇已知可用的節點，或選取設定中已有的自動選擇組。如果清單中有多層策略組，請繼續展開確認最終選擇，避免只看到外層組名，卻沒注意到內層仍指向 DIRECT 或已失效的舊節點。

用戶端提供的連線測試或延遲測試可作為篩選參考，但測試成功只代表當時可以連上指定測試目標，不保證所有網站與應用程式都能使用。初次操作時，先選定一個節點完成後續確認，不要在網頁尚未載入完成時頻繁切換。更換節點後，部分應用程式會繼續使用舊連線；必要時重新開啟測試頁面，或中斷該應用程式的連線後再試。

「全域」不代表整台裝置的所有應用程式都已交由 Clash 接管。它只會改變進入核心後的處理策略；應用程式的請求是否會進入 Clash 用戶端，還取決於系統代理、TUN 或應用程式本身的代理設定。同樣地，選擇規則模式也不會自動啟用系統代理。這兩項設定位於不同環節，下一步需分別完成連線設定。

如果代理頁面是空的，請先回到第一步確認設定已啟用；如果看得到節點，卻找不到教學中的某個組名，不必手動建立同名策略組，請依照目前設定中的實際分組操作。策略組類型、規則順序與 MATCH 的意義屬於進階內容，完成基本連線後可再閱讀進階設定手冊。這一步只需確認目前使用規則模式，且相關代理策略已選好可用出口。

第三步：啟用連線並確認接管方式

桌面版先在首頁或設定中找到「系統代理」並啟用。此開關通常會將作業系統支援的代理設定指向用戶端的本機監聽位址，瀏覽器等遵循系統代理設定的應用程式便能將請求交由核心處理。啟用後請讓用戶端保持執行，不要立即結束程序；部分用戶端關閉主視窗只會縮到系統匣，真正的「結束」則會停止本機代理服務。

先不要變更本機連接埠。網路上常見的範例使用 mixed-port: 7890，但不同用戶端實際使用的連接埠可能不同，請以目前設定為準。如果記錄出現 address already in use 或監聽連接埠繫結失敗，請檢查是否有另一個 Clash 用戶端或其他程式佔用連接埠。關閉重複執行的執行個體後再試，不要在瀏覽器中隨意輸入新的連接埠。

Android、iOS 通常透過「連線」或啟動按鈕啟用網路接管。首次連線時，系統可能會提示新增 VPN 設定或允許建立 VPN 連線；確認提示來自剛安裝且由你主動開啟的用戶端後，再授予權限。這裡的 VPN 是系統提供的網路接管介面，狀態列出現 VPN 圖示並不代表訂閱節點已可使用；仍需完成第四步的實際連線確認。

系統代理正常後，再考慮使用 TUN

如果瀏覽器已可連線，但某個應用程式不讀取系統代理設定，可以再考慮使用 TUN 模式。TUN 透過虛擬網路介面與路由接管請求，可能需要系統管理員權限、服務模式、網路擴充功能或系統 VPN 授權；實際需求取決於平台與用戶端。請依照目前用戶端的說明完成安裝或授權。若服務啟動失敗，先處理該錯誤，不要在錯誤尚未排除時繼續修改 DNS 參數。

初次測試時，盡量只保留一種明確的網路接管方式。需要切換至 TUN 時，可以先關閉系統代理，再啟用 TUN 進行確認；若用戶端明確要求兩者搭配使用，則依照其說明操作。其他 VPN、虛擬網卡與安全軟體可能影響路由，測試期間請避免同時啟動多個接管工具。若裝置連線至公司內網，請先記錄原有網路狀態，並確認不會影響必要業務。

完成這一步後，桌面版應顯示系統代理已啟用，或 TUN 已依預期啟動；行動裝置則應顯示連線狀態並取得系統授權。如果開關才剛開啟就自動關閉，請先前往「記錄」查看啟動階段的錯誤，記下第一則相關訊息，再到說明中心查找處理方式。重複點選啟動通常無法解決權限或連接埠衝突。

第四步：確認連線與規則命中

開啟瀏覽器，造訪平常可以直接連線的網站，確認基本網路正常；再造訪預期會使用代理的網站，例如規則明確指定透過代理連線的網站。不要只看用戶端上的連線圖示。必須綜合確認網頁是否完整載入、請求是否進入核心，以及最後使用哪個出口，才能判斷設定是否生效。

接著開啟 Clash 用戶端的「連線」頁面，重新整理測試網頁，尋找對應的網域或應用程式請求。部分連線持續時間很短，頁面載入後可能很快消失；遇到這種情況，可查看「記錄」並再次重新整理。留意請求命中的規則、策略組，以及最後使用的節點或 DIRECT。規則模式下同時出現直連與代理請求屬正常情況，不必為了讓所有記錄都顯示相同節點而切換至全域模式。

如果網頁已開啟，卻沒有任何相關記錄，請先確認重新整理是否產生了新請求。瀏覽器快取、其他代理擴充功能、應用程式內建的獨立代理，或另一款 VPN，都可能讓觀察結果與預期不同。可以暫時停用瀏覽器代理擴充功能，再重新開啟測試頁面；也可以使用同一瀏覽器的無痕視窗減少快取干擾，但無痕視窗本身不會略過系統代理或改變網路出口。

依照現象縮小排查範圍

完全沒有新的請求記錄時，先檢查系統代理或行動裝置的連線開關是否確實開啟，再確認測試應用程式是否遵循該接管方式。如果記錄出現 connection refused，請根據目標位址判斷是本機監聽服務未啟動，還是遠端連線遭到拒絕；不要只憑這兩個字就認定訂閱已失效。

看得到請求、也已選取代理節點，但網頁仍然逾時時，可以在同一策略組中換用其他可用節點，再重新測試。如果切換至全域模式後可以連線，但規則模式下失敗，請優先檢查該網域命中的規則與策略，不要一再重裝用戶端。完成比對後，記得切回規則模式，並保留出問題的網域與命中結果，以便進一步排查。

如果記錄持續出現網域解析失敗或 DNS 查詢逾時，先確認裝置網路與目前設定是否正常，再查看DNS 設定章節。不要一次更換所有 DNS 位址、啟用 TUN、修改規則並切換節點，否則即使恢復連線，也很難找出是哪項設定生效。每次只變更一項相關設定，測試後記錄結果，並還原無效的變更。

遇到憑證警告時，請勿直接忽略瀏覽器提示。先檢查系統日期與時間，再確認是否安裝了封包擷取工具的憑證，以及是否有其他網路過濾軟體參與連線。代理可以連線，不代表可以忽略憑證異常。若遇到其他常見狀況，例如裝置從睡眠狀態恢復後無法連線、訂閱更新失敗或應用程式仍走直連，可繼續查閱說明中心的故障排查。

結束使用與下次啟動

確認連線與規則命中結果符合預期後，基本設定就完成了。先保留這份可用設定，不必急著加入覆寫指令碼或合併多份訂閱。下次啟動時，先確認設定仍已選取、策略組選擇未變，再啟用系統代理或行動裝置連線。開機自動啟動只會決定用戶端是否啟動；自動連線或自動設定系統代理可能是其他選項，需分別確認。

結束使用時，桌面版先關閉系統代理，行動裝置先中斷連線；使用 TUN 的裝置則先關閉 TUN，再結束用戶端。如果用戶端意外當機後瀏覽器無法連線，請檢查作業系統是否仍保留指向本機連接埠的手動代理設定，確認後移除殘留設定。若要繼續調整規則集、Fake-IP 或外部控制，請前往進階設定手冊，不要在這份已確認可用的基本設定上同時進行多項測試。