Shadowrocket 官網 · 官方手冊

Shadowrocket
Settings 設定詳解

查閱各設定項的用途、適用條件與排錯順序。先確認設定來源,再調整 DNS、連線觸發與本機 Proxy。

本頁是系統設定參考手冊,不重複首次連線的完整操作流程。尚未匯入自己的訂閱或伺服器資訊,請先參閱使用教學;已能連線、想了解特定選項時,再依下方目錄查閱。教學中的設定說明也以本頁為參考。

Shadowrocket 支援 iPhone、iPad、Mac(Apple 晶片與 Intel)、Windows、Android 及 Linux。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。取得方式與系統安裝說明請見全平台下載頁。iPhone / iPad 的系統需求以 App Store 頁面標示為準。

查閱步驟:記錄原值 → 每次只改一項 → 重新連線 → 以相同目標驗證 → 保留或還原。

01 / SETTINGS & CONFIG

先區分 Settings、Config 與連線狀態

設定不一定來自同一處

尋找選項時,先判斷它管理的是 App 行為、設定檔行為,還是單一伺服器。Settings 常見的是測試、記錄、同步與本機服務等偏好設定;Config 用於管理設定檔;伺服器編輯頁則儲存位址、連接埠、驗證資料與傳輸參數。這些設定會共同影響連線,但不能互相取代。例如,修改本機 Proxy 連接埠不會改變遠端伺服器連接埠;修改測試方式也無法修正錯誤的驗證資料。

Home 的連線開關表示是否嘗試建立系統網路通道,不代表所有請求都已經透過目標伺服器。Global Routing 決定請求依設定處理、經由 Proxy,或走 Direct;所選伺服器則是可能用來轉送代理流量的出口。排錯時應一併記錄這三處狀態,別只因開關已開啟,就認定設定、解析及遠端連線都正常。

如何理解預設值、目前值與建議值

本手冊所稱的「預設值」,是指目前安裝環境中可查證的初始狀態,不會將網路截圖視為所有裝置通用的預設值。匯入設定、還原備份、更新系統或更換網路,都可能改變實際行為。介面留白也可能代表沿用系統或設定檔內容,不一定表示功能已關閉。請先查看選項說明與目前的 Config,再判斷是否需要填寫;尤其不要把未確認的數字直接照抄到連接埠、逾時或間隔欄位。

建議設定同樣有適用前提。需要本機測試時,建議先保留目前可正常運作的方式;需要依網域分流時,建議先確認規則與解析路徑;不需要跨裝置使用時,不必為了「設定完整」而啟用同步。只有在問題明確、能說明預期變更,且有還原方法時,才調整相關項目。設定越多不代表連線越穩定;同時新增多個變數,反而可能掩蓋真正原因。

建立可還原的基準狀態

變更前記下目前的 Config 名稱、Global Routing 模式、所選伺服器、網路類型,以及準備修改項目的原值。涉及設定檔時,先另存一份可獨立還原的副本,並取容易辨識的名稱。備份可能包含驗證資料,請存放在自己可控的位置;向他人說明問題時,只保留相關欄位名稱與已遮蔽敏感資料的結構,不要公開完整訂閱網址。

每次只變更一個項目,然後中斷並重新連線,讓新設定套用到新工作階段。已建立的長連線可能仍沿用舊路徑,瀏覽器與 App 快取也可能保留舊結果。驗證時使用相同目標、相同操作及相近的網路條件。如果變更未產生預期效果,先確認剛修改的設定確實已生效,再考慮調整下一項,不要立刻疊加更多選項。

位置主要用途排錯時先確認
SettingsApp 偏好設定與可用的輔助功能該項目是否適用於目前平台
Config解析、分流與設定檔內容是否選取預期的檔案
伺服器編輯頁遠端位址、連接埠、驗證與傳輸是否符合使用者已有的服務資訊
Home連線入口、所選伺服器與執行狀態連線後是否產生目標請求

跨平台查閱時的注意事項

同一概念在不同系統上可能由不同權限機制實現。iCloud 與 Widget 依賴相應的系統功能;本機連接埠則會受到監聽位址、防火牆與程序占用影響。不要因為某台裝置有特定入口,就認定另一台也應有相同版面。移轉設定時,應移轉需求與規則意圖,再逐項確認可用的選項,而不是照著介面位置照本宣科。

