1. 新增伺服器或匯入訂閱

先確認手上的資料類型，再選擇相應入口。訂閱網址通常用於取得及更新一組伺服器資料；單一伺服器分享連結只包含一項連線資訊；位址、連接埠、密碼等分開提供的欄位則需手動填寫。網址看起來相似，不代表用途相同；帳號管理頁面、說明頁面與訂閱網址不能互相取代。

已有訂閱：使用 Subscribe

開啟 Shadowrocket，前往 Config 頁面，找到 Subscribe，在訂閱相關操作中輸入已有的訂閱網址，並依照畫面提示確認匯入。複製網址時請保留完整內容，尤其是問號後方的查詢參數；也要檢查開頭與結尾是否多出空格、換行或中文標點。網址中的存取憑證屬於敏感資訊，請勿張貼在公開留言區，也不要為了展示問題而公開完整連結。

送出後先留意是否出現錯誤提示，再返回 Home 查看 SERVER 區塊。以清單中實際出現可選伺服器作為匯入完成的依據，不要只因輸入視窗關閉就判定成功。若現有訂閱支援更新，之後更新時會重新取得遠端內容；伺服器名稱、數量與參數可能隨訂閱內容變動，手動修改的項目也應留意更新後的結果。

訂閱網址與完整配置檔網址並非同一種資料。前者主要用於管理伺服器資料，後者可能包含規則、網域對應等設定。若匯入後只看到配置項目，卻沒有伺服器，請先確認資料用途，不要反覆將同一網址貼入不同入口。

已有伺服器欄位：使用 Add Server

返回 Home，點選新增項目的加號，進入 Add Server。先選擇與現有資料相符的協定類型，再填寫伺服器位址、連接埠與身分驗證資訊。選擇協定後，表單欄位會隨之變動；不能因為兩種協定都包含密碼或 UUID，就把它們當成相同類型的設定。

例如，Shadowsocks 需要核對加密方式與密碼；VMess、VLESS 則需依照資料核對 UUID 及相關欄位；Trojan 還要留意密碼與 TLS 設定。傳輸方式、TLS、伺服器名稱、路徑等附加參數也須逐項相符。資料未提供的欄位不要憑經驗補填，也不要把停用憑證驗證當成通用解法。確認後儲存，再返回 SERVER 選取該項目。

已有分享連結或 QR Code

如果資料是伺服器分享連結，可使用應用程式提供的剪貼簿匯入入口；如果是 QR Code，則使用 Scan QR Code，並依照系統提示允許相機存取。掃描或辨識後仍須檢查協定、位址與連接埠；成功匯入只代表應用程式辨識了內容，不代表遠端服務已通過測試。QR Code 也可能包含密碼與存取憑證，請比照原始連結妥善保管。

此階段的檢查結果應為：Home 中已有明確的伺服器項目，且準備使用的項目已選取。完成後再設定流量的處理方式。入口與格式的詳細差異請參閱訂閱匯入入口說明；欄位含義請參閱名詞解釋。

2. 選擇 Global Routing

在 Home 點選 Global Routing。此處決定流量的處理方式，與上一步「選擇哪台伺服器」是兩項獨立操作。清單中已選取伺服器，不代表所有連線都會經過該伺服器；反過來說，選擇代理模式也無法讓錯誤的伺服器參數自動生效。

配置(Config)：依目前規則處理

配置(Config)適合搭配現有規則配置日常使用。應用程式會依照目前配置中的規則判斷連線去向，可能採用 PROXY、DIRECT 或 REJECT 等策略。因此，同一連線工作階段中，不同網域出現不同處理結果，可能是規則預期的行為。選擇此模式前，請在 Config 確認目前生效的是哪份配置，而不只是確認清單中存在某個檔案。

本頁不要求初次操作時編寫規則。如果目前配置的來源與內容尚不明確，請先確認伺服器可用，再決定是否使用這份配置。規則比對順序、預設策略與具體語法集中於規則與配置參考，第一次連線時不必同時修改。

代理(Proxy)：先排除規則因素

