官方手冊 · 首次連線

Shadowrocket 使用教學

使用現有訂閱或伺服器資料完成首次連線,並分別檢查分流選擇、伺服器回應與實際連線。

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

開啟 Shadowrocket,點選底部的 Home,再點右上角的加號進入 Add Server。先確認手上的資料類型:訂閱連結可取得一組項目;單一伺服器資料則對應一個項目,通常會依協定分別列出位址、連接埠和驗證資訊。首次設定只要選一種方式即可,不必同時匯入訂閱並手動填寫同一台伺服器。新增資料時,可先保持頂端連線開關關閉。

已有訂閱連結:選擇 Subscribe

在 Add Server 開啟類型選單,選擇 Subscribe,將完整訂閱連結貼到 URL 欄位。確認連結的開頭與結尾,尤其留意複製時是否包含空格、換行或旁邊的說明文字。不要刪除連結問號後方的參數,也不要將整個連結拆成伺服器位址和連接埠。儲存後返回 Home,查看 SERVER 清單中是否出現訂閱及其下的伺服器項目。若只看到訂閱名稱,沒有可選項目,請先確認該訂閱能否更新,再決定是否繼續。

已有單一伺服器:依照協定填寫

在 Add Server 選擇資料指定的協定,例如 Shadowsocks 或 VLESS,然後逐項填寫位址、連接埠及該協定要求的驗證欄位。位址欄只填資料指定的主機名稱或 IP 位址,連接埠則填在獨立欄位中。協定相關的傳輸與安全選項也應與資料一致;若缺少必要欄位,請先向資料提供者確認,不要用其他項目的值補上。儲存後返回清單,確認新項目是否出現。若有多個名稱相近的項目,可用容易辨識的備註區分,不要將密碼寫入備註。

無論使用哪種方式,下一步都是在 SERVER 中點選一台特定伺服器,並確認目前選取的是準備測試的項目。訂閱匯入成功只代表清單已載入,不代表伺服器可以連線;儲存手動填寫的項目也不代表驗證已通過。請先記住目前選取的名稱,接著選擇分流方式時保留這個項目,避免同時變更兩個條件。

2. 在 Global Routing 選擇設定檔、代理或直連

在 Home 點選 Global Routing,依照目前需求選擇設定檔(Config)、代理(Proxy)或直連(Direct)。這裡選擇的是連線建立後如何處理流量,不是選擇伺服器。切換分流方式不會修改已儲存的伺服器位址或訂閱連結。選好後返回 Home,先確認顯示的模式,再開啟連線。

模式流量處理方式適用情況
設定檔(Config)依照目前設定檔的規則和策略處理。確認日常分流是否符合設定。
代理(Proxy)由用戶端接管的流量透過代理傳送。暫時排除分流規則的影響,檢查代理路徑。
直連(Direct)由用戶端接管的流量直接連線,不經過代理伺服器。與代理路徑進行比較。

使用 Config 前確認目前的設定檔

底部的 Config 是查看和管理設定檔的位置;Global Routing 中的 Config 則是讓連線依照目前設定檔執行的選項。兩處名稱相同,作用不同。若已有準備使用的設定檔,請先前往下方的 Config 確認目前選取的是該檔案,再返回 Home 選擇 Global Routing 中的 Config。不要將剛匯入的訂閱當成分流設定檔:訂閱提供可選伺服器,設定檔則決定如何處理連線請求。

如果目前只想驗證伺服器能否運作,可以先用 Proxy 進行一次短暫測試,驗證後再切回原本預計使用的模式。使用 Direct 能開啟網頁,只能說明該請求可透過直連路徑完成,無法證明代理伺服器可用。反過來說,選擇 Config 也不代表每個網站都會經過代理;不同網域可能符合不同規則。首次測試先不要修改規則,只要記錄目前的選擇即可。

3. 開啟 Home 開關並允許 VPN 設定

返回 Home,確認 SERVER 的選取項目及 Global Routing 的目前模式。確認兩項正確後,點選頁面頂端 Not Connected 一側的連線開關。首次建立連線時,iPhone 或 iPad 可能會顯示新增 VPN 設定的系統提示。確認請求來自 Shadowrocket 後允許,並依照裝置提示完成驗證。驗證成功後返回應用程式,等待頂端狀態變更;系統提示尚未處理完成前,不要重複點選開關。