本頁只說明如何使用自己已有的訂閱或伺服器資訊,不提供、不販售或推薦節點與訂閱。App 一次性購買 ≠ 線路方案;取得 App 與使用遠端服務是兩回事。若尚未完成首次匯入,請回到快速入門流程,先建立最基本的可用連線,再回來逐項調整;與目前需求無關的設定可維持原狀。

02 / DNS

DNS:先確認由誰解析網域

DNS 與代理連線是兩個階段

連線至網域時,App 通常需要先取得可用的目標位址,才能建立後續連線。DNS 負責名稱解析,代理伺服器負責傳輸相關請求;兩者有關聯,但不是同一項測試。伺服器延遲正常,只能表示某種探測收到回應;若網域解析失敗,網頁仍可能無法開啟。反過來說,網域能解析也不代表遠端服務、憑證驗證或代理傳輸一定成功。

檢查 DNS 時,先確認目前使用的是系統解析、設定檔指定的解析服務,還是 App 自身的解析行為。系統網路可能透過 Wi-Fi 或行動網路提供不同的 DNS,部分 App 也可能自行保留快取。修改 Shadowrocket 的 DNS 設定後,如果測試目標仍使用先前的快取,結果可能暫時不變。因此,應分開確認「設定已儲存」與「新請求確實走了新的解析路徑」。

留白、system 與明確位址

設定檔中的 dns-server = system 表示該項目使用系統提供的解析服務,並不保證網路品質。是否沿用系統解析,應依目前網路與目標連線結果判斷。如果現有解析正常,建議先維持原設定,不必只因看到別人的設定填了多個位址就跟著更換。指定解析服務前,應確認該位址可連線、用途明確,並了解請求會傳送至何處。

介面留白時,不應直接解讀為 system,因為也可能代表未覆寫設定;實際意義請參閱該項目的說明。也不要把完整的加密 DNS 位址填入只接受一般位址的輸入欄位;協定形式與輸入格式必須符合該項目的支援範圍。如果介面未說明支援某種格式,就不要自行推斷。格式錯誤通常會造成解析異常,不一定會在儲存時立即顯示錯誤。

[General]
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

上例僅示範設定檔段落中 DNS 與規則可以同時存在,不是適用所有網路的完整建議設定。example.com 是教學用網域;規則中的 PROXY 也需要有效的代理選項。此例重點在於區分用途:[General] 中的 DNS 選項會影響解析行為,[Rule] 中的規則則決定如何處理請求,兩者不能只憑相似字詞互相推論。

延遲正常但網頁無法開啟時的檢查順序

先確認問題是否只發生在單一網域,再改用另一個平常可正常連線的目標,並查看 Log 是否有解析失敗訊息。若只有一個網域異常,檢查本機對應、快取及該網域本身;若多個網域同時異常,再比較不同網路下的情況。測試時不要同時更換伺服器、DNS 與 Global Routing,否則即使恢復,也無法判斷是哪項設定生效。

若網域已解析出位址,卻在後續連線階段失敗,請改查伺服器參數、規則命中情況與目標連接埠。若連線建立後才出現憑證錯誤,也應檢查系統時間、目標主機名稱與相關 TLS 參數。直接以目標 IP 取代網域並非通用的驗證方式,因為目標服務可能依賴主機名稱、SNI 或憑證比對;測試條件改變後,結果不能直接比較。

IPv6、快取與本機對應的影響

同一網域可能同時回傳 IPv4 與 IPv6 位址。若其中一條路徑異常,可能出現部分 App 可用、部分 App 等待較久的情況。不要一看到 IPv6 就立刻關閉;先確認系統網路是否具備相應連線能力,以及 Log 中的目標屬於哪一類位址,再進行單一變數對照。若關閉相關選項後問題改善,請記錄結果與網路條件,不要將其視為所有網路的固定設定。

[Host] 本機對應也可能改變解析結果。排錯時請查看目前設定是否為目標寫入固定位址,並確認該對應仍符合實際需求。更換 DNS 不一定會略過本機對應;清除 App 快取也不等於撤銷設定。還原前先記錄原始設定,只暫時停用與問題目標相關的項目,避免一併刪除其他運作正常的對應。