代理(Proxy)可用於首次測試或比對排查：通常由應用程式接管的連線會交由代理處理，有助於區分「伺服器本身無法連線」和「某條規則改變了連線去向」。這不能取代伺服器品質測試，也不保證所有目標都能存取。系統層級的流量例外與應用程式自身的連線行為，仍可能影響實際結果。

直連(Direct)：直接連線至目標

直連(Direct)會直接連線至目標，不經由選取的代理伺服器轉送。若正在確認伺服器是否生效，卻一直停留在此模式，就不能以網頁成功開啟來證明代理連線可用。切換至此模式也不代表已關閉 Home 的連線開關；路由選擇與系統連線狀態應分開理解。

首次設定時可先選擇代理(Proxy)，使用同一台伺服器完成後續測試；確認可用後，再切換至配置(Config)檢查日常規則的運作情形。每次切換後都重新發起連線，避免瀏覽器既有連線影響判斷。

3. 開啟開關並完成授權

返回 Home，再次確認 SERVER 中選取的項目與 Global Routing 目前模式，接著開啟連線開關。尚未連線時，可能會看到 Not Connected 等狀態文字；操作後請留意狀態是否改變，以及是否立刻恢復為中斷狀態。系統確認視窗尚未處理前，請勿連續切換開關。

首次使用時，系統可能會提示 Shadowrocket 要求新增 VPN 設定。此提示是允許應用程式建立系統網路設定，並非要求重新購買應用程式，也不會代為填寫伺服器參數。確認提示是由剛開啟的 Shadowrocket 發起後，依照系統指示允許，並完成裝置密碼或身分驗證。請在裝置的系統介面完成驗證，不要將裝置密碼填入伺服器表單或網頁。

如果先前取消了提示，請返回應用程式再次嘗試連線，並依照實際出現的提示操作；也可在系統設定中搜尋 VPN，查看 Shadowrocket 的設定狀態。操作前請確認目前裝置是否受組織管理，以及是否設有相關限制。若遇到明確的管理限制，請依照裝置管理規範處理，不要不斷刪除不明的系統設定。

完成授權後返回 Home，檢查連線狀態。系統顯示 VPN 已建立，代表本機網路接管已啟動，並不表示遠端伺服器、DNS 與目標網站都正常。下一步仍須測試實際存取情形。如果開關剛開啟就關閉，請先記錄系統提示與應用程式錯誤資訊，不要立刻重新安裝。

首次測試期間先保留 On Demand 原有設定，避免將自動連線條件與手動開關混在一起排查。如果關閉開關後又自動建立連線，請檢查 On Demand 是否已啟用及其觸發條件。手動連線穩定後，再依照自己的使用需求設定自動連線行為。

4. 確認連線是否實際生效

測試分為三個層面：伺服器是否通過測試、系統連線是否維持，以及目標請求是否依預期完成。三者彼此相關，但不能互相取代。分別記錄各層結果，之後比起籠統地說「連不上」，更容易找出問題所在。

先查看 Connectivity Test

在 Home 使用 Connectivity Test，查看目前伺服器的測試結果。測試方式與目標都會影響結果，因此單次成功不代表所有網站都正常，單次逾時也不能單獨證明所有連線都無法使用。如果清單中有多台現有伺服器，請確認測試結果對應哪一項，以及目前實際選取的是哪一項。

不要只根據測試數字下結論。測試請求的路徑、目標與實際服務請求可能不同；只有持續失敗時，才進一步核對參數、目前網路與遠端狀態。也不要為了改善單次測試結果，同時變更 DNS、TLS、協定與路由模式，否則後續比較將失去依據。

接著重新發起實際連線

保持連線開啟，切換至瀏覽器，重新開啟平時使用且已知能正常回應的 HTTPS 頁面。重新整理舊分頁可能讀取快取，建議重新發起請求，並確認頁面實際內容已載入。挑選少數不同目標交叉測試即可，不要僅憑單一網站失敗就判定整個連線有問題。

如果瀏覽器可以存取，但某個應用程式異常，請先確認該應用程式是否保留舊連線，或有登入、權限、服務狀態等自身問題。可重新開啟相關應用程式再比對結果。未經確認前，不要將帳號錯誤、目標維護或網頁本身的錯誤歸因於 Shadowrocket。

