先釐清客戶端、設定格式與伺服器協定

在 iPhone 上使用 Clash 訂閱，首先要選擇能讀取相應設定的 iOS 客戶端。Clash 設定通常採用 YAML，包含節點、策略群組、規則與 DNS 設定；客戶端則負責匯入、顯示設定並啟動網路延伸功能。兩者屬於不同層級，也不能只因應用程式名稱含有「Clash」就認定相容。

Clash Meta 現稱為 mihomo，是一個核心專案。在桌面端使用 mihomo，不代表 iOS 客戶端也採用相同核心，更不表示訂閱中的所有欄位都能直接執行。即使協定名稱相同，傳輸參數、TLS 選項或規則擴充功能仍可能不同。

客戶端或設定類型匯入前須確認不能據此推定的事項
Stash支援 Clash 風格設定，並依目前版本文件確認擴充欄位與協定支援情況不能假設完整相容 mihomo 專用欄位
Shadowrocket使用該客戶端支援的節點訂閱或專用設定格式不能把完整的 Clash YAML 當成同等設定直接使用
sing-box 類型客戶端確認客戶端要求的 JSON 結構與核心版本不能只改副檔名，就把 Clash YAML 變成 sing-box 設定

本文以支援 Clash 風格設定的客戶端為主，並以 Stash 作為參考案例；Stash 並非原 Clash 專案的官方 iOS 版本。選用其他應用程式時，也應個別確認開發者、格式支援情況與目前的商店頁面，不要把網站品牌或相似名稱誤認為專案授權關係。

App Store 下載管道與帳號地區限制

先查看 App Store 頁面，再確認地區限制

能否搜尋到應用程式，取決於 Apple 帳號的商店地區、開發者的上架範圍、裝置相容性與目前的發佈狀態。裝置語言、時區及「設定」中的裝置地區，都不等於 App Store 帳號地區。切換網路出口也不會自動變更商店所屬地區。

  1. 從開發者官方網站的 App Store 連結前往商品頁，確認應用程式名稱、開發者名稱、最低 iOS 版本需求與價格。
  2. 如果顯示「目前所在國家或地區尚未提供」，請先確認「媒體與購買項目」目前使用的帳號，不要反覆變更手機語言。
  3. 如果提示系統版本不支援，請到「設定」→「一般」→「關於本機」查看 iOS 版本；變更地區無法解決系統相容性問題。
  4. 購買前請確認是一次性付費、訂閱制或其他收費方式，並以當下的商品頁資訊為準。應用程式費用與節點服務費是兩筆獨立支出。

變更地區與帳號安全

以下以 iOS 18 的選單為例：前往「設定」→點選頂端的 Apple 帳號→「媒體與購買項目」→「檢視帳號」→「國家或地區」，即可查看帳號地區。不同系統版本的選單名稱可能略有差異。正式變更前，請依 Apple 指示處理帳戶餘額、現有訂閱、家人共享與付款方式。

App Store 的供應情況可能變動，本文不保證任何地區會長期上架。TestFlight 屬於測試發佈管道，名額與版本有效期限都有限，不能視為永久下載管道。如需安裝連結，可先查看本站下載中心的平台說明，再確認開發者提供的正式管道。

匯入前準備：確認訂閱回傳的是完整設定

「訂閱連結」沒有統一格式。有些會回傳完整 YAML，有些只有節點清單，有些回傳編碼後的節點 URI，還有些會依請求參數或客戶端識別資訊回傳不同內容。瀏覽器能開啟連結，只代表請求收到回應，不表示內容適用於目前的客戶端。

  • 完整 Clash 設定：通常會看到 proxies 或 proxy-providers，以及 proxy-groups、rules 等欄位。
  • 節點提供者：內容可能只有 proxies 清單，還需要主設定中的 proxy-providers 引用；不一定能直接當成完整設定啟動。
  • 網頁回應：如果出現登入頁、方案頁面或 HTML，通常表示取得的是網頁網址、驗證失敗，或伺服器要求先登入。
  • 其他客戶端專用格式：請向服務提供者索取相應客戶端的連結，不要只根據副檔名判斷內容。

