01 新增伺服器或匯入訂閱
先確認手上的資料類型:可用來更新伺服器清單的完整連結,通常作為訂閱處理;包含協定、位址、連接埠及驗證資料的一組資訊,則作為單一伺服器處理。兩種方式都從 Home 的新增入口開始,但填寫內容不同。不要將訂閱網址填入 Host,也不要將單一伺服器位址直接填入 Subscribe。
已有訂閱:選擇 Subscribe
在 Home 點選 Add Server 或頂端的新增按鈕,進入 Add Server 後開啟 Type,選擇 Subscribe。在訂閱的 URL 欄位貼上自己的完整連結,檢查開頭、結尾及查詢參數是否完整,再填入方便辨識的名稱並儲存。連結中若含有空格、換行,或只複製了訊息的一部分,都可能導致匯入失敗。
儲存後返回 Home,等待伺服器清單載入;若沒有出現項目,請在對應訂閱的操作選單中更新,再查看是否有錯誤訊息。匯入成功的確認方式是:Home 中出現對應分組及其伺服器項目,且可以選取其中一項。只看到訂閱名稱,不代表已成功取得訂閱內容。
訂閱更新會依遠端內容調整清單。平時不要同時修改訂閱網址、伺服器欄位及設定檔;先確認清單能正常更新,再進行下一步。更新失敗時,請確認原連結是否仍有效、目前網路能否連上訂閱網址,以及回傳內容是否為應用程式支援的訂閱格式,而非網頁提示或登入頁面。
已有伺服器資料:逐項填寫 Add Server
手動新增時,先將 Type 設為資料所對應的協定,再填寫 Host 和 Port。接著依頁面顯示的欄位填寫 Password、Method 或該協定所需的其他驗證參數。不同 Type 的欄位並不相同:截圖中的 Password 與 Method 只是對應類型的範例,不能據此為所有協定填入相同參數。
Host 僅填寫資料指定的伺服器網域名稱或位址;Port 必須與伺服器實際監聽的連接埠一致。密碼有區分大小寫,複製時請留意前後是否有空格。若涉及 TLS、伺服器名稱或傳輸路徑,也應逐項對照原始資料,不要單憑網域名稱判斷。儲存前再次確認 Type,避免位址和密碼正確,卻選錯連線協定。
若已有對應的 QR Code,可使用 Scan QR Code 匯入,再檢查欄位。Import from Cloud JSON 僅適用於已備妥且格式相符的雲端 JSON 資料,並非所有訂閱連結都應從此處匯入。完成任一方式後,返回 Home 的 SERVER 分組,確認已儲存的伺服器可供選取,再前往設定 Global Routing。
02 選擇 Global Routing 與設定
伺服器決定代理連線使用哪一組遠端資料,Global Routing 則決定哪些請求交由它處理。返回 Home,點選 Global Routing,先分辨設定(Config)、代理(Proxy)與直連(Direct)三種模式。初次使用時,不要只確認開關是否開啟,也要確認此處的選項符合驗證目標。
設定(Config):依規則決定流量走向
日常需要依網域或位址分流時,請選擇設定(Config),再前往 Config 頁面確認目前使用的設定檔。Config 儲存的是規則與相關設定,不是訂閱伺服器清單;成功匯入訂閱,不代表已選取預期的設定檔。請分別檢查 Home 中的伺服器及 Config 中目前使用的檔案。
開啟設定檔的編輯頁面,可辨認 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。初次使用時,先確認目前檔案的來源及 Rule 的末尾策略,不要為了完成連線流程而修改所有區段。尤其不要將 HTTPS Decryption 當作首次連線的必要步驟;本頁的連線驗證不需要此設定。
以下片段僅說明比對方式,不需要直接取代現有檔案。規則通常由上而下檢查,第一條符合的規則會決定處理策略;前面的規則都未符合時,才會使用 FINAL。實際請求也會受到目前 Global Routing 模式及其他設定影響,不能只看單一規則就判斷整體連線結果。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
在這個片段中,example.com 及其子網域使用 PROXY;符合指定私有位址範圍的請求使用 DIRECT;其他請求最後交由 PROXY 處理。這些位址僅用於說明語法,並非可用的連線資料。修改既有設定前,請先保留副本,避免測試規則覆蓋原有設定。
代理(Proxy)與直連(Direct):用於路徑比對
代理(Proxy)會讓流量主要經由代理路徑處理,適合在排查時判斷問題是否與規則分流有關;直連(Direct)則用於比對目前網路直接存取的結果。兩者都無法修復失效的伺服器或錯誤的驗證參數。使用 Proxy 時若無法存取,應繼續檢查連線資料,而不是反覆切換模式,期待參數會自動變更。
確認模式後,返回 Home 並保持選取預期的伺服器。若只是暫時使用 Proxy 或 Direct 測試,結束後記得恢復日常所需的 Config。設定檔各區段、規則優先順序及策略說明,請參閱規則與設定欄位參考;初次使用時,先分清楚「伺服器、模式、目前設定」三者即可。
03 開啟連線開關並完成授權
現在返回 Home,在 SERVER 分組中點選準備使用的伺服器,確認選取標記位於預期項目上,再檢查 Global Routing。截圖頂端的 Not Connected 表示當時尚未連線;這只是狀態提示,不能以伺服器項目名稱或測試數值代替。
點選 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。請先閱讀系統對話框中的應用程式名稱與說明,確認這是剛才主動發起的操作,再依系統流程允許並完成裝置要求的驗證。此授權是讓系統將相應網路流量交由應用程式處理,不會替使用者補上伺服器位址或驗證資料。
完成系統授權後返回 Shadowrocket,確認頂端開關與狀態文字是否維持連線狀態。如果開關隨即關閉,或出現錯誤提示,請先記下提示內容,再檢查伺服器欄位,不要快速連續重複點按。若尚未完成系統授權,請重新發起連線並處理提示;若裝置受到管理策略限制,也需先確認相關限制。
連線狀態建立,只表示系統端已啟動網路處理,不代表目標伺服器和所有網頁都可正常使用。有些錯誤會在實際發出請求後才出現,例如密碼錯誤、遠端無法連線、網域解析失敗或規則走向不符。因此,完成此步驟後,務必繼續進行下一節的測試與實際存取。
需要停止時,可返回 Home 關閉頂端開關,並確認狀態已變更。首次驗證期間,先不要同時啟用新的自動連線條件,否則手動關閉後可能又重新連線,導致結果難以判斷。若已設定 On Demand,請先了解其觸發條件,再決定是否暫停自動行為;相關檢查方式請參閱本頁的設定與故障排除。
04 驗證連線與分流結果
驗證時要同時檢查三件事:系統連線是否維持、所選伺服器的測試是否完成,以及實際請求是否依預期處理。只看頂端開關、VPN 標示或單次測試結果,無法證明每個目標都能正常存取。請維持目前的網路環境,依下列順序檢查,才能將結果對應到具體設定。
先執行 Connectivity Test
在 Home 點選 Connectivity Test,等待測試完成,留意所選項目是否顯示結果或失敗提示。可在 Settings 的 Test Method 中確認測試方式;不同方式檢查的環節不同,因此某種測試成功,不代表實際請求一定成功;單一測試失敗也無法據此判定所有原因。
若測試失敗,先保留原始狀態,並檢查伺服器資料與基本網路。不要立刻大量刪除項目,也不要把測試結果當作訂閱有效期限的唯一依據。清單可否更新、位址能否連線、驗證能否通過,是不同層面的問題,需分別檢查。
接著檢查實際請求與策略
開啟瀏覽器,前往需要驗證的頁面,重新載入並觀察請求是否完成。若目前使用 Config,可在應用程式提供的請求紀錄或 Data 相關頁面中,依目標網域及請求時間尋找對應紀錄,確認實際使用的策略。具體入口依目前的應用程式介面而定,請勿將舊請求或其他應用程式的背景請求誤認為此次測試。
需要經過代理的請求,應確認是否符合 PROXY;預期直連的請求,應確認是否為 DIRECT;若符合 REJECT,應先確認該阻擋規則是否符合原設定意圖。使用 CDN 的頁面可能會請求多個網域;若部分資源載入失敗,應檢查該資源本身,而不只是網址列中的主網域。
若仍無法分辨是規則還是連線問題,可暫時從 Config 切換至 Proxy,重新送出相同目標的請求進行比對。Proxy 正常而 Config 失敗時,優先檢查規則、FINAL 與 DNS;兩種模式都失敗時,優先檢查伺服器與驗證資料。比對後恢復原模式,每次只變更一項條件,並記錄變更前後的結果。
05 設定檢查與常見問題
排查時依照「基本網路 → 資料 → 連線 → 模式 → 規則」的順序檢查。先儲存目前設定,記下問題發生在匯入、測試、連線還是實際存取階段;避免一次修改多個欄位,否則即使恢復正常,也難以確認是哪項設定產生作用。
清單未顯示項目:檢查匯入階段
先確認裝置目前可以正常連上網路,再檢查 Subscribe 中的完整網址,特別是連結末尾的參數。手動更新後若仍沒有伺服器項目,請確認遠端是否回傳有效的訂閱內容,以及自己的訂閱是否仍可使用。請保留錯誤提示原文;向他人說明時,則應隱藏訂閱網址中的驗證資訊。
已有項目但連線失敗時,重新開啟該伺服器的編輯頁面,依原始資料逐項檢查 Type、Host、Port 及驗證參數。若有其他傳輸設定,也要確認路徑、伺服器名稱等欄位。此處的目標是讓資料與原始資訊一致,而不是任意更換協定或加密方式。
開關已開但無法存取:分層定位問題
先執行 Connectivity Test,再檢查 Global Routing。若目前是 Direct,就不能用來驗證代理伺服器是否有效;若目前是 Config,應確認選取的設定檔是否正確,以及目標是否已被較前面的規則命中。FINAL 僅處理先前未命中的請求,無法覆蓋已符合 DIRECT 或 REJECT 的規則。
若伺服器測試有結果,但網域仍無法存取,請進一步檢查 DNS 設定及相關請求紀錄。不要把更換 DNS 當成所有問題的通用解法:驗證錯誤、遠端無法連線及規則阻擋都無法靠調整 DNS 解決。先記下目前的解析設定,確認問題確實出在網域解析後,再進行單項比對。系統化的檢查順序請參閱開關已開卻無法上網的逐項排查。
Settings:先檢查,不要一次大量變更
進入 Settings,可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等項目。Test Method 用於確認目前的測試方式;On Demand 用於管理依條件自動連線的行為;Diagnostics 用於查看或產生診斷資訊。這些項目的用途各不相同,初次使用不需要逐一修改。
若手動關閉後又自動連線,先檢查 On Demand 是否仍有符合條件的規則,不要立刻刪除應用程式。若只有特定應用程式或特定網路環境下失敗,請記錄 Wi-Fi 或行動網路、失敗目標及發生時間,再配合 TCP、UDP 等相關設定檢查。確認問題範圍後再查閱進階設定的具體說明,避免變更與故障無關的項目。
需要儲存 Diagnostics 資訊時,先確認其中是否包含伺服器位址、訂閱連結、驗證欄位或個人存取紀錄,分享前請先遮蔽敏感資料。可保留錯誤類型、發生順序及已執行的檢查項目;這些資訊比完整揭露連線資料更適合用於複查。
完成故障排除後,返回 Home,再次確認伺服器、Global Routing 及連線開關,並依驗證步驟重新測試。若要深入了解設定檔結構、DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL,請繼續閱讀設定欄位與規則參考;若要重新整理操作順序,從本頁的新增與匯入重新開始即可。