若先前取消了系統提示,可返回 Home 再嘗試開啟一次。若提示未再次出現,且開關也無法維持開啟,請先到系統設定確認 VPN 設定狀態;如果裝置由公司或學校管理,也要確認管理政策是否允許新增 VPN。若裝置上已有其他作用中的 VPN 連線,且可以自行管理該連線,請先中斷連線再測試。不要為了完成這個步驟刪除用途不明的設定,也不要關閉裝置的管理限制。

頂端顯示已連線,只代表用戶端的 VPN 連線已啟動;不等於訂閱更新成功,也不代表選取的伺服器已通過實際請求驗證。此時請保持目前的網路不變。例如,剛才使用 Wi-Fi 開啟連線,就先在同一個 Wi-Fi 環境完成下一步,不要一邊測試伺服器一邊切換到行動網路。如此一來,發生問題時才能判斷變化是來自網路、伺服器還是分流方式。

4. 使用 Connectivity Test 與實際連線進行驗證

在 Home 點選 Connectivity Test,等待測試完成,再查看目前選取伺服器對應的結果。清單中其他伺服器有回應,並不能證明目前使用的伺服器也有回應。若目前項目顯示逾時,請記下使用的網路、伺服器名稱和測試結果,不要只因一次逾時就刪除項目。測試結果只反映當下對測試目標的回應,不是所有網站連線情況的彙總,也不能根據回應時間推測下載速度。

接著開啟瀏覽器,用新分頁前往一個你知道運作正常、適合用來比較的網頁。等待頁面載入實際內容後再重新整理一次,避免將先前已開啟的頁面當成新請求。如果使用 Config,最好分別驗證一個預期經過代理的目標,以及一個預期直連的目標。驗證前先確認目標網域符合設定檔規則;同一個網站的首頁、登入頁和資源檔可能使用不同網域,因此只查看首頁能否開啟,不足以判斷整個網站的連線情況。

若結果與預期不符,保留伺服器和網路,只更換一種分流方式,再前往同一個目標。舉例來說,目前在 Config 下連線失敗,但在 Proxy 下可以開啟,應先檢查目前設定檔及該網域符合的策略;若 Proxy 和 Direct 都失敗,請先確認目標或目前網路是否正常。比較完成後,切回預計長期使用的模式並再次連線。記錄「開關狀態、測試結果、實際連線」三項,比只記錄單一延遲數值更有助於後續排查。

5. 依照問題發生的位置進行排查

先找出第一個未達預期的步驟:清單沒有項目、開關無法開啟、伺服器測試逾時,或測試有回應但網頁無法開啟。依序檢查,先解決前一個環節,再測試下一個環節。如果已能正常開啟頁面,只是某個目標不符合分流預期,不必先重新安裝應用程式或重做訂閱。

訂閱已儲存,但清單沒有伺服器

返回新增資料,確認儲存時選擇的類型為 Subscribe,且填入的是完整連結原文。檢查手上的連結是否比目前儲存的內容新,並在可正常上網的網路上嘗試更新。若仍無法取得項目,請向資料提供者確認連結是否有效,以及回應內容是否適用於用戶端。回報時可說明錯誤提示與發生時間,但不要在公開討論中貼上完整連結、驗證欄位或包含這些資訊的截圖。

開啟開關後立即關閉

返回連線步驟,確認是否已允許系統的 VPN 設定提示,以及裝置上是否有其他作用中的 VPN。先處理權限或衝突,再返回 Home 重新測試。若設定受到裝置管理,請記錄系統提示並聯絡裝置管理員確認。這個問題發生在啟動連線階段,修改伺服器連接埠或分流規則並非優先檢查項目。

伺服器逾時,或有回應但網頁無法開啟

先中斷 Shadowrocket 連線,確認目前的網路本身能否開啟一個通常可直連的網頁。如果連基本連線都失敗,請先處理網路登入、Wi-Fi 或行動網路問題。基本網路正常時,重新啟動 Shadowrocket,確認伺服器位址、連接埠與協定;如果自己的清單中還有另一台已知可用的伺服器,可在相同網路和模式下進行比較。只有一個項目逾時時,優先檢查該項目的資料與可用性;多個項目都失敗時,再考慮網路或設定的共同影響。

若 Connectivity Test 有回應,但實際連線失敗,請重新進行連線比較,確認問題是否只在 Config 下出現。若瀏覽器顯示網域名稱解析失敗,請記錄具體網域與提示,再參閱疑難排解手冊檢查 DNS 與規則;若只有某個網站的圖片或登入頁異常,請先記下發生問題的具體頁面。每次只變更一項;若沒有改善,請還原原值,再檢查下一個因素。