先確認 App 與訂閱格式,再處理商店地區

在 iPhone 上建議依序確認:代理 App 支援的設定格式、App Store 是否提供下載、匯入設定,最後授權 VPN 並測試連線。安裝 App 不會自動取得節點;訂閱網址通常由服務商另外提供,App 購買費用也與節點服務費用無關。

桌面版 Clash App、mihomo 核心與 iOS 代理 App 並不能直接畫上等號。iOS App 通常透過系統的 Network Extension 擴充功能接管網路,支援的協定、規則語法和設定管理則視各 App 的實作而定。名稱中有「代理」或「VPN」,不代表就能完整讀取 Clash YAML。

檢查項目確認事項常見誤解
Stash 等支援 Clash 格式設定的 App查看目前版本支援的 YAML 欄位、協定與擴充語法誤以為支援 Clash 設定就代表支援 mihomo 的所有功能
Shadowrocket 等代理工具使用服務商明確標示適用於該 App 的訂閱入口把完整 Clash YAML 當成通用節點訂閱
訂閱服務區分節點訂閱、完整設定檔與 App 專用連結認為同一個網址可以不加區分地匯入所有 App

App Store 下載方式與地區檢查

部分代理 App 只在特定國家或地區的 App Store 上架。搜尋不到 App 時,先檢查商店地區,不要急著更改 iPhone 的語言、時區或「語言與地區」設定。App Store 顯示哪些商品,主要取決於用來購買項目的 Apple 帳號地區;上架狀況可能變動,請以目前商店的 App 詳細資訊頁為準。

先核對 App 名稱、開發者與系統需求

  1. 開啟 App Store,搜尋 App 完整名稱並核對開發者資訊。不要只憑相似的圖示或搜尋結果排序判斷。
  2. 進入 App 詳細資訊頁,查看「相容性」中的最低 iOS 版本需求。如果目前系統版本不符,切換商店地區也無法解決相容性問題。
  3. 確認價格、購買帳號,以及能否在自己的裝置上安裝。購買前先確認訂閱格式,避免安裝 App 後才發現設定不相容。

查看或更改購買帳號的國家或地區

以 iOS 18 常見介面為例,操作路徑為「設定」→ 點選頂端姓名 →「媒體與購買項目」→「檢視帳號」→「國家或地區」。依 iOS 版本和帳號狀態不同,選單名稱可能略有差異。這裡的地區設定與「設定」→「一般」→「語言與地區」不同。

  • 更改現有帳號的地區:Apple 可能要求先用完帳戶餘額、處理訂閱與待處理訂單,並提供新地區接受的付款方式。家庭共享也可能影響變更條件。
  • 使用自己持有的其他地區帳號:可在「媒體與購買項目」中管理商店登入,不必為了下載 App 而登出整部裝置的 iCloud。切換帳號仍可能影響購買項目、媒體訂閱與日後更新,請先閱讀系統提示。
  • 保留購買紀錄:App 的購買、重新下載與更新資格都隸屬於購買帳號。不要使用陌生人提供的共用帳號,也不要把自己的驗證碼交給代操作人員。

請依實際情況填寫地區資料,並遵守 Apple 的使用條款。網頁提供的安裝檔不能取代透過 App Store 正常安裝;桌面版的 .exe、.dmg 和 Android 的 .apk 也不能用於 iPhone。TestFlight 是測試版發佈管道,名額與版本有效期限都有限,不適合作為長期使用的 App Store 替代方案。

匯入訂閱連結:保留原始網址並確認更新結果

訂閱連結適合需要定期更新節點的情況。連結通常包含存取權杖,任何取得完整網址的人都可能讀取訂閱內容。不要將網址貼到公開聊天室、截圖或客服單內容中;需要排查時,只提供狀態碼、錯誤訊息,以及已隱藏權杖的網域資訊。

依序完成「新增設定 → 下載 → 選取」

  1. 從服務商的帳戶頁面複製適用於該 App 的 HTTPS 訂閱網址。確認複製的是連結本身,而非登入頁網址、分享說明或帶有引號的文字。
  2. 開啟 App 中的「設定」、「訂閱」或「設定檔」頁面,選擇「新增」、「從 URL 下載」等選項。不同 App 的選項名稱各異,重點是找到遠端設定匯入功能,而不是手動新增單一節點。
  3. 貼上完整網址,並為設定取一個方便辨識來源的名稱,例如「個人訂閱」。若 iOS 詢問是否允許從其他 App 貼上,請確認來源無誤後再允許。
  4. 執行下載或更新,並確認是否出現節點、策略群組或規則。只儲存設定名稱,不代表內容已成功取得。
  5. 將新設定設為目前使用的設定。部分 App 可儲存多份設定,但同一時間只有選取的設定會用於連線。

完整的 Clash 格式設定常見欄位包括 proxies、proxy-groups、rules,也可能透過 proxy-providers 載入節點。只回傳編碼節點清單的訂閱並非完整 YAML;同樣地,回傳 HTML 登入頁面也不是可用的訂閱。若發生解析錯誤,先確認回應內容類型與 App 支援範圍,不要一開始就大幅修改規則。

更新訂閱會重新取得遠端內容。是否覆蓋本機規則、是否保留節點選擇,取決於 App 的實作。若需長期保留分流調整,優先使用該 App 支援的覆寫、指令碼或獨立規則機制;直接編輯遠端設定後的內容不一定會永久保存。

匯入檔案與 QR Code:先辨別內容類型

從「檔案」App 匯入設定

