說明中心 / 常見問題

Clash for iOS 常見問題

從匯入設定檔到排查連線問題,依裝置與症狀尋找解答。桌面系統的 TUN、系統代理及 UWP 迴圈豁免問題,另列於故障排查分類。

01 / 概念與模式

基本觀念

先釐清用戶端、設定檔與連線方式。

Clash 是核心、設定檔,還是 iPhone 用戶端?

Clash 通常是指依據設定檔處理代理連線的核心及其生態系;手機上實際安裝的是具有圖形介面的用戶端。設定檔用來描述代理、DNS 與分流規則,訂閱則是取得及更新設定檔的方式之一。請先確認使用中的用戶端名稱,再依照該用戶端的匯入入口操作,別把設定檔當成安裝程式。

訂閱連結、設定檔和節點有什麼不同?

訂閱連結是取得設定檔的網址;設定檔是用戶端讀取的內容,通常包含代理項目、策略群組與規則;節點則是其中可選用的代理出口之一。匯入訂閱後,仍須選取該設定檔,並確認策略群組中的出口選擇。訂閱網址可能包含帳戶資訊,請勿貼在公開截圖或求助貼文中。

規則、全域和直連模式該怎麼選?

日常使用建議選擇規則模式:連線會依設定檔中的規則比對出口。全域模式通常會將代理連線統一交由選定的代理出口處理,適合短時間用來比對及排查;直連則是不經代理出口。切換模式無法修復失效的訂閱或不可用的節點。若網站連線結果不如預期,請先檢查目前設定檔的規則與策略群組。

iPhone 的連線開關和電腦的系統代理是同一回事嗎?

不是。iPhone 用戶端通常透過 iOS 的 VPN 設定接管相關網路流量,首次連線時會觸發系統授權;桌面用戶端的系統代理通常會修改作業系統提供的代理設定,應用程式是否遵循該設定則取決於應用程式本身。排查時請先確認裝置及流量接管方式,再查看對應用戶端的連線狀態。

02 / 匯入與授權

安裝設定

從系統授權開始,逐項檢查設定來源。

iPhone 首次安裝後,如何允許 VPN 設定?

先在用戶端匯入並選取設定檔,再開啟連線開關。iOS 顯示新增 VPN 設定的系統提示時,請確認允許,並依系統要求完成裝置驗證;接著返回用戶端查看連線狀態。若先前取消了提示,可再次啟動連線以重新觸發。也請檢查系統設定中的 VPN 項目是否已有設定,避免同時連線多個互相衝突的 VPN 服務。

如何將 Clash 訂閱連結匯入 iPhone?

在用戶端的設定檔或 Profile 頁面選擇從 URL 下載,貼上完整的訂閱網址,儲存並等待下載完成,再將新設定檔設為目前使用的設定檔。若用戶端顯示格式錯誤,請先確認網址開啟後回傳的是用戶端支援的設定檔格式,而非登入頁面或一般網頁。不同用戶端的按鈕名稱可能略有不同,請以目前畫面為準。

訂閱連結失效或更新失敗時該怎麼辦?

先確認訂閱網址完整,並檢查帳戶或訂閱服務是否仍有效;不要只憑舊節點清單判斷更新是否成功。確認手機網路可連上訂閱服務後,在設定檔頁面手動更新一次,並查看具體錯誤訊息。若回傳的是登入頁面、空白內容或格式錯誤,請向訂閱服務提供者確認網址及格式。更新前可保留上一份可用的設定檔,以便比對。

本機 config.yaml 匯入失敗時,該先檢查什麼?

先確認檔案副檔名及用戶端支援的匯入方式,再檢查 YAML 縮排是否一致使用空格。頂層欄位如 proxies、proxy-groups、rules 必須位於正確層級;策略群組引用的代理名稱也必須與項目相符。請勿將從網頁複製的說明文字一併存入檔案。可先匯入原始設定檔,確認成功後再逐項修改,以找出問題所在。

03 / 設定檔管理

使用技巧

切換設定檔時,留意策略群組與 DNS 設定也會隨之改變。

如何切換多個 Profile?切換後需要重新連線嗎?

