iOS Clash 客戶端安裝：App Store 下載與設定檔匯入

安裝前：確認客戶端與設定格式

在 iPhone 上使用 Clash 設定，重點不是找到名稱含有 Clash 的 App，而是確認客戶端支援哪種設定格式、使用哪個核心，以及目前 App Store 所屬地區是否提供下載。原始 Clash 專案並未推出統一的官方 iOS 客戶端；iOS 上的相容 App 由不同開發者提供，介面與功能各有差異。

「支援代理訂閱」不代表「支援完整 Clash YAML」。有些客戶端只能讀取節點，有些可以匯入策略群組與規則，也有些只接受自有格式。Mihomo 是常被稱為 Clash Meta 的核心；為 Mihomo 編寫的設定可能包含舊版 Clash 核心不支援的協定或欄位。匯入前請先查看 App 說明中的設定格式與核心資訊。

• 已有完整 YAML：確認支援 proxies、proxy-groups、rules，並檢查設定使用的協定是否受支援。
• 只有訂閱連結：確認服務提供者提供的是 Clash、Mihomo 設定，還是僅包含節點 URI 的訂閱。
• 只有單一節點：ss:// 等節點 URI 不是完整 YAML，通常應使用「新增節點」或相應的 URI 匯入功能。
• 準備跨裝置使用：iPad 與 iPhone 的商店供應情況、最低系統版本及購買紀錄都需要分別確認。

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

從下載頁前往 App 詳細資訊

1. 開啟本站的客戶端下載頁，選擇 iOS 入口，再前往 App Store 的 App 詳細資訊頁面。
2. 確認 App 名稱與開發者，並閱讀「相容性」和版本說明。名稱相近的 App，可能採用完全不同的設定格式。
3. 點選「取得」或價格按鈕，依系統提示完成 Apple 帳號驗證。是否收費及支援哪些裝置，請以 App Store 目前顯示的資訊為準。
4. 首次開啟後，先查看「關於」或「設定」中的 App 版本與核心資訊，再決定要匯入哪種設定。

如果看到「此 App 在你所在的國家或地區尚未提供」，通常是商店發行範圍的問題，與訂閱失效無關。App Store 的下載地區主要由用於購買項目的 Apple 帳號國家或地區決定；變更「設定」→「一般」→「語言與地區」不會直接改變商店所屬地區。

找不到 App 或無法安裝時

• 確認系統版本：前往「設定」→「一般」→「關於本機」查看 iOS 或 iPadOS 版本，並與 App Store 標示的最低需求比較。
• 確認購買帳號：查看「設定」→「Apple 帳號」→「媒體與購買項目」，確認目前使用的帳號。較舊版本的系統可能會顯示 Apple ID。
• 區分核心與 App：桌面版安裝檔無法直接在 iPhone 上執行；匯入本機檔案的入口也不是安裝 App 的入口。

切換帳號地區可能影響餘額、訂閱與付款方式，操作前請先閱讀 Apple 的帳號變更說明。不要為了下載 App 而安裝來源不明的裝置管理描述檔。

匯入訂閱連結：儲存遠端網址並下載設定

遠端設定適合需要定期更新節點與規則的情況。連結通常包含存取憑證，應妥善保管並視同密碼。本文所說的「更新訂閱」是重新下載設定內容，不是更新 App Store 上的 App。

1. 從設定提供者複製完整連結，確認開頭是 https://，結尾沒有多餘空格或換行。不要任意刪除網址中的查詢參數。
2. 在客戶端尋找「設定」或「訂閱」入口，選擇新增遠端設定、從 URL 匯入等功能。
3. 輸入方便辨識的名稱，例如「日常分流」，貼上連結並開始下載。首次測試建議手動更新，確認成功後再設定自動更新。
4. 查看下載結果與解析提示。成功儲存後，將這份設定設為目前使用的設定；只出現在清單中不代表已啟用。
5. 前往策略群組確認節點數量與選取狀態，再開啟連線。使用規則模式時，請確認策略群組沒有意外停留在 DIRECT。

如果客戶端要求選擇訂閱類型，請依提供者的標示選擇。節點清單訂閱不會自動補上規則群組；完整設定也不一定適合放在「節點訂閱」入口。匯入後若只有節點、沒有原本的規則，請先確認匯入類型，不要立刻反覆更換節點。

匯入檔案與剪貼簿內容：分清設定本文和連結

透過「檔案」App 匯入 YAML

將設定儲存到「檔案」App 的「我的 iPhone」或 iCloud 雲碟。返回客戶端的設定頁面，選擇從檔案匯入，並透過系統檔案選擇器開啟 .yaml 或 .yml 檔案。部分 App 也支援透過「分享」選單匯入；是否會出現目標 App，取決於其支援的檔案類型。

