官方手冊 · 首次設定

Shadowrocket
匯入、連線與使用驗證

依序完成五個步驟:將既有資料加入用戶端、決定請求的處理方式,再開啟連線並檢查結果。先完成一次完整流程,再調整規則和自動連線條件。

截圖取自 App Store 官方介面。請依欄位名稱尋找對應入口;介面位置可能隨應用程式更新而略有調整。

步驟 01 · 準備可選取的伺服器項目

Add Server 與訂閱匯入

訂閱連結、單筆分享連結和手動填寫是不同的資料形式。先確認手邊的資料類型,再選擇相應入口。

從 Home 開啟 Add Server

開啟 Shadowrocket 後停留在 Home。初次使用時,SERVER 群組可能還沒有可用項目,這不代表安裝失敗。點選 Add Server 進入新增頁面,先查看 Type,再決定要填寫哪些資料。不要看到截圖中的欄位就逐項照填:Type 改變後,下方顯示的欄位也會變動,應以既有資料中的協定類型為準。

如果持有的是單一伺服器資料,請在 Type 中選擇相應協定,例如 Shadowsocks、VMess、VLESS 或 Trojan,再填寫位址、連接埠與驗證資訊。官方截圖中的表單包含 Type、Host、Port、Password、Method;其中 Method 適用於相應協定,其他協定可能使用不同的驗證欄位。Host 只填資料要求的主機名稱或位址,Port 填入連接埠號碼,不要自行在位址後加上網頁路徑,也不要把多項資料塞進同一個輸入欄位。

已有訂閱連結時選擇 Subscribe

如果取得的是用來更新伺服器清單的訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整連結填入 URL,並填寫方便辨識的備註,再儲存。訂閱網址常帶有較長的查詢參數,複製時應從開頭完整保留至結尾,避免一併貼入聊天文字、前後空格或換行。訂閱連結本身可能包含存取憑證,請如同密碼般妥善保管,不要貼到公開留言或截圖中。

儲存後返回 Home,等待訂閱內容載入,再檢查 SERVER 中是否出現可選取的伺服器。儲存訂閱來源與成功取得其中的項目是兩回事;如果只看到來源名稱,卻沒有可用項目,請先檢查連結能否正常更新、資料是否仍有效。此處匯入的是伺服器資料,不代表已選定規則設定檔;Config 頁中的設定檔訂閱也不要與伺服器訂閱混用。

如何處理 QR Code 與剪貼簿資料

如果已有伺服器 QR Code,可在新增頁面使用 Scan QR Code,允許相機存取後進行掃描,再確認辨識出的協定和位址。如果已有單筆分享連結,可使用應用程式提供的剪貼簿匯入入口;若出現系統貼上授權,確認內容來源後再繼續。Import from Cloud JSON 適用於相應的 JSON 資料,不是所有訂閱連結都能使用的通用入口。完成匯入後先檢查欄位,不要立即開啟連線。

本步驟的完成條件是:Home 中已有來源清楚、可供選取的伺服器項目。不要為了嘗試不同入口而重複匯入同一份資料,否則之後容易選到舊項目。需要釐清 Subscribe、設定檔和分享連結時,可參閱概念速查,再繼續選擇路由方式。

Shadowrocket Add Server 新增頁面,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先確認 Type,再填寫該協定所需欄位;截圖中的表單並非所有協定通用的欄位清單。
步驟 02 · 決定請求處理方式

Global Routing 三種模式

伺服器決定可連線的目標,Global Routing 則決定如何處理請求。兩者需要分別確認。

返回 Home,點選 Global Routing 查看目前選項。三種模式分別是設定(Config)、代理(Proxy)、直連(Direct)。Config 依目前設定中的規則處理請求;Proxy 以代理方式處理進入用戶端處理範圍的請求;Direct 則以直連方式處理。模式名稱不是連線品質等級,也不是越前面的選項就越適合所有網路,請依這次要驗證的用途選擇。

日常需要依規則分流時,請選擇設定(Config),並前往 Config 頁確認目前使用的設定檔。成功匯入伺服器,不代表規則已符合需求。開啟準備使用的檔案查看內容,編輯頁會依 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段整理。初次使用時,先確認 Rule 和最終策略,不需要為了完成連線而開啟或修改每個區段。

