首次使用 Shadowrocket（小火箭）連線時，「加入 VPN 設定」是 Apple 系統的授權步驟，不是連線失敗提示。本文適用於 iPhone / iPad：先分辨系統 VPN 設定與 App 內的 Config，再完成授權並確認系統狀態；若曾拒絕授權或誤刪設定，可依步驟重新觸發新增流程。以下內容以使用者已有自己的服務商與訂閱為前提，授權本身不會提供連線服務。
一、為什麼首次連線需要加入 VPN 設定
Shadowrocket 需要透過系統提供的網路延伸機制建立 VPN 通道，才能依照 App 內的設定處理流量。App 首次要求將相關 VPN 設定寫入系統時，系統會請使用者確認。這個提示是要允許建立該設定，不是向服務商購買服務，也不是逐一授權 App 內的每條規則。
請在主動開啟 Shadowrocket 的連線開關後確認是否出現提示。確認 App 名稱與目前的操作相符，再選擇允許；若系統接著要求裝置驗證，請依畫面指示完成。裝置驗證屬於系統授權流程，不需要將裝置密碼提供給服務商或填入訂閱設定。
允許加入只代表完成流程中的一個步驟。後續仍可能因伺服器參數、網路環境或設定內容而連線失敗。因此，「已允許加入」與「已能瀏覽目標網站」必須分開確認，不能只因提示消失就判定連線正常。
二、系統 VPN 設定、Config 與訂閱有何不同
常說的「VPN 描述檔」在此通常是指 App 在系統設定中建立的 VPN 項目。這與透過裝置管理安裝的設定描述檔並非同一概念，也不等同於 App 內 Config 頁面的規則檔。即使它們出現在相近的系統選單中，也不表示需要另外安裝裝置管理描述檔。
| 項目 | 確認位置 | 主要用途 |
|---|---|---|
| 系統 VPN 設定 | 系統 Settings 中的 VPN 清單 | 讓系統儲存 App 的 VPN 連線設定並顯示連線狀態。 |
| App 內的 Config | Shadowrocket → Config | 儲存分流規則及相關設定，供相應的路由模式使用。 |
| 已有的訂閱 | Shadowrocket → Home | 匯入並更新使用者已有的伺服器連線項目。 |
例如，App 內的 Config 可以包含 DOMAIN-SUFFIX、IP-CIDR、GEOIP 與 FINAL 等規則關鍵字；這些規則決定請求符合條件後採用的策略，並非系統提示所要求的權限。刪除系統 VPN 設定通常不會一併刪除 Home 中已有的項目或 Config 檔案，但操作前仍應備份自己的設定資訊。
三、首次授權與系統設定確認步驟
以下以 iPhone / iPad 為例。選單名稱會因系統語言而異，入口位置也可能隨系統版本調整。中文系統通常可依序前往「設定 → 一般 → VPN 與裝置管理 → VPN」；英文介面路徑為 Settings → General → VPN & Device Management → VPN。若找不到入口，可在系統 Settings 中搜尋 VPN。
-
確認 App
請確認使用的是 App Store 上的 Shadowrocket，開發者為 Shadow Launch Technology Limited，App ID 為 932747118。系統需求、相容性與購買適用範圍請以 App Store 頁面標示為準。
-
檢查已有設定
在 Shadowrocket → Home 檢查已匯入的連線項目，並確認所需參數完整。系統權限不會自動補上伺服器位址、連接埠或驗證資訊。
-
開啟連線
開啟 Home 中的連線開關，等待系統顯示加入 VPN 設定的提示。確認提示中的 App 名稱，再選擇允許，並依系統要求完成裝置驗證。
-
查看系統狀態
前往系統 Settings → General → VPN & Device Management → VPN，找到 Shadowrocket 的項目並查看連線狀態。看到項目表示設定已儲存，但仍須另外確認目前是否正在連線。
-
確認實際連線情形
返回 App 確認連線開關狀態，再前往需要使用的目標網站。若通道已連線但無法存取，請改為檢查伺服器參數、Global Routing 與 Config，不要反覆加入系統設定。
依序排查先確認系統設定能否儲存，再確認通道能否維持連線，最後檢查個別請求如何分流。依序排查這三個層面，可避免將規則問題誤判為權限問題。
四、拒絕授權或誤刪後，如何重新加入
若首次選擇不允許，App 就無法完成這次系統 VPN 設定的新增。通常不必重新購買 App，也不需要先刪除訂閱。返回 Shadowrocket，確認目前沒有尚未結束的連線嘗試，再次開啟連線開關，讓 App 重新要求建立 VPN 設定。
若曾在系統 VPN 清單中刪除 Shadowrocket 項目，處理方式相同：先返回 App 檢查已有內容，再開啟連線開關。系統再次顯示授權提示時，完成確認；若沒有出現提示，先返回系統清單確認是否仍有對應設定，不要直接認定「沒有跳出提示」就是故障。
- 設定已存在：系統可繼續使用已儲存的設定，不會每次連線都重新詢問。確認項目名稱與實際連線狀態即可。
- 反覆要求加入：確認是否每次都在最後確認前取消，以及是否已完成裝置驗證。若設定始終未儲存，請先處理系統授權步驟。
- 準備重建設定：先關閉 App 的連線；若已啟用 On Demand，先前往
Shadowrocket → Settings → On Demand停用相關設定，再處理系統 VPN 項目。 - 裝置受到管理：學校或公司管理的裝置可能會限制 VPN 設定操作。查看系統是否顯示管理限制，並請裝置管理員確認相關政策；不要刪除用途不明的管理項目。
只有在確認該項目異常，且一般重新連線無法復原時，才考慮先中斷連線，再刪除該項目並重新建立。不要清空整份 VPN 清單，也不要刪除同一頁中供工作、學校或其他用途使用的描述檔。重新安裝 App 可能導致本機內容遺失，不應作為排查權限問題的第一步。
五、連線開關、系統狀態與 On Demand 的關係
Home 中的連線開關用來開始或停止連線；系統 VPN 頁面顯示的是系統端的通道狀態。設定項目可以長期保留，但連線仍可能處於中斷狀態，因此「清單中還有 Shadowrocket」不代表背景持續有連線。判斷是否連線應查看狀態，而不是項目是否存在。
On Demand 會依照已設定的條件向系統要求連線。若手動中斷後又看到重新連線，請先檢查 Settings → On Demand，不要立刻認定關閉操作沒有生效。若要進行純手動測試，請先停用相關的隨選設定，再中斷並重新連線，觀察行為是否改變。
| 觀察到的狀況 | 說明 | 下一步 |
|---|---|---|
| 有設定，未連線 | 系統保留了設定，但目前尚未建立通道。 | 返回 Home 手動連線，觀察狀態變化。 |
| 已連線，但存取異常 | 系統通道已建立，仍須另外確認能否存取目標。 | 檢查目前使用的項目、Global Routing、Config 與目標網路。 |
| 中斷後再次連線 | 可能是 On Demand 條件再次觸發連線。 | 停用相關的隨選設定後，再進行一次手動測試。 |
| 連線後立即中斷 | 設定、網路或伺服器可能導致連線無法維持。 | 記錄失敗發生的階段，並確認已有的伺服器參數與網路連線狀況。 |
Global Routing 與系統授權也是不同層面。Proxy、Direct、Config、Scene 是 App 內的路由選項，不是四種系統 VPN 權限。尤其選擇 Direct，不能視為「VPN 已中斷」的證據；若要停止通道，請操作連線開關並確認系統狀態。
六、依提示文字分辨授權與連線問題
排查時請保留畫面上的完整文字及提示出現的階段。以下英文文字會顯示於英文系統中，系統語言不同時則會顯示相應譯文。這些文字本身不一定代表錯誤：前者是授權請求，後者是連線狀態。若只記下文字而忽略出現時機，容易得出相反的結論。
系統提示：「Shadowrocket」Would Like to Add VPN Configurations
原因與處理方式：App 正在要求儲存系統 VPN 設定——若提示是在自行開啟連線開關後立即出現，請確認 App 名稱後選擇允許，並完成系統要求的裝置驗證；尚未確認前，不要將其視為伺服器連線錯誤。
系統狀態：Not Connected
原因與處理方式：表示目前 VPN 尚未建立連線——返回 Home 開啟連線開關，觀察連線能否維持；若狀態立即恢復，請檢查 App 顯示的具體錯誤及已有的伺服器參數，而不是一再重做系統授權。
若系統 VPN 設定已存在，但 App 仍持續要求建立設定，請先完整結束這次連線嘗試，再確認系統項目確實屬於目前使用的 App。若需進一步排查，請記錄「點擊開關、出現提示、完成確認、中斷連線」的先後順序，以及當時使用 Wi-Fi 或行動網路。分享截圖前，請遮蔽訂閱網址、驗證資訊與伺服器敏感欄位。
七、首次連線常見問題
允許加入後，所有請求都會經過 Proxy 嗎？
不會。允許加入解決的是系統設定權限問題，個別請求如何處理仍取決於 Global Routing 與目前使用的設定。若要依規則分流，請確認 Global Routing 中的 Config 及實際啟用的規則檔；不要只根據 VPN 圖示判斷每個請求的出口方式。
刪除 VPN 設定會連訂閱一起刪除嗎？
刪除系統 VPN 項目與刪除 Home 中的訂閱是不同操作，通常不會一併清除 App 內的訂閱。請先返回 Home 和 Config 確認內容是否仍在，再重新開啟連線以觸發系統設定建立；不要為了恢復權限而先刪除已有的訂閱。
為什麼第二次連線時沒有再次詢問權限？
系統已儲存對應設定時，後續連線通常會直接使用該設定。前往系統 VPN 清單確認項目與狀態即可；沒有再次顯示提示，不代表未使用系統 VPN 機制，也不需要為了看到提示而刪除正常設定。
關閉連線後，還需要刪除設定嗎？
日常停止使用時，只要中斷連線即可；若不希望條件觸發重新連線，再前往 Settings → On Demand 檢查隨選設定。系統保留設定可供下次連線使用，不必每次使用後都刪除。若確實需要移除，請先中斷連線，再只刪除確認屬於 Shadowrocket 的項目。
購買 App 後，為什麼還是無法連線？
買斷 App ≠ 連線服務方案。Shadowrocket 是閉源商業 App，採一次性買斷；使用者仍須設定自己已有的伺服器資訊。完成授權後，請依序檢查 Home 項目、網路環境與 Global Routing；伺服器是否有效，請向自己的服務商確認。