一、確認 iPhone 用戶端與訂閱格式

在 iPhone 上搜尋「iOS 版 Clash」時,實際上要選擇能處理相應訂閱、代理協定及分流規則的用戶端。Clash 是代理核心與設定生態系中的名稱,不能只因 App 名稱含有 Clash,就認定它能直接使用現有的 YAML。桌面版安裝檔也不能安裝為 iOS App。

本文以從 App Store 下載、支援 Clash 風格 YAML 的用戶端為例,Stash 是其中一個可考慮的選項。Stash 有自己的實作方式與設定支援範圍,不能視為桌面版 Clash 或 Clash Meta(mihomo)的完全替代品。尤其是 mihomo 專用欄位、指令碼及部分協定參數,匯入前請先查閱用戶端文件。

現有內容需要確認下一步
Clash YAML 訂閱用戶端是否支援其中的協定與欄位選擇相容用戶端的訂閱匯入方式
單一節點分享連結用戶端是否支援該連結協定以節點方式匯入,不要當成完整規則設定
其他用戶端專用訂閱服務端是否提供 Clash 或 Stash 格式先切換輸出格式,再複製連結
本機 YAML 檔案檔案是否包含節點、代理群組與規則透過檔案匯入,後續更新需自行管理

二、從 App Store 下載用戶端

確認 App Store 頁面與系統需求

  1. 開啟 iPhone 上的 App Store,點選底部的「搜尋」,輸入正確的產品名稱,例如「Stash」。不要只依圖示顏色或搜尋結果排序來選擇 App。
  2. 進入 App 詳細資料頁面,查看開發者、功能說明及「相容性」資訊,確認支援目前的裝置與 iOS 版本。若 App 標示付費,請先確認價格,再依系統購買流程安裝。
  3. 安裝完成後點選「打開」。首次開啟時先查看設定匯入入口,不必馬上開啟連線;沒有設定檔時啟用 VPN,也不會產生可用節點。

如果搜尋不到 App,請先確認產品是否仍在目前的 App Store 上架,以及 Apple 帳號的商店地區。以 iOS 18 為例,可前往「設定」→頂端的 Apple 帳號→「媒體與購買項目」→「檢視帳號」→「國家或地區」查看。選單可能因系統版本而異,App Store 的販售範圍也可能變動。

更改 App Store 地區可能牽涉餘額、訂閱及付款方式,並非排查連線問題的必要步驟。不要使用來路不明的共用帳號,也不要在第三方網站輸入 Apple 帳號密碼來安裝用戶端。若頁面要求透過企業憑證安裝,或安裝裝置管理描述檔,請先停止操作並確認來源。

若要比較系統相容性與用戶端下載方式,可查看用戶端下載頁;iOS App 是否可下載、實際價格及支援的系統版本,請以 App Store 目前頁面為準。

三、準備訂閱連結並匯入設定

複製訂閱網址,不要複製帳戶管理頁網址

在服務提供者的訂閱管理頁面,找到適用於目標用戶端的匯出選項。如果同時提供通用節點訂閱、Clash、Stash、mihomo 等入口,請優先選擇明確相容於目前用戶端的項目。要複製的是訂閱網址,不是登入頁、訂單頁或瀏覽器目前顯示的網址。

  • 請完整保留網址中的查詢參數,不要自行刪除問號後方的內容;其中可能包含身分權杖或輸出格式資訊。
  • 檢查網址前後是否有空格、換行或中文引號,尤其是經由通訊軟體轉傳的長網址。
  • 訂閱網址通常具有帳戶存取權限,請勿貼到公開留言、截圖或線上格式檢查工具。

在用戶端新增並啟用設定

  1. 開啟用戶端的設定管理頁面。以 Stash 為例,從首頁的設定入口進入設定清單,找到新增或下載遠端設定的操作;不同版本可能標示為「從 URL 下載」或類似名稱,請以實際介面為準。
  2. 將完整的訂閱網址貼到 URL 輸入欄位。若可設定名稱,可使用「主要訂閱」等容易辨識的名稱,避免在名稱中寫入密碼或權杖。
  3. 點選下載或確認,等待設定出現在清單中。若出現錯誤訊息,先記下錯誤類型,不要連續重複提交。
  4. 點選剛新增的設定,將它設為目前使用的設定。返回首頁或代理群組頁面,確認能看到代理群組與節點,而不只是設定檔名稱。
  5. 展開預設代理群組,選擇一個有效節點。初次測試時先使用手動選擇群組,方便確認實際出口;若使用自動選擇群組,也要檢查測速網址及群組成員是否有效。

匯入成功只代表用戶端接受了設定,不代表每個節點都能連線。完整的 Clash 風格設定通常包含節點或節點提供者、代理群組及規則等內容;如果設定依賴遠端規則集或節點提供者,也要確認這些資源已成功下載。若只有代理群組名稱、群組內沒有節點,請先不要啟用連線。

四、授權 VPN 設定並首次連線