訂閱網址中的查詢參數常含有存取憑證。複製時請保留完整參數，避免漏掉末尾字元；分享截圖時應遮住整個網址。不要將有效訂閱交給不受信任的線上轉換服務。若需轉換，請優先使用服務提供者提供的相容連結，或自行掌控的轉換工具。

如果訂閱已在電腦上使用，請先記下三項資訊：目前選用的策略群組、實際節點名稱，以及訂閱提供者標示的格式。匯入 iPhone 後即可逐項比對，而不只是確認節點數量是否相同。

訂閱匯入流程：分別確認下載、選用與更新

不同客戶端版本的按鈕名稱可能不同，但匯入流程應包含「新增遠端設定、下載、設為目前設定」三個步驟。以 Stash 這類客戶端為例，可從設定清單新增 URL 來源；若目前版本支援掃描 QR Code 或匯入檔案，也要確認匯入的是遠端連結還是本機副本。

  1. 前往設定管理。開啟客戶端的設定清單，選擇新增設定或從 URL 下載。不要把訂閱連結貼到 HTTP 代理位址、DNS 位址或節點伺服器位址欄位。
  2. 貼上原始訂閱連結。檢查連結中是否包含空格、換行、全形標點，或聊天軟體附加的說明文字。可取一個容易辨識的名稱，例如「日常規則」。
  3. 開始下載。等待客戶端完成解析。若出現錯誤，請記下狀態碼與欄位位置，不要只記錄「匯入失敗」。
  4. 選用目前設定。下載成功後返回設定清單，確認已選用該設定；若有多份設定，新增成功不代表已立即切換。
  5. 檢查策略群組。開啟代理或策略頁面，確認主要策略群組有可選節點，且規則引用的群組名稱確實存在。
  6. 確認更新來源。檢查是否保留遠端 URL，以及是否有自動更新開關或手動更新入口。本機檔案通常不會自動同步原訂閱的變更。

依錯誤類型處理，不要不斷重試

  • 401 或 403：優先檢查憑證、連結是否有效及伺服器存取限制，不要先修改 DNS。
  • 404：確認完整路徑，並檢查舊訂閱是否已更換。
  • YAML 解析錯誤：檢查縮排、重複鍵與錯誤所在行；也可能是伺服器回傳了 HTML，而非 YAML。
  • 下載逾時：檢查基本網路連線與訂閱網域是否可連線。若客戶端支援透過現有代理更新，可在已有可用連線時嘗試。

VPN 設定授權：iOS 網路延伸功能如何接管流量

首次啟動連線時，iOS 通常會詢問是否允許新增 VPN 設定。確認應用程式來源後，依照系統提示允許，並使用裝置密碼或系統驗證完成授權。此處的 VPN 是系統網路延伸功能的入口，不代表訂閱中的每個節點都使用傳統 VPN 協定，也不表示所有流量一定會經過遠端節點。

以下以 iOS 18 為例，可前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」，查看設定與連線狀態。如果清單中已有公司 VPN、其他代理客戶端或安全軟體，測試前請先停止另一條個人 VPN 連線。受管理裝置的相關限制，請洽裝置管理員確認。

與桌面系統代理及 TUN 的差異

桌面系統代理通常要求應用程式遵循 HTTP 或 SOCKS 代理設定；iOS 這類客戶端常透過 Network Extension 的 Packet Tunnel 接入系統網路。兩者都涉及網路層流量接管，但授權、路由能力、排除流量與執行期間各受作業系統規範限制，不能直接照搬 Windows 服務模式的操作步驟。

  • 不必先修改 Wi-Fi HTTP 代理。使用客戶端的 VPN 網路延伸功能時，一般不需要在 Wi-Fi 詳細資訊中設定手動代理。
  • 連接埠不等於 VPN 授權。桌面設定中的 mixed-port: 7890 是本機監聽連接埠的範例，不是 iPhone 的系統授權參數。
  • 控制區域網路的暴露範圍。除非確實需要讓其他裝置連線，否則不要為了讓手機上網而開啟允許區域網路存取。
  • VPN 圖示不代表驗證完成。系統顯示 VPN 已連線，只能證明隧道狀態；仍須確認規則、節點與目標請求。