設定檔適合離線傳送、備份還原或問題排查。先將檔案存到「檔案」App 的「我的 iPhone」或 iCloud 雲碟,再到代理 App 選擇「從檔案匯入」;也可從檔案的分享選單選擇目標 App,但前提是該 App 已註冊支援相應的檔案類型。

  1. 確認檔案的實際內容。.yaml 和 .yml 常用於 Clash 格式設定;更改副檔名不會自動轉換格式。
  2. 匯入後查看設定檢查結果,留意縮排、欄位類型與不支援的協定。YAML 縮排必須使用空格,不能任意改用 Tab。
  3. 選取該檔案設定,確認策略群組中是否有可選節點。檔案引用的遠端節點提供者或規則提供者,仍須連線下載。
  4. 保留原始檔案備份。靜態檔案通常不會像遠端訂閱一樣自動取得新節點,除非檔案內容本身包含受支援的遠端引用。

掃描 QR Code 匯入訂閱或單一節點

QR Code 只是承載文字的方式,不是統一的設定格式。掃描結果可能是 HTTPS 訂閱連結、單一節點 URI,或 App 專用的匯入指令。只有 App 支援其中的內容,掃描才有用。

  • 掃描另一個螢幕上的 QR Code:從 App 內開啟掃描功能,依 iOS 提示授予相機權限,再確認匯入預覽內容。
  • QR Code 存在本機相簿:若 App 支援「從相簿辨識」,可以選取截圖;若不支援,回到服務商頁面複製訂閱連結會更直接。
  • 使用系統相機辨識:系統可能只會將辨識結果當作一般網址開啟,不能因此認定 App 已成功匯入。

匯入後要確認新增的是「單一節點」還是「一份訂閱」。單一節點 QR Code 通常不會附帶完整分流規則,也不一定支援後續自動更新。含有節點密碼或訂閱權杖的 QR Code 與原始連結同樣敏感,分享截圖前應遮住整個 QR Code。

VPN 授權與首次連線測試

成功匯入後,先選取設定與節點,再點選連線。首次啟動 VPN 隧道時,iOS 通常會提示 App 要新增 VPN 設定。確認提示中的 App 是剛安裝的代理 App,再選擇允許,並依系統要求輸入裝置密碼或完成驗證。

這項授權是允許 App 建立系統網路隧道,不等於安裝企業管理描述檔、根憑證或 MDM 管理。一般匯入訂閱通常不需要這些額外步驟;若來路不明的教學要求安裝憑證或管理描述檔,請先停止操作並確認用途。

檢查三個項目確認連線,不要只看 VPN 圖示

  1. 確認模式與策略群組:首次測試可使用規則模式,並在實際被規則引用的手動選擇群組中選取節點。若群組選的是 DIRECT,符合該規則的流量仍會直接連線。
  2. 確認隧道狀態:查看 App 是否顯示已連線,也可在 iOS 18 的「設定」→「一般」→「VPN 與裝置管理」→「VPN」查看狀態。選單可能因系統版本而異。
  3. 確認實際連線請求:開啟一個依目前規則應透過代理連線的網站,同時查看 App 的連線紀錄或日誌,確認目標網域、套用的策略與出口節點。也可用出口 IP 查詢輔助判斷,不要只憑狀態列圖示下結論。

規則可能將某些 IP 查詢網站設為直連,因此「查詢結果沒有變化」不一定代表連線失敗。需要排除變因時,可暫時使用 App 提供的全域代理模式,並確認全域策略選取了目標節點。測試完成後,請恢復原本的規則模式。不要同時修改 DNS、節點與規則,否則很難判斷是哪項設定造成影響。

桌面 App 所稱的「TUN 模式」與 iOS 系統隧道在使用體驗上都可能接管 App 流量,但設定選項和底層限制並不相同。不要因為桌面設定含有 tun 欄位,就認定 iOS App 會以完全相同的方式處理。

匯入失敗、連線逾時與更新異常的排查順序

問題狀況優先檢查接著處理
訂閱回應 HTTP 401 或 403網址權杖是否失效、服務是否限制存取回到服務商頁面重新取得網址,並確認帳戶狀態
訂閱回應 HTTP 404連結是否缺少路徑、複製時是否被截斷重新複製完整連結,不要手動刪改查詢參數
下載成功但解析失敗回傳的是否為登入頁、節點清單或含有不支援的 YAML 欄位改用該 App 專用的訂閱格式
設定已匯入但無法連線是否已選取設定、策略群組是否選到可用節點先手動選取一個節點,再查看連線錯誤
VPN 顯示已連線但網頁逾時節點是否可用、DNS、規則與其他 VPN 是否互相衝突停用其他網路隧道,分別透過 Wi-Fi 和行動網路測試
更新後規則恢復原狀是否直接編輯了遠端設定使用 App 支援的本機覆寫方式保存修改

每次只改一項設定,再重新測試

建議先中斷連線,確認一般網路可以開啟服務商頁面,再執行一次訂閱更新。接著選取一個節點連線,記下出錯時間與 App 顯示的錯誤類型。如果 Wi-Fi 失敗、行動網路成功,優先檢查目前的路由器、DNS 或區域網路限制;如果兩種網路都失敗,再檢查節點狀態與設定相容性。

iOS 上的其他 VPN、隨選連線規則或網路過濾擴充功能都可能影響測試。排查時先中斷其他 VPN,並確認它是否會自動重新連線。如果重新啟動後代理 App 又自動接管流量,請檢查 App 內的「隨選連線」設定,以及系統 VPN 設定中的相關開關,不要反覆刪除訂閱。

延遲測試顯示數值,只代表測試目標在當時可連線,不代表所有網站、串流服務或 UDP App 都能正常使用。首次連線的基本驗收標準是:設定可以更新、目前策略選取正確、預期透過代理的請求有出現在日誌中,且目標服務可以正常存取。遇到協定或規則欄位問題,可參閱本站的 YAML 手冊,但實際支援情況仍以所使用的 iOS App 為準。