在設定檔清單中選擇目標 Profile,並確認它已顯示為目前使用的設定檔;部分用戶端會立即重新載入,另一些則需要先中斷連線再重新連線。切換前請留意各設定檔的策略群組與規則可能不同,別沿用上一個設定檔的出口判斷。切換後若連線異常,請先查看目前設定檔名稱,再檢查連線狀態及策略群組選擇。

何時該更新訂閱?更新會覆蓋手動修改嗎?

訂閱服務提供者調整代理項目或規則,或原有節點失效時,可在設定檔頁面手動更新。透過 URL 管理的設定檔,更新時可能會以遠端內容取代本機內容;若曾直接編輯訂閱產生的檔案,請先另存為獨立設定檔。更新完成後,確認目前的 Profile、策略群組及規則模式,不要只看更新提示。

Fake-IP DNS 模式會影響區域網路裝置嗎?

Fake-IP 會為符合條件的網域名稱回傳對應位址,再由核心依據該對應關係處理連線。區域網路裝置探索、特定遊戲,或依賴真實解析結果的應用程式,可能需要額外規則。遇到問題時,先比較規則模式與直連模式下的狀況,再檢查設定檔中的 dns.enhanced-mode 和 fake-ip-filter;不了解現有 DNS 設定時,請勿整段取代設定。

什麼時候該開啟允許區域網路連線?

只有確實需要讓同一區域網路中的其他裝置,使用這台裝置提供的代理入口時,才需要查看「允許區域網路連線」選項。開啟後還須確認監聽位址、連接埠、裝置防火牆及同網段的連線狀況;只開啟選項不代表其他裝置已設定完成。若用戶端只在本機使用,通常不必為其他裝置開放監聽。

04 / 依症狀排查

故障排查

先確認裝置可連上網路,再檢查設定檔、權限及應用程式的流量接管方式。

iPhone 的 VPN 開關無法開啟,或連線後無法上網,該如何排查?

先確認已選取有效的設定檔,並完成 iOS VPN 授權;接著檢查系統 VPN 頁面是否有其他連線正在使用。若能開啟 VPN 但無法上網,請先透過一般網路確認手機本身可連線,再檢查目前的策略群組、節點及規則模式。暫時中斷其他 VPN 或網路過濾應用程式後再試,並查看用戶端記錄中的第一則具體錯誤訊息。

節點測速正常但連線逾時,該先檢查哪裡?

測速結果只能反映測試當下對特定目標的連線狀況,不代表實際請求都能順利完成。先確認手機網路、目前的 Profile 和策略群組是否仍指向同一個節點,再試著連線到不同目標,以分辨是單一網站故障還是普遍逾時。接著查看記錄中的 DNS、連線或驗證錯誤;若多個節點都逾時,請再檢查訂閱資訊及裝置網路。

桌面版 Clash TUN 模式顯示權限不足,該怎麼辦?

TUN 需要用戶端能建立或管理虛擬網路介面,實際授權方式會因 Windows、macOS、Linux 及用戶端而異。請先閱讀目前用戶端的權限提示,依設定頁面的要求完成系統授權或安裝服務,再重新啟用 TUN。若仍然失敗,請檢查系統中既有的 VPN、虛擬網卡或安全軟體是否占用介面;iPhone 的系統 VPN 授權與桌面版 TUN 授權並不相同。

Windows 已啟用系統代理,為什麼部分應用程式還是無法使用?

系統代理只會對讀取該設定的應用程式生效,有些程式會使用自己的網路設定,或直接建立連線。先確認用戶端正在執行且系統代理開關已開啟,再用瀏覽器進行比對測試。若只有特定應用程式無法使用,請查看該應用程式本身的代理設定;若確實需要接管更多流量,再評估用戶端支援的 TUN 模式及其權限需求,不要反覆修改連接埠來猜測原因。

Windows UWP 應用程式無法使用本機代理,如何檢查迴圈豁免?

部分 UWP 應用程式受 Windows 網路隔離限制,無法直接連線到本機代理位址。先確認一般桌面程式能透過相同代理連接埠連線,再檢查目標 UWP 應用程式是否已取得迴圈豁免。可在 Windows 終端機執行 CheckNetIsolation LoopbackExempt -s 查看現有清單;若要新增豁免,請先確認目標應用程式的套件系列名稱,再依所用用戶端的迴圈設定說明操作。

下載用戶端