官方手冊 首次連線

Shadowrocket 使用教學:
訂閱匯入與首次連線

從現有連線資料開始,依序完成新增、選擇路由、連線授權與驗證。本文僅說明首次使用所需操作;規則欄位與比對原理請參閱設定參考。

如果已完成某個步驟,可直接跳至後續章節。排查時請盡量保留目前設定紀錄,每次只變更一項條件。

STEP 01 / IMPORT

Add Server:新增伺服器或匯入訂閱

開啟 Shadowrocket 後,先進入 Home。此處可查看伺服器清單、選擇目前使用的伺服器並控制連線。首次使用時,先確認手上的資料類型:完整的訂閱連結,或包含協定、伺服器位址、連接埠及認證欄位的單一伺服器資料。兩種方式擇一即可,開始連線不必同時完成兩套操作。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的新增入口,進入 Add Server,開啟 Type 並選擇 Subscribe。在 URL 欄貼上完整訂閱連結,為項目填寫方便辨識的備註,再透過頁面右上角的儲存入口完成新增。貼上後先確認網址開頭、結尾與查詢參數,尤其留意複製時是否多出空格或換行。

儲存後返回 Home,等待訂閱內容取得完成,再檢查訂閱群組及其中的伺服器項目。顯示訂閱名稱不代表伺服器內容已成功載入;請展開對應群組,確認其中有可選取的項目。若清單空白或出現取得錯誤,請先停在此步驟,檢查連結與目前網路,不要急著開啟連線開關。

更新訂閱會重新取得服務端發布的清單,不代表已建立連線。日後服務供應商調整伺服器資料時,可在對應訂閱的操作選單中執行更新,並檢查更新後的項目。清單變動可能會影響原有選擇,更新後請再次確認目前選取的伺服器。

已有伺服器資料:依 Type 填寫

如果取得的是單一伺服器參數,一樣從 Home 進入 Add Server,但 Type 應選擇資料指定的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan,而非 Subscribe。依所選 Type 顯示的欄位,填寫伺服器位址、連接埠、密碼或其他認證資料。欄位是否需要填寫,取決於協定與你已有的資料,不要從其他協定的範例任意補上數值。

伺服器位址與完整網頁網址並非同一概念。資料要求填寫主機名稱時,只填入對應的主機名稱;連接埠填入連接埠欄,認證內容則填入對應的認證欄。涉及 TLS、Server Name 或傳輸參數時,請依資料逐項確認,不要以關閉安全檢查取代修正參數。完成後儲存,返回 Home 確認項目是否出現。

已有 QR Code:使用 Scan QR Code

若已有資料以 QR Code 提供,可使用 Scan QR Code 掃描,並依系統提示授予相機權限。辨識完成後,仍須檢查匯入結果中的 Type、位址及必要欄位;成功辨識僅代表已讀取 QR Code 內容,不代表伺服器可正常連線。QR Code 與訂閱連結一樣,可能包含私人認證資料,請勿公開展示。

最後,在 Home 選擇準備使用的伺服器,確認清單中的選取標記位於目標項目上。完成這一步,連線資料才算準備就緒。接著先決定流量的處理方式,再啟動連線。

STEP 02 / ROUTING

Global Routing:選擇流量處理模式

返回 Home,點選 Global Routing 查看目前選擇。三種模式分別是設定檔(Config)、代理(Proxy)、直連(Direct)。它們決定請求如何選擇策略,不會變更伺服器位址或認證資料,也無法修復錯誤的訂閱連結。

設定檔(Config):依目前設定檔處理

Config 會使用目前啟用的設定檔,依規則判斷請求應使用 PROXY、DIRECT、REJECT 或設定檔指定的策略群組。準備使用此模式時,先進入底部的 Config 頁面,查看目前生效的設定檔。清單中只有一份檔案,不代表它已設為目前設定;請透過選取標記或目前設定狀態確認。

首次使用不必馬上編輯整份規則。若已有可信且符合自身需求的設定檔,先確認已啟用,再返回 Home 選擇設定檔(Config)。訂閱主要用於更新伺服器資料,設定檔則負責規則與其他設定,兩者內容不同;新增訂閱後,不代表分流規則也已設定完成。

