官方手冊 · 系統查閱

Shadowrocket
Settings 設定參考

依適用範圍確認設定,記下修改前的值,再以相同請求驗證結果。

首次設定請先閱讀快速入門教學,完成既有資料匯入與連線驗證;本頁供連線後查閱系統設定,說明各項設定的關係、建議基準及還原方式。以下操作路徑以 iPhone / iPad 為例,其他平台的項目位置可能不同,系統權限步驟也不可直接照搬。

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

01 / SETTINGS

Settings 的適用範圍與預設值確認

先區分伺服器、設定檔與應用程式設定

Shadowrocket 的運作結果並非由單一開關決定。Home 儲存伺服器或透過 Subscribe 匯入的資料,Config 管理規則及相關設定,Settings 則提供應用程式層級的行為與工具選項。系統 VPN 權限、網路權限,以及目前連線的 Wi-Fi 或行動網路,也構成另一層條件。排查時必須先確認問題出在哪一層:伺服器位址錯誤應檢查資料,網域走向不符預期應檢查規則,只有自動重新連線才應檢查 On Demand,不能把所有問題都歸咎於 Settings。

同名項目也可能分別出現在應用程式設定與設定檔中。例如 DNS 可能受目前 Config 設定影響,也與系統網路環境有關。Settings 中顯示某個值,不代表執行中的連線只會使用該值。檢查時應先記錄目前的 Global Routing、選取的伺服器及正在使用的 Config,再查看設定檔是否指定相關參數,最後確認應用程式設定。只有確認有效設定的來源,後續比較才有意義。

「預設值」不等於畫面目前顯示的值

本文不會把某一台裝置的初始狀態當成所有裝置固定的出廠值。應用程式更新、舊版資料移轉、訂閱附帶的設定及備份還原,都可能讓目前值有所不同;部分項目的名稱或可選範圍也會因平台而異。因此,對於沒有統一數值可供確認的設定,本頁建議以「維持目前可用狀態」作為基準,而不臆測預設數字。若介面提供明確的重設選項,請先備份再使用,並記錄重設前後的差異。

建立基準時,建議在本機記錄網路類型、Global Routing、目前 Config 名稱、伺服器備註,以及這次要調整的項目。請勿將密碼、完整訂閱網址、PrivateKey 等資料寫入要分享的紀錄。測試前先確認一個原本可正常存取的目標,修改後仍測試該目標;不要同時更換網站、網路和伺服器。否則即使結果改善,也無法判斷是哪一項設定造成影響。

範圍主要內容建議基準
Home伺服器、Subscribe、目前選取項目保留一筆已驗證可用的資料
Config規則、DNS 與設定引用修改副本,不直接覆寫可用檔案
Settings測試、記錄、同步與本機行為只調整與目前問題相關的項目
系統設定VPN、網路權限、背景執行條件依實際提示授予所需權限

讓每次修改都能還原

開始編輯前,先匯出或複製目前的 Config;若涉及伺服器資料,也要確認能從原始資料還原。不要只儲存 Home 清單的截圖,因為圖片通常不會包含完整參數。接著一次只修改一個變數,視需要中斷並重新建立連線,再確認新設定是否已套用。編輯了檔案卻沒有選用,是常見的「改了卻沒生效」原因;只看檔名也不夠,還應確認實際內容。

若修改後出現異常,優先還原剛才調整的那個值,不要接連疊加其他修改。還原後重新測試,確認問題隨設定還原而消失,才能判斷兩者有關。找不到對應項目時,不應根據名稱相近的選項猜測替代功能;可先查閱術語手冊確認含義。在共用裝置上維護時,也應說明這次調整會影響哪些連線,避免他人在測試期間變更目前使用的伺服器或設定。

02 / ROUTING

Global Routing 與 Config 規則優先順序

設定、代理、直連各自會改變什麼

Global Routing 決定請求採用哪一種整體處理模式。配置對應 Config,依目前設定中的規則決定流向;代理對應 Proxy,適合短時間確認請求能否透過選取的代理路徑完成;直連對應 Direct,用來比較目前網路直接存取的結果。三者不是速度等級,也不是越「全域」就越完整的開關。日常需要依規則分流時,通常使用 Config;排錯時才暫時切換到另外兩種模式作比較,測試結束後應恢復原本選項。

