平台教學 閱讀時間約 10 分鐘

iPhone 使用 Clash 規則:從 App Store 下載相容用戶端並匯入設定

了解如何從 App Store 下載支援 Clash 設定的 iOS 用戶端,並透過連結、檔案或掃描 QR Code 匯入訂閱,另附 VPN 權限授予與背景運作設定。

相容範圍:Clash 規則不等於通用 iOS 設定

在 iPhone 上使用 Clash 規則,關鍵在於用戶端是否支援相應的設定格式,而不是 App 名稱裡有沒有 Clash。Windows 安裝檔無法在 iOS 上執行;iOS 用戶端也不一定採用桌面版 Clash 或 mihomo 核心。即使都能讀取 YAML,支援的欄位、通訊協定與規則集格式仍可能不同。

本文以支援 Clash 格式設定的 Stash 為操作範例。購買前,請先在 App Store 產品頁面與用戶端文件中確認系統需求、設定相容範圍及價格。商店是否提供下載會依 Apple 帳號的商店地區與產品上架狀況而異,搜尋不到不代表裝置故障。

現有資料 匯入前檢查 處理方式
完整 Clash YAML 包含代理、策略組與規則,且欄位受目標用戶端支援 選擇匯入設定檔或設定 URL
節點訂閱或單一節點連結 可能只有伺服器資訊,沒有策略組與分流規則 使用用戶端支援的節點匯入入口,並另外設定規則
mihomo 專用設定 檢查專用欄位、通訊協定與規則集編碼 向服務提供者索取明確支援目標 iOS 用戶端的設定
其他用戶端設定 例如 Surge 設定或產品專用訂閱 不要只改副檔名;請選擇相應格式或可信賴的轉換方式

從 App Store 下載:先確認產品,再安裝

商店與系統需求

  1. 開啟 App Store,在「搜尋」中輸入產品名稱,例如 Stash。
  2. 進入產品頁面,確認開發者、產品說明、更新紀錄,以及「相容性」中的最低 iOS 需求。不要只憑相似圖示或搜尋廣告判斷。
  3. 查看目前帳號顯示的價格與購買條件,確認後再下載。用戶端的購買費用與訂閱服務費用是兩筆獨立支出。
  4. 開啟用戶端,先查看匯入設定的入口,再準備訂閱連結或本機檔案。首次啟動時不必立刻開啟連線。

如果搜尋不到產品,先點 App Store 右上角的個人頭像,確認「媒體與購買項目」使用的 Apple 帳號。商店地區取決於購買帳號等條件,不是把「設定」→「一般」→「語言與地區」改成其他地區就能切換。

若要變更帳號地區,請依照 Apple 官方流程處理餘額、訂閱與付款方式等限制。不要使用來源不明的共用帳號,也不要在裝置的 iCloud 登入他人的帳號。企業憑證安裝、描述檔發佈與從 App Store 下載是不同管道,不能混為一談。

安裝前記下三項資訊

  • 用戶端版本:記下 App「設定」或「關於」頁面顯示的版本,發生錯誤時可用來確認欄位支援狀況。
  • 系統版本:前往「設定」→「一般」→「關於本機」查看 iOS 版本。
  • 設定來源:記下訂閱控制台標示的目標用戶端。如果服務提供者分別列出 Clash、Stash、Surge,請優先選用明確支援目前產品的項目。

透過連結匯入:保留訂閱網址與更新功能

遠端設定適合需要定期更新節點或規則的情況。以下以 Stash 常見介面為例:進入設定清單,點選右上角「+」,選擇「從 URL 下載」等類似選項。不同版本的按鈕可能顯示為「下載設定」;請選擇可輸入遠端設定 URL 的功能,而非手動新增單一代理。

  1. 從服務提供者的帳戶控制台複製適用於目前用戶端的訂閱連結。確認複製的是完整 URL,而不是登入頁面、購買頁面或一段顯示文字。
  2. 貼上後檢查連結首尾是否完整,以及是否多了空格、換行或通訊軟體附加的標點。不要為了「整理連結」而刪除查詢參數。
  3. 下載完成後,為設定命名,例如「日常設定」,再從設定清單中選取該項目。
  4. 開啟設定內容或摘要,確認代理、策略組與規則都已載入。如果只看到一組節點,請進一步確認取得的是節點訂閱,而非完整設定。
  5. 在設定詳細資料中檢查更新來源與更新入口。先手動更新一次,再依照用戶端實際提供的選項設定更新週期。