03 / GLOBAL ROUTING

Global Routing:設定、代理與直連

先選擇處理模式,再解讀個別規則

Global Routing 常見的三種模式是設定、代理與直連,對應介面用語 Config、Proxy、Direct。Config 依目前設定檔處理請求,適合需要規則分流的情況;Proxy 用於讓進入 App 處理範圍的請求採用代理模式;Direct 則用於直連對照。這些是整體處理方式,不是三台伺服器,也不是三種訂閱匯入格式。

若要確認某條規則是否生效,先確認目前使用 Config,且已選取包含該規則的檔案。在 Proxy 或 Direct 模式下,單憑請求最後的出口,無法證明設定檔中的特定規則已命中。常見誤判是編輯規則後仍停留在 Proxy,看到所有目標都走代理,就以為規則順序有誤。檢查整體模式應先於修改規則內容。

模式主要用途無法據此證明
設定 / Config依生效中的設定檔進行分流每個請求都會經過代理
代理 / Proxy對照代理連線路徑設定檔中的特定規則已命中
直連 / Direct對照直接連線遠端代理伺服器正常

規則依序比對,具體條件應放前面

DOMAIN 用於比對完整網域,DOMAIN-SUFFIX 用於比對網域後綴,DOMAIN-KEYWORD 用於比對網域中的關鍵字。三者涵蓋範圍不同,不應只為了減少行數而互換。需求若精確到單一網域,優先使用明確條件;後綴規則可能涵蓋子網域,關鍵字規則的範圍更廣,新增前應確認不會誤中其他無關網域。

GEOIP 與 IP-CIDR 用於比對位址相關條件,IP-CIDR6 則用於比對 IPv6 網段。FINAL 用來處理未符合前面條件的其他請求,因此應放在最後。網域規則與位址規則混用時,解析結果與規則順序都會影響觀察結果;不能只看清單中是否有某個網域,就斷定請求一定會依預期處理。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

在此例中,完整網域 example.com 先符合 DIRECT;其子網域則可繼續符合後綴規則並走 PROXY。後面的 GEOIP 與 FINAL 會處理尚未比對的請求。此例用於說明規則順序,不建議直接取代現有設定。PROXY、DIRECT 與 REJECT 是處理動作,其中 REJECT 會拒絕相應請求,不能用來一般性地修復連線問題。

Config 檔案中的各段落用途

[General] 管理全域行為,[Rule] 管理分流條件,[Host] 儲存本機名稱對應,[URL Rewrite] 用於改寫請求。將規則行寫在錯誤段落,不會因語法看起來像規則就自動歸類。編輯時請保留段落標題,並確認相鄰內容屬於同一類;不要只複製中間幾行,卻漏掉原本依賴的設定脈絡。

訂閱主要用於匯入與更新使用者已有的伺服器資訊;設定檔則可能同時包含規則與行為選項,兩者並非同義詞。伺服器清單更新成功,不代表目前的 Config 已被取代;切換 Config,也不一定會更改所選伺服器。若更新後流量行為改變,應分別檢查這兩類項目,不要反覆執行 Subscribe 更新,試圖修復規則問題。

建議的驗證方法與還原範圍

針對明確的目標建立新請求,確認實際網域、目標位址、處理動作與所選伺服器是否符合預期。測試目標應盡量單一,因為一個網頁可能同時請求多個資源網域;看到其中一個請求走 DIRECT,不代表整個頁面的連線都相同。先找出真正失敗的資源,再決定要修改哪條規則,避免以範圍過廣的規則掩蓋其他問題。

修改規則後,保留一份差異記錄:修改了哪一行、預期哪些請求會改變,以及實際符合了哪些條件。沒有依據時,不建議直接重新排列整份規則。需要進一步了解格式,請參閱規則關鍵字與比對範圍;需要了解段落結構,請參閱設定檔結構詳解。還原時切回已儲存的設定檔,再重新連線驗證。

04 / ON DEMAND

On Demand:系統何時觸發連線

按需觸發與手動開關的差異