此處的 Config 模式與底部的 Config 頁面要區分:前者決定是否依規則處理,後者用來管理具體檔案。即使已編輯並選取設定檔,若 Global Routing 仍是 Proxy,也不能據此判斷某條網域規則是否正確命中。反過來說,處於 Config 模式時存取異常,也不能直接斷定伺服器無法使用,因為請求可能已由前面的 DIRECT 或 REJECT 規則處理,根本沒有經過預期的代理路徑。

中文說明 / 介面用詞檢查目的不能據此證明
配置 / Config驗證目前設定的規則比對結果所有請求都經過選取的伺服器
代理 / Proxy確認選取的代理路徑是否可用Config 中每一條規則都正確
直連 / Direct比較目前網路直接存取的結果所有目標都適合直連

依序閱讀規則,不要憑名稱猜用途

規則通常依設定中的順序比對,最先命中的規則會決定該請求的處理方式。DOMAIN 用於精確網域,DOMAIN-SUFFIX 用於網域後綴,IP-CIDR 與 IP-CIDR6 用於位址網段,GEOIP 依 IP 地理資料庫分類,FINAL 則處理前面都未命中的請求。DOMAIN-SUFFIX 不應填入含通訊協定標頭的完整網址,也不應連同路徑和查詢參數一起填寫。若要區分主網域與子網域,請先確認比對範圍,再選擇關鍵字。

以下片段只展示語法與順序:第一個網域後綴交由 PROXY 處理,接著符合 GEOIP 條件的請求使用 DIRECT,其餘請求則交由 FINAL 指定的 PROXY 處理。這不是適用所有人的完整設定,也不包含伺服器憑證。GEOIP 規則可能涉及解析後的位址與資料庫結果,不能取代明確的業務網域判斷。若某個目標同時符合前面的網域規則與後面的位址規則,不能忽略順序、只看後面的策略。

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

以實際請求驗證命中規則

檢查某個網域時,先在目前設定中搜尋精確網域、上層後綴及相關規則引用,確認是否有更早命中的項目。接著排除測試干擾:關閉目標頁面後重新送出請求,必要時中斷並重新連線,避免舊連線仍在傳輸。瀏覽器中的同一個頁面可能會呼叫多個網域;頁面正文載入成功但圖片失敗,不代表整個網站只命中一條規則。請從記錄中找出實際失敗的主機名稱,再分別檢查。

建議先在設定副本中新增一條範圍明確的測試規則,確認命中後再決定是否合併至正式檔案。不要為了修復一個網域,就任意將 FINAL 改成其他策略,因為這會影響所有未命中的請求。預設策略必須依既有設定的用途確認,沒有適用所有情況的「永遠正確」值。若 Proxy 模式可存取、Config 模式失敗,優先比較命中規則、DNS 與策略目標;若兩種模式都失敗,再檢查伺服器、驗證資料及底層網路。

更新規則後,還應確認遠端資源是否成功取得,以及設定是否重新載入。Subscribe 更新伺服器清單與 Config 更新規則並非同一件事,不能以清單更新成功證明規則已生效。若想先完成基本連線,再回到此處研究比對關係,可依照教學中的 Global Routing 步驟建立基準;遇到專有關鍵字時請查閱術語手冊,不要從中文備註推測規則含義。

03 / DNS

DNS 解析、快取與請求路徑

DNS 負責解析名稱,不會直接決定所有流量

DNS 會將網域名稱轉換成可用位址,是連線流程的一部分。解析成功只能表示取得回應,不能證明目標連接埠可連線、TLS 交握成功或網頁資源完整。反過來說,網頁無法開啟也不一定是 DNS 故障,原因可能是伺服器驗證失敗、規則走錯路徑或目標服務異常。調整設定前應先確認問題發生在哪個階段,避免遇到任何故障都反覆更換解析伺服器。

先查看目前 Config 是否明確指定 DNS,再檢查 Settings 中的對應項目。若無明確需求,建議保留目前可用的設定,不要把某個公共解析位址當成所有網路的標準答案。系統提供的解析器、手動指定的解析器及加密解析方式,各有不同的可達條件;解析伺服器本身也必須能透過目前網路路徑連線。新增無法連線的位址,可能讓原本只有一個網站異常的問題擴大到多個網域。

如何記錄預設狀態與建議基準

