先確認用戶端與設定格式

在 iPhone 上使用 Clash Meta 規則，第一步不是搜尋同名安裝包，而是確認用戶端接受哪種設定格式。Clash Meta 後續以 mihomo 名稱發展；mihomo 是代理核心，訂閱是取得設定或節點資料的管道，規則則決定連線要交由哪個出口處理。三者並不是同一回事。

iOS 用戶端通常透過系統的 Network Extension 建立 VPN 通道。畫面出現 VPN 標示，只代表通道已啟用，無法據此判斷 App 內執行的是 mihomo，也不能證明設定中的所有規則都受支援。桌面版可用的 YAML，不一定能直接匯入 iPhone。

用戶端類型匯入前檢查規則處理方式
Stash 等支援 Clash 風格 YAML 的用戶端查看目前版本支援的協定、欄位與規則集格式部分設定結構可共用，mihomo 擴充欄位仍須逐項確認
Shadowrocket 等採用自有設定格式的用戶端選擇服務商提供的相應訂閱類型節點訂閱與規則設定可能需要分別匯入
其他 iOS 代理用戶端核對開發者文件與 App Store 產品頁面依用戶端標示的解析能力判斷，不要只憑 App 名稱推測

從 App Store 下載與 Apple ID 地區

先到用戶端下載頁確認 iOS 下載入口，再核對 App Store 中的 App 名稱、開發者與購買資訊。App Store 的下載項目會依 Apple 帳號所屬的商店地區而異；更改 iPhone 的介面語言或「語言與地區」設定，並不會切換 App Store 地區。

查看目前的商店地區

  1. 開啟 iPhone「設定」，點選頂端的 Apple 帳號名稱。
  2. 進入「媒體與購買項目」→「檢視帳號」，依系統提示完成驗證。
  3. 查看「國家或地區」。不同 iOS 版本的名稱可能略有差異，請以帳號頁面顯示為準。
  4. 返回 App Store，搜尋正確的 App 名稱並核對開發者，不要只看圖示。

如果搜尋不到用戶端，先確認是商店地區無法下載、iOS 版本不符合需求，還是 App 已調整上架狀態。不要反覆更改手機地區設定，也別把第三方網頁上的安裝按鈕誤認為 App Store 頁面。

切換帳號前確認購買條件

  • 依 Apple 規定處理帳號餘額、訂閱、家人共享與有效付款方式。更改地區前可能必須先完成這些事項。
  • 使用自己管理的帳號，切勿把 Apple 帳號密碼或雙重認證驗證碼交給代安裝人員。
  • 下載屬於「媒體與購買項目」的操作，安裝代理用戶端不需要登出整台裝置的 iCloud。
  • 付費 App 的購買紀錄會與帳號連結；後續更新、重新下載或恢復購買，可能仍須使用原購買帳號。

用戶端費用與代理服務費用分開計算。購買 App 不會自動取得可用節點，已有訂閱也不代表已購買特定用戶端。下載完成後，先開啟 App 確認基本畫面能正常顯示，再匯入設定。

匯入訂閱連結

先前往訂閱服務商的帳號頁面，選擇符合用戶端需求的格式。mihomo 使用的完整 YAML、單獨的節點訂閱，以及其他用戶端專用設定，可能分別由不同入口提供。檔名相同、網址都以 HTTPS 開頭，也不代表內容格式一致。

  1. 選擇匯出類型：使用 Clash 風格設定的用戶端，先確認支援哪種 YAML；使用 Shadowrocket 時，優先選擇服務商明確標示的對應入口。
  2. 複製完整網址：保留路徑、查詢參數與權杖。透過聊天工具複製時若產生換行，或漏掉結尾字元，都可能造成驗證失敗。
  3. 新增遠端設定：在用戶端的設定或訂閱管理頁面，選擇新增、透過 URL 下載或遠端設定等選項。各 App 的選項名稱不盡相同，請勿將網址貼到單一節點的伺服器欄位。
  4. 下載並選取設定：確認清單中顯示設定名稱與更新時間；若 App 還要求選擇目前使用的設定，匯入後再進行選取。
  5. 檢查策略群組：進入策略或代理頁面，確認最終出口不是空群組，並選取一個可用節點。

匯入失敗時先檢查回應內容類型

若出現 HTTP 401 或 403，優先檢查權杖、帳號狀態與存取限制；若出現 404，確認複製的路徑是否完整。若提示 YAML 解析錯誤，檢查回傳內容是否其實是登入頁面或錯誤訊息頁。若顯示不支援的協定或規則類型，應改用目標用戶端適用的匯出格式，而不是刪除錯誤行後直接連線。

瀏覽器能開啟服務商首頁，不代表訂閱網址也能正常回傳設定。訂閱介面可能使用獨立網域，也可能發生重新導向。排查時記下錯誤訊息與發生時間即可，不要把含有憑證的完整回應貼到公開討論區。

本機 YAML 與規則相依項目

如果已有設定檔，可以先儲存至 iPhone 的「檔案」App，再透過用戶端的檔案匯入功能選取；支援分享匯入的 App，也能從分享選單接收檔案。請確認匯入的是實際設定檔，而不是網頁捷徑，或被聊天軟體轉成文字附件的副本。

檔案副檔名通常是 .yaml 或 .yml，但副檔名不代表相容。完整設定可能包含節點、策略群組、規則與遠端規則集；只有 rules 的片段無法提供代理節點。以下示範常見規則的排列順序，並非可直接連線的完整設定。

