從 App Store 下載前:確認 Clash 設定相容性
先確認用戶端能否匯入手邊的設定,再決定是否安裝。支援某種代理協定、支援 Clash 訂閱,以及支援完整的 Clash YAML,是三件不同的事。即使桌面版 mihomo 能讀取同一份檔案,iOS 用戶端也可能只讀取節點、忽略規則與策略組,或無法辨識某些欄位。
- 確認開發者與 App 頁面。透過開發者公布的連結前往 App Store,或在 App Store 搜尋產品名稱後確認開發者名稱。名稱或圖示相似,不代表是同一款用戶端。
- 確認系統版本。在 iPhone 開啟「設定」→「一般」→「關於本機」查看 iOS 版本,再比對 App Store 詳細頁「資訊」中的「相容性」。若頁面顯示目前商店地區無法使用,請先確認開發者公布的上架地區;不要把來源不明的安裝連結當成 App Store 入口。
- 確認支援的匯入方式。若手邊只有訂閱連結,請查閱「遠端設定」或「訂閱」的支援說明;若手邊是 YAML 檔案,請查找本機檔案匯入說明。若需要自訂分流,也要確認是否支援
proxy-groups、rules和遠端規則集。
匯入訂閱連結:確認取得的是完整設定
優先使用服務商明確標示為 Clash,或與目前用戶端相容的訂閱網址。訂閱連結通常看起來像 HTTPS 網址,無法只憑副檔名判斷內容;同一服務也可能分別提供完整設定、節點清單和帳戶管理頁面。
- 在服務商的訂閱頁面複製完整網址,保留問號後方的參數。不要將個人訂閱連結貼到公開聊天室、截圖或線上格式轉換網站;連結可能含有可直接讀取訂閱內容的權杖。
- 開啟用戶端的設定管理頁,選擇新增遠端設定或從 URL 匯入,再將連結貼到網址欄位。可自行設定方便辨識的名稱;這不會改變訂閱內容,也不是代理伺服器位址。
- 儲存並執行首次更新。確認用戶端顯示下載或解析成功,再檢查設定是否產生預期的節點與策略組。若原設定包含分流規則,也要確認匯入後規則仍然存在,而不只是節點清單。
- 將新設定設為目前使用的設定。儲存、更新和啟用是不同操作:清單中出現新項目,不代表目前執行中的連線已切換至該設定。
根據回傳結果判斷失敗發生在哪個步驟。若日誌明確顯示 HTTP 401 或 403,先確認訂閱授權與服務商的存取條件;若下載成功但解析失敗,先確認取得的不是網頁、登入回應或其他用戶端專用的訂閱格式。可先保留原本能用的設定,等新設定測試通過後再刪除。
匯入本機 YAML:使用「檔案」選擇器開啟
將完整檔案存到 iOS「檔案」App,再從用戶端匯入。可先在「檔案」→「瀏覽」中尋找「我的 iPhone」或「iCloud 雲碟」裡的檔案;如果檔案旁仍顯示雲端下載圖示,請先開啟或下載,確認本機可以讀取。若設定位於壓縮檔內,請先解壓縮,再選取實際的 .yaml 或 .yml 檔案。
- 在用戶端的設定管理頁選擇從檔案匯入,透過系統檔案選擇器開啟該檔案。若用戶端支援從分享選單接收設定,也可在「檔案」中長按檔案,點選「分享」後選擇用戶端。
- 遇到附有行號的解析錯誤,先檢查該行與上一行:縮排使用空格,同一層級的清單項目要對齊,並將以
-開頭的項目放在相應欄位下。將檔案重新命名為.yaml,不會把網頁或節點文字轉成設定檔。 - 檢查匯入結果後,將其設為目前使用的設定。本機檔案通常只會匯入成一份副本;除非用戶端明確支援同步更新,否則修改「檔案」中的原始檔後,必須重新匯入,並確認目前使用的設定已切換至新版。
若同一份檔案在電腦上可用、在 iPhone 上卻無法載入,請先區分 YAML 語法錯誤與用戶端欄位相容性問題。例如,設定若引用本機規則集,只匯入主 YAML 不一定會一併匯入外部規則檔;桌面版的絕對路徑也無法直接用於 iPhone。優先取得適用於該用戶端的版本,不要只為排除錯誤就刪除整段規則。
用最小範例檢查規則縮排
以下是 Clash 風格的頂層欄位範例,只說明規則清單的寫法與順序,不包含代理節點,也不能用來確認代理是否連線正常。檢查實際設定時,請將具體的比對規則放在兜底規則之前;規則通常會依序採用第一條符合的規則。
mode: rule
rules:
- DOMAIN,example.com,DIRECT
- MATCH,DIRECT
首次連線:允許 iOS 新增 VPN 設定
先選取已匯入的設定,再從用戶端點選連線。首次啟動通道時,iOS 通常會詢問是否允許該用戶端新增 VPN 設定。確認提示來自剛安裝的用戶端後,點選「允許」,並依系統要求完成身分驗證。訂閱與 YAML 是用戶端讀取的資料;VPN 設定則是 iOS 用來啟動通道的系統設定。匯入前者不會自動授予後者所需的權限。
- 在用戶端查看連線狀態。若一直顯示未連線或一連上就立即中斷,請先查看啟動日誌,確認目前使用的設定已載入,且已完成系統授權。
- 在 iOS 18 中,可開啟「設定」→「一般」→「VPN 與裝置管理」→「VPN」確認狀態。若選單名稱不同,可在「設定」中搜尋「VPN」。請確認目前顯示已連線的是這次安裝的用戶端,而非先前使用的其他 VPN。
- 若首次連線時點選了「不允許」,請返回用戶端重新連線,並留意系統提示。若裝置由企業或學校管理,且連線受到限制,請聯絡裝置管理員確認相關政策,不要自行移除管理描述檔。
連線後驗證:分別檢查規則與節點
VPN 顯示已連線,只代表通道已啟動,不代表遠端節點、DNS 和分流規則都運作正常。請先在同一個 Wi-Fi 網路下測試,不要同時更換節點、切換模式或修改 DNS,否則難以判斷是哪項變更讓連線恢復。
- 確認模式與策略組。若用戶端提供規則模式,請確認目前使用規則模式,並檢查預期經由代理連線的策略組是否選用了可用節點,而非
DIRECT。若目前使用全域模式,僅憑網頁能開啟,無法證明規則比對正確。 - 各測試一個直連與代理請求。從自己的規則中挑選一個預期直連的網域,以及一個預期經由代理連線的網域,分別發出新請求。若用戶端提供連線清單或日誌,請依網域確認比對到的規則及實際出站方式。測速結果只反映測試請求的狀況,不能取代對目標網域的實際連線驗證。
- 依症狀逐項檢查。只有個別網域連線失敗,先確認是否被順位更前面的規則比對到;只有某個節點不斷連線逾時,則保持模式與網路不變,在同一個策略組中換用另一個節點測試;多個網域都出現解析錯誤,先確認目前的 Wi-Fi 是否需要登入網頁,再檢查用戶端的 DNS 設定是否相容。
- 最後測試行動網路。確認 Wi-Fi 測試通過後,關閉 Wi-Fi,維持相同的設定與節點,再次連線到相同網域。若只有行動網路連線失敗,先在「設定」→「行動服務」確認用戶端及用來測試的 App 是否允許使用行動數據,再對照日誌判斷是解析失敗還是連線逾時。
若訂閱更新後才開始出現問題,先確認更新是否成功、目前使用的設定是否有變動,以及原先選用的節點是否遭移除或更名。需要尋求協助時,請記錄 iOS 版本、用戶端版本、匯入方式和第一則相關錯誤訊息;分享前請移除訂閱網址、權杖及設定中的帳戶資訊。