匯入本機檔案通常會在客戶端另存一份設定，不會隨原始檔案自動更新。若修改雲碟中的原始檔案，請在客戶端重新匯入，或使用 App 提供的編輯功能。透過遠端連結建立的設定，則可能在下次更新時覆蓋本機變更；需要長期保留的規則，請放入客戶端支援的覆寫或合併機制。

剪貼簿裡應該放什麼

• 完整 YAML 文字：使用「從剪貼簿匯入設定」，複製時保留縮排，不要連 Markdown 的三個反引號一起複製。
• HTTPS 連結：使用遠端設定入口，避免將網址當成 YAML 本文解析。
• 節點 URI：使用節點匯入入口；之後仍需要規則與策略群組，才能組成所需的分流設定。

iOS 可能會詢問是否允許從其他 App 貼上；這與 VPN 授權是兩種不同的權限。如果先前拒絕了授權，請先嘗試長按輸入欄位手動貼上。若系統版本提供相關選項，可在 App 設定中查看「從其他 App 貼上」權限。以 iOS 18 為例，可前往「設定」→「App」→選擇相應的客戶端。

使用最小設定檢查 YAML 解析

以下設定僅用於確認匯入與規則解析是否正常，所有連線都會直連，不包含代理節點。如果客戶端要求額外欄位，請以該 App 的設定文件為準；不要將此範例當成可連線至遠端代理的訂閱。

mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

YAML 縮排請使用空格，不要使用 Tab。rules 是清單，每行規則前的連字號是語法的一部分。設定中的策略群組名稱必須與規則引用的名稱完全一致；例如規則指向「代理選擇」，設定中就必須有同名的策略群組。最後的 MATCH 會接收前面未匹配的連線，通常放在最後一行。

首次啟用 VPN：系統提示與連線確認

設定準備好後，點選客戶端的連線開關。使用 Network Extension 的客戶端首次建立通道時，iOS 通常會顯示「想要加入 VPN 設定」的系統確認視窗。確認提出要求的是剛安裝的客戶端，再點選「允許」，並依系統提示輸入裝置密碼或完成身分驗證。

這項操作是允許 App 建立 VPN 設定，不代表安裝根憑證，也不代表將裝置交由組織管理。一般代理通道連線不需要為此啟用 HTTPS 解密。如果接著出現安裝憑證或加入裝置管理的步驟，請先確認用途與來源。

1. 前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」，檢查客戶端對應的設定與連線狀態；不同系統版本的選單層級可能略有差異。
2. 返回客戶端，確認目前使用的設定與規則模式。暫停其他同類型的代理或 VPN App，避免重複建立通道造成干擾。
3. 開啟 Safari 發出新的連線請求，再到客戶端的連線紀錄中查看目標網域、命中的規則、策略群組與最後使用的節點。
4. 分別測試預期直連與預期經代理的目標。VPN 顯示已連線，只能表示通道已建立，不能單憑此狀態確認節點、DNS 與規則都正常。

相容客戶端通常透過系統通道介面接管流量，但實際涵蓋範圍會受 App 實作方式與系統政策影響。不要直接照搬桌面版的 tun、auto-route 或路由權限設定；iOS 客戶端可能忽略這些欄位，也可能要求在 App 介面中設定。規則模式決定已接管的連線如何分流，不代表所有連線都必須經過代理節點。

匯入失敗或連線異常：依提示逐步排查

排查時一次只調整一類設定：先確認設定能否下載，再檢查解析，接著驗證通道與節點，最後檢查規則和 DNS。如果下載逾時，先在中斷通道的狀態下測試；如果設定網址只能透過代理存取，就需要已有可用的連線才能更新，不能期待尚未成功匯入的設定提供連線。

回報問題時，請提供客戶端版本、系統版本、錯誤發生時間，以及已移除敏感資訊的紀錄。不要公開訂閱權杖、節點密碼或完整設定。截圖請保留錯誤文字與設定類型，遮住帳號和憑證即可。

日常更新與換機：保留可還原的資料

• 記錄更新來源：區分遠端訂閱與本機檔案，保留來源說明，避免誤把舊檔案當成最新訂閱。
• 更新前先備份：保留自訂規則、策略群組選擇及必要的覆寫設定；遠端更新可能會取代整份設定。
• 換機後重新確認：即使已移轉 App 資料，也應確認設定仍可下載，並依系統提示重新授予 VPN 權限。
• 刪除前先中斷連線：停用連線後再移除客戶端。若有殘留設定，可前往系統的 VPN 頁面確認並刪除相應項目。

完成安裝後，最重要的是沿著同一條流程逐一確認：使用來源可信的 App、符合格式的設定、成功取得系統授權，以及能說明流量去向的連線紀錄。日後遇到更新失敗或個別 App 無法連線時，就能找出問題所在，不必反覆重新安裝。