# 設定片段：PROXY 必須已在 proxy-groups 中定義
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,PROXY
  • DOMAIN-SUFFIX 會依網域後綴比對；範例網域僅用來說明語法，實際使用時應換成明確需要直連的網域。
  • 192.168.0.0/16 是一段私有 IP 位址範圍，不代表涵蓋所有區域網路位址，也不表示代理用戶端一定會接管區域網路流量。
  • no-resolve 可避免只為這條 IP 規則主動解析網域，並非全域關閉 DNS。
  • 將 MATCH 放在最後作為兜底規則。前面的規則一旦符合，通常不會再以後續規則決定該連線的處理方式。

移植 mihomo 設定時的三項檢查

第一，策略名稱必須一致。例如規則引用 PROXY，就必須有同名且包含可用成員的策略群組。第二，遠端規則集除了要能下載，其格式與行為類型也必須受用戶端支援。第三，GEOSITE 與 GEOIP 各自相依於相應資料與實作，支援其中一種不代表兩種都支援。

桌面版設定中的控制連接埠、監聽位址與 TUN 路由參數，不應直接照搬為 iOS 操作步驟。iPhone 的通道由 App 與系統協作建立，實際的 DNS、UDP 與路由行為仍取決於用戶端的實作。修改遠端訂閱前，優先使用 App 提供的覆寫或本機副本功能，避免手動編輯內容在下次更新時被覆蓋。

首次連線與 VPN 設定授權

匯入設定只完成資料載入。第一次點選連線時，iOS 通常會提示 App 要新增 VPN 設定。請確認要求是由剛安裝的用戶端發出，再點選允許，並依系統要求輸入裝置密碼或完成驗證。這裡授權的是系統網路通道，不是購買代理服務。

  1. 確認已選取目前使用的設定，且策略群組中至少有一個可用出口。
  2. 選擇依規則分流的運作模式；App 可能將其稱為規則、設定或其他名稱，請以用戶端說明為準。
  3. 點選連線並完成系統 VPN 授權，等待 App 顯示連線狀態。
  4. 開啟「設定」→「一般」→「VPN 與裝置管理」→「VPN」，確認相應設定的連線狀態。

若已安裝其他 VPN、DNS 工具或網路過濾 App，請先停止可能占用同類通道的連線，再單獨測試。不同 Network Extension 類型能否共存取決於各自實作，不要假設所有網路工具都能同時啟用。一般代理連線也不應透過關閉系統安全功能來解決。

驗證規則、DNS 與實際出口

連線後依序檢查「節點可連線 → 規則命中 → 實際請求」。延遲測試成功只代表測試目標當下可連線，不等於影片、遊戲與所有網站都能正常使用。節點延遲、頁面載入時間與頻寬是不同指標，不要把毫秒數當成下載速度。

完成一次可重現的驗證

  1. 查看測試結果：記下選取的節點名稱、測試目標與是否逾時。測試尚未完成時，請勿連續切換策略。
  2. 開啟明確設定為走代理的網站：查看用戶端連線紀錄中的目標網域、命中規則與最終節點。並非所有 App 都提供完整紀錄，請以實際介面為準。
  3. 比較出口 IP 位址：使用同一個 IP 查詢頁面，分別記錄斷線與連線後的結果。查詢網域必須符合代理策略，否則結果相同也可能是設定正常。
  4. 確認直連：存取一項明確設定為直連的服務，確認仍可正常使用，避免只驗證代理出口，卻忽略本機服務。

如果連線紀錄中有目標網域但解析失敗，優先檢查 DNS 設定與解析伺服器是否可連線。若設定使用 fake-ip，請確認用戶端支援相應機制；不要把虛擬映射位址當成網站的實際伺服器位址，也別只為了消除紀錄中的合成位址就重寫整套 DNS 設定。

測試期間盡量固定使用 Wi-Fi 或行動網路，避免網路切換引入變因。iCloud 私密轉送、瀏覽器既有連線與快取也可能影響比較結果；可以先關閉舊頁面並重新送出請求，再搭配代理紀錄判斷。單次成功開啟頁面，不能取代規則命中紀錄。

常見問題與日常更新

訂閱匯入成功，為什麼沒有可選節點？

先確認匯入的是節點訂閱、完整設定，還是單獨的規則檔。如果設定是透過遠端代理集合載入節點，也要檢查該集合的下載結果與引用名稱。設定檔解析成功，不代表所有外部資源都已下載完成。

VPN 顯示已連線，但網頁打不開，該先檢查什麼？

依序確認策略群組成員、節點測試結果、DNS 錯誤與最終命中的規則。可以暫時改用明確可用的節點進行比較，但不要同時修改 DNS、規則與運作模式。每次只變更一個項目，並保留原始設定以便還原。

桌面版可用的訂閱，為什麼 iPhone 會出錯？

桌面版 mihomo 與 iOS 用戶端在協定支援、規則解析及擴充欄位方面可能不同。先核對錯誤欄位與用戶端的支援說明，再選擇服務商提供的相容格式。只把檔案改名為 YAML，或重新貼上訂閱網址，都無法解決解析能力的差異。

更新訂閱後，手動設定的規則為什麼不見了？

遠端設定更新可能會取代本機內容。請將個人修改放在用戶端支援的覆寫、合併功能或獨立本機設定中，並保留備份。更新後重新檢查目前設定、策略群組選擇與遠端規則集狀態，不要只確認更新時間已變更。

日常維護只要依照清楚的順序檢查：從 App Store 更新用戶端，視需要更新訂閱，再確認節點、規則與 DNS 是否正常。更換用戶端時重新確認格式，不要把舊 App 的選單路徑、監聽連接埠或 TUN 參數直接當成新 App 的預設值。