On Demand 讓系統在符合條件時觸發相應的 VPN 連線行為。它回答的是「何時嘗試連線」,而不是「連線後哪些網域走代理」。後者仍應查看 Global Routing 與 Config。混淆這兩個層次,容易誤以為設定了某個 Wi-Fi 條件,也會同時改變該網路上的網域規則;實際上兩者負責不同設定。

啟用前先確認手動連線已可正常運作。若伺服器位址、驗證資料或 DNS 本身有誤,On Demand 只會在符合條件時再次觸發同一個失敗流程,不會補上缺少的參數。建議先在穩定網路下手動連線,完成目標存取並檢查 Log,再新增觸發條件。如此後續發生問題時,才能分辨是自動觸發失敗,還是原本連線就未成功。

如何選擇 Wi-Fi 與行動網路條件

設定網路條件前,先明確需求:是在特定 Wi-Fi 下連線、離開該網路後連線,還是對行動網路採用不同處理方式。不要同時堆疊多個互相覆蓋的條件。若介面支援依 Wi-Fi 名稱區分,請核對實際網路名稱;名稱相同不代表是同一個實體網路。公共場所可能有同名網路,因此名稱條件不能視為身分驗證。

行動網路與 Wi-Fi 切換時,可能短暫斷線、位址變更並重建工作階段。觀察 On Demand 時,請等系統完成網路切換後,再發出新的存取請求,不要只盯著切換瞬間的圖示。既有長連線可能中斷,背景 App 也不一定會立即重試。建議使用可重複操作的前景目標驗證觸發結果,並記錄切換前後的實際網路類型。

手動關閉後為何又重新連線

若手動中斷後,系統在新請求發生時又嘗試連線,請先檢查 On Demand 條件是否仍符合。此時應先停用相關觸發條件,再測試手動開關。不要立刻刪除所有 VPN 設定;系統也可能有裝置管理要求或其他網路設定。刪除前請確認項目與用途;受管理裝置則應遵循組織的網路政策。

排查「總是自動連線」時,記錄三個時間點:使用者中斷連線、網路變更,以及 App 再次送出請求。若每次都在相同條件後觸發,就應檢查該條件;若沒有固定規律,再查看 Log 與系統狀態。只憑圖示消失後又出現,無法判斷是 On Demand、生效設定變更,還是上一次連線結束後顯示延遲;必須透過可重複的操作觀察。

預設與建議:先保持設定清楚,再增加自動化

本頁不將 On Demand 的初始開關狀態定為固定值。初次設定、還原資料及系統 VPN 設定都可能影響目前狀態,請以裝置實際介面為準。建議從可手動運作的基準開始,只加入一個確有需要的條件,測試通過後再擴充。對不熟悉條件關係的使用者而言,能清楚手動啟停,比設定一組難以解釋的自動規則更適合作為排錯起點。

測試自動連線時,也要測試不應連線的情況。只確認「應觸發時能成功」,不足以證明設定正確;還應切換至預期不觸發的網路,手動中斷後觀察新請求是否使其重新連線。若行為與預期相反,先簡化為單一條件檢查,不要在規則末尾加入拒絕動作,取代連線觸發控制;這會把兩個不同層次的問題混在一起。

睡眠、背景執行與電量觀察

系統背景排程、網路請求頻率與伺服器端的重新連線策略,都會影響連線活動。啟用 On Demand 後若覺得耗電增加,應先比較相同使用時間內的實際請求與重連記錄,不要只根據開關狀態推測。反覆失敗並重試應優先檢查,因為原因可能是參數失效或網路無法連線;減少無效重試前,應先修復連線失敗的原因。

恢復使用時,先確認前景存取正常,再讓裝置依序經過常見的鎖定、喚醒與切換網路流程。系統不保證每個 App 在喚醒瞬間都立即恢復工作階段,因此要區分通道已恢復與目標 App 已重新嘗試。如果手動連線始終正常,只有特定觸發流程失敗,可整理網路條件、觸發動作與 Log 摘要,再參照疑難排解繼續查找原因。

05 / PING & CONNECTIVITY TEST

Ping 與 Connectivity Test:了解測試範圍

有延遲數值,不代表服務連線完整成功