DNS 的預設狀態應以目前安裝版本、目前 Config 及系統網路實際顯示為準。記錄時不只寫下位址,也要註明資料來自系統、應用程式設定或設定檔;若填入多個位址,還要保留完整順序及相關選項。以下以 system 表示採用系統 DNS 的設定寫法,僅用來說明參數結構,不代表所有裝置的出廠檔案都有這一行。不要直接用片段覆寫既有完整檔案,尤其不能刪掉原有的伺服器與規則部分。

[General]
dns-server = system

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

建議的故障排除基準是先保留一個已確認可連線的解析方案,暫停同時調整多個 DNS 相關選項。若從系統解析切換至手動解析,必須使用相同網域、相同網路及相同伺服器重新測試,並檢查回傳位址是否改變。位址不同本身不代表錯誤,因為同一項服務可能依位置和負載回傳不同結果。只有將回應、後續連線及實際存取結果一併比較,才能判斷調整是否有效。

快取、IPv6 與區域網路名稱

DNS 快取可能分別存在於應用程式、系統與存取工具等不同層級。修改設定後仍看到舊位址,不一定代表設定未生效,也可能是既有連線尚未關閉或快取仍有效。若目前介面提供清除快取功能,可先記錄舊結果,再清除快取、重新連線並送出新請求;若沒有對應入口,不要猜測隱藏操作。只重新整理網頁有時仍會沿用原連線,應搭配記錄判斷是否真的重新解析並建立連線。

對於同時回傳 IPv4 與 IPv6 位址的目標,不能只因其中一個位址可連線,就認定整體正常。網路可能提供 IPv6 位址,卻無法穩定完成目標連線;也可能只限制其中一種位址類型。排查時記錄實際連線位址及其類型,並在相同條件下比較結果;不要一開始就把停用某種位址類型當成永久方案。涉及區域網路主機名稱、路由器管理位址或公司內部網域時,也要確認它們是否依賴目前網路專用的解析器。

切換至外部解析器後,區域網路名稱可能無法取得正確回應,這不代表遠端伺服器資料失效。請先在原本的網路直接驗證該名稱,再檢查規則是否讓內部流量走上不合適的路徑。網路登入頁面也可能依賴系統提供的解析與重新導向條件;尚未完成網路驗證時,不宜先大幅調整 DNS。完成網路連線後再恢復 Shadowrocket 測試,會更容易區分環境問題與設定問題。

04 / ON DEMAND

On Demand 與連線生命週期

分開處理自動觸發與規則分流

On Demand 用於依照設定條件觸發連線行為,屬於連線生命週期管理;Global Routing 則決定建立連線後如何處理請求。兩者不是同一個開關。啟用 On Demand 不會自動修正錯誤的伺服器資料,也不會替你產生完整的分流規則。使用前應先確認伺服器、Config 與目標存取在手動連線時都正常,否則自動化只會一再觸發相同的失敗過程,增加排查難度。

是否預設啟用,應以目前裝置介面及系統 VPN 設定為準,尤其是曾還原備份或更換裝置的情況。排查期間建議暫時改用手動連線,記錄 On Demand 原本的開關狀態與條件,再測試切換網路。手動連線穩定後,才依實際需求逐項恢復自動觸發。不要為了看起來「一直連線」而未經驗證就開啟所有條件;條件越多,越需要確認彼此的比對關係。

切換網路後為什麼可能重新連線

從 Wi-Fi 切換至行動網路時,本機位址、路由及可用解析器都可能改變,既有連線也可能需要重新建立。此時狀態短暫變化不一定代表設定損壞;請先等目前的連線程序完成,再檢查實際請求。若每次切換都失敗,但在原網路內長期正常,應比較兩種網路對伺服器位址、連接埠及解析路徑的可達性,而不是只調整自動觸發開關。自動連線可以發起嘗試,卻無法改變底層網路條件。

若設定依 Wi-Fi 名稱或網路類型區分觸發條件,請先確認目前連線確實符合條件。名稱相近的兩個 Wi-Fi 不一定屬於同一個規則範圍;系統是否會提供相關網路資訊給應用程式,也受權限與系統行為影響。測試時選擇明確情境,例如只觀察目前的 Wi-Fi 一次,再切換至另一個已知網路。每個步驟都記錄是否觸發連線、是否成功建立,以及失敗後是否繼續嘗試。

  1. 先關閉自動觸發,確認手動連線與實際存取都能完成。
  2. 記錄原有條件,只保留這次要驗證的一組 On Demand 條件。
  3. 切換一次網路,等狀態穩定後,再檢查新的存取請求。
  4. 測試結束後恢復原值,避免把暫時條件留作日常設定。

