Shadowrocket 加入 VPN 設定提示如何處理：描述檔與系統 VPN 設定的關係

1. 加入 VPN 設定代表授予什麼權限

Shadowrocket 會使用系統提供的網路延伸機制處理符合設定的流量。首次啟動連線，且裝置尚未建立對應設定時，必須先取得加入 VPN 設定的許可。這是系統提示，不是訂閱頁面；允許後，系統會儲存供此 App 啟動網路通道使用的設定項目。

允許加入設定不代表伺服器已可使用，也不代表已匯入訂閱。伺服器位址、連接埠、通訊協定與驗證資訊，仍須來自使用者原有的服務商與訂閱。允許後能否連上目標網站，也取決於所選伺服器、Global Routing、Config 規則與 DNS 等設定。

2. 首次連線時的授權步驟

以下步驟假設已加入自己的伺服器或訂閱。如果 Home 中沒有可選伺服器，請先完成匯入；手動新增通常從 Home → Add Server 開始，通訊協定與連接埠應依照現有服務資訊填寫，不要為了處理授權提示而任意更改。

1. 確認 App

   開啟 Shadowrocket，進入 Home，確認使用的是預期的 App 與既有伺服器項目；不要透過陌生網頁發起所謂的 VPN 授權。

2. 選擇伺服器

   在 Home 選擇要使用的伺服器。若使用規則分流，請檢查 Global Routing → Config，並確認 Config 頁面已選取所需的設定檔。

3. 開啟連線

   開啟 Home 的連線開關。系統顯示加入 VPN 設定的提示時，確認提示中的 App 名稱是 Shadowrocket，再選擇允許。

4. 完成驗證

   依照系統畫面完成裝置身分驗證。若需要輸入密碼，請使用裝置解鎖密碼；此處不是輸入訂閱密碼、伺服器密碼或 App Store 帳號密碼。

5. 確認狀態

   回到 Home 查看連線狀態，再開啟自己要存取的網站進行測試。若開關很快就關閉，請先確認系統設定是否已建立，再排查連線參數。

驗證期間切換 App、取消輸入密碼或鎖定裝置，都可能導致此次授權未完成。不要只憑「按過允許」判斷成功；應確認系統 VPN 頁面出現對應項目，且 App 後續可以嘗試連線。狀態列是否顯示 VPN 圖示會受裝置版面配置影響，不能作為唯一判斷依據。

3. 系統 VPN、描述檔與 Config 的差異

中文系統的多個管理入口位置相近，容易讓人把「加入 VPN 設定」誤認為「安裝描述檔」。兩者並不相同。Shadowrocket 正常連線授權不需要另外從網頁下載裝置管理描述檔。

上表中的系統路徑，對應中文設定中的「設定 → 一般 → VPN 與裝置管理 → VPN」。不同系統版本的入口名稱可能略有差異，也可以在系統設定中搜尋 VPN。若裝置沒有描述檔，頁面可能只顯示 VPN 等可用項目，不必為了補齊頁面內容而另外安裝檔案。

例如，Config 檔案中的 DOMAIN-SUFFIX,example.com,DIRECT 會決定符合網域時採用的策略；FINAL,DIRECT 則會為未符合前述規則的連線指定策略。這些規則屬於流量處理設定，不會授予系統權限，也不會讓首次連線時的授權提示消失。

4. 誤按拒絕後如何重新授權

拒絕或取消此次加入設定，通常只代表這次沒有建立可用的 VPN 設定，並不表示訂閱失效。此時先重新觸發連線即可，不必先刪除訂閱、重置網路設定或重新安裝 App。

1. 回到 Shadowrocket → Home，確認連線開關已關閉，再重新開啟一次，查看系統是否再次顯示加入設定的提示。
2. 若提示再次出現，請選擇允許並完成系統驗證；若沒有提示，先前往系統 Settings → General → VPN & Device Management → VPN，確認是否已有對應設定。
3. 若設定已存在，請返回 App 嘗試連線。系統已有可用設定時，不再顯示首次加入提示是正常情況。
4. 若設定不存在，而且一直沒有提示，可以完全關閉 App 後重新開啟再試；仍無改善時，請重新啟動裝置，並確認裝置是否受組織管理。

若系統明確提示操作受到限制，或受管理的裝置不允許變更 VPN，請勿反覆刪除 App 試圖繞過限制。請查看系統 Settings → General → VPN & Device Management 中的管理狀態，並聯絡裝置管理員確認允許的設定方式。設定中的按鈕無法使用，本身不能證明是訂閱或通訊協定錯誤。

5. 查看、刪除與重新建立 VPN 設定

只有確認需要重建系統設定時才刪除。刪除前，請先保存自己的訂閱連結、必要的伺服器參數與 Config 檔案；不要把刪除系統 VPN 設定當成清除 App 所有資料的方法，也不要將它視為備份方式。

1. 先開啟 Shadowrocket → Settings → On Demand，確認是否啟用了自動連線條件。若要完全停止連線，請先停用相關條件，再回到 Home 關閉連線開關。
2. 前往系統 Settings → General → VPN & Device Management → VPN，找到 Shadowrocket 對應的項目，確認不是其他 App 或組織管理的設定。
3. 點選項目旁的詳細資訊按鈕，找到 Delete VPN；中文系統通常會顯示「刪除 VPN」。依系統提示確認刪除，請勿誤刪同一頁的裝置管理描述檔。
4. 回到 Shadowrocket → Home，再次開啟連線開關，重新允許加入 VPN 設定並完成驗證，接著確認連線狀態。

刪除系統 VPN 項目，刪除的是系統連線設定；這不等於在 Home 刪除伺服器，也不等於在 Config 刪除 .conf 檔案。重新建立後，應分別確認伺服器選擇、Global Routing 與目前的 Config，不能只看授權提示是否消失。

6. 已允許但連線異常時的排查方向

若系統 VPN 頁面已有設定，而且 Home 可以啟動連線，排查重點應轉向連線本身。取得授權、建立通道與存取目標網站是不同階段；重複授權無法修正錯誤的連接埠、驗證失敗、DNS 解析問題或規則比對問題。

• 開關立即關閉：先確認是否完成系統驗證，再核對所選伺服器的位址、連接埠、通訊協定與驗證參數。連接埠應與現有服務資訊一致，不要一律改成 443。
• 顯示已連線但網頁無法開啟：檢查 Global Routing 目前使用的是 Proxy、Direct、Config 還是 Scene。Config 會依規則處理，Direct 則採用直接連線；不能以此證明伺服器可用。
• 只有部分網站連線失敗：查看相關網域的規則比對與 DNS 設定。檢查規則順序與 FINAL 的預設處理策略，比刪除系統 VPN 設定更能對症排查。
• 訂閱更新失敗：確認使用者原有訂閱連結是否有效，以及目前網路是否正常。系統 VPN 授權不會延長訂閱期限，也不會自動修正連結內容。

聯絡支援人員時，請說明裝置類型、系統設定中是否有 VPN 項目、問題發生在允許之前或之後，以及 Home 開關的狀態變化。可以記下提示原文，但請勿公開完整訂閱連結、驗證密碼或含有權杖的頁面截圖。

7. 授權與系統設定常見問題