最後檢查規則處理結果

完成代理(Proxy)測試後，切換至配置(Config)，重新存取相同目標。若要進一步核對，可在 Data 查看可用的連線資訊，搭配目標網域、比對規則與策略判斷連線去向；流量增加本身不能證明請求經由選取的伺服器傳送。若現有記錄不足以判斷，請保留「尚未確認」的結論，不要把推測當成測試結果。

代理(Proxy)正常但配置(Config)異常時，排查重點應從伺服器參數轉向目前配置、規則與 DNS。此時請保留已正常運作的伺服器設定，前往規則參考檢查具體比對結果，避免從頭重做所有步驟。

5. 依照失敗階段逐項檢查

先確認流程停在哪個步驟：沒有匯入內容、已有伺服器但測試失敗、系統授權失敗，或連線維持但目標無法開啟。每次只修改一個變數，測試後記錄結果；確認沒有改善時，恢復原值再檢查下一項。這樣可保留已驗證的設定，也方便接著參閱相關問題說明。

匯入後沒有出現伺服器

重新確認輸入的是訂閱網址、單一分享連結還是配置檔網址，並確認入口與資料類型相符。檢查連結是否遭通訊軟體截斷、查詢參數是否完整，以及存取憑證是否仍有效。如果更新後收到的是登入頁面或錯誤說明，即使網址本身可以開啟，也不代表回傳內容是應用程式可辨識的訂閱資料。

接著檢查目前網路是否能取得訂閱內容，以及現有訂閱是否需要在原管理頁面更新狀態。優先核對回傳的錯誤，不要反覆新增同一個網址，以免留下多個難以辨認的項目。對外說明問題時只需提供錯誤類型，並隱藏完整訂閱網址與身分驗證欄位。

伺服器已列出，但測試持續失敗

先核對位址、連接埠與協定類型，再檢查密碼、UUID、加密方式等身分驗證欄位，最後確認 TLS、伺服器名稱與傳輸相關參數。特別留意數字連接埠是否輸入錯誤、密碼是否包含空格，以及路徑是否遺漏。所有欄位都必須與現有伺服器資料相符，不能只核對名稱。

也可在另一個自己能使用的網路環境中重複相同測試，判斷問題是否與目前的 Wi-Fi 或行動網路有關。切換網路前請留意裝置的數據用量設定。如果同一項目在不同網路中都失敗，請保留測試結果，並向原服務提供者確認伺服器狀態與參數，不要只靠反覆切換模式來處理身分驗證錯誤。

連線已開啟，但頁面無法開啟

先確認目前不是直連(Direct)，再以代理(Proxy)和配置(Config)測試同一目標。如果只有配置(Config)失敗，請檢查目前生效的配置是否包含非預期的 REJECT、不適用的 DIRECT 或錯誤的預設策略。如果兩種模式都失敗，則繼續檢查伺服器、DNS 與目標網站狀態，不要只針對規則調整。

遇到憑證錯誤時，請先核對裝置時間、伺服器名稱與 TLS 參數，不要預設略過憑證驗證。只有部分網域失敗時，記錄具體網域與發生時間，再查看相關連線資訊；不必清除所有配置。DNS 變更可能影響網域解析結果，但應根據錯誤證據調整，不要盲目疊加多項設定。

為下次排查保留有效資訊

建議記錄四項資訊：失敗發生在哪個步驟、當時的 Global Routing 模式、應用程式顯示的錯誤原文，以及切換網路或模式後的變化。記錄中不要包含密碼、UUID、完整訂閱網址或含有憑證的 QR Code。尋求進一步協助前，先確認自己能說明「哪裡成功、哪裡失敗」，而不只是描述開關顏色。

完成首次連線後，日常使用主要是維護現有訂閱、確認目前伺服器與配置，以及留意異常變化。更多連線與匯入情況請參閱常見問題；需要了解 On Demand、FINAL 等術語時，請查看名詞解釋。系統化的配置細節請參閱規則參考。本頁的完成標準是：現有伺服器可正常連線、實際請求已完成驗證，並且知道發生問題時應從哪個步驟開始檢查。

Shadowrocket 使用說明