Shadowrocket 匯入訂閱與連線教學
以 iPhone / iPad 介面為例,依序完成新增、模式選擇、連線與驗證。先讓既有連線正常運作,再檢查規則和自動連線條件。
匯入內容 → 確認流向 → 驗證結果
Add Server:新增伺服器或匯入訂閱
先確認手上的資料是單一伺服器參數、QR Code,還是可更新的訂閱網址,再選擇其中一種方式操作即可。
已有訂閱連結:選擇 Subscribe
開啟 Shadowrocket 的 Home,在 SERVER 區域找到 Add Server,進入新增頁面。點選 Type 後選擇 Subscribe,再將自己的完整訂閱網址貼到對應欄位。儲存前從頭到尾核對一次,特別留意複製時是否帶入空格、換行或說明文字。訂閱網址可能包含身分憑證,不要改動其中看似隨機的字元,也不要將一般網頁網址當成訂閱連結。
完成後點選右上角的儲存按鈕,返回 Home,依照訂閱項目提供的更新操作讀取內容。更新成功後,SERVER 清單中應出現從訂閱解析出的伺服器項目。訂閱名稱本身只是群組或更新入口,不代表已選取可用伺服器;接著要在展開的清單中選取一個具體項目。如果儲存後清單為空,先檢查網址是否完整、目前網路能否取得訂閱,以及訂閱本身是否仍有效,不要立即重複新增相同網址。
已有單一伺服器資訊:依 Type 填寫欄位
如果手上有伺服器位址、連接埠和認證資訊,請在 Add Server 中選擇相符的 Type。不同協定顯示的欄位不同,不能因為都有 Host、Port 就互相套用。以 Shadowsocks 類型為例,Host 填入伺服器位址,Port 填入服務端指定的連接埠,Password 和 Method 必須與服務端一致。不要在 Host 中額外加入網頁路徑,也不要把伺服器顯示名稱填入位址欄位。其他類型出現的認證與傳輸欄位,也應依照自己已有的資訊逐項填寫。
儲存後返回 Home,檢查新項目的名稱與位址是否符合預期。顯示名稱可用來辨識用途,但修改名稱不會改變連線參數。遇到服務提供者同時提供多種協定資訊時,應選擇一組完整資訊填寫,不要混用其中一組的連接埠與另一組的認證欄位。如果無法判斷 Type,先核對原始設定說明再繼續連線,避免反覆嘗試填寫而掩蓋真正的欄位錯誤。
已有 QR Code:使用 Scan QR Code
在 Add Server 頁面可使用 Scan QR Code。首次啟用相機時,依照系統提示授予相機權限;掃描後仍須檢查解析出的 Type 和伺服器欄位,再儲存。QR Code 應來自自己的設定資料,與明文連結一樣可能包含憑證。Import from Cloud JSON 是另一個結構化匯入入口,不是所有訂閱網址都適用的貼上位置。完成一種匯入方式後即可進入下一步,不必為同一台伺服器重複掃描和手動輸入。
進入下一步前:Home 的 SERVER 中已有具體伺服器項目,且能辨認準備使用的項目。
Global Routing:選擇流量處理模式
伺服器決定可用的代理連線,Global Routing 決定流量的處理方式,兩者需要分別確認。
匯入完成後返回 Home,點選 Global Routing。初次使用先熟悉三種常用模式:Config / Proxy / Direct。不要只憑選項名稱判斷連線是否成功;選擇模式只是設定處理方式,仍須選取伺服器並開啟連線開關。排查期間記下原本的模式,暫時更改測試後再恢復,避免將測試用設定當成長期設定。
Config:依照所選設定檔執行
Config 會根據目前設定檔中的規則判斷請求流向。進入底部的 Config 頁面,確認所需設定檔已匯入並選取;僅將檔案保存在清單中,不代表它已成為目前使用的設定。開啟設定檔可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。初次使用只需確認所用檔案與規則來源符合自己的用途,不要為了成功連線而一次啟用所有進階功能。
Rule 中的規則通常依序比對,較具體的條件與預設條件的位置會影響結果。PROXY、DIRECT、REJECT 是處理流向,不是三個伺服器名稱。例如 DOMAIN-SUFFIX,example.com,PROXY 表示符合對應網域後綴時使用代理策略,而 FINAL,DIRECT 會將前面未符合的請求交由 DIRECT 處理。此處的網域僅用於說明語法,不需要將它加入自己的設定中。如果使用既有設定,先保持規則不變,再透過請求記錄檢查實際命中情況。
Proxy 與 Direct:用於比對檢查
Proxy 可用來檢查所選伺服器的代理連線是否正常,方便將伺服器問題與 Config 中的分流問題分開。Direct 則會讓請求直接連線,適合比對目前網路本身是否可用;選擇 Direct 不代表已驗證代理伺服器。三種模式的結果不應混為一談:在 Proxy 下能夠存取,不能證明 Config 中的規則順序正確;在 Direct 下能開啟網頁,也不能說明訂閱中的伺服器可用。
建議先用所需模式完成一次連線驗證。如果只有 Config 下出現異常,再核對目前檔案、相關規則與實際命中策略,而不是直接刪除整份設定。協定欄位的意義與選擇依據請參閱協定參考;如有規則方面的具體問題,可繼續查看FAQ,本頁則保留首次連線所需的操作順序。
進入下一步前:已確認目前 Global Routing 的選擇;使用 Config 時,也已確認目前設定檔。
Home:選取伺服器並開啟連線
先選取項目,再開啟頂端開關,最後檢查系統授權與連線狀態。
返回 Home,在 SERVER 清單中點選準備使用的伺服器,確認選取狀態位於具體伺服器上,而不只是展開訂閱群組。首次測試盡量固定使用同一台伺服器,避免一邊切換模式一邊更換項目,否則之後無法判斷是哪次修改造成影響。如果清單較長,先依照自己儲存的名稱辨認項目;不要因為名稱相似就認定參數相同。
確認 Global Routing 後,開啟 Home 頂端原先顯示 Not Connected 附近的連線開關。首次連線時,系統可能會提示允許新增 VPN 設定,這是用戶端接管裝置網路流量所需的系統授權。確認提示確實由目前操作觸發後再允許,並依照系統要求完成裝置驗證。如果拒絕授權,伺服器項目雖然仍在清單中,連線程序也可能無法繼續;應重新操作並檢查系統中的 VPN 設定狀態。
返回 Shadowrocket 後,觀察頂端狀態是否離開 Not Connected,並確認開關能維持開啟。系統 VPN 標示可作為設定已啟用的輔助資訊,但不能單獨證明目標網站可存取。不要因為剛出現標示就反覆關閉再開啟,也不要在狀態尚未穩定時連續切換伺服器。如果開關立即關閉或一直無法連線,先保留目前參數,前往本頁的失敗原因排查,區分授權問題與伺服器連線問題。
測試時也應檢查裝置是否已有其他 VPN 連線占用系統通道,必要時先中斷其他連線,再返回 Home 重試。如果之前啟用 On Demand,手動中斷後可能會因觸發條件而重新連線,容易誤以為開關沒有反應;排查期間可先記下原本設定,暫時關閉相應的自動觸發,待手動連線驗證完成後再恢復。
連線成功後先不要調整設定檔。接著直接進行 Connectivity Test 和實際存取檢查,使用相同伺服器、相同模式取得一組可比較的結果。儲存項目、選取項目和開啟連線是三個不同動作,缺少任何一步,都可能出現「清單中有伺服器但實際未使用」的情況。
進入下一步前:已確認伺服器選取、模式選擇與連線狀態,且沒有其他連線干擾本次測試。
Connectivity Test:驗證連線與規則結果
分開檢查「測試有回應」、「網頁可存取」與「策略符合預期」,避免只看單一結果。
先執行測試,再檢查實際請求
在 Home 點選 Connectivity Test,等待本次測試完成。測試結果用來觀察所選測試方法對應的連線情況,不代表所有 App、所有網域和所有傳輸方式都正常。如果要比較兩次結果,應維持相同的 Test Method 與網路環境;不同測試方法的結果意義不同,不宜直接比較數值,更不能只依靠單一測試結果判斷伺服器的長期表現。
接著開啟瀏覽器,造訪需要驗證的頁面,必要時重新載入。只看到先前開啟的頁面不能作為可靠依據,因為頁面內容可能來自快取。可分別檢查一個預期為 DIRECT 的一般請求和一個預期為 PROXY 的請求,觀察結果是否符合設定目的。選擇的目標應是自己確實需要存取的內容;若某個目標暫時無法使用,可換另一個目標比對,先排除目標網站本身的異常。
在 Data 中比對實際策略
返回用戶端,在 Data 中查看可用的請求記錄。找到剛才造訪的網域,搭配記錄中顯示的規則或策略資訊,判斷請求使用了 PROXY、DIRECT 還是 REJECT。如果沒有看到預期記錄,先確認 App 仍處於連線狀態、頁面確實發出了新請求,以及檢視的記錄範圍是否正確。不同版本的顯示細節可能不同,應以目前介面可見欄位為準,不要將找不到某個欄位直接視為網路故障。
如果請求實際使用 DIRECT,但預期是 PROXY,應優先檢查 Global Routing 是否仍為 Config,以及目前規則為何命中 DIRECT。反之,如果請求已使用 PROXY 卻仍無法存取,就應檢查所選伺服器、相關傳輸參數或目標可達性,而不是不斷新增相同網域規則。能將問題定位為「未命中預期策略」或「命中後連線失敗」,就能大幅縮小後續排查範圍。
記錄本次使用的網路、伺服器名稱、Global Routing 和具體狀況即可,不需要公開完整訂閱或密碼。測試完成後,將暫時切換的 Proxy 或 Direct 還原為日常所需模式,再進行一次實際存取驗證。如此既能確認連線,也能確認最後保留的設定,避免測試結束後仍停留在不符合日常用途的模式。
完成標準:連線開關維持開啟,實際請求可完成,需要分流的請求命中預期策略。
Settings:依照失敗位置逐項排查
每次只修改一個變數,重新測試後再繼續。先檢查可直接核對的資訊,再考慮進階設定。
訂閱內容空白或更新失敗
先檢查訂閱是否完整貼上、是否填在 Subscribe 對應的網址欄位,以及目前網路能否取得這份訂閱。伺服器已存在但更新失敗,與首次匯入時沒有任何項目是兩種情況:前者先保留現有項目和設定,後者應著重核對網址與訂閱格式。不要為了觸發更新而反覆新增相同訂閱,也不要在沒有備份時先刪除所有內容。必要時向自己的服務提供者確認訂閱狀態,但不要將完整網址貼到公開討論區。
連線開關無法維持開啟
確認首次 VPN 授權是否已完成,再檢查裝置系統中的 VPN 設定及其他正在執行的連線。如果出現系統提示,應先看清楚具體內容,而不是連續重複操作。伺服器參數錯誤也可能造成連線失敗,此時返回 Add Server 對應項目的編輯頁,逐項比對 Type、Host、Port 和認證欄位。伺服器名稱相似、網域相同或表單成功儲存,都不能取代參數核對。
已連線,但網頁仍無法開啟
先測試目前 Wi-Fi 或行動網路本身是否正常,再比對 Proxy 與 Config 的狀況。如果 Proxy 正常、Config 異常,請檢查目前設定檔和規則命中情況;如果兩者都失敗,先檢查伺服器資訊及伺服器可用性。如果只有個別網域失敗,可搭配 Data 記錄檢查 DNS 與目標請求,而不是立即修改所有 DNS 設定。需要深入了解協定欄位時,請前往協定參考並依使用的 Type 閱讀,避免在無關欄位上反覆嘗試。
測試失敗,或中斷後又自動連線
進入 Settings 查看 Test Method,確認所用的測試方法後,再返回 Home 重新執行 Connectivity Test。測試有回應但網頁無法使用時,應根據實際請求繼續排查;測試失敗但網頁可存取時,則應先區分測試目標與測試方法,而不是直接判定整個連線不可用。如果切換網路後連線狀態自動改變,請檢查 On Demand 的觸發條件與順序,暫時停用相關條件進行手動比對,再恢復所需的自動連線設定。
Settings 中的 Diagnostics 可用於進一步定位問題,但診斷輸出可能包含網域、位址或設定線索,分享前應檢查並移除敏感內容。不要同時修改 Proxy、TCP、UDP 等多組設定;先保留原值,確認具體狀況後再進行對應調整。一般連線驗證也不需要啟用 HTTPS Decryption 或安裝憑證,以免在初次使用流程中引入額外變數。
如果問題仍然存在,請整理「在哪個步驟失敗、使用哪種模式、目前網路類型、測試與實際存取的結果」四項資訊,再查看FAQ 中的匯入、規則與故障排查說明。比起只描述「無法使用」,這些資訊更有助於區分設定、系統授權、網路與伺服器問題,也能避免不必要的重新安裝與重複匯入。