手動中斷後又重新連線,如何找出原因

手動中斷後很快又重新連線,首先檢查 On Demand 是否仍啟用,以及系統 VPN 設定中是否保留相關的按需行為。接著確認是否有其他已授權的自動化操作正在呼叫連線動作。不要反覆點擊開關來「壓住」重新連線,這會在短時間內產生多筆連線與中斷記錄,讓記錄難以判讀。先停止自動觸發來源,再明確手動操作一次,較容易取得可解讀的結果。

系統 VPN 標記可作為狀態線索,但不能單獨證明目標流量套用了哪條規則,更不能證明既有服務資料仍有效。應同時確認 Shadowrocket 的連線狀態並送出一個實際請求。裝置鎖定、網路暫時無法使用及系統資源管理,都可能影響連線表現;不要據此保證任何情境下都能維持同一個連線工作階段。若工作需要長時間傳輸,測試時也應觀察切換網路後的恢復情況,而不只看頁面開啟的瞬間。

若在需要登入網路的 Wi-Fi 中自動連線反覆失敗,可先停用 On Demand,完成系統要求的網路驗證後,再手動連線測試。離開該網路後,記得恢復原有設定。若只有特定網路會出問題,記下網路類型與發生順序即可,不必公開完整網路名稱或個人位置。日常使用建議保留數量最少且用途明確的觸發條件,並定期檢查更換裝置或修改 Config 後,是否仍符合原本的使用需求。

05 / CONNECTIVITY TEST

Ping、Connectivity Test 與逾時判斷

名稱相近的測試,測量對象可能不同

日常所說的 Ping 常泛指延遲測試,但應用程式中的實際測試可能涉及不同流程。網路層探測、連線至伺服器連接埠的測試,以及透過代理存取測試目標,不能混為一談。使用 Connectivity Test 前,應先查看目前介面提供的測試方式與目標說明。不要只因清單旁顯示時間值,就認定驗證、DNS、規則和網頁載入都已通過;測試涵蓋到哪一層才是關鍵。

預設測試方式、目標與逾時時間應以目前介面為準,本文不指定未經確認的出廠數值。建議先保留原有可用值,只有在確認測試目標無法連線、回應過慢或不適合目前網路時才修改。若需自行填寫測試網址,請選擇自己能驗證、回應穩定且不需登入的目標,並確認測試是否經過代理。不要使用含私人參數、存取權杖或臨時授權資訊的連結作為公開測試網址。

分開觀察延遲、傳輸量與服務可用性

單次較短的回應時間,只反映當時使用該測試方式連至該目標的結果,不代表大型檔案傳輸一定更快。傳輸量還受連線頻寬、壅塞、伺服器限制與目標網站負載影響;網頁載入則可能包含多個網域及多輪請求。選用既有伺服器時,先確認目標服務可以正常使用,再在相同條件下多次測試,觀察穩定性。不要只憑一次測得的最低值更換目前選項,也不要把測試結果當成長期保證。

觀察結果優先檢查項目下一步驗證
測試逾時,但實際存取正常測試目標、測試方式、逾時範圍維持實際請求不變,改用另一種測試方式比較
測試有回應,網頁載入失敗驗證、DNS、規則與目標服務查看記錄中實際失敗的連線階段
只有特定網路下失敗伺服器連接埠與網路路徑在另一個已知網路中重複相同測試
偶發波動網路切換、並行傳輸、目標負載分時重複測試,維持相同測試條件

逾時不代表伺服器已失效。可能是測試目標未依預期回應,也可能是目前網路無法連線至伺服器連接埠,或測試逾時設定短於實際完成時間。應先確認其他存取是否也同時失敗,再判斷故障範圍。若只有一種測試方式失敗,優先確認測試機制;若所有請求都失敗,再檢查伺服器位址、連接埠、密碼或金鑰,以及目前裝置是否確實已建立連線。

建立可重現的對照測試

大量測試前,先停止大型檔案傳輸,盡量讓裝置維持在同一網路,並選少量既有資料進行驗證。大量並行測試會占用連線資源,結果可能受裝置與網路負載影響,不宜直接比較不同批次的排名。同一筆資料連續測試數次,觀察是否每次都能完成;若只有第一次較慢,可能與建立連線、解析或快取有關,應搭配記錄進一步確認,而不是立刻修改通訊協定參數。

