Shadowrocket 使用教學

新增成功的判斷方式：返回 Home 後，SERVER 群組中出現可選項目。看到項目只代表資料已儲存，不表示認證正確或已成功連線。請先確認手上的資料是完整訂閱網址，還是單一伺服器的協定與參數，再選擇相應入口。

已有伺服器資料：依欄位填寫

在 Home 點選 Add Server 進入新增頁面。先開啟 Type，選擇資料中明確標示的協定類型。Type 會決定後續欄位，請勿只憑伺服器名稱或網址猜測。截圖中的 Host、Port、Password、Method 是該頁面所示類型的欄位；切換至其他 Type 後，請依畫面顯示填入相應參數。

Host 通常填入現有資料中的網域名稱或 IP 位址，請勿在此貼上整段訂閱網址；Port 請填入對應連接埠，複製時留意不要連同空格一起貼上。Password 與 Method 必須符合現有資料，不能因某個選項看似常見就自行更換。若資料還包含其他認證或傳輸參數，也請逐一核對；資料不全時應向自己的服務供應商確認，不要反覆嘗試隨機值。

頁面底部的 Scan QR Code 可用來讀取自己已有的相容 QR Code。系統詢問相機權限時，請依實際掃描需求決定是否允許。掃描結果仍須核對 Type 與伺服器欄位；成功讀取 QR Code 不代表其中參數仍然有效。Import from Cloud JSON 是另一種匯入入口，與 Subscribe 不同；只有一般訂閱網址時，不必使用此入口。

已有訂閱連結：使用 Subscribe

在 Add Server 的 Type 中選擇 Subscribe，將自己的完整訂閱連結貼到相應的網址欄位，填入方便辨識的備註後儲存。保留網址原有路徑與查詢參數，請勿只複製網域，也不要把瀏覽器頁面標題當成網址。訂閱連結可能含有個人憑證，請比照密碼妥善保管。

儲存後等待內容讀取，再返回 Home 確認訂閱群組與伺服器項目。若群組已出現但裡面沒有伺服器，請先檢查網址是否完整、目前網路是否可讀取，以及服務是否仍有效；不要直接重複建立多個相同群組。訂閱通常用來管理一組伺服器資料，Config 則用來管理設定檔與規則，兩者是不同操作。

完成此步驟後，保留一個準備測試的項目即可。遇到不熟悉的協定或欄位，請先查閱術語表；需要進一步整理多組設定時，再閱讀完整使用手冊。

新增伺服器後，返回 Home 點選 Global Routing。這裡決定流量的處理方式，而 SERVER 中選取的項目則提供代理連線所需的資料。選好了伺服器卻維持直連 (Direct)，無法用來確認該伺服器的代理連線是否正常；兩項設定都要檢查。

三種模式各適用於哪些情況

• 設定檔 (Config)：依目前設定檔中的規則處理流量。不同目標可能套用不同策略，因此並非每次連線都會使用所選伺服器。
• 代理 (Proxy)：以代理方式處理流量，排查問題時可減少設定規則造成的影響；但仍須確保既有伺服器參數正確且服務可用。
• 直連 (Direct)：以直接連線方式處理流量，可與原本的網路存取情況比較，但不能用來確認代理伺服器是否可用。

若已有用途明確的設定檔，通常應先確認其中的規則，再選擇設定檔 (Config)。若只是想確認剛新增的伺服器能否建立有效連線，可暫時選擇代理 (Proxy) 進行比較，完成後再恢復原本需要的模式。請勿將排查時的暫時選擇視為適用所有情境的固定設定。

使用 Config 前確認目前設定檔

進入 Config，確認目前選用的設定檔，再查看其內容。官方截圖顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule 入口。本次入門操作只需著重 Rule：了解目標流量會依何種策略處理，首次連線不必啟用其他區段中的功能。

Rule 中的規則會由上往下比對，符合後套用相應策略。DIRECT 代表直接連線，PROXY 代表以代理方式處理，REJECT 代表拒絕；FINAL 用來處理先前未符合規則的流量。以下僅為方便閱讀的語法範例，並非完整設定檔，也不必直接覆蓋現有內容：

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

此例中，符合 example.com 及其子網域的請求會使用 PROXY，其餘未符合規則的流量則由 FINAL 交由 DIRECT 處理。實際結果仍取決於完整規則的順序與目前設定。編輯前請先保留原設定，避免刪除必要項目。規則撰寫與比對細節較多，可前往完整使用手冊繼續閱讀；本頁先完成連線與測試。

