Shadowrocket VPN 配置提示：如何處理系統 VPN 描述檔與連線開關

一、加入 VPN 配置提示代表什麼

Shadowrocket 需要使用系統提供的 VPN 功能才能啟動連線。首次提出連線要求時，iOS 或 iPadOS 會請使用者確認是否允許 App 加入 VPN 配置。這項授權是讓系統儲存並使用該 App 的 VPN 連線配置，不代表已購買連線服務，也不代表 App 已成功連上遠端。

中文系統通常會顯示加入 VPN 配置的請求；英文系統則可能顯示以下提示。這是權限確認，不是連線錯誤。請先確認請求是由目前操作的 Shadowrocket 發出，再決定是否允許；不要在來源不明的彈出視窗中輸入裝置密碼。

系統之後可能會要求輸入裝置解鎖密碼或進行身分驗證，實際畫面請以裝置顯示為準。這裡不是要求輸入連線配置的密碼，也不是要求輸入 App Store 購買憑證。驗證完成後，仍須返回 App 檢查實際連線狀態。

二、系統 VPN 配置、Config 與連線開關的差異

使用者常把系統設定中的 VPN 項目稱為「VPN 描述檔」。排查時較精確的名稱是系統 VPN 配置：它負責將 App 的連線要求交由系統處理。它不是 Shadowrocket 的完整備份，也不能取代 App 內的連線參數或規則檔案。

Home 的開關用來啟動或停止連線，不是永久授權開關。Config 中的檔案用來控制 App 內的相關行為，例如在 Global Routing 選用 Config 時依規則處理要求。系統 VPN 配置則屬於系統層。刪除其中一項，不代表另外兩項也會一併消失。

三、首次允許後的檢查步驟

建議從 Shadowrocket 的 Home 啟動首次連線，不要先在系統設定中反覆切換 VPN。這樣能將目前選取的連線項目、App 回報與系統狀態互相比對。系統選單名稱可能因語言與系統版本而異，以下路徑僅供查找，請以裝置實際顯示為準。

1. 開啟 Home，確認已有連線項目且已選取。若清單是空的，請先依據已有配置資料完成匯入或輸入；系統授權本身不會填入連線項目。
2. 開啟連線開關，等待系統要求加入 VPN 配置。確認 App 名稱後選擇「允許」，依提示完成身分驗證，過程中不要連續點擊開關。
3. 返回 Home，查看連線狀態是否維持。若開關立即回到關閉，先記下同時出現的提示，再前往系統設定確認 VPN 項目是否已儲存。
4. 開啟裝置的「設定」→「一般」→「VPN 與裝置管理」→「VPN」，尋找 Shadowrocket 對應項目；部分系統也可能提供更直接的 VPN 入口。
5. 確認連線維持後，再測試平常可存取的網頁。請分別記錄「系統顯示已連線」與「目標網頁可開啟」這兩項結果。

僅憑狀態列是否顯示 VPN 標示，無法做出完整判斷：標示位置可能因裝置與顯示情境而異。請一併確認 Home 的狀態與系統 VPN 頁面。系統顯示連線成功，也不代表所有目標都會透過相同路徑存取。

四、拒絕授權或誤刪 VPN 配置後如何重建

不小心按下「不允許」不代表必須重新購買或重新安裝。先返回 Home，再次開啟連線開關，確認系統是否重新要求授權。若沒有彈出視窗，不要假設 App 已取得權限，應先查看系統 VPN 清單中是否已有項目。

1. 先關閉 Home 的連線開關。如果連線會自動恢復，請前往 Shadowrocket 的 Settings → On Demand 檢查並暫時關閉隨選連線，再返回 Home 停止連線。
2. 檢查 Home 中現有的連線項目，以及 Config 中的檔案是否仍在。只刪除系統 VPN 項目，通常不會一併刪除 App 內的資料，但仍應以實際清單為準。
3. 返回 Home 啟動連線，讓 App 再次要求建立系統 VPN 配置。出現授權請求後完成確認，再檢查系統清單中是否已恢復對應項目。
4. 若仍無反應，請正常結束並重新開啟 App 後再試；同時記錄系統 VPN 頁面狀態及 App 顯示的提示。不要把刪除 App 當作第一步，以免遺失未備份的本機設定。

只有在確認項目異常、知道如何復原且已有妥善保存配置時，才考慮移除系統中的 Shadowrocket VPN 項目後重建。操作前請核對名稱，避免誤刪其他用途的 VPN 配置。刪除系統項目不是更換規則檔案的方法，也無法修正錯誤的伺服器位址或連接埠。

五、依照現象排查連線開關無反應

「無反應」可能是沒有出現權限視窗、開關立即關閉、一直停留在連線中，或顯示連線成功但網頁無法開啟。這些現象分別對應不同環節。每次只變更一項條件，並保留原本的選擇與提示，才能判斷是哪個步驟影響結果。

如果只有在某個 Wi-Fi 網路下失敗，可在網路條件允許時改用另一個網路測試，並記錄兩次結果是否相同。切換網路時不要同時修改協定、DNS 與規則，否則無法判斷問題源自網路環境還是配置變更。向支援人員說明時，請以「開關回到關閉」或「已連線但無法存取」描述現象，避免只說「不能用」。

六、已連線但無法存取時，不要重複處理授權

系統 VPN 項目存在且連線狀態能維持時，通常表示已完成加入配置的步驟。接下來請檢查 Home 中選取的項目與 Global Routing。Proxy、Direct、Config、Scene 屬於路由選擇，不是四種系統授權；切換這些選項無法取代「允許加入 VPN 配置」。Scene 還須配合現有場景設定判斷，不適合在條件不明時當作通用修復方式。

• 檢查連線參數：依照使用者已有的資料，逐項確認伺服器位址、連接埠與驗證資訊。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的參數不能互相套用；不要為了排查授權問題而任意更換協定。
• 檢查路由選擇：Direct 用於直接連線，Proxy 用於代理路由，Config 則依所選配置處理。如果結果與預期不同，先記下目前模式，再檢查對應設定。
• 檢查規則檔案：Config 中的 DOMAIN-SUFFIX 用來比對網域後綴；GEOIP 與 IP-CIDR 涉及目標位址判斷；FINAL 則在前面的規則都未符合時進行最後處理。規則錯誤與系統授權是不同問題。
• 檢查 DNS：延遲測試有結果，只表示在該測試條件下收到回應，無法保證網頁的網域解析、目標連線與後續傳輸都正常。請保留失敗的網域名稱與測試時的網路條件，再檢查 DNS 設定。
• 謹慎更新訂閱：先確認問題確實與現有配置失效有關，再更新使用者自己的訂閱。更新訂閱不會重建系統 VPN 授權，也不應成為每次開關異常時的固定處理步驟。

提供排查資訊時，可記錄裝置類型、系統版本、是否出現授權請求、系統項目是否存在、Home 的狀態、目前選取的 Global Routing 模式，以及切換網路前後的差異。請勿公開完整訂閱網址、驗證密碼或私鑰；分享截圖前應先遮蔽敏感欄位。系統需求與相容性請以 App Store 頁面標示為準。