Shadowrocket（小火箭）首次啟動連線時，需要取得系統授權才能建立 VPN 設定。本文適用於 iPhone 與 iPad：先說明系統 VPN 設定和 App 內 Config 檔案的差異，再介紹允許、拒絕或誤刪後的處理方式，最後從「設定是否存在、通道是否連線、目標是否可存取」三個層面逐步排查。
「加入 VPN 設定」提示代表什麼？
Shadowrocket 使用系統提供的 VPN 功能處理連線。首次在 Home 開啟連線開關時，系統可能會詢問是否允許 App 加入 VPN 設定。這個步驟會在裝置上登錄由 App 管理的 VPN 連線項目，並非購買確認，也不是訂閱更新提示。
授權前請先閱讀系統提示中與流量相關的說明。允許後，App 才具備建立相應 VPN 連線所需的設定條件。連線使用 Proxy、Direct 或設定規則，仍由 Shadowrocket 的執行設定決定；點選允許不會自動填入使用者既有服務商提供的伺服器位址、連接埠或驗證資料。
提示原文：“Shadowrocket” Would Like to Add VPN Configurations
原因：使用英文系統時，可能會出現這類要求加入 VPN 設定的授權提示。這是系統權限確認，本身不代表連線發生故障。
處理方式：確認提示中的 App 名稱是 Shadowrocket，再選擇 Allow；若暫時不打算授權，請選擇 Don’t Allow，稍後返回 App 重新發起連線。中文系統會顯示對應的本地化文字。
只有在剛由自己發起連線，且能確認 App 來源時，才進行授權。Shadowrocket 是閉源商業 App，唯一取得管道為 App Store，開發者為 Shadow Launch Technology Limited。購買方式為一次買斷，價格與系統需求請以 App Store 頁面標示為準。買斷用戶端 ≠ 線路方案。
首次允許：從 Home 到系統確認
以下操作以使用者已有自己的服務商與連線資料為前提。先在 Home 確認資料已儲存，再啟動連線，便能分別處理「尚未授權」和「連線資料有誤」的問題。若尚未匯入資料，請先參閱快速入門教學。
-
確認已有資料
開啟 Shadowrocket → Home，檢查準備使用的伺服器項目。確認位址、連接埠、協定與驗證資訊來自自己已有的服務商，勿憑猜測填寫。
-
啟動連線
在 Home 選擇要使用的項目，再開啟頂端的連線開關。首次建立系統設定時，系統會顯示加入 VPN 設定的授權提示。
-
確認系統授權
確認 App 名稱後選擇 Allow。若系統接著要求輸入裝置密碼或進行身分驗證，請依照系統目前提供的方式完成；不要將裝置密碼填入伺服器驗證欄位。
-
確認連線狀態
返回 Home 查看連線狀態，再前往系統 Settings → General → VPN & Device Management → VPN，確認對應項目。系統語言與版本不同，顯示的選單名稱可能略有差異。
授權成功不代表所有目標都能存取。系統設定已新增、通道已啟動、目標請求成功，是三種不同的檢查結果。若系統顯示已連線，但某個網站仍無法開啟，請改為檢查連線資料、DNS 與規則，而非反覆刪除系統設定。
系統新增了什麼：VPN 項目與 Config 檔案的差異
完成授權後，系統 VPN 清單通常會出現由 Shadowrocket 建立的項目，供系統辨識並管理這項 VPN 連線。日常所說的「VPN 描述檔」在此主要是指這項系統連線設定，請勿與裝置管理描述檔、憑證或 App 內的規則檔案混淆。
判斷方式：先找出故障所在層面
若系統清單中沒有對應項目，請先重新完成加入設定的授權；若項目存在但無法連線，再檢查 Home 中的連線資料。不要以重新授權取代伺服器參數檢查。
| 項目 | 查看位置 | 主要用途 |
|---|---|---|
| 系統 VPN 設定 | 系統 Settings → General → VPN & Device Management → VPN | 登錄 VPN 連線及其與 App 的關聯，並顯示系統連線狀態。 |
| App 內的設定檔 | Shadowrocket → Config | 儲存分流規則等設定內容，例如 DOMAIN-SUFFIX、IP-CIDR、GEOIP、FINAL 規則。 |
| 連線資料 | Shadowrocket → Home | 儲存使用者已有的伺服器項目與相關驗證參數。 |
| 依需求連線設定 | Shadowrocket → Settings → On Demand | 依條件觸發連線；排查自動重新連線時需另外檢查。 |
Global Routing 中的 Proxy、Direct、Config、Scene 也不是四份系統授權，而是 App 內的路由選項。變更這些選項不等於重新加入系統 VPN 設定；排查權限問題時，請先記下目前選項，避免同時變更多處而失去判斷依據。
誤選拒絕後：重新發起授權
選擇 Don’t Allow 後，App 無法透過這次請求完成系統 VPN 設定的新增。Home 中既有的項目通常仍會保留；拒絕系統授權本身不會刪除伺服器資料，也不需要因此重新購買用戶端。
-
返回 Home
結束尚未完成的連線嘗試，確認 Home 中仍保留要使用的項目，再次開啟連線開關，讓 App 重新要求所需的系統設定。
-
查看系統清單
若沒有再次跳出提示，請開啟系統 Settings → General → VPN & Device Management → VPN。已有設定時，首次授權視窗不再出現可能是正常情況。
-
檢查裝置限制
如果清單無法修改，或系統明確指出操作受到限制，請確認裝置是否由組織管理。受管理的裝置應由管理員確認 VPN 權限，請勿刪除組織派發的設定。
-
重試並記錄
離開目前的系統設定頁面，再開啟 Shadowrocket 發起連線。若仍失敗，請記錄系統提示原文、是否已有 VPN 項目，以及 Home 中的連線狀態。
不要在系統中手動建立同名的一般 VPN 項目，取代由 App 建立的設定。名稱相同不代表連線類型和 App 關聯也相同。也不要為了取得授權而安裝額外憑證；加入 VPN 設定與信任憑證是兩項獨立操作。
誤刪 VPN 設定後：保留資料並重新建立
如果只從系統 VPN 清單刪除了 Shadowrocket 對應項目，通常移除的是系統連線設定，而不是 Home 中的伺服器項目或 Config 中的規則檔案。請先開啟 App 確認資料是否仍在，再次啟動連線，讓 App 重新建立所需的系統設定。
- 先處理自動連線：準備主動移除設定前，請前往 Shadowrocket → Settings → On Demand 暫停依需求連線，並中斷目前連線，避免排查期間反覆自動啟動。
- 只操作對應項目：前往系統 VPN 清單，點選對應項目的資訊按鈕查看詳細資料。確認該項目確實屬於 Shadowrocket 後再移除，請勿一次清除其他設定。
- 返回 App 重新建立：在 Home 再次啟動連線。若系統再次要求加入 VPN 設定，請確認 App 名稱並完成授權。
- 檢查兩個位置：確認系統 VPN 項目已重新出現，並檢查 Home 與 Config 中原有的內容。重新建立系統設定不會替使用者還原已遺失的服務商資料。
若先前也刪除了 App，或同時移除了 App 內的資料，情況就不只是「誤刪系統 VPN 設定」。此時應使用自行保存的資料或原有備份重新設定。不要把重新安裝當作第一步，以免擴大需要還原的範圍。
已允許仍無法連線：依照現象繼續排查
加入授權只處理系統能否儲存並使用這項 VPN 設定。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定各有不同的參數要求；允許系統設定不會驗證參數是否正確，也不會檢查服務商帳戶是否可用。
| 觀察到的現象 | 優先檢查 | 下一步 |
|---|---|---|
| 點選連線後仍停留在授權畫面 | 是否選擇 Allow，以及是否完成系統要求的身分驗證 | 返回系統 VPN 清單確認項目是否已建立，並保留提示原文。 |
| 系統項目存在，但連線立即中斷 | 所選項目、伺服器位址、連接埠、驗證參數及目前的網路 | 依照自己已有的服務商資料逐項檢查，每次只修改一項。 |
| 顯示已連線，但只有部分目標失敗 | Global Routing 目前的選項、Config 規則與 DNS 設定 | 記錄連線失敗的目標與套用的策略，不要先刪除運作正常的系統設定。 |
| 手動中斷後又重新連線 | Settings → On Demand，以及系統中其他 VPN 的自動連線設定 | 暫停相關的自動連線條件，再重現一次，以區分手動操作與規則觸發。 |
回報問題時，請提供操作步驟、提示原文、系統 VPN 項目是否存在，以及是否只在特定網路下失敗。截圖或記錄應遮蔽訂閱連結、密碼、私密金鑰與驗證權杖。其他連線排查方式請參閱常見問題中的故障排除說明。
如何判斷已完成復原只有在系統 VPN 項目存在、Home 能建立預期連線，且測試目標依目前路由設定正常存取時，才表示整條連線流程已復原。僅看到授權視窗消失，還不足以確認連線已恢復。