訂閱更新與規則集更新不一定是同一個流程。設定檔可能透過 proxy-providers 引用代理集合,並透過 rule-providers 引用規則集合;即使主設定下載成功,這些遠端資源仍可能各自下載失敗。排查時請查看記錄中的個別資源網址與錯誤訊息,不要只看首頁是否顯示設定名稱。

透過檔案或掃描匯入:分清靜態副本與遠端來源

從「檔案」App 匯入 YAML

本機檔案適合用來移轉現有設定,或在網路下載失敗時檢查語法。先將 .yaml 或 .yml 檔案儲存至「檔案」App 的「下載項目」、iCloud 雲碟或「我的 iPhone」。副檔名只能作為辨識線索,檔案內容仍須符合目標用戶端支援的設定格式。

  1. 在用戶端設定清單中點選「+」,選擇從檔案匯入;如果目前版本沒有這個選項,可在「檔案」App 中長按檔案,點選「分享」並尋找目標用戶端。
  2. 匯入後選取該設定,查看是否出現 YAML 解析錯誤。縮排請使用空格,不要混用定位字元。
  3. 檢查檔案引用的外部資源。桌面設定中的本機路徑不會自動對應到 iPhone 上同名的檔案,相關內容必須重新匯入,或改用用戶端支援的引用方式。
  4. 保留一份未修改的副本。在本機調整規則前,先確認遠端更新是否會覆蓋這些變更。

本機匯入通常只是匯入當下的靜態副本,不會單靠檔名自動連結原訂閱。若要持續更新,請透過遠端設定入口重新新增來源。不要把手動下載的新檔案,誤認為現有設定已自動更新。

掃描訂閱 QR Code

QR Code 是資訊載體,不是獨立的設定格式。它可能編碼 HTTPS 訂閱網址,也可能是單一節點 URI。請先從用戶端的新增設定或掃描入口辨識;若介面支援從相簿讀取,也可選取已儲存的 QR Code 圖片。

  • 首次掃描時,請依提示授予相機權限;之後可前往「設定」→「隱私權與安全性」→「相機」調整。
  • 若辨識結果是遠端設定 URL,請繼續確認來源與下載結果,步驟與透過連結匯入相同。
  • 若辨識結果是單一節點,請確認它已加入節點清單;不要預期完整的分流規則也會一併出現。
  • 使用系統相機掃描時,系統可能只顯示網址或重新導向提示,不保證會將內容直接交給代理用戶端。

如果 QR Code 顯示在同一部 iPhone 的螢幕上,請優先使用用戶端的相簿辨識功能,或直接複製原始訂閱連結。不要為了掃描而將含有權杖的截圖上傳至公開辨識服務。

VPN 授權與首次連線檢查

選取設定後,再開啟用戶端的連線開關。首次連線時通常會出現系統提示,要求允許新增 VPN 設定;確認產品名稱後點選「允許」,並依系統要求使用裝置密碼或生物辨識完成驗證。這是在授權用戶端建立網路通道,不是安裝訂閱服務提供者的憑證。

可前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」查看設定狀態。若裝置由組織管理,相關權限可能受到管理政策限制,請聯絡管理員確認,不要企圖透過重複匯入來繞過限制。

四步確認流量分流

  1. 選擇規則模式:在用戶端的出站或模式設定中選擇「規則」。全域模式主要用於暫時比較,不適合拿來確認規則是否生效。
  2. 檢查策略組:開啟設定中實際存在的代理策略組,選擇可用節點,或使用設定中已定義的自動選擇組。
  3. 測試兩種連線:分別造訪預期直連的網站與預期經代理連線的網站,並在請求記錄中查看套用的規則、策略與出站方式。
  4. 重新測試 App:瀏覽器確認可用後,再測試目標 App。既有長連線可能仍沿用舊路徑,必要時請關閉並重新開啟該 App。