比較兩項設定時,先記錄修改前的方式、目標與結果,再只變更一個值。測試過程中不要同時更新 Subscribe、切換 Global Routing 及更換 DNS。結束後再執行一次實際使用操作,例如重新開啟同一頁面,等待主要資源載入完成。只有測試與實際存取的變化方向一致,才能作為日常選擇的依據;若兩者不一致,應優先保留能完成實際任務的設定,並繼續找出差異。

若已有多份 Subscribe,備註相同不代表連線參數相同,測試前應確認所測資料來自哪一份。更新後出現重複項目,也可能讓你誤以為正在比較不同伺服器。分組、排序及重複資料的處理方式,請參閱多份訂閱管理文章。本節只討論測試方法,不依測試數值評價或推薦任何服務來源,也不以測試清單證明服務品質。

06 / LOG

Log、Data 與分階段故障排除

先縮小時間範圍,再查看錯誤訊息

Log 用來觀察連線過程,Data 中的流量記錄可協助判斷是否有資料傳輸;兩者都不能單憑總量證明已成功存取某個目標。記錄的位置與可見欄位以目前介面為準。查找時先記下問題重現時間,再只執行一次測試動作。大量舊記錄混在一起時,很容易把背景請求的錯誤誤認為目前頁面的失敗原因,因此應先縮小觀察範圍,不要一開始就逐行閱讀所有內容。

記錄詳細程度的預設狀態應以目前設定為準。建議日常維持足以進行基本診斷的狀態,只有在重現複雜問題時才暫時提高詳細程度;若介面沒有記錄等級選項,就不要照文件猜測不存在的開關。詳細記錄可能增加儲存與處理負擔,也會揭露更多存取情境。問題釐清後應恢復原設定,並依個人隱私需求管理既有記錄,不要長期收集超出實際需求的資訊。

依解析、連線、驗證與應用程式回應分層排查

先確認是否出現請求。若完全找不到與目標相關的記錄,請確認應用程式是否正在連線、目標是否沿用既有工作階段,以及該流量是否在目前處理範圍內。接著檢查是否取得目標位址,再確認是否已連線至伺服器或目標連接埠。位址解析失敗與連接埠連線失敗屬於不同階段,處理方式也不同;不要只看到 timeout 就認定密碼錯誤,逾時可能發生在連線流程的多個位置。

驗證失敗時,請回頭檢查使用者已有的伺服器資料,包括通訊協定、連接埠、密碼或金鑰、加密參數,以及必要時的 TLS 和傳輸參數。不要將某一種通訊協定的欄位直接套用到另一種。如果連線已建立,但 TLS 階段失敗,應確認伺服器要求的名稱、憑證有效條件與裝置時間,不能把停用驗證當成通用修復方式。若已收到目標的應用層錯誤回應,則需進一步判斷目標權限或服務本身的狀態。

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

上方的窄範圍規則可用於設定副本作比較:只有精確網域交由 PROXY 處理,其餘則依 FINAL 處理。此規則不涵蓋該網站可能呼叫的子網域,也不是完整的故障排除設定。若主頁與靜態資源的流向不同,記錄中會出現多個主機名稱,應分別確認。處理完畢後,請刪除臨時規則或還原原始檔案,避免測試用的 FINAL 改變日常請求路徑。儲存設定與確認目前使用的是該設定,兩個步驟都必須完成。

將記錄整理成可供溝通的重現資料

有效的問題紀錄應包含裝置平台、網路類型、Global Routing、目前 Config 的用途、失敗操作,以及已完成的對照測試。可在應用程式內查看版本資訊;回報時請使用實際看到的值,不要照抄舊文章。錯誤文字盡量保留原文與上下文,但分享前請刪除完整訂閱網址、驗證欄位、個人網域及網路名稱等敏感內容。只遮住密碼,卻留下含權杖的連結,仍可能洩漏服務存取權限。

若 Config 可存取部分目標,先比較成功與失敗請求命中的規則及位址類型;若只有某筆伺服器資料失敗,請比較它與原始資料是否一致;若所有資料在一個網路下都失敗、換另一個網路則正常,應優先調查網路路徑。依這些分支逐步縮小範圍。相反地,反覆重新安裝、刪除所有設定或同時重設多個選項,會丟失有用線索,還可能導致原本能還原的狀態無法找回。

