OFFICIAL MANUAL / SETTINGS
Shadowrocket 設定指南
從設定的作用範圍開始,依序查閱 DNS、On Demand、Global Routing、連線測試、Log、同步與本機連接埠。
本頁是 Shadowrocket 官方手冊的系統設定查閱內容,適合已匯入自己的訂閱或伺服器資訊,並想確認某項設定是否需要修改的使用者。第一次連線請先閱讀入門指南,依照匯入、選擇模式、連線和驗證的步驟完成操作;遇到特定設定問題,再回到本頁相應章節查閱。兩頁各有用途,初次使用前不必修改所有選項。
Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 和 Linux;本文以 iPhone / iPad 常見介面用語編排,其他平台請以實際顯示的選項為準,不假設各平台功能完全相同。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。一次性購買客戶端不等於購買線路方案。本網站不提供、不銷售,也不推薦節點或訂閱。
SETTINGS / SCOPE
設定範圍、初始狀態與建議基準
先確認設定儲存在哪個層級
同一個連線結果可能同時受到 Settings、目前的 Config、所選伺服器及系統網路狀態影響。Settings 中的偏好設定不等於設定檔中的指令,訂閱項目的參數也不等於全域開關。例如,伺服器位址和驗證資訊屬於連線項目,規則比對屬於目前的設定檔,而系統是否允許建立 VPN 連線則屬於系統權限。排查前先記下正在編輯的層級,避免在錯誤位置反覆調整,也避免將匯入後的變化誤認為應用程式自動修改了所有設定。
本文所說的「初始狀態」,是指首次開啟或尚未自行修改時實際顯示的值,不會把建議值說成固定的出廠預設值。不同系統、匯入的設定檔及既有同步資料,都可能讓目前狀態有所不同;升級後也可能沿用先前的選擇。若無法確認預設值,先截圖記錄這台裝置目前的值,再檢查正在使用的 Config 是否宣告了對應參數。不要只因選項名稱相似,就認定介面設定和設定檔一定有統一的覆寫順序。
建立可還原的最小基準
修改前先儲存目前設定檔的副本,記錄 Global Routing、所選伺服器、連線開關和目前網路。已有的訂閱連結、密碼與金鑰應存放在自己掌控的安全位置,不要放進要分享的截圖。保留原本可正常連線的項目,只在副本中驗證新規則;如果原本就無法連線,則保留原始狀態作為比較基準。備份的目的在於能還原實際輸入的內容,而不只是記得「之前好像開了哪些選項」。
建議基準:使用已確認有效的伺服器資訊,暫時不要加入用途不明的進階參數,維持單一且容易理解的 Config,先在穩定網路下手動連線。DNS 可先觀察系統解析是否正常,On Demand 暫不加入複雜條件;排查時再將 Log 開到足以判斷問題的層級。這些建議是為了方便定位問題,不代表所有裝置的預設值都相同,也不要求長期關閉已驗證有效的功能。
| 作用層級 | 常見內容 | 修改前記錄 |
|---|---|---|
| 連線項目 | 位址、連接埠、協定、驗證參數 | 原項目副本與服務端要求 |
| Config | General、Rule、Host | 目前生效的檔案與規則順序 |
| Settings | 測試、Log、同步等偏好設定 | 目前選項與實際顯示的說明 |
| 系統 | VPN 權限、網路、雲端帳戶 | 網路類型與權限狀態 |
每次只變更一個可驗證因素
每次測試只修改一個變數,並先訂出成功條件。例如,修改 DNS 後,檢查先前無法解析的網域是否能正常解析,而不只是看連線開關是否仍然開啟。每次測試使用相同目標、相同網路和相同伺服器,記錄結果後再決定是否保留修改。若同時更換伺服器、路由模式和解析器,即使恢復連線,也無法判斷真正有效的是哪項變更,日後遇到類似問題便難以重現。
介面位置和系統功能可能因平台而異。若裝置上找不到手冊提到的選項,請勿用名稱相近的其他選項代替,也不要在設定檔中加入未確認的鍵。先確認使用的平台,再檢查目前頁面是否為 Settings,而非伺服器編輯頁。各平台的客戶端下載與系統允許步驟請見全平台下載頁;設定問題應在安裝完成且應用程式能正常開啟後處理,不應試圖用網路參數解決安裝權限問題。
SETTINGS / DNS
DNS:解析路徑與本機對應
先判斷問題出在解析還是連線
DNS 會將網域名稱轉換成網路位址,但取得位址不代表後續連線一定成功。網域請求失敗可能發生在解析階段,也可能是已取得位址卻無法建立連線。先從 Log 確認是否有解析結果,再查看連線使用的位址、目標連接埠和策略。如果把所有逾時都歸因於 DNS,頻繁更換解析器只會增加變數;伺服器驗證失敗、目標服務沒有回應或規則選錯策略,都不會因更換解析器而自行排除。
需要區分三種網域:瀏覽器要存取的目標網域、Proxy 伺服器本身的網域,以及訂閱連結的網域。它們可能在不同階段使用不同的網路路徑。尤其伺服器位址本身是網域名稱時,建立 Proxy 連線前就可能需要先完成解析,不能簡單認為「連線後所有解析都經過 Proxy」。如果只有伺服器網域無法解析,應先檢查目前網路和服務商提供的資訊,再討論目標網站的 DNS 行為。
了解 dns-server 與 system
設定中的 dns-server = system 表示使用系統提供的解析來源,不代表預設使用某家公共解析服務,也不表示解析一定會經過指定伺服器。系統解析結果可能隨 Wi-Fi、行動網路或網路管理策略而變化。排查時從系統解析開始,有助於保留目前網路原有的行為;若 Log 已顯示系統解析異常,再依實際需求設定可信且目前網路可連線的解析來源,並比較相同網域的結果。
[General]
dns-server = system
[Host]
localhost = 127.0.0.1
這段範例只展示區段名稱與參數,並非完整的網路設定方案。加入現有 Config 前,先搜尋是否已有同名區段或重複鍵,避免在檔案末尾重複新增後,誤判實際生效的內容。若已設定其他解析方式,請確認應用程式目前支援的位址格式、傳輸方式,以及該解析服務的說明。不要混淆一般網域、完整網頁網址和解析伺服器位址,也不要為了測試一次填入一長串來源。
Host、快取與 IPv6 的適用範圍
Host 對應可明確指定名稱與位址的關係;它無法修復目標伺服器憑證,也不會改變應用程式層的驗證方式。範例中的 localhost 是本機回送名稱,不應改成 Proxy 伺服器位址。如果曾為某個網域設定固定對應,目標遷移後舊位址仍可能影響存取,因此排查時也要檢查目前 Config 的 Host 區段。刪除對應前先儲存副本,以免一併移除使用者有意設定的內部網域名稱。
快取可能讓連續測試的結果看起來互相矛盾。應用程式、系統和目標程式都可能保留先前的結果;修改後應依目前平台提供的方式清除相關快取,或結束目標程式並重新送出請求,再查看新產生的記錄。不要只靠反覆重新整理同一個頁面判斷設定是否生效。若涉及 IPv6,也要確認網路具備有效的 IPv6 連線能力;解析出 IPv6 位址和透過該位址成功連線,是兩個不同條件。
| 觀察到的現象 | 優先檢查 | 下一步 |
|---|---|---|
| 沒有解析結果 | 解析來源與網路連線狀態 | 在相同網路下改用對照網域 |
| 已取得位址但連線逾時 | 策略、目標連接埠與位址類型 | 檢查對應的連線記錄 |
| 只有少數網域異常 | Host、快取與精確規則 | 撤銷對應的單項修改 |
建議設定以能說明原因並經過驗證為準:系統解析正常就先保留,確有需求時才新增自訂解析設定。初始值以這台裝置目前的 Config 和 Settings 為準,不保證所有平台一致。驗證時記錄網域、解析結果、時間和網路環境;分享結果前遮蔽內部網域及伺服器資訊。若解析成功但仍無法存取,請接著查閱本頁的路由和 Log 章節,而不是繼續堆疊 DNS 參數。
SETTINGS / ON DEMAND
On Demand:條件式連線與手動中斷
按需連線與規則分流屬於不同層級
On Demand 會依系統支援的網路條件觸發連線行為;Rule 則決定連線中的請求應採用哪種策略。前者回答「何時建立連線」,後者回答「連線後如何處理請求」。因此,開啟 On Demand 不代表所有請求都會走 Proxy,關閉它也不代表設定中的規則已刪除。排查時應分開觀察連線狀態和流量策略,否則容易把按條件重新連線誤判為規則失效,或把直連規則誤認為 VPN 沒有建立。
On Demand 的實際條件、設定位置和可用程度會因平台而異。本文主要說明 iPhone / iPad 上的使用方式,不會把某個系統的條件清單說成所有裝置都具備的固定功能。初始狀態以裝置目前顯示為準;舊的系統 VPN 設定、同步還原或先前手動修改都可能影響觀察結果。首次設定前先關閉自動觸發,確認手動連線、中斷及目標存取都符合預期,再逐步加入條件。
先說明需要的網路行為
設定前先用一句話描述目標,例如:「在指定 Wi-Fi 下不自動連線,切換到其他網路時依既定條件連線。」接著列出實際使用的各種網路,包括家中 Wi-Fi、公司 Wi-Fi、行動網路,以及需要網頁認證的網路。只設定可明確辨識且確實需要區分的條件,不要把名稱相似的無線網路視為同一個網路,也不要把 Wi-Fi 名稱當成可信的身分憑證。
逐項設定時,先儲存一個條件並測試網路切換,再新增下一個條件。測試時應等待系統完成網路切換,不要在訊號尚未穩定時連續點選連線開關。記錄切換前後的網路、應用程式中的連線狀態,以及系統 VPN 狀態;綜合這三項判斷,比只看狀態列圖示可靠。如果兩個條件可能重疊,應依實際介面說明確認優先順序,不要假設它一定採用與 Rule 相同的比對順序。
釐清「剛中斷又重新連線」
手動中斷後很快又重新連線,應先檢查 On Demand 是否仍符合觸發條件。系統依條件重新建立連線,和按鈕失靈是不同情況。若要長時間中斷、排查其他 VPN,或處理網路認證,可以先停用按需觸發,再中斷連線並確認系統狀態隨之改變。完成後依需求恢復原有條件;不要只是不斷點選開關,因為每次重新觸發都會影響故障時序的觀察。
需要網頁認證的網路應另外處理。連上 Wi-Fi 不代表已能正常存取網路,可能還需要在系統彈出的頁面完成認證。認證完成前自動連線可能失敗,也可能讓認證入口不易顯示。遇到這種情況,先停用自動觸發、完成該網路要求的認證並確認一般網路可用,再手動連線。不要用修改 DNS、規則或連續重試取代網路本身要求的認證步驟。
一併檢查系統權限與休眠後恢復
取得系統 VPN 授權後,應用程式仍可能受到裝置管理政策或其他網路工具影響。若系統拒絕連線,請查看系統提示和已安裝的 VPN 設定,確認是否有衝突,而不是在應用程式中尋找不存在的規則例外。受管理裝置的限制應由裝置管理者處理,不要靠刪除不明系統設定來試錯。也不要將桌面系統的背景執行選項照搬到 iPhone / iPad 的 On Demand 設定中。
設定完成後,至少檢查一次鎖定螢幕再解鎖、Wi-Fi 與行動網路切換、手動中斷及重新連線。如果只有恢復網路時發生異常,記下發生時間並查看同一時段的 Log,分辨是網路尚未就緒、解析失敗,還是連線遭到拒絕。長期保留的建議設定,不是條件越多越好,而是保留已驗證且用途明確的條件。若要重新確認基本操作,請回到入門指南,先完成手動連線流程。
CONFIG / GLOBAL ROUTING
Global Routing 與 Config 的生效關係
先確認目前模式,再判斷規則結果
Global Routing 常見的三種模式為設定檔 Config、代理 Proxy、直連 Direct。Config 依目前設定檔處理請求,適合日常分流;Proxy 可用來對照整體走代理時的結果;Direct 則用於對照直連情況。它們是路由行為的選擇,不是伺服器協定,也不是網路速度等級。存取結果不如預期時,先確認目前模式,不要只盯著 Config 中的某條規則,就認定應用程式執行錯誤。
| 模式 | 查閱重點 | 常見用途 |
|---|---|---|
| 設定檔 Config | 目前檔案、策略名稱與比對順序 | 驗證依規則分流 |
| 代理 Proxy | 所選伺服器與 Proxy 連線狀態 | 排除部分規則因素 |
| 直連 Direct | 目前網路的直接存取能力 | 建立直連對照結果 |
不要憑記憶推斷初始模式,尤其更換裝置或還原資料後,應直接查看 Home 中目前的選擇。建議在確認伺服器有效後使用 Config,並保留結構清楚的設定檔;暫時使用 Proxy 或 Direct 對照後,記得恢復日常使用的模式。如果介面也提供 Scene 等入口,請依該入口的實際功能另外確認,不要將它和本文的三種模式測試混為同一個開關。
Rule 依序由上往下比對
使用 Config 時,規則會依序比對,第一條符合的規則會決定該請求採用的策略。因此,較精確的 DOMAIN、DOMAIN-SUFFIX 通常應放在較廣泛的兜底規則之前,FINAL 則放在最後。規則中的策略名稱必須在目前設定檔中有實際定義;下方的 PROXY 只是需要關聯代理策略的範例,複製這個單字不代表伺服器已建立連線。使用範例前,請確認自己的設定檔結構和策略名稱。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT
這段範例展示網域後綴、網域關鍵字、IP 網段、地理位置和最終規則的排列方式,並非適用所有人的完整設定。DOMAIN-SUFFIX 會比對指定網域及其子網域;DOMAIN-KEYWORD 的涵蓋範圍較廣,可能影響名稱中含有該字串的其他網域。IP-CIDR 用於 IP 網段,GEOIP 則依賴可用的地理位置資料;兩者都不能簡單取代依業務網域撰寫的精確規則,也不保證某項服務永遠使用相同位址。
修改規則後,驗證新請求
儲存設定檔和選取設定檔是兩回事。編輯檔案後,請確認它就是目前使用的 Config,再依介面要求重新載入或重建連線。既有的長連線不一定會立刻依新規則改走其他路徑;驗證時應關閉目標應用程式的舊連線並送出新請求,再從 Log 確認目標與策略。只看到網頁仍然開啟,不足以證明新規則已生效,因為頁面可能來自快取或沿用原有連線。
若同一個應用程式部分內容正常、部分異常,通常應分別檢查它所請求的網域,而不是替應用程式名稱編寫一條想像中的通用規則。登入、圖片、API 和媒體內容可能來自不同目標。先從 Log 找出失敗的請求,再選擇足夠精確的比對方式;不要只為修復一個網域就加入涵蓋過廣的關鍵字。USER-AGENT 等比對方式也有適用條件,不能假設每種流量都會提供相同且可供比對的資訊。
建議的還原方式是切回已儲存的 Config,而不是繼續在檔案底部加入相反規則。想了解 General、Rule 與 Host 的完整結構,請參閱設定檔區段說明。如果使用 Proxy 對照時能存取、使用 Config 時卻不行,優先檢查命中的策略;兩者都失敗時,再檢查伺服器和網路。依此順序排查,可區分規則問題和連線問題,減少反覆修改。
TOOLS / CONNECTIVITY TEST
Ping 與 Connectivity Test 的測試結果
測試結果只回答相應的問題
不同測試方式下,Ping 測量的對象並不相同。有些方式可能只確認主機或連接埠是否回應,另一些則可能包含協定交握或測試請求。先查看目前測試方式的實際說明,再解讀時間和失敗狀態,不要把所有數值都當成完整的網頁載入時間。主機有回應不代表驗證參數正確,Proxy 交握成功也不代表特定目標的服務介面一定可用。
Connectivity Test 用來驗證特定測試條件下的連線狀態。測試位址、逾時時間、所選伺服器、DNS 和目前網路都會影響結果。初始測試方式和位址以裝置目前顯示為準,本文不指定未經確認的通用預設網址。建議先保留目前可理解的設定,選用自己確認穩定、回應單純的測試目標;發生失敗時記錄錯誤類型,不要只把紅色或空白狀態解讀為伺服器永久失效。
分開觀察延遲、傳輸量與穩定性
延遲是一次往返或操作所花的時間;傳輸量是持續傳送資料的能力;穩定性則需要多次觀察。一次較低的數值不代表下載一定較快,一次逾時也不代表之後所有請求都會失敗。小型請求容易受到網路瞬間排隊、裝置休眠後恢復及網域快取影響。比較伺服器時,盡量使用相同測試方式、相同目標和相近的時間區間,避免把不同條件下的結果混在一起排序後,推論長期表現。
逾時時間太短,可能將暫時較慢但有效的連線判定為失敗;太長則會拖慢故障排查。建議先使用目前合理的設定,只有在 Log 顯示交握時間經常接近逾時門檻時才調整,並記錄調整前後的成功率。不要無限延長逾時時間來掩蓋持續遭拒的連線或驗證錯誤。測試間隔也應適度,密集連續測試會增加裝置和網路負載,也可能觸發伺服器限制,影響後續結果。
| 測試現象 | 可能代表 | 不能直接推論 |
|---|---|---|
| 主機有回應 | 對應的探測路徑可連線 | Proxy 驗證與目標存取正常 |
| 交握失敗 | 協定或連線階段異常 | 一定是 DNS 故障 |
| 測試請求成功 | 該目標在當時可連線 | 所有網站和應用程式都正常 |
| 偶發逾時 | 曾發生瞬間失敗 | 伺服器已長期無法使用 |
將測試拆分成可定位的階段
先確認目前網路是否正常,再核對訂閱項目中的位址、連接埠和協定是否符合服務商提供的資訊。接著確認伺服器網域能否解析、連線能否建立、驗證是否通過,最後才測試目標請求。每個階段都應透過相應記錄確認,不要跳過驗證階段就直接修改分流規則。若協定需要額外的傳輸或安全參數,請逐項核對服務端要求,不要直接套用其他項目的參數。
若出現「測試成功但應用程式無法開啟」,應回頭檢查實際應用程式送出的請求。測試目標可能採用不同規則,也可能只連到簡單的測試位址,而實際應用程式還需要存取多個網域。檢查 Global Routing 和命中策略,並在 Log 中查看失敗目標。反之,測試位址本身無法連線時,實際服務仍可能正常;此時應更換測試目標,不要刪除已驗證可用的伺服器資訊。
如果所有項目同時失敗,優先檢查共同因素:目前網路、系統 VPN 權限、測試目標和 DNS。只有單一項目失敗時,再核對該項目的輸入和服務端狀態。不要以重新排序清單當作修復方式,也不要在結果波動時反覆更新訂閱,覆蓋現場資訊。常見錯誤的簡短問答請見常見問題;本頁的 Log 章節說明如何將測試結果對應到實際連線過程。
SETTINGS / LOG AND DATA
Log 與 Data:定位請求,不要堆積記錄
重現問題前先設定 Log 範圍
Log 的作用是將一次失敗放回具體的時間順序中,不是記錄越多越好。啟用前先寫下要確認的問題,例如「網域是否成功解析」、「命中哪條規則」或「交握在哪個階段失敗」。不同平台和介面提供的記錄層級可能不同,預設層級以目前設定為準。建議只使用足以回答問題的最低必要層級;一般記錄資訊不足時,再暫時提高詳細程度,排查完成後恢復日常設定。
重現問題前先記錄目前時間、網路類型、Global Routing、Config 名稱,以及所選伺服器的本機備註。如果 Log 已累積太多,先確認不需保留後再清除,接著只執行一次最簡單的操作,例如開啟一個無法存取的頁面。不要同時啟動多個應用程式、執行速度測試和更新訂閱,否則大量請求會混在一起,難以將同一秒內的失敗逐一對應。裝置時間不準時,也應先校正再比對記錄。
依解析、策略、連線的順序閱讀
閱讀時先找出目標網域或位址,再查看是否有解析結果,接著確認實際採用的策略,最後檢查連線和驗證結果。如果目標完全沒有出現在記錄中,可能是請求未送出、目標程式使用了快取,或目前記錄範圍未涵蓋該請求;不能直接認定客戶端丟棄了請求。請結束目標程式、重建連線並重新測試,再核對系統 VPN 狀態和應用程式開關是否一致。
發生逾時時,應判斷是解析、建立連線,還是等待目標回應時逾時;遭拒絕連線時,請核對目標連接埠和服務端監聽狀態;出現驗證或安全交握錯誤時,則檢查協定參數、系統時間和服務端要求。錯誤訊息相似,不代表根本原因相同。不要為了消除提示而任意降低安全驗證要求,也不要傳送包含完整驗證資訊的記錄;先擷取足以說明失敗階段的最小片段。
Data 統計的意義與限制
Data 中的流量統計可用來觀察是否確實有資料傳輸,但不能單獨證明某項服務已成功完成。建立連線、重試、背景更新和協定額外資料都可能產生流量。統計範圍也應以實際介面說明為準,不要將應用程式內的計數直接當成電信帳單,或把單次連線的數值當成安裝以來的累計量。重設統計前先記錄時間點,之後只在相同範圍內比較變化。
若連線已開啟,但 Data 沒有明顯增加,先確認目標程式是否真的送出新請求,再檢查路由和記錄範圍。若 Data 持續增加但頁面仍無法載入,應定位具體失敗的請求,不能因此判斷「連線一定正常」。背景應用程式、系統服務和自動重試都可能產生傳輸。關閉無關的目標,只重現一次問題,比長時間盯著總流量數字更容易找出原因。
| 記錄內容 | 排查用途 | 分享前的處理方式 |
|---|---|---|
| 目標網域與時間 | 對應實際失敗操作 | 遮蔽內部名稱與查詢參數 |
| 策略與錯誤階段 | 區分規則、解析及連線問題 | 保留必要的前後文 |
| 伺服器與驗證資訊 | 在本機核對輸入資料 | 隱藏位址、密碼與金鑰 |
| Data 統計變化 | 確認相同時段的資料傳輸 | 說明統計起點與範圍 |
匯出、保存與完成排查
Log 可能包含存取目標、伺服器位址、訂閱請求和裝置環境資訊。匯出前先在本機檢查,隱藏密碼、金鑰、完整訂閱連結及其中的查詢參數;如果只需要錯誤附近幾行,就不要傳送完整歷史記錄。截圖也要檢查頂端、側邊欄和分享面板中的備註名稱。若有效憑據已經外洩,應聯絡自己的服務商處理相關憑據,不只是刪除已傳送的圖片。
排查完成後,將結論記錄為:「在什麼網路下,哪項設定導致哪個階段失敗,撤銷後是否恢復。」保存必要片段和已驗證的設定檔,清除不再需要的敏感匯出檔,並將暫時提高的 Log 詳細程度恢復原狀。下次遇到類似情況時,就能沿用判斷流程,而不必重新嘗試所有選項。只有結論能對應到可重現的結果,Log 才真正完成診斷工作。
SETTINGS / WIDGET AND ICLOUD
Widget、iCloud 同步與換機還原
Widget 是快捷入口,不是獨立設定
Widget 會在系統允許的位置提供狀態資訊或快捷操作;實際尺寸、按鈕和更新方式依裝置提供的功能為準。它不是另一套獨立伺服器設定,也不是會持續在背景更新的完整監控頁。首次使用前,先在應用程式內完成連線設定,再加入系統提供的 Widget。如果系統沒有相應的元件入口,不要照搬其他平台的桌面小工具操作步驟。
Widget 的顯示可能受系統更新時機影響。狀態與預期不符時,先開啟 Shadowrocket 查看實際連線狀態,再檢查系統 VPN 狀態,不要只憑元件上顯示的一行文字判斷是否已中斷。透過元件切換後,也要等待系統處理完成再查看結果。如果 On Demand 仍符合觸發條件,手動中斷後又重新連線的原因應依按需連線章節排查,不要反覆刪除和新增 Widget。
同步前先確認資料範圍
iCloud 同步是 Apple 裝置上的相關功能,需要裝置允許應用程式使用相應雲端服務。本文不會將它描述成適用所有平台的帳戶同步功能。初始開關狀態、可同步項目及目前裝置條件,以實際介面為準;啟用前先確認系統雲端帳戶正確、儲存空間足夠且網路正常。成功登入系統帳戶不代表應用程式資料已傳輸完成,也不代表所有本機檔案都會自動納入同步。
請分別確認伺服器項目、訂閱、Config 和偏好設定是否出現在另一台裝置,不要因為其中一項已出現就認為整個移轉已完成。尤其要區分匯出的設定檔和伺服器清單:設定檔可以還原規則,不代表也包含完整驗證資訊;訂閱連結可以重新取得項目,不代表會還原所有本機手動修改。先列出真正需要保留的內容,再選擇同步或匯出方式。
同步不能取代歷史備份
同步可能將刪除和修改傳送到其他裝置,因此不能取代另外保存的還原副本。批次整理前,先匯出重要設定檔,並將訂閱資訊存放在自己掌控的安全位置。兩台裝置同時編輯相同內容,可能發生覆寫或重複;建議指定一台裝置作為這次修改的來源,等另一台確認完成後再繼續編輯。同步狀態尚未確認前,不要在兩台裝置間交替重新命名或刪除同一批項目。
若雲端沒有出現預期資料,先檢查是否使用相同帳戶、應用程式的雲端權限和網路,再等待合理的同步時間,最後逐項核對內容。不要反覆關閉開關、登出帳戶或清除本機資料來催促同步,因為這些操作會改變現況,也可能移除尚未傳出的唯一副本。發生衝突時,先分別保存兩端內容,再比較差異並保留確認有效的版本,不要只依裝置新舊決定取捨。
換機後的驗證順序
新裝置先確認應用程式能正常開啟,再還原資料並檢查目前的 Config、所選伺服器和 Global Routing。伺服器備註相同不代表參數也相同,必要時請核對位址、連接埠、協定與服務商要求。首次連線可能需要系統授權,請依系統提示完成;還原設定檔不能取代這個步驟。測試成功前不要刪除舊裝置上的副本,也不要假設舊裝置的系統權限會像一般偏好設定一樣同步。
最後進行一次手動連線、目標存取、中斷連線及網路切換測試,再重新設定 On Demand 和 Widget。如果出現重複項目,先確認它們來自手動匯入還是訂閱更新,以免刪除後又再次產生。完整移轉步驟請參閱備份與換機移轉說明。建議保留一份已驗證的獨立設定檔副本,並記錄還原時需要的資訊類別,不要只依賴雲端清單目前看起來是否完整。
SETTINGS / LOCAL PROXY
Proxy 連接埠、區域網路存取與最後複查
本機監聽連接埠不是伺服器連接埠
Proxy 相關的本機連接埠,供本機或獲准的裝置將請求交給客戶端處理;Add Server 中填寫的連接埠則是遠端伺服器接收連線的位置。兩者用途不同,不要為了讓數字相同而修改。遠端連接埠應符合服務商提供的資訊;本機監聽連接埠則應配合要接入的程式。初始連接埠以目前平台實際顯示為準,本文不指定所有系統通用的固定數字,也不要求未使用此功能的使用者主動啟用。
本機連接埠還要區分接收的 Proxy 類型。HTTP 和 SOCKS5 的連線方式不同,目標程式必須選擇與監聽器相符的類型;若將一種連接埠填入另一種協定的欄位,可能會出現連線成功卻無法完成請求的情況。先確認類型、監聽位址和連接埠再測試,不要因選項名稱中有 Proxy 就假設它能接收所有協定。如果本機程式根本沒有 Proxy 設定,應依它的實際功能判斷,不要在 Shadowrocket 中臆造不存在的相容選項。
回送位址與區域網路位址的差別
回送位址只指向目前裝置本身。另一台裝置使用自己的回送位址,不會連到執行 Shadowrocket 的裝置。若確實需要透過區域網路連線,應使用執行端可從區域網路存取的位址,並確認監聽範圍、系統防火牆及網路是否允許裝置互相通訊。各平台是否提供相關功能,以實際選項為準,不要直接將桌面版的監聽方式推論到行動裝置。
日常使用建議只開放確實需要的範圍。如果只供本機程式使用,優先限制為本機存取;需要區域網路存取時,只在自己了解並掌控的網路中啟用,並依可用選項設定存取限制。不要將監聽服務直接暴露在公開網路,也不要為了排除一次連線失敗就關閉整套系統防護。無線網路可能啟用了裝置隔離,即使兩台裝置連上名稱相同的 Wi-Fi,也不一定能互相存取。
| 參數類別 | 應與哪項設定相符 | 常見誤區 |
|---|---|---|
| 遠端伺服器連接埠 | 自己的服務商設定 | 誤改成了本機監聽連接埠 |
| 本機監聽連接埠 | 接入程式的 Proxy 設定 | 連接埠已被其他程式占用 |
| 監聽位址 | 本機或區域網路的存取範圍 | 使用回送位址連線到另一台裝置 |
| Proxy 類型 | HTTP 或 SOCKS5 接收方式 | 只核對數字,忽略類型 |
依本機、區域網路、目標請求分層檢查
連接埠無法使用時,先確認監聽功能已啟用、設定已儲存,且連接埠未被其他程式占用。接著從本機發出符合協定的測試,確認請求進入 Log;本機測試成功後,才測試另一台裝置。若遠端裝置無法連線但本機正常,優先檢查位址、監聽範圍、防火牆和網路隔離。這樣可避免將區域網路連線問題誤判為 Proxy 伺服器故障,也能減少修改已有效的連線項目。
請求進入客戶端後仍然失敗,應繼續檢查 Global Routing、命中規則、解析結果和遠端連線,不要繼續更換本機連接埠。連接埠只負責接收請求,不保證後續每個階段都會成功。尤其要避免形成迴圈:如果系統 Proxy 指向本機監聽器,而某項上游設定又將請求送回同一個入口,就可能造成重複轉送或連線失敗。新增系統層級 Proxy 前,先釐清請求方向,並保留可還原的原始設定。
以完整驗證流程結束設定修改
完成調整後,依固定順序複查:確認目前網路、核對伺服器資訊、手動連線、檢查 DNS 和規則、送出實際請求,再查看 Log 與 Data。最後再恢復需要的 On Demand、Widget 和同步偏好設定。只保留已通過驗證的修改,未改善結果的選項應撤銷。若只有特定應用程式失敗,記錄該應用程式的目標和錯誤階段,不要因局部問題重寫整份設定。
長期維護時,設定記錄應說明用途和驗證方式,而不只是列出開關:為什麼指定解析來源、哪條規則需要優先、哪個本機程式使用監聽連接埠,以及換機後要檢查什麼。遇到新問題時,先回到相應層級,再查閱常見問題或新手十問十答。本指南旨在讓每項保留的設定都有明確用途、可觀察的結果,以及可執行的還原方式。