Shadowrocket 使用教學：匯入與初次連線

STEP 01 / INPUT

Add Server：新增伺服器與匯入 Subscribe

開啟 Shadowrocket，進入 Home，在 SERVER 區域附近找到 Add Server。先確認手上的資訊類型：訂閱連結可用來取得並管理一組伺服器；單一伺服器資訊則需選擇相應協定並填寫欄位。兩者用途不同，不能將完整訂閱網址填入 Host，也不能將伺服器網址當成 Subscribe 網址。

已有訂閱連結：選擇 Subscribe

1. 點選 Add Server，進入 Type 選擇清單，選取 Subscribe。在訂閱網址欄位貼上自己的完整連結，並填入方便辨識的名稱。
2. 確認貼上的內容完整，特別留意開頭、結尾、查詢參數，以及是否誤帶空格或換行。訂閱網址可能包含帳戶憑證，請勿為了排查問題而公開。
3. 儲存後返回 Home，等待訂閱完成匯入，或使用訂閱項目提供的更新功能。確認 SERVER 中出現實際伺服器項目，而不只是訂閱名稱。

訂閱更新成功只代表用戶端取得可解析的資料，不表示每個項目都能連線。先選擇其中一個自己有權使用的項目，確認其協定與網址符合預期，再進行下一步。若清單為空，先檢查訂閱狀態與網址是否有效，請勿重複新增同一個訂閱；重複項目會增加後續選擇與排查的難度。

已有單一伺服器資訊：依 Type 填寫

若手上有伺服器位址、連接埠及驗證參數，請在 Add Server 的 Type 中選擇相應協定。選擇後，可填寫的欄位會隨協定而異。畫面中的 Host、Port、Password、Method 是對應介面的欄位範例，並非所有協定都會出現的固定清單。Host 通常填寫伺服器網域名稱或 IP 位址，Port 填寫連接埠；Password、Method 及其他驗證或傳輸參數，必須與現有資訊一致。

使用 VLESS、Trojan、WireGuard 等協定時，請確認各自需要的身分、加密或 Peer 參數；不要依其他協定的欄位猜測填法。若原始資訊包含 TLS、SNI、傳輸路徑等設定，也應逐項對應。無法確認的參數應回到原始設定說明查證，勿任意關閉相關選項。

Scan QR Code 可掃描自己現有設定的 QR Code；使用時請依系統提示處理相機權限，並在辨識後確認內容。Import from Cloud JSON 用於匯入相應格式的資料，並非通用訂閱入口。儲存後返回 Home，確認伺服器項目存在，且可重新開啟檢視資訊，再前往 Global Routing。

STEP 02 / ROUTING

Global Routing：選擇連線模式

新增伺服器後，返回 Home，開啟 Global Routing。此處決定請求如何交由目前設定或連線策略處理，與「是否已開啟連線」是兩回事。首次操作時，先確認目的是依規則分流，還是暫時測試所選伺服器是否可用。不要只憑選項名稱判斷它適用於所有情境。

使用 Config 前，先確認啟用中的設定

進入底部的 Config 頁面，確認目前選用的設定檔。伺服器訂閱與設定檔的用途不同：前者主要提供連線項目，後者則決定規則及相關設定。匯入伺服器訂閱，不代表已替換或啟用預期的規則設定。需要編輯時，請先保留原始檔案副本，再開啟設定檢視；首次連線時不必一次加入大量不熟悉的規則。

官方截圖展示設定編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule 入口。本教學只需確認與分流相關的 Rule 和策略目標；首次連線不必修改其他區段，也不必啟用 HTTPS Decryption。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

以上是閱讀規則語法的範例，不是要直接覆寫現有設定。第一行依網域後綴比對並交由 PROXY 處理；第二行依 GEOIP 條件交由 DIRECT 處理；最後一行則是在前面的規則都未命中時作為預設處理。規則通常依序判斷，且策略名稱必須是目前設定環境中的有效項目。不要只複製單行，卻忽略其所需的策略定義。

若目前只想確認伺服器能否正常連線，可先選用代理 (Proxy) 縮小測試範圍；確認基本連線後，再切回設定 (Config) 檢查分流。修改模式後返回 Home，再確認一次 Global Routing 顯示的值。規則優先順序與更細的比對方式，請參閱常見問題；此時應避免同時變更伺服器、規則與 DNS。

STEP 03 / CONNECT

Home：選擇伺服器並開啟連線

返回 Home，檢查 SERVER 區域，點選準備使用的伺服器，確認選取標記位於預期項目上。若訂閱中有名稱相近的項目，請開啟詳細資料核對位址或備註，避免選錯。接著再次確認 Global Routing：選擇 Config 時，確保啟用中的設定檔是上一步確認的檔案；選擇 Proxy 時，確保目前選取伺服器的資訊已儲存。

