說明中心 / 常見問題
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 查看現有清單;若要新增豁免,請先確認目標應用程式的套件系列名稱,再依所用用戶端的迴圈設定說明操作。