Ping、連線探測與完整網頁存取可能檢查不同階段。某種測試只確認主機或連接埠可達,另一種則可能需要完成交握或向指定目標送出請求;實際內容請以目前介面的測試方式說明為準。結果中的時間值必須依測試類型解讀,不能直接比較不同方法的數字,再據此判斷所有 App 的使用體驗。

傳統 Ping 通常與 ICMP 探測有關,但某台伺服器未回應 ICMP,不代表其代理連接埠一定無法連線。同樣地,連接埠可連線也不代表協定驗證正確。若介面允許選擇測試方式,建議先釐清要驗證的是主機、連接埠,還是經代理送出的請求,再固定一種方式比較。不要把所有顯示 timeout 的結果都解讀為伺服器已停止服務。

測試位址、逾時與並行測試的設定條件

若測試需要目標位址,應選擇用途明確、可穩定重複存取,且符合輸入格式的目標。測試完整 URL 與只輸入主機名稱可能不是同一件事,不應憑經驗互換。目標服務可能限制請求、變更回應或暫時無法連線,因此單一目標測試失敗只能作為線索。請再用另一種獨立方式交叉確認,避免把目標本身故障歸咎於所有伺服器。

逾時時間太短,可能將較慢但最終成功的請求判定為失敗;時間太長則會延遲發現明顯無法連線的結果。沒有適用所有網路的固定數值。建議先保留目前可用的設定,在相同網路與測試方式下重複觀察,再依正常完成時間及實際等待需求調整。測試結果波動很大時,優先檢查網路變化,不要不斷延長逾時來掩蓋異常。

批次測試也會受到並行數量、裝置負載與網路資源競爭影響。一次同時測試多個項目,結果可能與單獨測試不同。若只想確認目前伺服器是否可用,先單獨測試一項,再實際存取;若批次結果異常但單項測試正常,應降低測試造成的干擾後重測,不要立刻修改每台伺服器的協定參數。

觀察結果可作為排查線索下一步
主機探測失敗該次探測未收到預期回應檢查連接埠與實際協定連線
連接埠可達,但驗證失敗已連至某個監聽服務核對協定、驗證資料與傳輸參數
測試正常,網頁卻無法開啟測試路徑不等於網頁的完整連線路徑檢查 DNS、規則與目標請求
只有切換網路後失敗工作階段或網路條件已變更重新建立連線並核對觸發狀態

逐項核對協定參數,不要只看名稱猜測

使用者已有的伺服器資訊可能採用 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard、HTTP 或 SOCKS5 等協定。不同協定所需欄位不同,不能因為位址與連接埠相同就互換類型。先核對協定,再核對該協定實際需要的驗證資料,最後檢查傳輸、TLS 與主機名稱等附加參數;缺少的欄位應向自己的服務資訊確認。

使用 UDP 或 QUIC 時,網路是否允許相應傳輸也會影響結果。TCP 連接埠測試正常,不代表 UDP 路徑也正常。若只有特定類型的協定在某些網路上失敗,請比較同一設定切換網路後的情況,並從 Log 查看相關交握或逾時訊息。傳輸原理可參閱Hysteria2 與 QUIC 說明,但不要因此推斷某種網路一定更快。

系統時間與可重複測試

系統時間明顯不準,可能影響憑證有效期限判斷,或需要時間一致性的驗證流程。先確認系統時間與時區符合實際狀況,並確認自動校時正常。憑證錯誤不應直接透過關閉驗證處理;應核對目標主機名稱、TLS 設定與時間,找出錯誤原因。略過驗證後「可以連線」,也不能證明原設定正確。

建議保留一份測試記錄,只記下網路類型、測試方式、目標、結果與變更項目,不要記錄驗證機密。對同一伺服器少量重複測試,再以實際需要的 App 驗證。若結果仍為 timeout,請依伺服器逾時檢查順序逐項排查;不要只以最低延遲作為選擇依據,也不要因單次失敗就下永久結論。

06 / LOG & DATA

Log 與 Data:將症狀定位到具體階段

先重現一次,再查看相關記錄

Log 的用途是將一次存取拆解為可檢查的階段,而不是盡可能收集更多文字。開始前記下時間,暫停無關操作,使用明確的目標重現一次問題,再查看相關記錄。如果同時開啟多個 App,背景同步、頁面資源與自動重試都會混在一起,容易把無關錯誤當成目前的故障。縮小測試範圍,通常比增加記錄量更有效。