1. 找到 Home 頂端的連線開關。未連線時會顯示 Not Connected，點選開關即可開始連線。
2. 首次使用若出現新增 VPN 設定的系統要求，請確認要求來自剛開啟的 Shadowrocket，再依系統提示確認。系統可能要求輸入裝置密碼或進行身分驗證，請在系統介面中完成。
3. 返回 Home，等待狀態更新。若開關立即關閉，或系統要求尚未完成，請先處理授權問題，不要快速反覆切換。

VPN 設定授權可讓 App 透過系統提供的網路機制處理流量；這不代表伺服器密碼已通過驗證，也不代表訂閱仍有效。開關維持開啟，同樣不能取代實際請求測試。請分開確認「系統已建立連線」與「目標網站已成功連線」，再於下一步驗證網路結果。

若已有其他 VPN 連線，或裝置受管理政策限制，系統可能發生設定衝突或權限限制。先確認裝置目前使用的連線及管理狀態；公司或學校管理的裝置應遵循管理規範，不要刪除不明設定。若先前拒絕了系統要求，可返回 App 重試，並檢查系統中相應的 VPN 設定；具體位置依系統介面而異。

在 iPad 上使用時，頁面可能因橫向模式或分割畫面而呈現不同版面，但仍可從 Home、SERVER、Global Routing 與頂端開關尋找操作位置。首次連線建議在同一個 Wi-Fi 或行動網路環境中完成測試，暫時不要切換網路，以便區分連線問題與網路變動。

STEP 05 / DIAGNOSE

Settings：依故障位置逐項排除

若前四個步驟未得到預期結果，先判斷問題發生在哪個層面，再前往 Settings 檢查相關設定。此處可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等項目。這些並非初次連線時都必須調整的項目；若已有預設值或現有設定，應先保留，以免大量變更掩蓋最初的原因。

訂閱未產生伺服器項目

返回訂閱項目，確認網址完整、目前網路可存取該網址，且訂閱仍有效。若網址開啟後顯示網頁、登入提示或錯誤內容，用戶端不一定能將其解析為伺服器清單。向原資訊提供者確認網址用途時，請說明錯誤訊息與發生時間，不要公開完整連結。更新訂閱可能會取代由訂閱管理的項目，手動編輯前請先確認項目來源。

開關無法開啟，或開啟後立即關閉

先確認系統 VPN 設定要求是否已完成，再檢查目前是否有衝突的連線，或是否受裝置管理政策限制。伺服器逾時與系統授權失敗是不同問題：授權尚未完成時，反覆修改 Host、Port 無法解決開關問題。若在系統更新或調整設定後發生異常，請先重新開啟 App 並記錄具體提示，再依故障排除手冊中的授權流程處理。

開關已開啟，但 Connectivity Test 逾時

依序確認 Host、Port、驗證參數、協定 Type 與傳輸設定，特別留意字母大小寫、複製時帶入的空格，以及 TLS 相關欄位。檢查裝置日期與時間是否正確，因為時間可能影響憑證驗證。接著在條件允許時，改用另一個自己有權使用的網路進行比較；每次都使用同一個項目與相同的測試方式。若只有特定項目失敗，應優先檢查該項目的原始參數與服務狀態。

只有 Config 下失敗，或部分網域異常

先檢查規則，再檢查名稱解析。確認啟用中的設定檔正確、策略名稱對應到有效目標，且 REJECT 未意外阻擋所需請求。網域請求與直接使用 IP 的測試結果不同，可能與 DNS 有關，也可能是目標對網域或 TLS 的要求所致，不能只憑單次現象下結論。確認目前設定中的 DNS 選項符合網路與連線方式；不要任意填入不熟悉的位址來嘗試修復。

測試方式與自動連線可能影響判斷

Test Method 會決定相關測試採用的方式，不同方式可能受伺服器與網路條件影響。比較前請先統一測試方式，不要把某一種測試失敗視為所有通訊都失敗。On Demand 負責依系統條件觸發隨選連線，不負責定義每個請求的規則策略；若手動中斷後連線再次觸發，請檢查既有的 On Demand 條件，而不是將它當作 Global Routing 的替代選項。

需要更詳細的資訊時，請在 Diagnostics 中使用適合目前問題的診斷功能，並記錄失敗步驟、測試方式、網路類型與錯誤訊息。分享紀錄前，請遮蔽訂閱憑證、伺服器驗證資訊及可識別個人身分的資料。本站教學僅說明操作與診斷方式，不會收取連線憑證。

若仍無法定位問題，不必反覆匯入或重建所有項目。保留最近一次可重現的狀況，前往故障排除手冊依症狀繼續檢查；購買、已購項目還原及常見介面概念可參閱常見問題。日常使用時，保留已驗證的設定，再依實際需求逐項調整。