先確認 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 名稱、開發者與系統需求
- 開啟 App Store,搜尋 App 完整名稱並核對開發者資訊。不要只憑相似的圖示或搜尋結果排序判斷。
- 進入 App 詳細資訊頁,查看「相容性」中的最低 iOS 版本需求。如果目前系統版本不符,切換商店地區也無法解決相容性問題。
- 確認價格、購買帳號,以及能否在自己的裝置上安裝。購買前先確認訂閱格式,避免安裝 App 後才發現設定不相容。
查看或更改購買帳號的國家或地區
以 iOS 18 常見介面為例,操作路徑為「設定」→ 點選頂端姓名 →「媒體與購買項目」→「檢視帳號」→「國家或地區」。依 iOS 版本和帳號狀態不同,選單名稱可能略有差異。這裡的地區設定與「設定」→「一般」→「語言與地區」不同。
- 更改現有帳號的地區:Apple 可能要求先用完帳戶餘額、處理訂閱與待處理訂單,並提供新地區接受的付款方式。家庭共享也可能影響變更條件。
- 使用自己持有的其他地區帳號:可在「媒體與購買項目」中管理商店登入,不必為了下載 App 而登出整部裝置的 iCloud。切換帳號仍可能影響購買項目、媒體訂閱與日後更新,請先閱讀系統提示。
- 保留購買紀錄:App 的購買、重新下載與更新資格都隸屬於購買帳號。不要使用陌生人提供的共用帳號,也不要把自己的驗證碼交給代操作人員。
請依實際情況填寫地區資料,並遵守 Apple 的使用條款。網頁提供的安裝檔不能取代透過 App Store 正常安裝;桌面版的 .exe、.dmg 和 Android 的 .apk 也不能用於 iPhone。TestFlight 是測試版發佈管道,名額與版本有效期限都有限,不適合作為長期使用的 App Store 替代方案。
匯入訂閱連結:保留原始網址並確認更新結果
訂閱連結適合需要定期更新節點的情況。連結通常包含存取權杖,任何取得完整網址的人都可能讀取訂閱內容。不要將網址貼到公開聊天室、截圖或客服單內容中;需要排查時,只提供狀態碼、錯誤訊息,以及已隱藏權杖的網域資訊。
依序完成「新增設定 → 下載 → 選取」
- 從服務商的帳戶頁面複製適用於該 App 的 HTTPS 訂閱網址。確認複製的是連結本身,而非登入頁網址、分享說明或帶有引號的文字。
- 開啟 App 中的「設定」、「訂閱」或「設定檔」頁面,選擇「新增」、「從 URL 下載」等選項。不同 App 的選項名稱各異,重點是找到遠端設定匯入功能,而不是手動新增單一節點。
- 貼上完整網址,並為設定取一個方便辨識來源的名稱,例如「個人訂閱」。若 iOS 詢問是否允許從其他 App 貼上,請確認來源無誤後再允許。
- 執行下載或更新,並確認是否出現節點、策略群組或規則。只儲存設定名稱,不代表內容已成功取得。
- 將新設定設為目前使用的設定。部分 App 可儲存多份設定,但同一時間只有選取的設定會用於連線。
完整的 Clash 格式設定常見欄位包括 proxies、proxy-groups、rules,也可能透過 proxy-providers 載入節點。只回傳編碼節點清單的訂閱並非完整 YAML;同樣地,回傳 HTML 登入頁面也不是可用的訂閱。若發生解析錯誤,先確認回應內容類型與 App 支援範圍,不要一開始就大幅修改規則。
更新訂閱會重新取得遠端內容。是否覆蓋本機規則、是否保留節點選擇,取決於 App 的實作。若需長期保留分流調整,優先使用該 App 支援的覆寫、指令碼或獨立規則機制;直接編輯遠端設定後的內容不一定會永久保存。
匯入檔案與 QR Code:先辨別內容類型
從「檔案」App 匯入設定
設定檔適合離線傳送、備份還原或問題排查。先將檔案存到「檔案」App 的「我的 iPhone」或 iCloud 雲碟,再到代理 App 選擇「從檔案匯入」;也可從檔案的分享選單選擇目標 App,但前提是該 App 已註冊支援相應的檔案類型。
- 確認檔案的實際內容。
.yaml和.yml常用於 Clash 格式設定;更改副檔名不會自動轉換格式。 - 匯入後查看設定檢查結果,留意縮排、欄位類型與不支援的協定。YAML 縮排必須使用空格,不能任意改用 Tab。
- 選取該檔案設定,確認策略群組中是否有可選節點。檔案引用的遠端節點提供者或規則提供者,仍須連線下載。
- 保留原始檔案備份。靜態檔案通常不會像遠端訂閱一樣自動取得新節點,除非檔案內容本身包含受支援的遠端引用。
掃描 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 圖示
- 確認模式與策略群組:首次測試可使用規則模式,並在實際被規則引用的手動選擇群組中選取節點。若群組選的是
DIRECT,符合該規則的流量仍會直接連線。 - 確認隧道狀態:查看 App 是否顯示已連線,也可在 iOS 18 的「設定」→「一般」→「VPN 與裝置管理」→「VPN」查看狀態。選單可能因系統版本而異。
- 確認實際連線請求:開啟一個依目前規則應透過代理連線的網站,同時查看 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 為準。