先釐清客戶端、設定檔與訂閱

在 iPhone 上搜尋「Clash iOS」,通常是要安裝能使用現有訂閱的代理客戶端,而不是把 Windows 安裝檔搬到手機上。Clash 原始專案並未推出可直接視為官方 iOS App 的應用程式。App Store 上相容的客戶端各有其開發者、設定格式與功能限制;本站名稱也不代表本站是這些應用程式的開發者。

安裝前先確認三件事:要使用哪個客戶端、服務商提供哪種訂閱,以及訂閱是否包含客戶端支援的通訊協定。能下載 App,不代表訂閱一定能匯入;能匯入節點,也不代表整份規則都已生效。

項目實際用途匯入前檢查
Stash採用 Clash 風格 YAML 設定的 iOS 客戶端優先選用服務商提供的 Stash 設定,並確認支援的通訊協定與欄位
Shadowrocket使用自有節點、訂閱與規則設定機制的客戶端選擇明確標示為 Shadowrocket 的訂閱入口,不要把完整 Clash YAML 當成通用格式
訂閱網址提供節點清單或完整設定的遠端網址確認輸出格式、帳戶狀態與更新權限
Profile客戶端載入的一份設定檢查節點、策略群組、規則與 DNS 是否齊全

透過 App Store 取得客戶端

從確認 App 資訊到完成安裝

  1. 前往本站下載中心,查看 iOS 客戶端說明與對應的下載入口。進入 App Store 後,再確認 App 名稱、開發者與詳細資訊。
  2. 展開商店頁面的「相容性」,確認目前的 iOS 版本符合需求。不要只憑名稱相近或圖示相似就判斷。
  3. 查看商店標示的價格與購買條件。客戶端費用與代理服務訂閱費用分開計費,購買客戶端不會自動取得節點。
  4. 下載完成後,從主畫面開啟 App。先找到設定管理入口,再匯入訂閱;在設定檔空白時啟動連線,無法進行流量分流。

如果 App Store 顯示「此 App 目前在你所在的國家或地區尚未提供」,表示目前商店地區沒有提供該 App,並非訂閱連結失效。App 是否上架、價格與最低系統需求,請以目前的商店頁面為準。

搜尋不到時,檢查哪些設定

前往「設定」→頂端的 Apple 帳號→「媒體與購買項目」→「檢視帳號」→「國家或地區」,即可查看商店帳號的地區。這與系統「語言與地區」中的地區設定不同;只修改系統地區,不會改變 App Store 的應用程式目錄。

準備可用的訂閱連結

登入服務商的帳戶面板,選擇適用於目標客戶端的訂閱入口。使用 Stash 時,優先尋找明確標示「Stash」的設定;使用 Shadowrocket 時,選擇專用訂閱或文件明確支援的節點訂閱。不要只因網址以 https:// 開頭,就認定兩者可以互換。

訂閱網址通常含有帳戶權杖,不是一般的說明頁網址。取得連結的人可能讀取節點資訊或使用相關服務。複製時請勿將連結貼到公開聊天室,也不要把真實訂閱網址貼到不明的線上轉換網站。

匯入前的四項檢查

有些介面會依客戶端的請求標頭回傳不同內容,因此在瀏覽器中能開啟網址,只能證明該次請求有收到回應,無法單獨證明客戶端能解析。最後仍應以 App 內的下載結果與設定檢查為準。

匯入訂閱並選取設定檔

以 Stash 的設定流程為例

不同版本的入口可能標示為「設定」、「設定檔」或相對應的英文名稱。操作目標都是新增遠端設定,而不是手動新增節點。以下依照功能說明,實際名稱請以安裝的版本為準。

  1. 進入設定管理頁面,點選新增入口,選擇從 URL 下載或匯入遠端設定。
  2. 貼上訂閱網址,為設定檔取一個容易辨識的名稱,例如「個人訂閱-iPhone」。不要把完整權杖放進名稱。
  3. 執行下載或儲存,等待 App 完成解析。若出現錯誤,記下錯誤類型;請勿公開含有權杖的完整 URL。
  4. 在設定檔清單中選取剛匯入的項目,確認它是目前使用的設定,而不只是已儲存在清單中。
  5. 開啟策略群組頁面,確認預期的群組已出現,再為手動選擇的群組挑選節點或子策略群組。

如果服務商提供「在客戶端中開啟」,系統可能會透過 URL Scheme 啟動 App。成功跳轉只代表開始交接,仍須確認下載已完成且目前設定已切換。若 Safari 未能啟動 App,可返回客戶端手動透過 URL 匯入。

確認規則引用,而非只看節點數量

以下設定片段用來說明策略群組與規則的關係,並非可獨立連線的完整設定。實際節點定義必須由有效訂閱提供。

