Shadowrocket（小火箭）要求加入 VPN 設定，是讓 Apple 系統儲存並管理 App 使用的 VPN 連線項目，不代表已匯入服務供應商設定，也不表示連線成功。本文適合首次授權、誤按拒絕，或刪除系統項目後無法連線的使用者；依序確認 App 來源、完成授權、檢查系統項目並測試實際連線，即可逐步找出問題。
加入 VPN 設定：授權系統連線功能
在 iPhone 或 iPad 上，Shadowrocket 首次啟動連線時，需要請求系統儲存 VPN 設定。系統提示會指出提出要求的 App，並說明 VPN 對網路流量的影響。只有在確認這是剛才於 Shadowrocket 中主動觸發的操作後，才繼續授權；若提示出現的時機與操作不符，請先取消並確認 App。
此處的「允許」是允許建立系統 VPN 項目，不是購買服務，也不會代替使用者填入伺服器位址或帳號資訊。後續能否連線，仍取決於 App 中已有的連線參數、目前網路及所選設定。本文假設使用者已有自己的服務供應商與訂閱；本站不提供、販售或推薦節點或訂閱。
這些階段不能互相取代：看到授權提示，只代表 App 正在申請權限；看到系統項目，只代表設定已儲存；看到連線狀態變更，才進入檢查通道是否運作的階段。即使系統顯示已連線，仍需確認目標網站或 App 是否能正常存取。
VPN 項目、描述檔與 Config 並非同一種設定
搜尋「Shadowrocket VPN 描述檔」時，容易把系統 VPN 項目、裝置管理描述檔與 App 內的 Config 混為一談。三者都可能被稱為「設定」，但儲存位置、用途及刪除後的影響各不相同。一般首次連線流程由 Shadowrocket 發起系統授權，不必先到系統設定手動新增通用 VPN 類型。
| 項目 | 查看位置 | 主要用途 | 無法據此判斷 |
|---|---|---|---|
| 系統 VPN 項目 | 系統 Settings → General → VPN & Device Management → VPN | 記錄 App 建立的 VPN 連線設定與連線狀態 | 服務供應商參數是否正確、遠端服務是否可用 |
| 裝置管理描述檔 | 系統 Settings → General → VPN & Device Management 中的描述檔區域 | 套用由組織等單位下發的裝置設定或管理政策 | 是否已完成 Shadowrocket App 內設定 |
| App 內的 Config | Shadowrocket → Config | 儲存並選取規則等 App 設定內容 | 系統是否已授予 VPN 設定權限 |
| 現有訂閱與連線項目 | Shadowrocket → Home | 管理使用者自行匯入的連線資料 | 系統通道是否已啟動 |
系統語言和版本可能影響選單名稱；上表以英文選單名稱作為參照。系統需求請以 App Store 頁面標示為準。若某個區域沒有顯示獨立描述檔，不代表 VPN 權限失效；請前往 VPN 清單確認實際連線項目。
判斷方式：先確認缺少哪一層
若 Home 中仍有連線資料，Config 也仍可選取，但系統 VPN 清單中沒有對應項目，請優先重新觸發系統授權，不要先清除訂閱或覆蓋現有規則。
首次允許：從 Home 發起，再到系統設定確認
開始前，請確認已從 App Store 取得 Shadowrocket，並確認開發者為 Shadow Launch Technology Limited。Shadowrocket 主要適用於 iPhone、iPad；其他 Apple 裝置的相容性、系統需求與購買適用範圍，請以 App Store 頁面標示為準。以下步驟適用於 iPhone、iPad，不必在其他裝置的設定介面尋找同名按鈕。
-
確認連線資料
開啟 Shadowrocket → Home，確認使用者自己的連線項目已儲存並選取。若使用 Config，請先確認目前選取的是預期設定；授權操作不能取代匯入連線資料。
-
啟動連線
在 Home 開啟頂部的連線開關。若系統尚未儲存所需的 VPN 設定，便會出現加入 VPN 設定的授權提示；若已有有效項目，通常不必每次都重新提示。
-
確認授權
確認提示中的 App 名稱後，選擇 Allow；若系統接著要求驗證裝置解鎖，請依提示完成。驗證方式以裝置當下顯示的要求為準。
-
查看 VPN 項目
前往系統 Settings → General → VPN & Device Management → VPN，確認 Shadowrocket 對應的項目與狀態。不要只根據狀態列圖示判斷是否成功。
-
測試連線
返回 Shadowrocket，確認 Home 中的連線狀態，再前往需要使用的網站。若系統顯示已連線，但存取仍有問題，請檢查連線資料、DNS 與規則，不要反覆刪除系統項目。
授權成功後仍顯示未連線，不一定代表權限未儲存。App 可能尚未完成啟動、目前連線資料不可用，或連線受到其他網路設定影響。請先確認系統項目是否存在，再判斷問題屬於「儲存失敗」或「連線失敗」。
誤按拒絕或誤刪項目：重新發起授權
首次拒絕加入 VPN 設定後，系統不會因為已購買 App 就自動補上權限。通常可返回 Shadowrocket，再次主動開啟連線，讓 App 重新要求儲存設定。若操作後沒有出現提示，請先確認開關已回到關閉狀態，再重新嘗試，避免連續點按而難以判斷目前狀態。
-
保留 App 資料
先在 Home 與 Config 檢查現有資料是否仍在。不要把刪除系統 VPN 項目當成清除 App 資料，也不要為了恢復權限而先解除安裝 App。
-
暫停自動連線
若先前已啟用自動連線，請前往 Shadowrocket → Settings → On Demand 檢查並暫時關閉相關設定，再停止目前的連線，避免疑難排解期間再次自動啟動。
-
重新啟動連線
返回 Home，再次開啟連線開關；出現加入 VPN 設定提示後，完成 Allow 與系統驗證。若系統項目已刪除，此步驟可讓 App 重新建立所需項目。
-
檢查系統限制
若仍無法儲存，請查看系統 VPN 清單與裝置管理資訊。受組織管理的裝置可能會限制 VPN 設定，請交由裝置管理員確認政策，不要自行移除組織描述檔。
刪除系統項目不等於刪除 Home 中的訂閱或 Config 檔案；反之，重新建立系統項目也不會自動修復失效的訂閱。這兩類問題應分別處理。只有在確認連線已停止且現有資料已妥善保存後，才考慮進一步處理明確損壞的項目。
允許後仍無法連線：分別檢查權限、狀態與存取
先記下問題發生在哪個步驟：沒有提示、提示遭取消、項目已儲存但啟動失敗，或系統已連線但網頁無法開啟。記錄完整提示與觸發操作，比只描述「VPN 不能用」更容易找出問題。不要把所有啟動錯誤都歸因於服務供應商，也不要把所有存取問題都歸因於系統授權。
錯誤：permission denied
原因與處理方式：若啟動或儲存設定時的錯誤詳情包含這段原文，表示相關操作遭到拒絕，但不能只憑這幾個字判斷拒絕來源。請先返回 Home 主動重新嘗試授權，再檢查系統裝置管理限制，並保留完整錯誤內容。
錯誤：Authentication failed
原因與處理方式：若連線記錄包含這段原文，請檢查對應的驗證步驟與連線項目；這不等於「未允許加入 VPN 設定」。請先確認系統項目存在，再檢查使用者現有連線中的驗證資料，不要以重複進行系統授權取代參數檢查。
以上內容僅用於辨識錯誤詳情中實際出現的原文，不代表每次失敗都會顯示相同提示。顯示內容會依失敗步驟而異，請以當下的系統提示或 App 記錄為準。系統清單中的 Not Connected 是狀態，不是指出特定原因的錯誤代碼。
- 系統中沒有對應項目：返回 Home 發起連線，確認是否出現系統授權提示；若無法建立，請檢查裝置限制。
- 項目存在但持續啟動失敗：停止反覆切換開關，記下完整錯誤內容，並確認目前選取的項目與網路符合既有連線需求。
- 已連線但無法存取目標：查看 Home → Global Routing 的目前選項，再確認 Config 中的規則與 DNS 設定。
- 手動關閉後又重新連線：檢查 Settings → On Demand，並確認系統對應 VPN 項目的 Connect On Demand 設定；不要靠反覆刪除項目來排查。
Global Routing 中選擇 Direct 與 Config 時，流量處理方式不同。使用 Config 時，規則也可能將不同目標交由不同策略處理；例如 FINAL,DIRECT 表示先前規則都未符合時使用 DIRECT。此規則不會建立系統 VPN 權限，也不能證明所有存取都經由相同出口。疑難排解時請記錄目前設定，不要同時變更授權、規則與連線資料。
常見問題：密碼、自動連線與解除安裝的影響
為什麼允許時還要輸入裝置密碼？
這是系統確認設定變更的流程。請只在系統授權畫面依提示驗證，不要將裝置密碼填入 Home 的連線密碼或訂閱網址欄位。連線資料中的密碼與裝置解鎖密碼用途不同。
允許後，所有存取都會經過 Proxy 嗎？
不能只根據「是否允許」判斷。請先查看 Home → Global Routing；使用 Config 時，再檢查目前設定的規則與實際套用的策略。系統 VPN 狀態描述的是通道狀態，不代表每個要求都使用 PROXY。
為什麼關閉後，過一會兒又重新連線？
先檢查 Shadowrocket → Settings → On Demand，再查看系統 VPN 項目中的 Connect On Demand。自動連線條件與手動開關屬於不同層級的設定；疑難排解期間可暫時關閉自動觸發，再測試手動啟動與停止。
重新安裝 App 能直接還原所有設定嗎？
不要優先以重新安裝作為復原方式。重新安裝可能影響 App 中儲存的資料，系統授權也可能需要重新完成。請先確認自己的設定備份、訂閱來源與驗證資訊可用，再決定是否需要重新安裝；還原購買項目本身不等於還原連線資料。
公司裝置不允許新增設定，應該刪除管理描述檔嗎？
請勿自行移除。先前往系統 Settings → General → VPN & Device Management 確認裝置管理狀況，並將失敗時的提示、操作路徑與時間提供給管理員，請管理員確認 VPN 使用政策。
處理完成後，建議進行一次可重複驗證：關閉連線並確認系統狀態變化；從 Home 再次啟動，確認不需重複授權且狀態正常變更；最後測試實際存取。若只有特定網站失敗，請保留當時的 Global Routing、所選 Config 與錯誤記錄，繼續檢查存取連線，而不是重新進行首次授權。