代理(Proxy):先檢查伺服器連線

Proxy 會以代理模式處理請求,適合在首次連線時減少規則分流對判斷的影響。已有伺服器並想先確認是否可用時,可暫時選擇代理(Proxy),再進行後續連線與網頁測試。這不代表每個 App 或每種請求都會得到相同結果,也無法保證服務端一定可連線。

若在 Proxy 下可存取目標,但切回 Config 後相同目標失敗,請優先檢查目前設定、命中規則與策略群組選擇,不要立刻刪除伺服器。驗證完成後,依日常使用需求恢復合適模式,不必一直維持用於排查的選項。

直連(Direct):請求不經代理伺服器

Direct 會以直連方式處理請求,適合確認原有網路是否正常,或在需要直連的情境下使用。選擇直連(Direct)後,即使連線開關仍開啟,也不代表請求正經由所選的代理伺服器傳送。判斷結果時,必須同時檢視 Global Routing 與開關狀態。

選好模式後返回 Home,再次確認已選取正確伺服器。接著啟動連線,並完成首次使用時的系統授權。

STEP 03 / CONNECT

Home:開啟連線開關並完成首次授權

在 Home 確認已選取目標伺服器,且 Global Routing 符合本次測試目的,再開啟頂部的連線開關。首次建立連線時,系統可能會提示 Shadowrocket 新增 VPN 設定。先確認提示中的 App 名稱,再選擇允許,並依系統要求使用裝置密碼或生物辨識完成確認。

此提示是允許 App 建立系統網路連線設定,不是訂閱登入,也不需要在彈出視窗中輸入伺服器密碼。完成系統認證後返回 Shadowrocket,檢查開關與連線狀態;若授權流程中斷操作,可能需要再次開啟開關。不要只因系統提示消失,就認定連線已建立。

如果先前取消過授權,請再次開啟連線開關,並依出現的系統提示完成操作。若裝置由組織管理、設有設定限制,或系統明確顯示不允許修改相關設定,請先確認裝置管理要求,不要反覆刪除現有系統設定。授權問題與伺服器認證失敗屬於不同階段,應分別處理。

首次驗證期間,建議先關閉 On Demand,方便觀察手動開啟與關閉的結果。On Demand 會依指定條件觸發連線,並非提升連線品質的開關。確認手動連線、路由選擇與目標存取都正常後,再依實際需要了解其條件設定。

系統顯示 VPN 狀態或 App 顯示連線已開啟,只能代表相關連線狀態已建立,不保證遠端伺服器、DNS 與目標網站都正常運作。請勿在此時結束檢查;下一步應以實際請求驗證結果,並區分「開關已開啟」與「成功存取目標」。

停止使用時,可返回 Home 手動關閉連線,再檢查系統狀態是否隨之變更。若關閉後又自動連線,請先查看 On Demand 是否已啟用及其條件,不要立刻判定開關故障。On Demand 的完整說明,請參閱常見問題中的 On Demand 相關問題。

STEP 04 / VERIFY

Connectivity Test:驗證連線與流量分流

驗證應從原有網路開始。若目前 Wi-Fi 需要先完成網頁登入認證,請先在瀏覽器完成認證;使用行動網路時,則先確認行動數據連線正常。基礎網路本身無法使用時,反覆切換伺服器通常無法解決問題。請準備一個平時確定可存取的頁面,作為基礎網路的檢查對象。

先測試目前伺服器,再送出實際請求

返回 Home,使用 Connectivity Test 檢查伺服器連線狀況,並確認測試對象包含目前選取的伺服器。測試結果可協助判斷伺服器是否可連線,但實際結果會受測試目標、目前網路與伺服器狀態影響。一次測試有結果,不代表所有網站與 App 都能存取;一次逾時也不能單獨證明訂閱已失效。

接著開啟瀏覽器,前往已知可存取的目標頁面。為避免把快取頁面誤認為新請求成功,可重新整理頁面或重新開啟目標網址,並確認能否繼續瀏覽其他頁面。再用實際需要的 App 進行檢查,比只查看連線狀態更能判斷目前設定是否適用。

在 Config 下檢查命中策略

