iPhone Clash 用戶端入門:Clash 類用戶端與訂閱設定匯入教學

整理 iOS 相容 Clash 設定檔的用戶端取得方式,以及訂閱連結匯入、VPN 設定授權與首次連線驗證步驟。

一、安裝前確認:App、商店地區與設定檔格式

iPhone 無法安裝 Windows 的 .exe、Android 的 .apk,也不能將 Linux 的 mihomo 執行檔直接當成 iOS App 執行。請先選擇提供 iOS 版本的用戶端,再確認它實際支援的訂閱格式。名稱中含有 Proxy 或 VPN,不代表就能讀取完整的 Clash YAML。

二、App Store 帳號:使用自己的帳號取得 App

確認商店地區與系統需求

先在 App Store 搜尋正確的 App 名稱。如果顯示「你所在的國家或地區尚未提供」,請確認目前的商店地區,不要反覆更換訂閱連結。訂閱決定設定內容,Apple 帳號地區則決定商店的可見範圍,兩者是不同環節。

  1. 開啟 iPhone「設定」→點選最上方姓名→「媒體與購買項目」→「檢視帳號」→「國家或地區」,查看目前帳號的地區。選單名稱可能因 iOS 版本略有不同。
  2. 開啟 App 詳細資訊頁,查看「相容性」中的最低 iOS 版本需求、開發者名稱與收費方式。
  3. 若需要建立新帳號,請透過裝置提供的帳號建立流程,使用自己的電子郵件地址及可接收驗證碼的電話號碼註冊,並開啟雙重認證。
  4. 只有在符合 Apple 規定且能提供有效地區資料時,才變更國家或地區。請先處理帳號餘額、訂閱與家庭共享的限制。

不要購買、租用或登入陌生人提供的共用帳號。購買紀錄、後續更新與帳號復原都仰賴帳號控制權。需要切換購買帳號時,請分清「媒體與購買項目」和裝置最上方的 iCloud 帳號;不要為了安裝單一 App 而登出整台裝置的 iCloud,更不要接受他人要求管理裝置。

下載後先確認 App 身分

從商店安裝完成後,先開啟 App 並查看說明或關於頁面,確認匯入入口與支援格式。如果 App 說明只列出部分節點 URI,請勿直接上傳整份 Clash YAML。商店顯示的價格、地區供應情況與版本需求以當下頁面為準,本文不假設特定 App 永遠都能下載。

三、準備訂閱連結:保留完整參數與存取憑證

訂閱連結通常包含專屬於帳號的權杖。複製時請保留完整路徑、問號後的查詢參數,以及其中的大小寫。聊天 App 自動換行、末尾標點或複製時帶入的空格,都可能造成請求失敗。請勿將訂閱網址貼到公開的轉換網站、留言區或截圖中。

取得的內容建議先做的事常見誤解
HTTPS 訂閱連結確認是訂閱介面後,再新增為遠端設定檔把帳號登入頁誤認為訂閱網址
本機 YAML 檔案存入「檔案」App,再使用用戶端的檔案匯入功能以為匯入檔案後就會自動取得遠端更新
單一節點 URI使用新增節點或從剪貼簿匯入功能把單一節點當成包含規則與策略群組的完整設定檔
QR Code確認內容來自可信來源後再掃描把網頁登入 QR Code 誤認為設定 QR Code

遇到多種匯出選項時,優先選擇用戶端文件明確支援的格式。服務商標示為「Clash」或「Clash Meta」的兩個入口,回傳內容可能不同;不要只靠變更副檔名來轉換格式。將 JSON 檔名改成 .yaml,並不會改變檔案內部結構。

Safari 能開啟網址,只代表瀏覽器收到回應,不能證明回應內容是有效的訂閱。登入頁、錯誤頁,甚至驗證碼頁面都可能回傳 HTTP 200。若要查看回傳內容類型,請使用用戶端的匯入記錄或服務商文件;不要在公開的疑難排解資料中洩漏原始權杖。

四、匯入設定:先更新,再選擇使用中的設定檔與策略群組

遠端訂閱匯入步驟

不同用戶端可能將入口命名為「設定」、「訂閱」、「Profiles」或「遠端資源」。以下依操作目的說明,不會將特定 App 的選單視為所有 iOS 用戶端的共通介面。

  1. 前往設定檔管理頁,選擇新增遠端設定檔或從 URL 匯入。
  2. 貼上完整訂閱網址,並設定容易辨識的名稱,例如「日常設定」。如果介面提供 User-Agent 設定,請只填入服務商或用戶端文件要求的值。
  3. 執行下載或更新。等到 App 明確顯示匯入成功後,再確認節點數量與更新時間。
  4. 將新匯入的項目設為使用中的設定檔。有些 App 只會儲存設定,不會自動切換目前執行的設定檔。
  5. 前往策略群組,選擇已知可用的節點。首次驗證建議手動選擇,暫時不要依賴自動測速群組。
  6. 如果支援執行模式,請先使用規則模式;稍後再透過記錄檢查連線命中了哪一條規則。

完整的 Clash 設定檔通常會包含 proxies、proxy-groups、rules 等欄位,也可能透過 proxy-providers 引用遠端節點資源。看到 YAML 文字不代表設定檔一定包含本機節點清單;如果依賴外部 provider,也要確認相關資源能否下載。

分別檢查本機檔案與遠端資源