排查結束後再做一次回歸檢查:還原記錄等級與臨時規則,確認原先正常的目標仍可存取,確認 On Demand 沒有留下測試條件,並查看是否仍有異常重新連線。故障說明應符合實際觀察,例如「切換網路後連接埠恢復連線」,而非籠統地說「設定修好了」。若證據仍不足,就保留不確定性,繼續收集單次重現記錄;不要把一次偶然成功寫成固定解法。

07 / BACKUP

iCloud 同步、Config 備份與移轉

同步不等於獨立的歷史備份

iCloud 同步可在符合條件的裝置間傳送應用程式支援的資料,但實際支援哪些內容,應以目前介面與實際還原結果為準,不能假設所有伺服器、規則、記錄與系統權限都會一併移轉。同步也不代表隨時都能還原至任意歷史狀態:刪除或錯誤修改可能會隨同步傳播。因此,大幅整理 Config、大量刪除資料或更換裝置前,應另行匯出一份可獨立保存的備份,並確認檔案能正常讀取。

同步預設狀態須分別檢查應用程式內的選項、系統 iCloud 權限及帳號狀態;裝置已登入帳號,不代表 Shadowrocket 已完成同步。建議先保持目前可用的裝置不變,在另一台裝置確認預期內容是否出現,再決定是否調整選項。若某項功能只在特定平台提供,請依該平台的實際入口操作;跨平台移轉時,尤其不能把某個系統的雲端同步功能當成所有平台通用的檔案傳輸方式。

分別備份規則、伺服器資料與設定紀錄

Config 檔案主要儲存設定內容,但可能只引用伺服器或遠端資源,並未內含完整資料。匯出前應開啟檔案,確認其中包含的是規則、DNS 參數、資源引用,還是也包含驗證資訊。只儲存檔名不足以證明備份完整,只保留 Subscribe 網址也不保證日後一定能重新取得內容。原始資料應由使用者自行妥善保管,同時避免將實際憑證寫入公開筆記或分享資料夾。

建議將移轉準備分成三部分:第一份保存目前可用 Config 的副本,第二份保存可重建既有伺服器資料的資訊,第三份記錄應用程式層級設定,例如 Global Routing、On Demand、測試方式及本機連接埠用途。匯出檔案應存放於可控的位置,檔名可註明用途,但不要直接包含密碼或訂閱權杖。含敏感資料的備份不應任意傳給他人,也不應將公開雲端硬碟連結當成長期保存方式。

  1. 先確認舊裝置目前連線可用,再匯出 Config 並檢查檔案內容。
  2. 另外確認既有伺服器與 Subscribe 是否有可供還原的原始資料。
  3. 在新裝置匯入後,重新選取 Config、Global Routing 與目前使用的伺服器。
  4. 完成實際存取與自動連線測試後,再整理舊裝置及重複檔案。

同步衝突與新裝置還原檢查

兩台裝置同時編輯同一份設定,可能造成內容被覆寫,或產生難以辨認的副本。開始處理前,先保留兩邊的檔案,比較規則、資源引用與重要設定,再決定以哪一份為基礎。不要只因檔名相同就認定內容一致,也不要在同步尚未完成時接連刪除和重建。建議指定一台裝置作為本次編輯端,另一台暫停修改,等結果確認後再繼續,這樣較容易追溯變更來源。

還原後先手動連線,不必急著啟用 On Demand。新裝置通常需要重新確認系統 VPN 授權,區域網路存取及其他系統權限也應依實際提示檢查。接著確認 Global Routing 符合原本用途、Config 已選取正確檔案,且伺服器仍指向有效資料。若規則引用遠端資源,也要確認資源可以正常取得;清單中看得到檔案,不代表所有外部相依項目都已準備完成。

舊裝置可用、新裝置卻失敗時,應逐項比較,不要立即判定是同步損壞。兩台裝置可能連線到不同網路、使用不同解析條件,或選取了名稱相同但參數不同的資料。先讓兩台裝置處於可比較的環境,再核對設定內容與目前選取項目。也要考慮既有服務是否限制同時連線;這屬於使用者原有的服務條件,不能靠更改用戶端顯示名稱解決,也不應為了測試公開帳號憑證。