不同平台與記錄層級顯示的欄位可能不同,請以目前介面為準。閱讀順序可以一致:是否有目標請求、目標名稱或位址為何、採用哪種處理路徑,以及失敗發生在解析、建立連線、驗證或傳輸階段。先按階段分類,再查看細節;不要只搜尋熟悉的英文詞,卻忽略它出現的上下文。

沒有請求記錄時,先確認流量是否進入

若重現問題後完全找不到相關請求,先確認記錄功能已開啟、顯示範圍涵蓋本次操作,且時間符合。接著檢查系統連線狀態與實際使用的網路介面。部分請求可能由快取直接回應,也可能走了目前觀察範圍以外的路徑。此時反覆修改遠端驗證欄位通常沒有幫助,因為尚無證據顯示請求已進入該階段。

網頁由一組請求構成,不是單一請求。若頁面主體能開啟、圖片卻無法載入,應檢查失敗圖片對應的網域,不要只檢查網址列中的主網域。App 登入也可能呼叫與首頁不同的 API。建議只記錄完成某個動作所需的最少步驟,例如開啟目標頁面後點一次登入,再依時間尋找相關連線,逐步縮小問題範圍。

解析失敗、交握失敗與遠端關閉的差異

解析失敗表示尚未取得預期的名稱解析結果,應先檢查 DNS 與本機對應。建立連線逾時可能是目標無法連線、連接埠不通或傳輸受限等原因所致,需配合測試方式判斷。驗證失敗則應優先核對協定類型與使用者已有的憑證資料。遠端關閉連線可能與目標服務或協定不相符有關,不能只憑「關閉」二字判斷是哪一方的問題。

Log 中的一筆錯誤,也可能只是後續重試成功前的暫時狀態。判斷問題時,應確認使用者操作最終是否完成、錯誤是否持續重複,以及新請求是否仍停在同一階段。偶發錯誤與穩定重現的故障應分開處理。若連線實際正常,不必為了清除每一筆記錄而修改已能運作的設定;Log 不是要求提示完全消失的成績單。

Data 統計不等於遠端服務計費

Data 中的統計應依其顯示範圍解讀,可能涉及目前工作階段、裝置記錄或介面篩選。它可以協助判斷是否有資料活動,卻不能取代遠端服務的用量記錄。用戶端與遠端的統計期間、協定開銷及計算位置可能不同,因此數字不一致不一定代表異常。需要核對時,先統一統計起點與觀察區間。

重設統計前,先確認是否需要保留目前資料以利排錯。重設 Data 不會修復 DNS,也不等於清除伺服器狀態;清除 Log 同樣不代表撤銷設定。請分開執行「清除畫面資料」、「重新連線」與「還原設定」,並在每個步驟後驗證目標症狀,避免一次清理後就誤以為網路問題已永久解決。

記錄層級與保留時間

更詳細的記錄可能增加儲存空間與處理負擔,也會擴大隱私暴露範圍。建議只在需要重現問題時提高詳細程度,完成後恢復原設定。若 Log 數量很多,先縮短重現流程,再依目標與時間篩選,不要長期維持最詳細的記錄。當前版本是否提供記錄層級、保留時間或清除入口,請以實際介面為準;不要在設定檔中猜測並新增不存在的鍵。

整理求助資訊時,請用一段文字說明系統平台、網路類型、Global Routing、問題操作、失敗階段及已完成的單一變數測試。附上必要且已遮蔽敏感資料的片段,通常比整頁截圖更容易判斷。若仍無法分類,可從疑難排解尋找相似症狀;若涉及設定檔段落,則回到本頁規則章節確認生效對象。

07 / ICLOUD & WIDGET

iCloud 同步、備份與 Widget

先區分同步、匯出與遠端更新

iCloud 同步依賴相應的 Apple 系統、帳號及系統權限,並非所有平台通用的同步方式。同步是讓支援的資料在裝置間維持相應狀態;匯出備份是保留特定時間點的副本;Subscribe 更新則是從使用者已有的訂閱來源重新取得資訊。這些動作可能影響不同項目,不能因為「都能帶回資料」就視為相同的還原方式。