桌面端常見的 mixed-port: 7890 代表本機代理的監聽埠,並非 iPhone 啟動 VPN 通道的必要條件。不要在 Wi-Fi 的「設定代理伺服器」中手動填入 127.0.0.1:7890,以此取代用戶端的連線開關;該位址只指向手機本身,也不保證有相應的監聽服務。

iOS 用戶端通常透過系統 Network Extension 建立通道,不能照搬桌面版 mihomo 的「安裝服務」或 TUN 網卡操作。也不要假設桌面設定中的 tun、路由與 DNS 參數,在 iOS 上都能逐項對應。

背景運作:鎖定螢幕、切換網路與按需連線

iOS 通道由網路擴充功能負責運作,介面 App 不必一直留在前景。「背景 App 重新整理」與通道能否持續運作不是同一項設定。無法保證開啟背景重新整理後就絕不斷線,也不應反覆強制關閉用戶端來「保持運作」。

建議測試順序

  • 鎖定螢幕測試:先確認前景使用正常,再鎖定螢幕約 2 分鐘,解鎖後檢查 VPN 狀態與新的請求記錄。這段時間只是排查步驟,不代表續航或穩定度的實測結果。
  • 切換網路測試:從 Wi-Fi 切換至行動網路,觀察是否恢復連線。如果只在行動網路上失敗,請前往「設定」→「行動服務」檢查用戶端的行動數據使用權限。
  • 按需連線:若用戶端提供「按需連線」功能,請依說明設定網路條件。此功能決定何時觸發連線,無法修復失效節點或錯誤設定。
  • 低耗電模式:若異常只在低耗電模式下發生,可暫時關閉該模式進行比較,但不要將它視為所有斷線問題的共同原因。

遠端設定更新可能取決於用戶端排程、前景運作或系統允許的背景執行時機。即使設定了更新間隔,也不代表 iOS 會在每個時間點準時喚醒 App。若長時間未開啟用戶端,重新使用前請先手動檢查設定的更新時間。

其他 VPN、DNS 過濾工具與安全類網路擴充功能可能影響路由或名稱解析。排查時先停用另一項服務,只保留一個待測通道;不要直接刪除公司或學校下發的管理設定。

常見錯誤:依下載、解析、連線分層排查

狀況或記錄 優先檢查 下一步處理
下載回應 401、403 或 404 權杖、存取限制,以及連結是否已重設 返回帳戶控制台重新複製連結,並確認訂閱狀態;狀態碼本身無法證明唯一原因
回應內容以 HTML 開頭 是否誤用了登入頁面,或被驗證頁面攔截 取得真正的設定端點,不要將網頁另存為 YAML 後匯入
YAML 解析失敗 錯誤行附近的縮排、冒號、引號與檔案完整性 還原原始副本,使用本機編輯器逐項檢查;不要將含有憑證的檔案上傳至公開工具
未知欄位或不支援的通訊協定 設定是否是為 mihomo 或其他產品提供 取得目標用戶端專用設定,不要直接刪除欄位後就假設行為不變
VPN 顯示已連線,但網站無法開啟 節點是否可用、策略組選項、DNS 與規則命中情況 先改用已知可用的節點,再根據請求記錄區分名稱解析失敗與連線逾時
主設定載入成功,規則集載入失敗 遠端規則網址、格式與下載路徑 查看個別資源記錄,確認用戶端支援其編碼;二進位規則集並非所有用戶端通用

延遲測試有回應,不代表所有連線都能正常使用。測速可能採用特定 URL,也可能未涵蓋目標網站的 DNS、UDP 或規則路徑。反之,測試逾時也可能只是探測網址無法連線,不能只憑單一數值判定整份訂閱失效。

向服務提供者或用戶端維護者回報時,請提供用戶端版本、iOS 版本、匯入方式、錯誤時間與去識別化記錄。保留欄位名稱與錯誤行號,移除訂閱權杖、密碼、私鑰及個人帳號資訊。依序確認「設定能否下載 → 能否解析 → 通道能否啟動 → 請求使用哪種出站方式」,通常比反覆重新安裝更有效。

下載Clash