若使用設定檔(Config),請進一步查看 Logs 中與剛才請求相對應的紀錄,留意目標網域、命中規則及最終策略。請求命中 DIRECT 不一定是異常,也可能是目前規則預期的結果;同樣地,看到 PROXY 只代表選擇了代理策略,仍須依請求是否成功判斷。

若遇到「應經過代理卻改走直連」的情況,先檢查目前設定檔是否正確、是否有更前面的規則先命中,以及策略群組是否選取預期項目。規則通常依序比對,修改其中一條可能影響後續請求。首次使用時只要確認結果即可,不建議因一次異常就連續修改多條規則。

可進行一次條件明確的比較:維持相同網路、伺服器與目標,分別在 Proxy 與 Config 下重複送出請求。若只有 Config 失敗,應優先檢查規則與設定;若兩者都失敗,則繼續確認伺服器資料、基礎網路與服務端狀態。比較時一次只變更一項條件,結果才有參考價值。

STEP 05 / DIAGNOSE

常見問題:依發生階段逐項檢查

若前述驗證未通過,先記錄問題發生在哪個步驟,再依下列順序檢查。無法取得訂閱、無法建立伺服器連線、特定網站無法存取,分別涉及不同環節。一概歸為「Shadowrocket 無法連線」,會讓排查範圍過大,也容易誤改原本正確的設定。

訂閱未匯入:檢查 URL 與取得結果

返回對應的 Subscribe 項目,確認 URL 是否完整、有沒有混入說明文字,以及服務供應商提供的連結是否仍有效。用於在瀏覽器查看帳戶的頁面,不一定是可直接匯入的訂閱網址。若不確定連結類型或有效性,請向你的服務供應商確認,不要任意刪改查詢參數嘗試修復。

如果先前可以更新、現在卻無法取得,先確認目前網路可連線至訂閱網址所需的服務,再重試一次更新。查看錯誤屬於網路逾時、認證失敗或內容無法解析,有助區分網路問題與連結問題。尚未確認新連結有效前,不要刪除原有可用項目。

清單有項目但無法連線:檢查伺服器欄位

先確認選取的不是空白群組或錯誤項目,再逐一核對 Type、伺服器位址、連接埠、認證資料及必要的傳輸參數。手動輸入時,密碼大小寫、連接埠與 Server Name 特別容易出錯。若資料來自訂閱,請優先確認更新是否成功及服務狀態,避免手動修改後又被下一次更新覆蓋。

Connectivity Test 逾時時,若條件允許,可更換一次基礎網路作比較,但請維持伺服器與測試目標不變。若切換網路後結果不同,請記錄差異;若多個網路下都失敗,則進一步確認伺服器狀態。不要只因連線開關可以開啟,就排除服務端連線失敗的可能。

只有部分請求失敗:檢查路由、DNS 與 Logs

先確認 Global Routing 是否誤停在直連(Direct),再確認 Config 頁面啟用的是預期設定檔。若單一目標異常,請在 Logs 中找到對應請求,檢查是否命中 REJECT、非預期的 DIRECT 或不同策略群組。不要為了掩蓋設定中的具體問題,而長期將所有請求都改為 Proxy。

若紀錄顯示網域解析失敗,請將 DNS 視為獨立環節檢查:基礎網路是否正常、目前設定是否變更過解析設定、同一網域能否穩定解析。DNS 欄位彼此相關,不適合在首次連線教學中逐項試填。需要調整時,請前往設定欄位與規則參考,先了解目前設定,再逐項修改。

連線狀態反覆變動:檢查系統條件

確認是否剛從 Wi-Fi 切換至行動網路、是否尚未完成網路認證,以及 On Demand 是否觸發重新連線。若手動關閉後立即恢復,請先暫停按需條件,再觀察狀態。若裝置顯示授權或管理限制,請返回系統提示確認原因,不要當作訂閱失效處理。

仍無法定位時,整理目前的 Global Routing、所選伺服器的協定類型、失敗目標、錯誤原文與發生階段,再參閱常見問題與故障排除。整理紀錄時,請隱藏訂閱 URL、密碼、認證欄位與 QR Code 等私人資料;保留錯誤類別與必要背景即可。