啟用同步前,先在目前裝置保留可還原的副本,並確認另一台裝置正在使用哪些資料。若兩端內容不同,先決定要保留哪一份作為基準,再開始同步。不要在兩端同時大幅編輯後反覆切換同步,期待系統自動判斷哪次變更才正確;衝突、刪除與覆寫的實際處理方式,應以介面提示與實際結果為準。

不要猜測同步範圍並自行補全

伺服器、設定檔、選取狀態或部分偏好是否會同步,請查看目前入口的說明,並以少量、容易辨識的測試項目確認。不要因為看到某個設定檔名稱,就認定所有驗證資料、Log 與本機連接埠也已同步。建議先以不含機密的名稱變更測試,確認範圍後再安排正式移轉;只有裝置本機有意義的設定,仍應逐台檢查。

同步沒有立即顯示時,先確認裝置使用預期帳號、系統允許該 App 使用 iCloud、網路正常且雲端空間狀態正常。接著讓兩端 App 有機會完成同步,再查看結果。反覆登出帳號或刪除 App 會增加變數,也可能影響本機副本,不適合作為第一步。若系統未顯示完成提示,不要只憑等待時間推斷資料一定已傳送完成。

備份檔案的儲存與還原方式

備份可能包含可用來存取遠端服務的資料,應視為敏感檔案管理。請存放於自己可控的位置,並註明檔案對應的裝置、Config 與用途;檔名不必包含驗證資訊。要傳送到自己的另一台裝置時,先確認接收裝置與儲存位置,完成後依需要清除暫存副本,避免備份長期散落在多個位置。

還原前先保存目前狀態,再匯入備份,並逐項核對伺服器清單、目前的 Config、Global Routing 與連線權限。還原成功提示只表示資料匯入流程完成,不代表遠端服務資訊仍有效。先選取已知可用的項目手動測試,再恢復 On Demand 等自動功能;如此即使出現舊參數,也不會被自動重試掩蓋。

Widget 是操作入口,不是完整的診斷介面

Widget 可用形式取決於系統與 App 實際提供的功能。它適合快速查看或執行支援的操作,但顯示內容可能受到系統更新排程影響。若 Widget 顯示的狀態與剛發生的連線變化不一致,先開啟 Shadowrocket 查看 Home 與實際請求;不要只依桌面小工具的文字判斷通道是否運作,也不要連續點擊造成多次相反操作。

新增 Widget 後,先以手動啟停進行一次對照,觀察它能顯示哪些資訊,以及點擊後會執行什麼操作。鎖定與解鎖狀態下的互動限制可能不同,請依系統提示完成授權。涉及連線權限時,仍須在 App 或系統中確認;Widget 不能用來略過系統權限。若沒有出現預期的小工具,先確認該系統是否支援相應形式。

移轉後依清單逐項確認,不要只看列表

更換裝置後,列表看起來相同不代表執行環境也相同。新裝置的網路、系統 VPN 權限、區域網路存取權限與省電策略都可能改變連線行為。建議依序確認:手動連線、DNS、規則命中、測試方式、本機連接埠,最後才檢查 On Demand 與 Widget。即使是可使用 iCloud 的裝置,也應依此確認;資料移轉不能取代功能測試。

若同步後兩台裝置同時出現錯誤,先停止繼續編輯,分別保存兩端現況,再找出最近變更的項目。還原其中一台裝置時,應考慮同步是否會再次傳播還原結果。沒有跨裝置需求的設定,建議留在本機管理;需要同步的資料則應另行建立備份習慣,讓同步便利性與還原能力各自獲得保障。

08 / LOCAL PROXY & RECOVERY

Proxy 連接埠、本機存取與還原順序

本機監聽連接埠與伺服器連接埠不同

伺服器編輯頁中的連接埠屬於遠端服務參數,必須符合使用者已有的服務資訊。本機 Proxy 連接埠則是目前裝置上的監聽入口,供支援手動設定代理的 App 連線使用。將本機連接埠改成遠端連接埠,不會讓兩者自動建立對應關係;同樣地,修改本機監聽也無法修正遠端驗證錯誤。操作前先確認正在編輯哪一種連接埠。