透過「檔案」App 匯入 config.yaml 時,請確認檔案內容是純文字,並使用空格縮排。不要從排版文件複製彎引號,也不要用定位字元作為 YAML 縮排。如果錯誤訊息附有行號,請先檢查該行與上一行的冒號、引號及縮排。

桌面檔案中的 ./rules/ 等相對路徑,不代表相關檔案已經匯入 iPhone 的 App 沙盒。只匯入主要設定檔時,規則集檔案可能會遺失。請優先使用用戶端支援的資源匯入方式;修改前先保留原始設定檔副本,不要直接覆寫唯一的遠端設定檔。

五、VPN 授權:允許新增設定,不要安裝陌生的管理描述檔

首次啟動連線時,iOS 通常會跳出「想加入 VPN 設定」的系統提示。請確認提出要求的 App 名稱,選擇允許,再依裝置指示輸入解鎖密碼或完成系統驗證。這項授權可讓 App 建立系統 VPN 設定,是啟用網路延伸功能的必要步驟。

  1. 返回用戶端,點選連線開關,等待狀態從「連線中」變為「已連線」。
  2. 開啟「設定」→「一般」→「VPN 與裝置管理」→「VPN」,確認目前的設定屬於剛安裝的用戶端。
  3. 若其他 VPN App 正在連線,請先手動中斷連線,再測試這次的設定,避免切換與自動重新連線互相干擾。

iOS 用戶端通常透過系統 Network Extension 處理通道流量,與桌面端手動啟用 TUN、修改網卡或設定預設路由的流程不同。不要為了讓 iPhone 接管流量,就照搬桌面教學中的虛擬網卡參數,或要求系統開放特定本機連接埠。

六、首次連線驗證:釐清通道、節點、規則與 DNS

狀態列顯示 VPN,代表通道已建立,不代表所有目標網站都會經過代理,也不代表選取的遠端節點可用。請依照以下順序驗證,每次只變更一項設定,並記下測試時間、網路類型、策略群組選擇與錯誤訊息。

  1. 確認基本網路連線:先中斷用戶端連線,再用 Safari 開啟平常可直接瀏覽的 HTTPS 網頁。如果本機網路也無法使用,請先處理 Wi-Fi 登入認證或行動數據權限。
  2. 確認系統時間:前往「設定」→「一般」→「日期與時間」,確認時間與時區正確。裝置時間明顯錯誤可能影響 TLS 憑證驗證。
  3. 連線後檢查規則:造訪預期會透過代理連線的目標,並在用戶端連線記錄中確認網域、命中的規則、策略群組與最後使用的節點。不要只看首頁上的連線開關。
  4. 確認出口:使用可信的出口 IP 查詢網站作為輔助。只有確認該請求確實經過代理,查詢結果才可用來判斷代理出口;若規則設定為直連,顯示本機出口是正常情況。
  5. 切換網路重新測試:分別透過 Wi-Fi 與行動網路測試一次。如果只有行動網路失敗,請檢查「設定」→「行動服務」中該 App 的數據權限,並記錄電信業者網路下出現的錯誤。

如果網域無法連線,但記錄顯示節點已成功連線,請接著檢查 DNS 查詢錯誤與規則命中情況。不要直接以 IP 位址開啟 HTTPS 網站,據此判斷 DNS 是否正常;憑證名稱、SNI 與網站虛擬主機設定都可能影響結果。

也要分清連接埠的用途。節點服務商標示遠端連接埠為 443 時,應檢查該節點的 port 欄位;桌面教學常見的本機混合連接埠 7890 並非遠端伺服器連接埠,也不是 iPhone 建立 VPN 時必須統一填寫的值。

七、匯入與連線問題:依症狀找出下一步

症狀優先檢查項目下一步操作
訂閱回應 401 或 403權杖有效期限、存取權限與要求標頭從服務商帳號重新複製連結,並依文件確認 User-Agent
訂閱回應 404路徑是否完整,以及舊介面是否已變更重新取得訂閱入口,不要自行刪改 URL 查詢參數
解析錯誤或沒有節點回傳內容是否為 HTML,以及格式與協定是否受支援查看解析記錄,確認匯出格式與 provider 下載狀態
節點測速成功,但網頁無法開啟測速網址、目標網域規則、DNS 與最後套用的策略查看實際網頁請求記錄,不要把單次延遲當成完整驗證
VPN 連線後完全無法上網使用中的設定檔、選取的節點、DNS 設定與其他 VPN 狀態先中斷連線以恢復網路,再從最精簡的可用設定逐項測試
更新後設定被還原是否直接修改了遠端設定檔內容改用 App 支援的覆寫功能,並確認更新後的套用結果

保留可重現問題所需的最少資訊

向用戶端維護者或訂閱服務商回報時,請附上 iOS 版本、用戶端版本、網路類型、錯誤時間與已遮蔽敏感資訊的記錄。分享前請隱藏訂閱權杖、節點密碼、UUID 等憑證。不要公開整份設定檔來取代問題描述。

首次驗證成功後,再依需求啟用自動更新、隨需連線或自動選擇策略。如果 App 提供隨需連線,請先確認關閉開關後不會立即自動重新連線,再測試鎖定螢幕與 Wi-Fi 切換。每新增一項功能都重新測試一次,日後才容易分辨問題是訂閱變更、系統網路變化,還是策略選擇所造成。

下載Clash