iOS 用戶端通常會透過系統的 Network Extension 建立隧道,接管設定範圍內的流量。這不是照搬桌面版的「系統代理連接埠」做法:在 iPhone 上使用這類用戶端,通常不必前往 Wi-Fi 設定手動填入 127.0.0.1:7890。這個位址與連接埠常見於桌面版教學,但不是 iOS 通用的安裝步驟。

  1. 確認已選取正確設定後,在用戶端首頁開啟連線開關。
  2. 系統顯示用戶端要新增 VPN 設定的提示時,先確認提出要求的 App 名稱,再點選「允許」。
  3. 依系統指示完成裝置密碼或生物辨識驗證。驗證應在 iOS 系統介面進行,而不是在網頁表單輸入鎖定畫面密碼。
  4. 返回用戶端,等待狀態變為已連線。若剛才取消授權,請重新開啟連線開關,再完成一次授權。
  5. 若要查看系統記錄,請前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」,確認對應設定與連線狀態。不同 iOS 版本的顯示位置可能略有不同。

系統顯示 VPN 標記只代表隧道狀態,不代表遠端節點已通過測試;有瀏海或動態島的機型也不一定會一直在狀態列顯示 VPN 字樣,請綜合控制中心、系統設定與用戶端狀態判斷。一般個人使用情境下,另一款 VPN App 連線時可能影響目前連線,首次測試前請先中斷其他 VPN。

五、確認節點、規則與 DNS 是否正常

首次連線採用「一個節點、一種網路、一組測試」的方式,每次只調整一個變因。不要同時更換節點、DNS 和規則,否則即使恢復正常,也很難判斷原因。以下的測試次數是排查流程,不代表實測線路效能。

  1. 確認運作模式:日常設定通常先使用 Rule(規則)模式。Direct(直連)模式不會依預期使用代理節點;Global(全域)模式則會改變分流結果,不能用來驗證規則是否正確。
  2. 測試節點連線狀況:在代理群組中對同一個節點進行 3 次延遲測試,觀察是否持續逾時。延遲測試通常會連線至特定測試網址,不等於影片下載速度,也無法證明所有網站都能正常存取。
  3. 測試實際網頁:使用 Safari 開啟一個應該直連的網站,再開啟一個依目前規則應透過代理連線的網站。每個頁面重新整理一次,同時到用戶端的連線記錄或日誌頁面查找對應網域。
  4. 確認規則比對結果:檢查日誌是否顯示預期的規則、代理群組與出口。若網頁能開啟但流量命中 DIRECT,就不能只憑網頁載入結果認定代理節點有效。
  5. 比較網路連線方式:保持使用同一個節點,分別透過 Wi-Fi 與行動網路測試。若只有其中一種網路失敗,請優先檢查網路環境、入口網站認證及服務端限制。

如果日誌持續出現網域解析逾時,請再檢查設定中的 DNS 選項,以及用戶端是否支援相關欄位。不要直接拼接多份教學中的 dns 區段:重複鍵、縮排錯誤及不支援的欄位都可能引發新問題。Clash Meta(mihomo)設定中的特定 DNS 或 TUN 選項,也不保證能原樣套用於 iOS 用戶端。

六、排除匯入失敗與連線後無法上網

遇到的狀況優先檢查項目處理方式
下載回應 401 或 403權杖、訂閱權限或服務端存取限制返回服務管理後台確認狀態,重新複製有效網址
下載回應 404訂閱路徑是否失效或遭截斷從服務提供者目前的頁面重新取得網址
出現 YAML 解析失敗回傳內容是否為網頁,以及格式是否相容選擇正確的訂閱輸出格式,保留錯誤行號
節點清單為空或顯示不支援該協定節點資源下載狀態與用戶端協定支援情形檢查提供者的更新結果,取得相容設定
VPN 顯示已連線,但網頁無法開啟目前選取的節點、規則出口、DNS 與訂閱狀態先更換同一群組中的有效節點,再依日誌追查
開啟連線後立即中斷設定載入錯誤或與其他 VPN 衝突先查看日誌,中斷其他 VPN 後再試

解析錯誤若出現 <html> 或登入頁面標題,常見原因是網址回傳了網頁,而不是用戶端需要的訂閱內容。節點清單為空也可能是方案到期、流量用盡,或遠端節點提供者尚未更新成功,不能一概視為用戶端故障。

需要恢復正常上網時,先在用戶端關閉連線,再到系統 VPN 設定確認已中斷。如果設定啟用了隨選連線,也請在用戶端或對應的 VPN 設定中檢查此選項,避免系統再次自動連線。不要一開始就執行「重置網路設定」;這會影響已儲存的網路資訊,卻未必能解決訂閱格式問題。

七、更新訂閱與日常設定維護

  • 區分遠端訂閱與本機檔案:透過 URL 新增的設定可以重新下載;匯入本機 YAML 不代表它會自動同步服務端的變更。
  • 更新前保留可用設定:先匯出或複製目前的設定,再手動更新一次,確認節點數量、代理群組選擇及連線結果。
  • 確認自動更新的運作方式:App 開啟時更新、背景工作及節點提供者更新是不同機制。iOS 會排程背景工作,即使設定了間隔,也不代表會精確地每隔幾分鐘執行。
  • 另外保存個人修改:直接修改遠端訂閱內容,可能會在下次更新時被覆蓋。若需要自訂規則,請優先使用用戶端明確支援的覆寫或本機設定機制。
  • 訂閱外洩後立即重設:在服務管理後台重設訂閱權杖後,記得同步更新用戶端中的網址;舊網址失效是正常現象。

完成以上步驟後,應能清楚回答三個問題:目前啟用的是哪份設定、實際選擇了哪個出口,以及連線請求命中了哪條規則。之後若發生連線異常,從這三處開始檢查,比重新安裝 App 更容易找出問題。完整的設定流程可繼續閱讀使用指南;規則與設定概念請參閱Clash 設定手冊。