返回 Home，先在 SERVER 群組選取準備使用的伺服器，再確認 Global Routing。首次操作建議只測試一個項目，暫時不要同時調整 On Demand、測試方式與多份設定檔，這樣發生異常時才容易判斷是哪項變更造成的。

在 Home 頂端找到連線開關。官方截圖中的 Not Connected 表示尚未建立連線；確認伺服器與模式後，開啟旁邊的開關。首次連線時，系統可能會詢問是否允許新增 VPN 設定。此提示是讓 Shadowrocket 建立處理裝置網路流量所需的系統設定，並非要求重新購買 App 或輸入訂閱密碼。

確認提示是由目前操作觸發後，依系統畫面允許並完成身分認證，再返回 Shadowrocket。裝置是否需要密碼或其他認證方式，請以系統實際提示為準。請勿將裝置解鎖密碼填入 Add Server 的 Password：系統認證與伺服器認證是兩種不同資訊。

若先前取消了系統提示，請返回 App 再次發起連線，並留意授權畫面是否重新出現。若裝置受組織管理，或目前已有其他 VPN 連線在使用，請先確認裝置本身的使用限制與連線狀態，不要反覆刪除用途不明的系統設定。記下畫面提示，通常比連續切換開關更有助於找出問題。

完成授權後，查看 Home 頂端狀態是否從 Not Connected 改變，並確認開關沒有立即關閉。建立系統 VPN 連線只是驗證流程的第一步；伺服器認證、目標連線能力與規則處理仍須進一步確認。狀態改變後先維持目前設定，進入測試步驟，不要立刻批次修改項目。

需要結束這次手動測試時，可返回 Home 關閉連線開關。若之後又自動連線，請前往 Settings 檢查 On Demand 是否已啟用及其觸發條件；不要直接判定為開關故障。

排查時每次只變更一項條件，並在修改後重做相同的測試。先判斷問題出在哪一層：訂閱讀取失敗、開關無法維持、測試失敗，還是只有特定網頁無法存取。這些狀況的檢查順序不同，不宜以反覆重新安裝取代問題定位。

訂閱內容為空或伺服器資料不完整

先關閉目前連線，確認裝置原有網路可正常使用，再檢查訂閱網址是否完整。網址讀取失敗與伺服器連線失敗是兩種不同問題：前者可能尚未取得可用項目，後者則是已有項目但連線異常。手動新增的項目請重新開啟詳細資料，核對 Type、Host、Port 與認證參數，特別留意複製時帶入的空格、換行或遺漏內容。服務狀態與使用條件請向自己的服務供應商確認。

開關自動關閉或所有實際請求都失敗

檢查系統 VPN 設定授權是否已完成，留意是否出現明確錯誤提示，再確認選取的伺服器是否正確。對照現有資料核對認證資訊，請勿為了排查而任意降低安全相關設定。若要比較 Wi-Fi 與行動網路，請在兩種網路下使用相同項目與模式，並確認測試操作符合目前網路的使用規定；切換網路後結果不同，只表示網路路徑值得進一步檢查，不能直接歸因於某個參數。

測試結果與實際存取情況不一致

進入 Settings，找到 Test Method，先記下原本的選擇。不同測試方法的檢測目標與結果含義可能不同，應搭配實際請求判斷，不要為了看到更小的數字而不斷更換方法。若代理 (Proxy) 下存取正常、設定檔 (Config) 下失敗，請優先回到 Config 檢查 Rule 的比對順序、目標策略與 FINAL，不必立刻重新輸入伺服器密碼。

關閉後又自動連線，或需要進一步診斷

在 Settings 檢查 On Demand。若已設定按需連線條件，網路變更或相關請求可能再次觸發連線。若要進行一次明確的手動測試，可先記下現有條件，再暫時停用按需連線；測試結束後依原用途恢復。不要同時修改多項自動化條件，否則很難判斷是哪項規則生效。

需要更多線索時，可查看 Settings 中的 Diagnostics。記下問題發生時間、當時網路、所選伺服器、Global Routing 與錯誤訊息。診斷記錄可能包含網域、位址或認證相關資訊，向他人說明問題前請先檢查並遮蔽敏感內容；不要公開傳送整段訂閱網址、密碼或 QR Code。

Settings 中還有 Proxy、TCP、UDP 等項目，入門時不必逐項調整。確認要解決的具體問題後，再修改相關設定。更完整的設定維護、Data 觀察與排查流程，請參閱完整使用手冊；術語說明請參閱術語表。