iOS 版 Clash 客戶端下載:App Store 安裝與匯入設定檔教學
整理 iPhone 上支援 mihomo 規則的客戶端,從 App Store 搜尋安裝、首次授權 VPN,到透過連結或檔案匯入訂閱的完整流程。
iOS 客戶端與 mihomo 設定相容性
在 iPhone 上搜尋「Clash」時,首先要分清楚客戶端名稱、代理核心和設定檔格式。Clash Meta 是 mihomo 的舊稱;App Store 中名稱含有 Clash 的 App,不一定採用 mihomo 核心,也不一定能完整讀取 mihomo 設定。反過來說,名稱不同的客戶端也可能支援部分 Clash 格式。
安裝前,請先查看開發者提供的相容性說明,確認支援的節點協定、規則類型、策略群組和 DNS 選項,而不是只看 App 名稱。能辨識 YAML 檔案,只表示可以讀取這種文字格式,不代表檔案中的所有設定欄位都能正常運作。
挑選前確認四項功能
- 訂閱格式:是否支援完整的 Clash 設定,還是只接受節點清單或客戶端專用訂閱。
- 節點協定:確認是否支援實際使用的協定與傳輸參數,例如 Shadowsocks、Trojan、VMess、VLESS、Hysteria2。支援範圍請以目前的客戶端版本為準。
- 規則與策略群組:確認是否支援設定中使用的
rules、proxy-groups、rule-providers等結構。 - 設定更新:確認遠端設定能否手動更新、是否提供自動更新,以及更新時會不會覆蓋本機修改。
在 App Store 搜尋與安裝前的確認事項
建議先透過下載頁提供的 iOS 入口確認產品,再前往 App Store。直接搜尋時可使用「Clash」或「mihomo」等關鍵字,但搜尋排序不代表相容性。App 是否上架、能否下載及價格,都可能因 Apple 帳號地區與開發者安排而異。
- 開啟 App Store,前往「搜尋」,輸入客戶端的完整名稱。
- 進入 App 詳情頁,確認開發者名稱、產品說明和版本記錄。不要只憑相似的圖示判斷。
- 查看詳情頁中的「相容性」,確認最低 iOS 版本需求。接著在 iPhone 的「設定」→「一般」→「關於本機」確認目前的 iOS 版本。
- 點選「取得」或價格按鈕,完成 Apple 帳號驗證。安裝完成後,先開啟客戶端查看設定入口,再匯入訂閱。
如果頁面顯示目前地區無法使用,重複搜尋通常不會改變結果。請先確認入口是否為開發者公布的網址,再核對帳號地區與發佈說明。不要安裝來源不明、使用企業簽署的 App,也不要為了取得客戶端而接受用途不明的裝置管理設定。
透過 App Store 安裝的是客戶端,不是代理服務。安裝完成後,通常仍需自行準備有效的訂閱連結或設定檔;App 能夠啟動,不代表已經有可用節點。
匯入前先分清訂閱連結與設定檔
設定入口通常會標示為 Profile、設定或設定檔,內容包含節點、策略群組、規則及相關執行參數。訂閱連結是取得遠端內容的網址;本機 YAML 則是某個時間點儲存的檔案。兩者內容可能相同,但更新方式不同。
| 設定來源 | 識別方式 | 更新方式 |
|---|---|---|
| 完整設定訂閱 | 提供包含節點、策略群組與規則等內容的 YAML | 重新取得遠端設定,可能覆蓋本機編輯內容 |
| 節點訂閱 | 只提供節點資訊,可能採用專用編碼或格式 | 需搭配客戶端範本或節點提供者設定 |
| 本機 YAML 檔案 | 儲存在「檔案」App 中的 .yaml 或 .yml 檔案 | 通常需要重新匯入或手動修改 |
不要把服務商的登入頁面網址當成訂閱連結。登入頁面通常會回傳 HTML,而非客戶端可解析的設定。請在服務商後台選擇明確標示適用於 Clash 或 mihomo 的訂閱格式;如果客戶端只支援專用格式,則依照說明選擇相應入口。
透過連結匯入遠端訂閱
客戶端介面名稱會因產品而異。以下依常見的「設定」、「新增」、「從 URL 匯入」功能說明操作;如果按鈕名稱不同,請尋找功能相同的入口,不要在 iOS 系統設定中貼上訂閱網址。
- 複製完整網址。從可信任的服務商後台複製訂閱連結,確認前後沒有空格、換行或通訊軟體附加的標點符號。
- 開啟新增入口。在客戶端的設定清單中點選「新增」或「+」,再選擇從 URL 下載或匯入。
- 設定容易辨識的名稱。例如「日常使用」或「備用線路」。名稱僅供本機管理,不會變更節點參數。
- 貼上並下載。如果 iOS 詢問是否允許從其他 App 貼上,確認來源後再允許。等待客戶端下載並完成解析。
- 選取目前使用的設定。匯入後返回設定清單,明確選取剛新增的項目,再檢查策略群組與節點清單。
「下載成功」和「設定可正常運作」是兩個階段。遠端網址可能已傳回檔案,但檔案中包含客戶端不支援的協定、錯誤縮排或外部規則引用。發生錯誤時,記下錯誤欄位,例如 proxy-groups 或 rule-providers,再進一步排查相容性問題。
設定下載逾時的排查順序
- 先確認 Wi-Fi 或行動網路可以正常瀏覽一般網頁,並排除尚未完成登入驗證的公共 Wi-Fi。
- 暫時停用其他 VPN 或網路過濾 App,再重新下載設定,避免既有通道影響連線路徑。
- 確認連結是否已過期。若回傳 HTTP
401或403,請優先檢查令牌、帳號狀態和伺服器端的存取限制。 - 若訂閱只能透過現有代理存取,可先使用有效的備用設定完成下載,或向服務商索取可直接連線的訂閱入口。
不要為了排除下載錯誤而關閉憑證驗證。HTTPS 憑證錯誤應從系統時間、網路環境與伺服器憑證著手排查,不應直接將設定網址改為不安全的傳輸方式。
透過「檔案」匯入本機 YAML
本機檔案適合用來保留可還原的副本,或在訂閱網址暫時無法連線時移轉設定。可透過 AirDrop、iCloud Drive 或可信任的檔案傳輸方式,將 .yaml 或 .yml 檔案儲存到 iPhone 的「檔案」App。
- 在「檔案」中找到目標檔案,確認它不是從網頁另存的 HTML,也不是尚未解壓縮的壓縮檔。
- 開啟客戶端的新增設定入口,選擇「從檔案匯入」,再透過系統檔案選擇器找到檔案。
- 如果客戶端支援透過分享匯入,也可以在「檔案」中長按檔案,選擇「共享」,再選擇目標客戶端。
- 匯入後選取該設定,確認節點與策略群組都已載入。如果客戶端複製了一份檔案,之後修改原檔通常不會自動同步到客戶端。
YAML 階層與策略引用
以下片段用來說明規則結構,並非可直接連線的完整訂閱。範例顯示網域規則優先比對、區域網路位址直接連線,其餘流量交由策略群組處理;其中的「日常出口」必須由完整設定中同名的策略群組提供。
rules:
- DOMAIN-SUFFIX,example.com,日常出口
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,日常出口
規則會由上而下比對,第一個符合的項目會決定流量出口。不要將 MATCH 放在仍需繼續比對的規則之前。YAML 縮排請使用空格;策略群組名稱必須與引用內容完全一致。全形冒號、混入定位字元或修改名稱,都可能造成解析或載入失敗。
如果設定還引用遠端規則集,即使本機 YAML 匯入成功,仍可能需要連線下載這些資源。遇到「規則提供者更新失敗」時,請檢查對應網址與客戶端是否支援該規則集格式,而不是反覆匯入同一個檔案。
首次連線與 VPN 設定授權
選取目前使用的設定後,在策略群組中選擇一個可用節點,再點選客戶端的連線開關。首次啟動通道時,iOS 通常會跳出新增 VPN 設定的系統確認視窗。確認提示中的 App 名稱後點選「允許」,並依照系統要求完成密碼或生物辨識驗證。
這項授權會允許客戶端建立網路通道,不會自動安裝根憑證。一般代理連線不需要使用者安裝用於 HTTPS 解密的根憑證;若額外出現憑證信任或裝置管理要求,請先確認其用途。
- 查看系統記錄:可前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」,查看已新增的 VPN 設定。不同 iOS 版本的選單名稱可能略有差異。
- 避免通道衝突:其他 VPN 或使用 VPN 功能的過濾工具,可能會取代目前的連線。排查時請先只保留一個啟用中的通道。
- 重新授權:如果誤按「不允許」,通常可以返回客戶端再次點選連線。若設定已損毀,可先中斷連線,再刪除對應的 VPN 設定,並由客戶端重新建立。
不要照搬桌面客戶端的「開啟系統代理」步驟。iPhone 的 Wi-Fi 手動 HTTP 代理是另一種設定方式,只會對特定網路及支援此功能的流量生效。使用客戶端的系統通道時,通常不需要再於 Wi-Fi 設定中填入桌面設定裡的 7890 等本機連接埠。
確認代理是否生效與常見問題排查
首次驗證應分別檢查設定、節點、規則和出口四個部分。延遲測試只能表示測試目標當下是否可連線,不能單獨證明網頁、UDP 或所有 App 都能正常運作。顯示數十毫秒延遲的節點,實際連線時仍可能遇到憑證、協定或目標網站的限制。
- 確認目前使用的設定。檢查選取的項目是否為剛匯入的檔案,避免以舊設定進行測試。
- 檢查策略群組選擇。確認目標策略群組沒有選到
DIRECT、失效節點或非預期的巢狀策略群組。 - 重新建立連線。重新開啟目標網頁,並查看客戶端提供的連線記錄或日誌,確認目標網域、命中規則與出口策略。
- 確認出口位址。造訪可信任的 IP 查詢網站,比較連線前後的公網出口。只檢查出口可能會忽略分流差異,還必須查看目標連線的規則記錄。
| 狀況 | 優先檢查項目 | 下一步處理 |
|---|---|---|
| 匯入時提示格式錯誤 | 連結是否開啟登入頁面、設定格式是否受支援 | 重新取得符合客戶端格式的訂閱,並依錯誤欄位檢查 YAML |
| 沒有節點或策略群組 | 是否誤匯入節點提供者檔案、是否已選取設定 | 匯入完整設定,或依客戶端要求建立策略群組 |
| VPN 已連線,但網頁逾時 | 目前使用的節點、DNS、遠端規則下載狀態 | 改用已知可連線的節點,查看具體連線錯誤 |
| 只有部分 App 無法連線 | 目標網域規則、UDP 支援,以及 App 是否仍有既有連線 | 重新啟動目標 App,並對照日誌逐項檢查 |
| 切換網路後連線中斷 | Wi-Fi 與行動網路權限、節點在新網路中的可達性 | 待網路穩定後重新連線,並再次發出測試請求 |
排查 DNS 問題時,不要一次更換所有解析器與模式。先記錄原始設定,每次只修改一個選項,再針對相同目標重新測試。桌面環境中有效的 Fake-IP 參數,不保證在另一款 iOS 客戶端中以相同方式實作;若 App 依賴真實位址,請依照該客戶端的過濾機制與官方說明處理。
訂閱更新與後續設定管理
遠端設定可以更新,本機檔案通常不會隨服務商的變更自動更新。首次匯入後,請先手動更新一次,確認下載與解析都成功,再設定客戶端支援的更新間隔。例如可先設為每 24 小時檢查一次,但 iOS 背景排程會受到系統限制,因此無法保證每天在特定時間完成更新。
- 更新前保留副本:尤其是手動新增規則、DNS 或策略群組時。重新整理遠端設定可能會覆蓋直接編輯的欄位。
- 區分設定用途:將日常與備用設定分別命名;切換後再次確認目前使用的設定與節點選擇。
- 確認更新結果:留意更新時間、解析提示與規則提供者狀態,不要只看下載按鈕是否停止轉動。
- 妥善保管匯出的檔案:YAML 可能包含伺服器位址、密碼和令牌。備份請存放在具備存取控制的位置;分享排查資訊前,先遮蔽敏感內容。
完成安裝、匯入、授權與驗證後,再逐步調整規則與 DNS。每次只修改一類設定,並保留可還原的設定。這樣在客戶端升級、訂閱變更或切換網路後,就能更快判斷問題出在哪個環節。