proxy-groups:
  - name: 出站選擇
    type: select
    proxies:
      - DIRECT

rules:
  - DOMAIN-SUFFIX,example.com,出站選擇
  - MATCH,DIRECT

DOMAIN-SUFFIX 會比對指定網域及其子網域,規則由上而下判斷。此處的「出站選擇」只有 DIRECT,因此不會透過代理連線。實際使用時,策略群組必須引用訂閱提供的節點或其他有效策略群組;若規則引用了不存在的名稱,載入時可能直接報錯。

更新訂閱時也可能覆蓋手動修改。若要自訂規則,請先確認客戶端是否支援本機覆寫或獨立的規則設定,再修改遠端設定內容。保留一份可還原的設定,比直接刪除原訂閱更容易復原。

允許 VPN 設定並建立連線

首次啟動連線時,iOS 通常會提示 App 要新增 VPN 設定。請確認提示中的 App 正是剛安裝的客戶端,再點選「允許」,並依系統要求使用裝置密碼或生物辨識完成授權。此步驟授予的是系統網路通道權限,不是替服務商購買訂閱。

  1. 返回客戶端,確認目前使用的 Profile 與策略群組選擇正確。
  2. 點選連線開關,並處理系統跳出的 VPN 設定授權提示。
  3. 等待 App 顯示已連線後,再開始測試網路;連線建立期間不要連續切換多個開關。
  4. 必要時前往「設定」→「一般」→「VPN 與裝置管理」→「VPN」,查看對應設定的連線狀態。

iOS 客戶端通常透過 Network Extension 提供的通道功能接管流量,不能直接照搬桌面版「開啟系統代理」的步驟。也不要照抄電腦上的 127.0.0.1:7890:在 iPhone 上,127.0.0.1 指向手機本身,而不是電腦。

首次連線的可驗證檢查順序

依照「設定已載入→通道已連線→請求命中規則→實際頁面可用」的順序測試。每次只調整一項設定,發生問題時才能判斷原因是節點、DNS 還是規則。

  1. 檢查設定:確認目前的設定名稱,查看是否有解析錯誤,並確認策略群組沒有停在不適用於目前請求的 DIRECT 或 REJECT。
  2. 檢查節點:使用客戶端內建的連線測試。測試結果只反映測試目標的連線狀況,不代表影片、下載或其他網站一定可用。
  3. 檢查實際請求:用 Safari 開啟需要存取的 HTTPS 網頁,同時查看客戶端的連線記錄,確認網域、命中的規則與最後的出站方式。
  4. 檢查直連:再造訪預期應該直連的網站,確認規則沒有誤將所有請求導向同一個出站方式。
  5. 檢查網路切換:從 Wi-Fi 切換至行動網路後重新測試。若只有其中一種網路無法使用,請分別檢查該網路的存取限制與節點是否可連線。

DNS 問題常見的情況是通道連線成功,但請求卡在網域解析階段。此時先還原服務商建議的 DNS 設定,不要同時加入陌生的加密 DNS、另一款 VPN 與自訂規則。fake-ip 是特定設定機制,不是 iOS 上必須手動開啟的通用修復選項。

常見錯誤訊息與處理方式

狀況優先檢查項目下一步
下載回應 HTTP 401 或 403權杖、帳戶權限或服務商的存取限制重新登入服務商面板取得訂閱;必要時聯絡服務商確認遭拒原因
下載回應 HTTP 404網址路徑是否完整、介面是否已更換重新複製目前的訂閱入口,不要自行猜測介面路徑
顯示 YAML 解析錯誤回傳內容是否為登入頁,以及縮排或格式是否受損取得適用於該客戶端的格式;不要將網頁內容存成設定檔
顯示不支援的通訊協定或欄位是否使用了只適用於其他核心的設定選擇 Stash 或目標客戶端專用的設定,並確認功能說明
設定匯入成功,但沒有預期的規則是否只匯入了節點清單補上客戶端支援的規則設定,或改用完整的 Profile
連線後仍無法存取目前節點、最終出站方式、DNS 與服務流量額度查看一筆失敗請求的記錄,逐項確認,不要一次修改所有設定

更新訂閱與更換裝置

節點下線或規則變更後,請在客戶端內執行更新,再確認目前使用的 Profile 仍是目標設定。即使設定了自動更新,也不代表 iOS 一定會依排程在背景執行;長時間未開啟 App 時,連線前手動更新較容易確認結果。

更換 iPhone 後,即使 App 已還原,仍應重新檢查 VPN 授權、目前的策略群組與遠端設定。如果訂閱網址已公開外洩,請前往服務商面板重設權杖,再更新所有使用舊網址的裝置。其他基本操作請參閱使用文件;規則與策略群組的關係請參閱進階設定。