完整移轉流程請參閱設定備份與換機移轉文章。清理舊資料前,至少要完成一次重新啟動應用程式後的存取驗證,並確認備份仍可獨立取得。若新裝置尚未完成安裝,請先依下載頁的說明取得應用程式並處理系統提示,再繼續還原設定。應用程式安裝、資料還原與連線驗證是三個階段,分開完成才能避免把取得、同步與網路問題混為一談。

08 / LOCAL ACCESS

Proxy 連接埠、Widget 與日常維護基準

本機 Proxy 連接埠不是伺服器連接埠

本機 Proxy 連接埠用來讓符合條件的程式透過指定通訊協定連入用戶端;Home 中的伺服器連接埠則是遠端服務的連線參數。兩者可能剛好相同,但沒有必須一致的關係。若某個程式要求填入 HTTP 或 SOCKS5 代理,應先確認 Shadowrocket 目前平台是否提供相應的監聽功能,以及該功能是否已啟用。除非既有服務本來就要求這種連線方式,否則不要直接把遠端伺服器位址和連接埠填入本機代理設定。

目前連接埠值、監聽位址及預設開關,應以實際 Settings 介面為準;本文不指定適用所有裝置的通用數字。建議基準如下:沒有程式需要明確使用代理時,不要額外開啟區域網路共享;若只有本機程式使用,優先限制在本機存取範圍。修改監聽連接埠前,先記錄原值,確認新連接埠沒有被其他程式占用,再同步更新使用該連接埠的程式。只修改其中一端,另一端仍指向舊連接埠,就會造成連線遭拒或逾時。

項目含義檢查重點
監聽位址哪些本機網路介面會接收連線本機存取與區域網路存取範圍不同
本機連接埠用戶端接收代理請求的位置呼叫程式填寫的連接埠必須一致
代理通訊協定呼叫程式與本機監聽之間的協定HTTP 與 SOCKS5 不可任意互換
伺服器連接埠既有遠端服務的連線參數以使用者持有的伺服器資料為準

區域網路共享的範圍與驗證順序

允許區域網路裝置連入會擴大可存取範圍,因此只應在明確需要且網路受控時使用。先確認連入裝置與執行 Shadowrocket 的裝置可以互相連線,再檢查系統防火牆、監聽位址和連接埠。使用相同的 Wi-Fi 名稱,不代表裝置之間一定能互相通訊;訪客網路隔離就可能阻止連線。不要只為了驗證一個程式就放寬所有系統防護,也不要將本機監聽公開至不必要的外部網路。

需要填寫代理位址時,本機程式與另一台裝置所指的「本機」並非同一台。呼叫程式中的本機回送位址指向執行該程式的裝置,不會自動指向另一台執行 Shadowrocket 的裝置。跨裝置存取應使用實際可連線的區域網路位址,並留意重新連線後位址可能改變。測試完成後,若不再需要共享,請關閉對應入口、恢復原本的監聽範圍,並清除呼叫程式中留下的代理設定。

Widget 是操作入口,不能取代連線驗證

Widget 提供快速查看或操作的入口,實際可用的動作以目前系統與應用程式提供的元件為準。新增前先在應用程式內確認連線正常,再依系統的小工具管理方式加入。Widget 的畫面更新受系統排程影響,不能把某一瞬間顯示的文字或圖示當成即時網路監控。若顯示狀態與實際存取不一致,先開啟 Shadowrocket 查看目前連線與伺服器,再送出一個請求;不要透過元件反覆切換開關。

是否新增 Widget 取決於系統版面與使用者選擇,不是 Config 檔案的統一設定值。建議只保留用途明確的入口,尤其要留意鎖定畫面與共用畫面是否顯示伺服器備註等資訊。更換裝置或還原備份後,可能需要重新確認小工具位置與授權;即使元件已還原,仍應檢查 Config、Global Routing 及目前使用的伺服器。元件可以觸發動作,不代表原有伺服器資料或系統權限已完整還原。

日常維護可依固定順序進行:先確認既有服務資料有效,再核對目前設定與規則引用,接著檢查 DNS、自動觸發及測試設定,最後處理本機連接埠與 Widget。每次只調整與目前問題相關的一層,並保留可用副本及還原紀錄。需要重新取得應用程式時,請前往全平台下載頁;剛完成初次設定,則返回快速入門教學驗證連線。維持穩定的基準,比不斷疊加設定更有助於找出後續變化。