HTTP 與 SOCKS5 是不同的代理連線方式,使用它們的 App 必須選擇與監聽服務一致的類型。若只填入位址與連接埠卻選錯類型,可能出現連線立即中斷或請求無法解析的情況。App 是否支援相應代理,請以其設定說明為準;不支援手動代理的 App,不會因系統存在本機連接埠就自動改走該入口。

監聽位址決定哪些裝置能連線

回送位址表示僅供本機存取,例如 IPv4 的 127.0.0.1;它不是區域網路中另一台裝置的位址。另一台裝置若填入自己的回送位址,請求會留在該裝置,而不會抵達執行 Shadowrocket 的裝置。若要供本機 App 使用,建議優先限制在本機範圍,並關閉不需要的區域網路分享功能。

若確實需要區域網路存取,先確認目前平台具備相應的監聽功能,再核對監聽位址、裝置的區域網路位址、防火牆與網路隔離條件。監聽範圍越廣,可連線的範圍也越大;不能把「連上同一個 Wi-Fi」當成存取控制。不要為了短暫測試將服務暴露在公共網路;測試結束後恢復原有監聽範圍,並確認仍有哪些 App 使用該連接埠。

連接埠設定與占用檢查

本手冊不指定適用所有平台的固定預設連接埠。建議先確認目前實際監聽的數值,再讓呼叫端 App 填入相同數值。若需修改,請選擇有效範圍內且未被其他服務占用的連接埠,並確認系統權限要求。成功儲存連接埠不代表監聽服務已建立;請查看服務狀態或 Log,並以本機明確請求進行驗證。

遇到連接埠占用時,先確認占用者,不要直接結束不明系統程序。可以停用不需要的重複監聽,或為其中一項服務改用其他連接埠;接著更新所有引用該連接埠的 App。若只修改 Shadowrocket,卻忘了瀏覽器中的手動代理設定,舊入口仍會被使用,看起來像修改後的 App 無法連線,實際上是呼叫端仍指向舊值。

症狀優先檢查避免的錯誤操作
本機 App 無法連線監聽狀態、位址、連接埠、代理類型直接重寫遠端驗證資料
另一台裝置無法連線平台功能、介面範圍、防火牆、網路隔離關閉所有系統安全控制
退出後瀏覽器也無法開啟網頁呼叫端 App 是否仍保留手動代理設定反覆匯入訂閱
只能存取部分目標實際規則、DNS 與失敗的請求任意更換本機監聽連接埠

從最小幅度的變更開始還原

若問題是在某項明確變更後出現,先還原該項,再重新連線驗證;不要立刻重設所有設定。若最近改動很多,先暫時停用相關自動觸發,切回已儲存的 Config,確認目前伺服器,再檢查 DNS。最後才處理本機監聽與呼叫端 App 設定。還原應依照相依關係逐層進行,不要將清除快取、刪除資料與重新安裝混成同一個步驟。

準備重設前,確認已儲存可用的備份、使用者已有的訂閱或伺服器資訊仍可取回,並記錄系統層級的手動代理與 VPN 設定。重新安裝不保證清除所有系統網路狀態,也無法讓失效的遠端資訊恢復。若要重新取得 App,請前往下載頁選擇目前的平台,並依頁面中的安裝放行說明操作;本頁不推測安裝檔路徑。

完成還原後的驗收順序

先確認單一明確目標可以正常存取,再檢查 Config 下的規則是否依預期命中,接著比較 Wi-Fi 與行動網路,最後恢復 On Demand、同步與 Widget。每完成一步都記錄結果;若出現問題,回到最近一次成功的狀態。如此可分別驗證「基本連線正常」與「自動化設定正常」,避免一次恢復所有功能後又失去排錯線索。

若仍無法連線,請依解析、連線、驗證、規則與呼叫入口的順序整理線索,並帶著必要且已遮蔽敏感資料的欄位,查閱疑難排解。設定的目的不是填滿每個輸入欄位,而是讓每項變更都有明確用途、可重複驗證的結果與還原記錄。其餘未涉及的項目維持目前已確認的狀態;有新需求時,再依相關章節逐項查閱。