平台適配 閱讀時間約 10 分鐘

iOS Clash 客戶端推薦與設定匯入｜App Store 下載指南

整理 iOS Clash 客戶端的 App Store 下載方式，並說明如何透過訂閱連結、檔案或 QR Code 匯入設定及啟用 VPN。

先確認：支援 Clash 設定，不代表使用 mihomo 核心

iPhone 代理 App 有三件事需要分別確認：目前的 App Store 地區能否下載、能否讀取手邊的設定格式，以及是否支援節點使用的協定。App 名稱含有 Clash，或介紹標示「支援 Clash 訂閱」，都不能單憑這些資訊判定它完整支援 mihomo 設定欄位。

Clash YAML 是設定格式，mihomo 是代理核心，而 iOS 客戶端負責管理設定、選擇節點及使用系統網路延伸功能。部分客戶端匯入 YAML 後會轉成自有的內部格式，另一些只會擷取節點，不會匯入原有規則與 DNS 設定。因此，「匯入成功」和「依原設定運作」是兩件事，必須分別確認。

  • 完整設定：通常包含 proxies、proxy-groups 和 rules，也可能包含 DNS、規則集及節點提供者。
  • 節點訂閱：主要提供伺服器資訊；匯入後仍須由客戶端或另一份設定提供策略群組與分流規則。
  • 客戶端專用格式：請依照 App 說明匯入，不要只把副檔名改成 .yaml。

從 App Store 下載：確認地區、開發者與系統需求

從下載中心前往 App Store 頁面

  1. 開啟本站下載中心，選擇 iOS 平台，查看目前列出的客戶端及取得方式。
  2. 前往相應的 App Store 頁面，確認 App 名稱、開發者、版本紀錄，以及「相容性」中的最低 iOS 需求。
  3. 閱讀 App 介紹中的設定格式說明，特別確認是否支援 Clash YAML、遠端訂閱、檔案匯入，以及所需協定。
  4. 確認價格與購買條件後再安裝。安裝完成後先開啟 App，確認是否有設定管理及連線入口，再開始匯入。

搜尋結果可能會出現名稱相近的 App。不要只看圖示，也別把搜尋廣告的排序當成相容性證明。要確認來源，應以 App Store 頁面上的開發者資訊和 App 官方文件為準。

App Store 無法下載時，先確認帳號地區

App Store 的供應範圍主要取決於用來購買項目的 Apple 帳號國家或地區，開啟代理並不會自動切換商店地區。可依序前往「設定」→「你的姓名」→「媒體與購買項目」→「檢視帳號」→「國家或地區」確認；不同 iOS 版本的選單名稱可能略有差異。更改地區通常會影響帳戶餘額、現有訂閱和付款方式，請先詳閱 Apple 的規定，不要只為了安裝一個 App 就更改地區。

若看到「此 App 在你所在的國家或地區尚未提供」，優先選擇目前地區可下載、且明確支援所需設定格式的客戶端。不要使用陌生人提供的 Apple 帳號，也不要為了安裝代理工具而信任來源不明的企業憑證，或接受不明的裝置管理要求。

匯入訂閱連結：儲存、更新並選取設定

遠端訂閱適合需要定期更新節點的情況。請先向服務提供者取得 Clash 專用訂閱網址；同一個帳戶可能同時提供 Clash、通用節點及其他客戶端格式，不能只看網址外觀就判斷回傳內容。

  1. 複製原始網址：使用服務提供者的複製按鈕，避免複製到網頁標題、前後空白或通訊軟體附加的標點符號。
  2. 新增遠端設定：前往客戶端的設定管理頁面，尋找「新增」、「從 URL 匯入」或「遠端設定」等選項。各 App 的選單不同，這些是功能名稱，並非所有客戶端都通用的固定路徑。
  3. 首次下載：輸入容易辨識的名稱並儲存，手動更新一次，等待下載與解析完成。
  4. 確認匯入結果：確認節點或策略群組已顯示；若 App 有顯示規則數量，也要確認規則是否一併載入。
  5. 設為目前設定：部分 App 可儲存多份設定，但同一時間只能啟用一份。儲存完成後，還要選取剛匯入的項目。

更新失敗時，先確認錯誤類型：401 或 403 通常與存取權限或伺服器限制有關；404 則應確認網址是否有效；若是解析錯誤，請檢查回傳內容及客戶端支援範圍。瀏覽器能開啟網址，不代表回傳內容是 YAML，也可能是登入頁面或錯誤訊息。

匯入檔案與 QR Code：先確認內容，再選擇匯入方式

透過「檔案」App 匯入 YAML

本機檔案適合用來轉移現有設定，或在訂閱暫時無法下載時使用。先將 .yaml 或 .yml 檔案儲存至「檔案」App 的「我的 iPhone」或 iCloud 雲碟，再從客戶端選擇「從檔案匯入」。若 App 支援分享延伸功能，也可以在「檔案」App 中長按檔案，點選「分享」，再選擇要使用的客戶端。

  • 檔案應為 UTF-8 純文字，不能是豐富文字文件、網頁封存檔，或只改過副檔名的 PDF。
  • YAML 縮排請使用空格，避免編輯器將縮排替換成 Tab；引號與冒號也要維持原有格式。
  • 檢查設定中的外部資源網址。主檔案儲存在本機，不代表 proxy-providers 或 rule-providers 已可離線使用。
  • 匯入後通常會在 App 內建立副本。在「檔案」App 中修改原始檔案後，可能需要重新匯入，不能假設客戶端會自動同步。

以下片段僅供辨認設定結構，並非可直接連線的完整設定：它引用了名為「手動選擇」的策略群組，實際設定還需要提供相應的策略群組及可用節點。

mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - MATCH,手動選擇

如果匯入後出現策略不存在的提示，請先檢查 rules 引用的名稱是否與 proxy-groups 完全一致。將桌面設定移到 iPhone 時，也要檢查本機檔案路徑、監聽連接埠及核心專屬欄位，不能只處理節點部分。

QR Code 可能只包含單一節點

QR Code 是承載文字的方式，並非統一的訂閱格式。內容可能是 HTTPS 訂閱網址、ss://、trojan:// 等單一節點連結，或 App 專用的匯入指令。匯入後只有一個節點，通常是因為 QR Code 原本就只編碼了一個節點，不代表原有規則也已匯入。

  1. 在客戶端內開啟掃描功能；首次使用時，依需求允許相機權限。
  2. 如果 QR Code 顯示在同一支手機上，請使用客戶端支援的相簿辨識功能；若沒有此功能，請向服務提供者索取原始文字連結。
  3. 辨識後先檢查預覽內容：確認是遠端設定網址、節點資訊還是未知指令，再決定是否儲存。
  4. 匯入完成後，請檢查設定清單與策略群組，不要只看「掃描成功」的提示。

QR Code 圖片也可能含有憑證，請勿上傳到公開的辨識服務。若相機權限遭拒，可前往系統設定找到相應 App 並檢查權限；以 iOS 18 為例，App 設定通常位於「設定」→「App」→「App 名稱」。

啟用 VPN：授權系統隧道，再選擇出口節點

準備好設定後，先在代理策略群組中選擇可用節點，再開啟客戶端的連線開關。首次連線時通常會出現系統提示，詢問是否允許新增 VPN 設定；確認是剛安裝的客戶端發起後，依照提示允許並完成系統驗證。這項授權會讓 App 透過系統網路延伸功能處理流量，但不代表所有連線都一定會經過遠端節點。

  1. 檢查系統設定：前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」，查看相應項目與連線狀態。這裡只需管理 VPN，不必另外安裝裝置管理描述檔。
  2. 確認代理模式：日常使用建議先選擇規則模式；若客戶端提供全域模式，可在診斷時短暫使用，並指定實際的出口節點。
  3. 確認策略群組選項：如果規則命中的群組選擇了 DIRECT，該連線仍會直接連線，即使系統顯示 VPN 已連線。
  4. 測試後再調整：先使用預設設定完成一次連線，再考慮調整 DNS、隨選連線或其他進階功能，避免同時修改多個變數。

桌面版常見的「系統代理」與「TUN」開關不能直接套用到 iOS。iOS 客戶端通常透過 Network Extension 中的 Packet Tunnel 接管流量；是否顯示「TUN」字樣則視 App 設計而定。不要為了照搬桌面教學，在 Wi-Fi 的 HTTP 代理欄位填入 127.0.0.1:7890：這個位址指向 iPhone 本身，只有 App 確實提供相應的監聽服務時才有作用。

連線驗證與故障排除

以同一筆連線確認規則與出口

開啟平時需要透過代理存取的 HTTPS 網頁，同時查看客戶端提供的連線或記錄面板。若面板顯示命中的規則、策略群組及出口節點，請一併核對這三項。只看到網域名稱、沒有成功回應，仍可能是 DNS、交握或遠端連線問題。若使用出口 IP 查詢服務，也要確認該請求沒有被規則分流為直接連線。

延遲測試只反映指定測試目標當下的回應情況。例如畫面顯示 120 ms，這不是下載速度，也不代表影片或遊戲使用的目標一定連得上；此數值僅為讀數示例，並非本站實測。實際驗證時，請載入一個網頁，並分別使用 Wi-Fi 與行動網路測試。

狀況 優先檢查項目 後續處理方式
訂閱已儲存，但沒有節點 回傳內容與匯入類型 確認回傳內容不是 HTML 登入頁面，並檢查是否誤把節點訂閱匯入為完整設定。
出現未知欄位或不支援的協定 客戶端格式與核心相容範圍 取得適用於該 App 的訂閱，不要直接刪除報錯欄位後繼續使用。
VPN 已連線，但網頁仍無法開啟 目前使用的設定、節點及 DNS 記錄 切換至已確認可用的節點，再開啟同一個網頁測試，並留意是否出現解析錯誤。
只有部分網站經由代理連線 規則命中結果與策略群組選項 確認是否為預期的分流結果；全域模式僅用於比對診斷，不能取代規則修正。
啟用後很快被另一個連線取代 其他代理 App 或本機 VPN 類 App 暫時關閉其他 App 的連線及自動連線選項，再單獨測試目前的客戶端。
只有行動網路無法更新或連線 行動數據權限與網路差異 前往「設定」→「行動服務」，檢查 App 權限，並與 Wi-Fi 的測試結果比較。

更新設定並保留記錄

節點失效時，先更新遠端設定，再確認策略群組是否仍選取有效節點。若 App 支援自動更新，可先設為每天一次，實際間隔依服務提供者的要求調整，不必設成每分鐘更新。更新規則集與更新節點訂閱可能是兩個獨立操作，請分別確認結果。

需要回報問題時，請記錄 iOS 版本、客戶端版本、設定類型、使用 Wi-Fi 或行動網路，以及發生錯誤的時間與操作步驟。分享記錄前，請遮蔽訂閱網址、節點密碼及權杖。依序確認「取得 App → 匯入設定 → 選取設定 → VPN 授權 → 驗證連線」，比反覆重新安裝更容易找出問題。更多匯入與排查步驟，請參閱入門指南；設定概念則可查看完整文件。

下載Clash