先了解規則,再修改設定

規則通常依序比對,較早符合的規則會影響後續處理。以下是用來理解語法的手冊範例,並非建議直接覆蓋現有設定的完整檔案:DOMAIN-SUFFIX 比對網域後綴,DIRECT 代表直連策略,PROXY 代表範例中的代理策略,FINAL 用來處理未符合前面規則的請求。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

在編輯頁使用 Add Rule 前,請先儲存設定副本,並確認規則中的策略名稱能對應目前設定中的實際策略。不要只因為範例出現 PROXY,就認定所有設定都採用相同的策略組織方式。修改後請儲存,並返回 Config 清單確認目標檔案正在使用中;只是開啟編輯器查看檔案,不代表已切換目前設定。

如果暫時無法判斷是伺服器問題還是規則問題,可在後續驗證時短暫使用代理(Proxy)進行對照,記錄結果後再恢復原本的設定(Config)。直連(Direct)可用來比較本機網路存取,但不能用來證明伺服器連線成功。規則關鍵字說明請參閱Global Routing 速查;協定參數與取捨請參閱協定詳解。本步驟只需確認目前模式和設定,不必一次調整所有規則。

Shadowrocket Config 設定檔編輯頁,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:查看設定內容時,請重點確認 Rule。Global Routing 模式選項位於 Home,不在此編輯頁中。
步驟 03 · 建立用戶端連線

選擇 SERVER,開啟連線開關

先確認選取的項目,再開啟頂端開關。系統授權與伺服器驗證是不同環節。

返回 Home,在 SERVER 群組中選擇剛才確認過的伺服器。如果清單中有多個名稱相似的項目,請開啟詳細資料確認位址或備註,不要只依排列順序判斷。接著再確認一次 Global Routing:使用規則時應選擇 Config,臨時進行對照測試時才依計畫改用 Proxy 或 Direct。如此一來,之後出現不同結果時,才能確認當時使用的條件。

確認後,開啟 Home 頂端的連線開關。首次連線可能出現系統新增 VPN 設定的授權提示;確認提示由 Shadowrocket 發起後再允許,並依系統要求完成裝置驗證。此授權是讓應用程式建立系統網路連線設定,不是購買伺服器,也不會將資料提交給本站。如果取消授權,請重新啟動連線並完成系統提示,不要重複匯入訂閱。

等待頁面上的連線狀態變更。截圖中的 Not Connected 表示拍攝當下尚未連線,並非需要輸入的設定值。開啟開關後,也要留意開關是否維持啟用,或是否很快回到原狀。系統顯示 VPN 狀態,只能表示相關連線設定正在運作,無法單獨證明伺服器驗證、目標網頁瀏覽和規則比對都已成功;下一步仍需實際驗證。

如果開關立即關閉,請先記下畫面上的錯誤提示,並檢查是否有其他正在執行的 VPN 連線設定。不要在多個網路設定之間反覆切換卻不記錄結果;必要時先停止另一條連線,再重試 Shadowrocket。如果開關維持啟用但網頁無法開啟,先保留目前狀態,直接進行下一步檢查,不要同時更換伺服器、設定檔和測試方式。

Shadowrocket Home 頁面,頂端顯示 Not Connected 開關,下方為 Global Routing、Connectivity Test 和 SERVER 群組中的 Add Server
Home:連線前確認 SERVER 選取項目與 Global Routing;連線後繼續使用 Connectivity Test 和實際瀏覽進行驗證。
步驟 04 · 區分狀態與實際瀏覽

Connectivity Test 與生效驗證

依「測試結果 → 實際瀏覽 → 規則路徑」的順序檢查,避免把單次測試當成全部結論。

保持連線開啟,在 Home 點選 Connectivity Test,等待測試完成。測試可協助確認目前測試方式下的連線情況,但只涵蓋相應的測試目標與條件。測試有回應,不代表所有網頁都能瀏覽;顯示逾時,也不必立刻認定所有應用程式都無法使用。請先記錄結果,再到實際要使用的瀏覽器或應用程式中驗證。

