iOS 用戶端與設定相容性
在 iPhone 上使用 Clash 設定前,請先確認兩件事:App 確實支援 iOS,且支援訂閱服務提供的設定格式。桌面版安裝檔無法直接安裝到 iPhone;名稱含有 Clash,也不代表完整支援所有 mihomo 設定欄位。
Clash 用戶端通常會以圖形介面提供匯入設定、選擇策略群組及連線開關等功能。底層代理可能採用 Clash、Clash Meta(mihomo),也可能是其他相容 Clash 設定的實作。判斷相容性時,應查看 App 說明、版本更新紀錄及設定文件,而非只看圖示或搜尋結果中的名稱。
先確認 App,再確認訂閱
- 平台:App Store 詳情頁應列出 iPhone 或 iOS 相容性,不能以同名的 macOS 軟體頁面取代。
- 格式:確認 App 支援完整的 Clash YAML、遠端設定連結,還是只支援節點清單。這三種匯入方式並不相同。
- 功能:若設定依賴特定代理通訊協定、規則集或 mihomo 擴充欄位,請確認目前 iOS 版本的用戶端支援這些內容。
- 維護:查看更新日期、系統需求及開發者資訊。安裝後記下 App 版本,方便日後排查相容性問題。
挑選 App 時,可到本站下載頁的 iOS 分類查看 Clash Plus 等用戶端的下載入口;App Store 也有 Stash 等支援 Clash 設定的 App。「設定相容」不代表採用相同核心,也不代表選單、功能或價格相同。App 是否在目前的 App Store 國家或地區上架,請以開啟後的詳情頁為準。
透過 App Store 下載與安裝
安裝前確認系統版本與商店地區
- 在 iPhone 開啟「設定」→「一般」→「關於本機」,記下 iOS 版本。接著在 App Store 的 App 詳情頁查看「相容性」,確認最低系統需求。
- 前往「設定」→ Apple 帳號姓名 →「媒體與購買項目」→「檢視帳號」→「國家或地區」。App Store 商品的顯示範圍取決於「媒體與購買項目」所使用帳號的地區。
- 從可信的專案說明或本站用戶端下載頁前往 App Store。若透過商店搜尋,請逐一核對 App 名稱、開發者與說明,避免只依搜尋排序安裝。
- 點選「取得」或價格按鈕,依照系統提示完成驗證。付費與訂閱條款以 App 詳情頁為準,請勿混淆購買用戶端的費用與節點服務費用。
- 安裝完成後,先開啟 App 確認能進入設定介面,再準備訂閱連結。此時通常還沒有可用節點,先讓連線開關維持關閉即可。
搜尋不到 App,可能是尚未在該地區上架、名稱已變更、暫時下架或系統不相容,並不代表 iPhone 無法使用 Clash 設定。請先回到開發者提供的商店入口確認狀態;不要為了找到同名 App 而下載來源不明的描述檔。
變更商店帳號地區可能影響帳戶餘額、既有訂閱及付款方式。請先查看 Apple 的帳號地區說明,避免只為安裝一次 App 就貿然變更。由企業或學校管理的 iPhone,也可能限制安裝 App、新增 VPN 或變更帳號設定。
準備訂閱連結並確認格式
訂閱連結通常由服務提供者在使用者後台產生,讓 Clash 用戶端取得節點、策略群組及規則。安裝 App 不會自動產生可用節點;App Store 的 App 分享連結也不是訂閱連結。
匯入前確認四項資訊
- 服務狀態:確認帳號仍在有效期限內、流量尚未用盡,且裝置數或同時連線數限制允許這台 iPhone 使用。
- 輸出格式:優先選擇後台標示的 Clash 格式或對應用戶端專用格式。若使用 mihomo 專用格式,也要確認 iOS 用戶端的相容性說明。
- 完整網址:複製完整的 HTTPS 網址,包括問號後方的參數。不要漏掉存取權杖,也不要誤複製說明頁面的網址。
- 妥善保密:連結可能包含存取權杖,分享連結等同分享設定存取權限。請勿將它放進公開截圖、群組聊天或第三方轉換網站。
| 取得的內容 | 建議匯入方式 | 判斷重點 |
|---|---|---|
| 遠端 Clash YAML 連結 | 從 URL 新增設定 | 下載後應能辨識節點、策略群組及規則 |
| 本機 YAML 檔案 | 從檔案匯入 | 匯入檔案不會自動連結遠端更新網址 |
| 單一節點分享連結 | 新增節點或匯入節點 | 通常不包含完整的分流規則 |
| 網頁或 JSON API 網址 | 先向服務提供者確認 | 登入頁面或錯誤頁面不能當成 YAML 解析 |
完整設定常見的頂層欄位包括 proxies、proxy-groups 和 rules;也可能透過 proxy-providers 引用遠端節點。若內容只有一批經編碼的節點網址,不一定能直接當成完整設定匯入。遇到格式錯誤時,優先請服務提供者輸出相容格式,不要反覆重新安裝 App。
匯入訂閱並啟用設定
透過 URL 匯入的操作步驟
- 在 Clash 用戶端開啟設定清單,選擇新增設定,再點選「從 URL」、「下載設定」或類似功能的入口。
- 輸入容易辨識的名稱,例如「日常使用-iPhone」。將剛才複製的訂閱連結貼到網址欄位;名稱和網址分開填寫,避免把備註文字一併貼進連結。
- 執行下載或儲存。首次取得訂閱需要目前的網路能連上訂閱伺服器;若尚未匯入可用節點,用戶端無法憑空透過該訂閱建立代理連線。
- 返回設定清單,確認項目沒有解析錯誤,並將它設為目前使用的設定。只新增到清單,不代表設定已啟用。
- 開啟策略群組或代理頁面,確認當中有節點。先選擇一個明確的節點作為測試目標,再啟動連線,避免初次排查時同時受到自動選擇與故障轉移影響。
設定中可能有手動選擇、自動測速及故障轉移等不同策略群組。手動群組需要選擇成員;自動群組則依設定的測試網址、間隔及選擇邏輯運作。看到群組名稱不代表成員有效,還要檢查成員清單及測試結果。
更新訂閱不等於重設所有設定
首次測試成功後,再啟用 App 支援的自動更新功能。若可設定更新間隔,可先設為每 24 小時更新一次;iOS 背景作業受系統排程限制,無法保證一定在固定時間完成。連線異常時,可手動更新一次並查看更新時間與錯誤訊息。
遠端更新可能會覆蓋訂閱檔案中的本機修改。若需要長期調整規則,優先使用用戶端提供的覆寫、合併或獨立規則功能,並確認適用範圍。請勿未儲存副本就直接修改遠端設定,還期待下次更新保留這些變更。
授權 VPN 並驗證連線
首次開啟連線開關時,iOS 通常會顯示 App 要求新增 VPN 設定的系統提示。點選「允許」,再依系統要求使用裝置密碼、Face ID 或 Touch ID 驗證。這項授權允許 App 建立系統網路通道,不代表授權存取 Apple 帳號。
授權後,可前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」,查看已新增的設定。若裝置由組織管理,設定可能受到管理者政策限制。請勿為了繞過限制而刪除不認識的管理設定,應先聯絡裝置管理者。
iPhone 的設定方式不同於桌面系統代理
iOS 這類連線通常透過 Network Extension 的 Packet Tunnel 接管網路流量,與桌面端在系統代理中填入 127.0.0.1:7890 的做法不同。桌面設定中的連接埠無法直接證明 iPhone 已接管流量,桌面端的 tun 區段也不一定適用於 iOS 用戶端。
VPN 顯示已連線,只代表通道已建立,無法單獨證明節點可用或分流正確。驗證時應分別檢查「通道狀態」、「節點可連線性」及「規則命中情況」。
- 檢查通道:返回 Clash 用戶端,確認連線開關仍為開啟,且系統 VPN 頁面顯示已連線。
- 檢查節點:對目前策略群組中的成員執行一次延遲測試。測試成功只代表測試目標可連線;測試逾時也可能是測試網址無法連線,不應只憑這項結果判定節點失效。
- 檢查連線要求:用 Safari 開啟
https://example.com/,再造訪一個確實需要透過代理存取的網站。前者只用來基本檢查 HTTPS 連線,不用於判斷對外 IP 所在地區。 - 檢查規則:在連線記錄或日誌中找到對應網域,查看命中的規則、策略群組及最終節點。符合
DIRECT規則的要求,不會因為 VPN 已開啟就自動改走代理。 - 更換網路:分別在 Wi-Fi 與行動網路上重複檢查。切換前後使用相同節點和目標,才方便比較網路差異。
初次使用建議選擇規則模式。全域模式可暫時用來判斷是否為分流問題,測試後應恢復原模式;全域模式無法修復過期訂閱、驗證錯誤或不相容的通訊協定。其他 VPN 或網路過濾 App 也可能與目前通道衝突,排查時應只保留一個啟用中的 VPN 連線。
排查匯入失敗與無法連線
| 現象 | 可能原因 | 下一步 |
|---|---|---|
| 下載訂閱時回傳 401 或 403 | 常見原因為權杖失效、權限不足或伺服器限制 | 確認帳號狀態並重新複製有效連結;必要時聯絡服務提供者 |
| 回傳 404 | 訂閱路徑不存在或網址已變更 | 從後台重新取得網址,不要自行猜測路徑 |
| 出現 YAML 解析錯誤 | 回應內容可能是網頁、錯誤訊息或不相容的設定 | 確認輸出格式,記下錯誤欄位與行號 |
| 匯入成功但沒有節點 | 可能只有空的策略群組,或遠端 provider 取得資料失敗 | 檢查節點來源與 provider 更新日誌 |
| VPN 已連線,但網頁無法開啟 | 節點、規則、DNS 或網路狀況仍可能異常 | 依序檢查目前節點、連線記錄及 DNS 錯誤 |
| Wi-Fi 可用,行動網路無法使用 | 可能是行動網路權限、網路路徑或資費方案狀態不同 | 到「設定」→「行動服務」查看 App 權限,再更換節點測試 |
DNS 與 Fake-IP 設定不宜直接照搬桌面端
若節點測試正常,但無法透過網域存取,先查看日誌是否出現解析逾時,再確認設定中的 DNS 選項及用戶端支援範圍。Fake-IP 是透過映射位址將網域與連線相互關聯的方式,並非新增一個 DNS 位址就能解決所有問題。部分區域網路服務或 App 需要相容性調整,貿然切換模式容易帶來新的變數。
建議先使用服務提供者針對目前 iOS 用戶端調整的設定,並保留原始版本,每次只修改一個項目。若訂閱包含用戶端不支援的欄位,應改用相容設定或依文件處理,不能直接假設 mihomo 桌面版可用的所有參數也適用於 iOS。
尋求協助時提供可重現的資訊
- iPhone 型號、iOS 版本、Clash 用戶端名稱及 App 版本。
- 失敗發生於下載訂閱、解析設定、VPN 授權,還是開啟網頁的階段。
- Wi-Fi 與行動網路各自的結果,以及兩者是否使用相同節點。
- 已去除敏感資訊的錯誤訊息、規則命中紀錄及故障發生時間。
不必一開始就刪除所有設定。先儲存可還原的副本,再手動更新、重新選擇設定並測試重新連線;只有確認本機設定損毀,或 VPN 設定殘留影響啟動時,才依 App 文件進行重設。更多基本操作請參閱使用說明;連線問題則可接著查看疑難排解。