切換規則模式：確認策略群組與實際出口

初次使用建議先選擇規則模式。規則模式會依序比對目標並套用策略；全域模式會將通常受其控制的流量交由全域策略處理；直連模式則用於直接連線。實際涵蓋範圍也會受到客戶端路由設定與系統限制影響。不要把「全域」解讀為絕對涵蓋裝置上的所有系統通訊。

以下規則片段用於檢查比對順序，並非可獨立匯入的完整設定。其中「代理選擇」必須對應現有設定中的策略群組名稱；若實際群組名稱不同，請依實際名稱修改。

mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,代理選擇

這段設定代表：符合 apple.com 及其子網域時直連；目的位址屬於指定區域網路網段時直連；其他請求則交由「代理選擇」處理。這僅用來示範規則結構，並非適用於所有人的分流建議。尤其網域後綴規則不會涵蓋同一家公司所有業務網域。

用同一個請求完成三項確認

  1. 選擇策略群組：在客戶端的代理頁面找到規則所引用的群組，並明確選擇一個節點。若是自動選擇群組，則需確認目前實際選用的成員。
  2. 測試延遲：執行客戶端提供的測試。若結果為 120 ms，只能代表該測試目標與測試方式下的耗時；這只是讀數範例，並非本文實測，也不能取代頻寬與實際服務可用性測試。
  3. 查看連線記錄：開啟預期會經過代理的網站，再查看客戶端的連線或請求記錄，確認目標網域、命中規則、策略鏈與實際節點。

如果出口 IP 仍與本地電信業者一致，請先確認這次查詢是否符合直連規則。出口檢測網站本身也可能被規則設為直連。請將檢測結果與同一時間的連線記錄對照，不要只看到一個 IP 位址，就認定整支手機的代理都失效。

iPhone 常見問題：DNS、更新失敗與網路切換

節點延遲測試正常，網頁卻無法開啟

先確認實際服務請求與延遲測試的目標是否相同，再檢查 DNS 和規則。節點交握成功，不代表目標網站一定可連線。如果記錄顯示網域解析失敗，請確認客戶端是否接受設定中的 DNS 欄位，以及是否有客戶端層級的 DNS 設定覆蓋該欄位。使用 Fake-IP 時，客戶端本身也必須支援相應模式，不能只新增 enhanced-mode: fake-ip 就假設設定已生效。

桌面設定正常，iOS 卻提示欄位不支援

保留錯誤訊息中的欄位名稱，並查閱目前客戶端版本的設定文件。mihomo 專用擴充功能、規則提供者的行為與傳輸選項都可能有所不同。不要為了消除錯誤而刪除整段規則或 DNS 設定；請先使用訂閱提供者提供的 iOS 相容設定，再確認重要策略是否仍然保留。

Wi-Fi 可以使用，行動網路卻無法連線

先在關閉代理的情況下確認行動數據能正常上網，再到「設定」→「行動服務」確認客戶端具備所需的數據存取權限。切換 Wi-Fi 與行動網路後，觀察隧道是否重新連線、節點是否重新交握。不同網路路徑對 UDP 的處理可能不同；使用 Hysteria2 等以 QUIC 為基礎的協定時，請特別確認 UDP 是否可連線，不要直接歸因於帳號地區。

訂閱更新後，原本的選擇不見了

訂閱可能變更了節點名稱、策略群組名稱或群組結構。請先檢查這次更新的結果，再重新選擇群組成員。若應用程式支援儲存策略選擇，也只有在比對規則有效時才能還原選擇；伺服器已刪除的節點，無法靠本機設定繼續使用。

需要停止連線或清除設定

先在客戶端停止連線，並確認是否開啟隨選連線或自動連線，避免系統立即重新連線。如需移除設定，再到系統的 VPN 清單刪除對應項目。回報問題時，請記下客戶端版本、iOS 版本、網路類型、錯誤時間與相關記錄，並遮住訂閱憑證、節點密碼及私人網域。更多排查方式請參閱常見問題。