Shadowrocket
新增設定與首次連線

開啟 Shadowrocket 後進入 Home。先確認手上的資料類型：一組伺服器參數、單一伺服器分享連結、QR Code，或訂閱連結。這些資料的匯入方式各不相同。訂閱連結用來取得及更新一組項目，伺服器參數則用來建立單一項目；不能只因連結以 HTTPS 開頭，就認定它一定是訂閱。

手動輸入伺服器參數

在 Home 的 SERVER 區域找到 Add Server，開啟新增頁面。先點選 Type，選擇與現有資料相符的協定類型，再填入 Host 和 Port。Host 是伺服器網域名稱或 IP 位址，Port 是服務端指定的連接埠。請勿將整段分享連結填入 Host，也不要把網址中的路徑或查詢參數當成伺服器名稱。

後續欄位會依 Type 而異。截圖中雖然顯示 Password、Method 等欄位，但並非每種協定都使用相同參數。Password、UUID、Method、TLS 相關參數及傳輸設定，都應逐項對照原始資料；不可用其他協定的欄位取代。連接埠或驗證資料只要有一個字元不同，就可能出現儲存成功卻無法連線的情況。填寫後儲存，返回 Home，確認 SERVER 中已出現新增的項目。

QR Code 與分享連結

若已有 QR Code，請在 Add Server 中選擇 Scan QR Code，依系統提示允許使用相機，再將 QR Code 完整放入取景框。辨識後先檢查 Type、位址與連接埠，再儲存。QR Code 只是資料的載體，不能保證內容正確。若相機無法辨識，請先檢查畫面是否清晰、QR Code 是否完整，以及其中是否包含用戶端可辨識的設定。

若已有單一伺服器分享連結，可複製完整內容，返回應用程式依出現的匯入提示操作；若沒有提示，請檢查複製內容是否包含多餘說明文字。Import from Cloud JSON 適用於相應的 JSON 資料，並非通用訂閱入口。若不確定資料格式，請先向提供者確認，不要反覆更換 Type 嘗試。

使用 Subscribe 匯入現有訂閱

在 Add Server 的 Type 中選擇 Subscribe，將自己的訂閱連結完整填入 URL 欄位，儲存後等待取得結果。返回 Home，檢查訂閱群組及項目是否出現。訂閱網址可能包含私人存取識別資料，查詢參數請完整保留，但不要將網址貼在截圖、討論區或公開文件中。

若只看到訂閱群組，卻沒有任何伺服器項目，請先確認本機網路能否取得該網址，以及訂閱內容是否仍有效。空白群組不代表匯入完成。訂閱更新可能新增或移除項目；重新命名或整理前，請先保留原始資料。此時只要確認至少有一個項目與原始資料相符，下一步再決定流量處理方式。

返回 Home，在 SERVER 清單中點選要使用的伺服器，確認選取標記位於預期項目旁。訂閱群組中可能有多個名稱相近的項目，請依位址或已有備註辨認。清單中有項目只代表資料已儲存，不代表已選取，更不代表用戶端正在連線。

再次確認 Global Routing 顯示的模式，然後開啟頂部 Not Connected 旁的連線開關。初次使用時，系統可能詢問是否允許新增 VPN 設定。這是授權 Shadowrocket 建立系統網路設定的步驟，不是購買連線服務，也不會代為填寫伺服器參數。確認是自己剛才觸發的操作後，依系統提示允許，並完成裝置要求的身分驗證。

若剛才取消授權，請返回應用程式重新開啟連線開關，並依實際出現的系統提示操作。若裝置受管理政策限制，可能無法自行變更權限，請先確認裝置的管理要求。請勿反覆刪除應用程式來嘗試解決權限問題，以免增加遺失本機設定的風險。授權與伺服器驗證是不同環節；允許新增 VPN 設定無法修正錯誤的 Host、Port 或 Password。

完成授權後返回 Home，查看頂部連線狀態是否已從 Not Connected 改變。若開關立即關閉或狀態遲遲未完成，請先停止反覆切換，記下目前模式、選取項目與提示文字。切換伺服器或修改參數時，建議先關閉連線，完成修改後再重新連線，方便確認本次測試使用的資料。

系統顯示 VPN 標示，只能代表系統層級的 VPN 連線狀態，不能單獨證明目標網站可瀏覽，也無法證明規則符合預期。確認 Home 的連線狀態後，保留目前項目與模式，繼續下一步測試實際請求。此時先不要啟用其他自動連線條件，以免手動測試期間連線受到其他條件觸發。

先依問題發生階段定位：沒有匯入內容，檢查資料格式；有項目但無法連線，檢查參數與權限；已連線但無法瀏覽，檢查 DNS、規則與目標。這樣可避免訂閱取得失敗時反覆修改 Rule，也能避免驗證欄位錯誤時調整無關的系統設定。

訂閱沒有項目，或掃描 QR Code 後內容不完整

重新確認原始資料是否完整，尤其是訂閱 URL 的查詢參數、分享連結的前綴及 QR Code 邊緣。檢查目前網路是否能取得訂閱，以及回傳內容是否為登入頁面或一般網頁，而非設定資料。請勿將私人訂閱網址交給不明的線上轉換頁面。確認格式後重新匯入一次，再返回 Home 檢查項目；若仍有問題，請向資料提供者確認內容是否有效。

開關無法維持連線，或出現驗證失敗提示

先確認系統 VPN 設定權限，再核對所選項目的 Type、Host、Port 與驗證欄位。若項目需要 TLS 或特定傳輸參數，也要檢查伺服器名稱及相應設定，不能只檢查 Password。若換到另一個可信任的本機網路後狀況不同，請記錄這項差異，但不要因此保證某種協定一定能解決問題。協定欄位的詳細說明請參閱協定參考。

測試有回應，但網頁仍無法開啟

前往 Settings 查看 Test Method，先了解 Connectivity Test 使用的測試方式，並與實際網頁請求區分。接著檢查目前設定的 DNS 與 Rule。若網域無法開啟，但其他測試有回應，DNS 解析是可能需要檢查的環節之一；但不能只憑這個現象判定原因。請勿任意用 IP 位址取代 HTTPS 網域，因為憑證與網站選擇也仰賴網域名稱。

連線反覆自動開啟，或測試結果難以重現

在 Settings 中檢查 On Demand。此功能依照已設定條件觸發連線，不會自動修正錯誤的伺服器參數。排查期間可暫時關閉 On Demand，以便觀察手動開關的實際結果。確認手動連線及目標請求都正常後，再逐項恢復需要的條件，並檢查切換本機網路後的行為是否符合預期。

記錄診斷資訊，再進行下一項修改

Settings 中的 Diagnostics 可用來查看可取得的診斷資訊。記下問題發生時的狀況、目前的 Global Routing、測試方式與錯誤提示，比只說「不能用」更有助於縮小排查範圍。分享記錄前，請隱藏伺服器私人位址、訂閱 URL、驗證欄位及其他身分資訊；不必公開完整設定。

每次只修改一項，並重複第四步的相同測試。修改前先保留原始設定，確認能還原後再繼續嘗試。若問題涉及訂閱狀態、伺服器憑證或驗證資料，請由原資料提供者確認；若涉及購買、裝置相容性或已購項目還原，請查看已購項目還原說明。其他情況請參閱常見問題，不必因單一問題同時變更所有設定。