選擇一個用途明確、目前可正常提供服務的頁面,重新發出瀏覽請求,而不是只看已載入的舊頁面。必要時重新整理頁面或開啟新分頁,避免快取內容造成誤判。接著檢查實際要使用的應用程式是否能完成一次完整操作,例如載入新內容;只看到應用程式首頁,不足以判斷新請求的處理結果。

使用 Config 時,分別檢查兩類請求

如果設定中同時存在代理和直連策略,請各選一個預期用途明確的目標進行驗證。能開啟某個直連頁面,不代表代理伺服器可用;代理頁面可瀏覽,也不代表區域網路等直連需求已設定妥當。請配合目前規則確認目標是否符合預期規則,必要時查看應用程式中可用的連線記錄或診斷資訊。不要只根據網頁開啟速度推斷路由路徑。

結果不一致時,先固定伺服器與測試目標,只切換一次 Global Routing 進行對照。例如 Config 下失敗、Proxy 下成功,請優先檢查規則、策略選擇和相關解析設定;兩種模式都失敗,則繼續確認伺服器欄位、資料狀態與目前網路。測試結束後,請恢復預定使用的模式並再次驗證,避免把臨時排查設定誤當成日常設定。

完成本步驟後,應能說明三件事:連線開關是否維持啟用、指定目標是否能完成新請求、Config 中預期的分流是否成立。如果只符合其中一項,請繼續依下一步找出問題。測試方式與常見狀態的意義可在疑難排解中查詢,不必為了得到更好看的測試數字而反覆修改設定。

步驟 05 · 每次只修改一項條件

常見失敗原因與 Settings 檢查

先找出問題發生在哪個環節,再檢查相關設定。不要同時切換所有開關。

匯入失敗:先檢查資料類型與完整性

訂閱取得失敗時,請先確認連結是否完整複製、是否仍在有效期限內,以及服務供應商是否要求更新網址。網頁網址、單筆分享連結、伺服器訂閱和設定檔網址不一定能互換。手動新增後無法使用,請返回 Add Server 確認 Type、Host、Port 和驗證欄位,特別留意密碼中的大小寫、不可見空格及協定要求的額外參數。欄位不明時,請向原始資料提供者確認,避免憑名稱猜填。

連線失敗:區分本機網路與遠端資料

先暫停連線,確認裝置的基本網路能正常瀏覽;如果目前 Wi-Fi 需要網頁認證,請先完成認證。接著重新連線 Shadowrocket,使用同一個項目進行測試。如果只有某個網路環境失敗,且條件允許,可切換 Wi-Fi 與行動網路進行一次對照,並記錄差異。如果所有環境都失敗,請優先確認伺服器資料與服務狀態,不要反覆刪除應用程式,因為重新安裝無法修正錯誤的連接埠或失效的驗證資訊。

測試與自動連線:查看 Test Method、On Demand

開啟 Settings,找到 Test Method,確認目前的測試方式是否適合要檢查的問題。不同方式的目標與條件不同,測試結果不能直接互相比較。Settings 中的 On Demand 用來依條件觸發連線,並非補齊缺少伺服器資料的功能;如果手動關閉後又自動連線,請檢查既有的 On Demand 條件。初次設定時,建議先完成手動連線驗證,再單獨設定自動連線條件,詳細說明請參閱On Demand 速查。

Diagnostics 可用來進一步定位問題。整理資訊時,保留錯誤類型、發生步驟、目前模式和網路環境即可;向他人展示截圖或記錄前,請先檢查是否包含訂閱網址、密碼或驗證資訊。Settings 中還可看到 Proxy、TCP、UDP 等項目,它們不是遇到問題就必須全部修改的選項。遇到特定協定參數問題,請參閱協定詳解中相應欄位的說明,不要照搬其他協定的設定。

如果問題仍未解決,請依「是否成功匯入、開關能否維持啟用、Connectivity Test 結果、實際瀏覽狀況、Config 與 Proxy 對照結果」的順序整理記錄,再到疑難排解查找類似情況。保留原設定副本,每次只修改一項條件,並在驗證後決定保留或還原。這樣能避免設定越改越多,也方便日後更新資料時沿用相同的檢查順序。

Shadowrocket Settings 頁面,列出 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:測試方式、自動連線和診斷分別用於處理不同問題;先確認失敗環節,再前往相應設定。