[Settings]官方手冊 · 系統查閱

Settings 設定項參考

先了解設定的適用範圍,再逐項核對 DNS、On Demand、連線測試、記錄、同步與本機連接埠。

首次匯入現有訂閱、選擇連線方式及確認連線是否正常,請先閱讀快速上手;本頁說明各項設定的作用、何時需要調整,以及修改後如何還原。以下以 iPhone / iPad 常見的介面用語編排;其他平台的設定位置與可用項目請以實際介面為準。

8 個查閱章節 先核對目前狀態 每次只調整一項

[General]

一、設定層級與預設狀態

先區分 Settings、Config 與伺服器參數

Shadowrocket 的連線結果並非由單一開關決定。Settings 中的 App 層級偏好、目前選取的 Config 檔案、Home 中選取的伺服器,以及系統授予的網路權限,都會共同影響連線請求。排錯前,建議先記下這四項的狀態。例如,修改 Config 中的 DNS 項目,不代表伺服器位址也改變了;調整 Add Server 中的連接埠,也不等於修改本機 Proxy 監聽連接埠。先辨明設定所屬層級,可避免在無關項目上反覆嘗試。

伺服器參數說明用戶端如何連線至使用者現有的伺服器,包括協定、位址、連接埠、驗證與傳輸條件。設定檔主要描述請求的處理方式,包括 DNS、規則與策略;App 偏好則可能涉及測試、顯示、連線觸發、同步及記錄。各項目在不同系統上的位置可能不同,名稱相近也不代表設定會互相覆蓋。若修改後看似沒有作用,應先確認目前啟用的設定檔與伺服器,而不是立刻認定設定失效。

如何理解預設值

本頁不會把某次安裝時看到的狀態,當成所有裝置一律適用的預設值。新安裝 App、從備份還原、匯入遠端設定檔或沿用舊設定,都可能產生不同的初始狀態;同名選項也可能因系統權限或設定檔內容而異。表格中的建議是排錯時的基準,並非要求所有使用者都照做。若介面提供預設選項,且沒有明確的調整理由,建議先保留原值;設定檔中未列出的欄位,也不要直接視為已關閉。

核對時可用文字記下欄位名稱、所在頁面、目前值與修改原因。開關請記錄為開啟或關閉,選擇器請記錄實際選取項目,設定檔則保留原始檔案。不要為了查看預設狀態而刪除正在使用的資料,也不要在沒有備份時重設所有設定。需要比較時,優先建立獨立的測試設定檔,並保留原設定檔作為還原點;測試結束後,確認切回哪一份,避免長期把測試檔當作日常設定檔。

層級主要影響修改前記錄
SettingsApp 偏好、測試、連線觸發與輔助功能選項名稱與目前狀態
ConfigDNS、規則比對與策略引用目前使用的檔案及其原始內容
Add Server連線至現有伺服器所需的參數協定、位址、連接埠與傳輸條件
系統設定網路權限、背景行為與雲端帳戶條件授權狀態與目前網路

建立可還原的修改流程

開始前,確認仍可取得現有訂閱或伺服器資料,並備份目前的設定檔。接著選擇一個可重複存取的測試目標,固定使用相同網路、伺服器與 Global Routing 狀態。每次只調整一項設定,視需要重新連線,再以相同目標驗證。只有結果能穩定重現時,才能將變化歸因於該設定;若同時修改 DNS、伺服器與規則,無論成功或失敗,都無法判斷是哪一項造成影響。

閱讀本手冊不需另外取得連線服務。Shadowrocket 是閉源商業 App,買斷用戶端不等於購買連線服務;本站不提供、不販售也不推薦節點或訂閱。取得方式請見下載頁:iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。iPhone / iPad 的系統需求請以 App Store 頁面標示為準;其他平台的安裝檔由下載頁導向本站 /dl/shadowrocket/ 路徑。

後續章節依序說明「作用、核對、建議、驗證」。若目前介面沒有文中提到的項目,請先確認平台與設定是否適用,不必用名稱相近的欄位勉強替代。若出現明確錯誤訊息,請保留原文,再依現象查閱常見問題,避免未經確認的調整擴大問題範圍。

[DNS]

二、DNS 與名稱解析

DNS 負責查詢位址

DNS 會將網域名稱查詢轉換為可用於連線的位址,但解析成功不代表連線一定成功。存取網域時,可能先查詢位址,再依設定比對規則,接著連線至目標或代理伺服器。不同的處理路徑可能由本機或遠端解析,因此不能只憑單一查詢結果判斷所有流量的去向。排錯時請分別記錄「網域查詢是否有回應」、「規則採用何種策略」及「連線是否完成」這三項結果。

若網域無法存取,但某個位址可以連線,只能表示應檢查解析流程,不能直接證明某個 DNS 服務無法使用。直接輸入位址可能改變 TLS 憑證驗證、伺服器虛擬主機選擇與 App 行為,因此兩者並非完全相同的測試。較可靠的做法是在相同 App 與請求路徑中觀察錯誤:名稱查詢逾時、伺服器連線逾時與憑證名稱不符,應分別處理,不要一律歸類為 DNS 故障。

核對 dns-server 與 system

在目前的 Config 中,尋找 [General] 下的 dns-server。若已設定,先記下完整內容與來源;若未列出,請勿假設目前使用某個固定的公共位址。以下片段表示該項採用系統提供的解析設定,是用來理解欄位的最小範例,並非要求取代整份設定檔。系統解析器的實際來源可能取決於目前網路、裝置管理或其他系統設定。

[General]
dns-server = system

建議先以目前可正常運作的系統設定作為基準,尤其是在辦公室、校園網路或需要存取內部網域的環境中。外部解析器不一定能解析內部網域;貿然更換後,公開網站可能仍可正常存取,但檔案服務、登入頁面或內部 App 卻可能出現問題。若確實需要採用其他解析方式,請依自己的網路需求設定,並確認該解析器可透過目前的連線路徑存取,而非只比較名稱或宣傳數據。

快取、網路切換與位址類型

修改 DNS 後立即重新整理頁面,可能仍使用 App 連線池或既有快取,因此重新整理一次不代表新設定已生效。請先結束相關測試請求,視需要中斷並重新連線 Shadowrocket,再於相同條件下測試。不要快速反覆切換多個解析器;這可能同時造成網路切換、快取更新與伺服器回應差異,難以判斷真正原因。記錄修改前後的現象,比連續嘗試更多位址更有幫助。

同一個網域可能會回傳 IPv4 與 IPv6 位址。若其中一種位址類型的網路路徑不完整,可能出現部分 App 正常、部分 App 等待較久的情況。此時應查看連線記錄,確認實際嘗試的位址,不要一看到 IPv6 就立刻停用相關功能。停用某種位址類型或許能暫時避開路徑問題,但也可能影響依賴該網路環境的服務。建議先比較不同網路下的結果,再決定是否需要針對性調整。

觀察到的現象優先核對避免誤判為
查詢沒有回應解析器是否可連線、目前網路與連線狀態直接認定伺服器驗證錯誤
已取得位址,但連線逾時路由策略、目標連接埠與實際連線路徑繼續盲目更換 DNS
只有內部網域無法使用內部解析器與內部網路存取條件以外部解析結果取代內部記錄

安全調整與還原範圍

加密解析可以改變查詢的傳輸方式,但不會自動修復伺服器參數、規則順序或目標網站故障。使用以主機名稱表示的解析端點時,也必須考慮該主機名稱最初如何解析,以及請求實際經過哪條路徑。若無法釐清這些相依關係,建議先還原原設定,確認一般存取恢復,再單獨了解解析方式。不要一次將多個不熟悉的 DNS 選項加入設定檔,尤其不要從不同設定檔拼湊互相矛盾的項目。

成功的判準應是實際目標能在預期策略下持續使用,而非測試按鈕顯示通過。建議至少檢查一個日常使用的公開網站、一個確實需要的內部網域,以及網路切換後的表現。還原時,請恢復原本的 DNS 項目,並依相同流程重新連線;若設定還原後現象沒有改變,應繼續檢查其他層級。下一章會說明與 DNS 有關的規則行為;兩者有所關聯,但不應視為同一個開關。

[Rule]

三、Global Routing 與設定檔規則

Config、Proxy、Direct 的適用範圍

Global Routing 是確認設定是否參與處理的第一個檢查點。設定、代理與直連分別對應介面用語 Config、Proxy、Direct。Config 依目前設定檔中的規則選擇策略;Proxy 會透過代理路徑處理可接管的請求;Direct 則會以直連路徑處理。這些是用戶端的處理選擇,不代表目標一定可連線,也不表示能涵蓋裝置上的所有特殊流量或系統限制。

日常需要依規則分流時,建議確認設定檔內容後使用 Config。Proxy 與 Direct 可用於縮小問題範圍,例如比較相同目標在不同處理路徑下的結果,但不能取代對規則的理解。若只有 Proxy 狀態正常,請檢查 Config 中的命中規則、策略引用與最終策略;若三種狀態都無法使用,應優先檢查目前網路、伺服器或目標服務,不能只從規則清單尋找原因。

介面狀態主要用途驗證重點
Config依設定檔進行規則分流目前檔案、命中規則與策略
Proxy對照代理路徑的結果現有伺服器能否完成實際請求
Direct對照直連路徑的結果本機網路能否連線至目標

規則順序比項目數量重要

在 Config 中,請求通常會依規則順序比對,由第一個符合的項目決定處理策略。因此,較明確的例外規則通常應放在範圍較廣的規則之前,FINAL 則放在規則清單末尾。若將涵蓋範圍較廣的規則放在前面,後續的細項可能無法比對。增加規則不會自動提高準確度,反而可能讓重疊條件更難排查;修改前應先確認現有項目為何沒有達到預期。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

此片段只用於展示語法與順序,不能當作適用於所有網路的完整設定。DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 依網域中的關鍵字比對,後者可能涵蓋比預期更多的名稱。IP-CIDR 用於比對位址網段,GEOIP 依賴位址地理資料庫,FINAL 則為前面未命中的請求指定最終策略。範例中的 example.com 僅供說明,並非可匯入的服務資料。

策略、解析與網路範圍

PROXY、DIRECT 與 REJECT 是不同的處理策略。使用第一種策略需要可用的代理路徑,直連則取決於目前的本機網路,拒絕會主動阻擋符合條件的請求。自訂策略名稱也必須在設定檔中有相應定義,拼字不同可能造成引用錯誤。排錯時應先使用容易理解的基本策略確認邏輯,再檢查較複雜的策略選擇;不要只憑名稱推斷實際連線到哪台伺服器。

網域規則與位址規則的行為也有所不同。請求保留網域名稱時,可以直接套用網域規則;以位址判斷時,可能涉及解析結果及其所屬網段。同一服務可能使用多個網域或動態位址,只為單一位址設定規則不一定能涵蓋所有請求。若頁面只有部分內容載入失敗,請檢查實際失敗的目標,而不只是瀏覽器網址列中的主要網域。登入、圖片與 API 可能使用不同網域。

維護設定檔的建議做法

遠端設定檔與本機修改應分開管理。若直接編輯更新時會被覆蓋的檔案,下次更新後可能失去修改內容;若長期只使用本機副本,也可能錯過原設定檔的必要更新。請先確認檔案來源、更新方式及修改位置。為每條例外規則註明用途,保留原始副本,並以少量實際目標驗證。完整操作流程請見快速上手中的 Config 與連線步驟。

設定檔更新後,不要只確認檔案能否儲存,還要重新核對 Global Routing、選取的檔案與測試目標。若規則行為突然改變,先比較檔案內容,再檢查伺服器,不要立刻重設所有 Settings。需要查閱規則關鍵字的意思,可閱讀術語表。本章建議的不是一組固定規則,而是讓 Config 與實際需求一致、每個例外都有可驗證的理由,並為所有修改保留明確的還原方式。

[On Demand]

四、On Demand 按需連線

按需觸發不代表伺服器一直可用

On Demand 會依系統支援的條件觸發連線。它處理的是「何時嘗試建立連線」,不會修復伺服器驗證問題、更新現有訂閱,也不保證目標可供存取。啟用後仍需要可用的設定檔、伺服器與網路權限。若連線反覆建立又中斷,應先分辨是觸發條件重複成立,還是連線本身失敗;把所有重新連線都歸因於開關不穩定,可能會忽略真正的網路或參數問題。

不同系統對按需連線的支援與呈現方式可能不同。本章主要說明 iPhone / iPad 的設定核對方法,實際條件請以目前介面為準,其他平台不一定有完全相同的開關。預設狀態應查看裝置現有設定;尤其是從舊裝置移轉後,不要假設目前仍是新安裝時的狀態。建議先在不受自動觸發影響的情況下手動連線一次,確認正常後再決定是否啟用 On Demand。

從手動基準開始設定按需條件

先在 Home 確認選取的伺服器,核對 Global Routing 與 Config,再手動連線並存取實際目標。只有整個流程穩定後,才開始檢查 On Demand 條件。若目前介面可依網路類型或名稱設定行為,請逐項記錄自己的需求,例如是否要在某個信任的網路或行動網路下連線。不要照抄不適用於自己網路環境的條件,也不要只依賴無法辨識的網路名稱來判斷。

無線網路名稱本身無法證明網路可信;相同名稱可能出現在不同地點。若需要依網路條件觸發,應配合實際環境與使用需求判斷,不能把名稱比對當成身分驗證。辦公室或受管理的裝置也須考慮管理者設定的網路配置與權限限制。若裝置已有其他網路管理策略,請先確認其作用,再調整 Shadowrocket,避免兩套策略互相覆蓋,導致最終狀態難以判斷。

網路切換後的驗證順序

測試應涵蓋實際可能發生的狀態變化:從 Wi-Fi 切換至行動網路、返回原本網路,以及短暫斷線後重新連線。每次切換後,先確認裝置已能正常上網,再觀察 Shadowrocket 是否依預期觸發,最後驗證目標是否可存取。若底層網路仍在登入驗證,或尚未取得可用位址,此時連線失敗不代表 On Demand 條件設定錯誤;太早連續切換只會增加變數。

需要網頁登入驗證的網路,尤其應分開處理。先完成網路本身要求的登入,再測試代理連線;尚未登入就反覆觸發連線,可能造成連線狀態改變但頁面仍無法開啟。驗證期間請勿同時更新訂閱、切換設定檔或更換伺服器。記下切換前後的時間順序,有助於判斷是網路尚未就緒、條件未符合,還是連線已觸發但遠端沒有回應。

背景執行、耗電與還原方式

On Demand 不代表 App 介面會持續顯示在前景,也不表示所有背景工作都由用戶端主動維持。系統排程、網路變化、App 活動與連線失敗後的重試,都可能影響觀察到的耗電量。若啟用後電量消耗明顯改變,應在相同使用強度下比較連線次數、網路切換頻率與失敗情況,而非只看某一刻的電池百分比。長時間診斷記錄也應在測試結束後恢復日常設定。

建議只設定用途明確的條件,並保留關閉後手動連線的還原方式。若出現無法解釋的重複觸發,先暫停 On Demand,確認手動連線是否正常;若手動連線也失敗,請改查伺服器、DNS 或規則。若手動連線正常、只有自動連線異常,再逐項恢復條件,找出最小的重現組合。不要以刪除所有網路資料取代這項檢查,否則可能失去排錯依據。

最後驗收時,應確認手動中斷後的預期行為、網路變化後是否觸發,以及實際請求是否採用正確策略。若只是想快速操作連線,不一定需要自動觸發,可參閱後文的 Widget。若希望依目標分流請求,應調整 Config,而不是增加 On Demand 條件。將「何時連線」與「連線後如何處理請求」分開,設定會更容易維護,也能避免把規則問題誤認為連線觸發問題。

[Connectivity Test]

五、Ping 與連線測試

先確認測試實際檢查的項目

Ping、Connectivity Test 與實際瀏覽網頁並非同一回事。不同測試方式可能只檢查主機是否回應、某個連接埠能否建立連線,或某個請求能否經指定路徑完成。測得的時間較短,只能表示該次測試涵蓋的環節回應較快,不能直接代表所有網站的存取速度。排錯前請先確認目前選取的測試方式、目標,以及是否經過指定伺服器,不要只比較清單中的數字。

有些網路不會回應特定探測,但實際 App 請求仍可完成;也可能伺服器位址可以連線,但後續驗證或傳輸失敗。因此,單項測試失敗不應立刻成為刪除伺服器的理由,單項通過也不能取代實際存取。建議將測試分成三個層次:底層網路是否可用、伺服器連線是否成功、目標 App 請求是否完成,並分別記錄結果,避免用一個「逾時」概括所有情況。

測試方式、目標與等待時間

若目前介面可以選擇 Ping 或其他測試方式,先保留現有或預設選項作為基準,並閱讀相關說明。需要調整時,請固定測試目標,並確認自己了解測試內容。測試位址應穩定、允許存取,且符合實際使用情境;不要把需要登入、頻繁轉址或可能限制探測的頁面當成所有伺服器的通用標準。目標無法連線,可能只是該目標的回應政策或暫時狀態。

逾時門檻應配合實際網路,不宜一味縮短。等待時間太短,可能把較慢但可用的連線判為失敗;設得太長,則會延遲發現問題。若介面沒有明確需求,建議維持目前預設值,不要填入沒有根據的通用數值。若確實需要調整,請記下原值,並觀察多次測試結果的分布。單次特別快或特別慢,都可能受到 Wi-Fi 訊號、行動網路切換與背景工作影響,不能據此下長期結論。

測試層級可據此判斷不能直接推論
主機或連接埠有回應某條基本連線路徑目前有回應驗證正確、目標網站可用
經由伺服器完成請求該伺服器與該目標的組合可用所有目標與協定都正常
實際 App 操作目前情境下的存取結果在其他網路下也有相同表現

如何進行有效比較

比較現有伺服器時,請固定裝置、網路、測試目標與方式,關閉不必要的大量背景傳輸,再間隔測試數次。不要一邊切換 Wi-Fi,一邊比較結果;也不要將不同測試方式得到的數值放在同一標準下排序。若設定檔會自動選擇策略,也要確認每次測試實際使用相同路徑,否則看似比較同一項目,實際採用的處理方式可能已不同。

若測試通過但 App 無法存取,下一步應檢查 App 目標與規則比對結果,而不是繼續重複測速。若只有某個協定的設定失敗,請核對該協定的驗證、傳輸與 TLS 條件。協定名稱相同,不代表欄位可以互換;例如伺服器主機名稱、TLS 使用的名稱與實際連線位址,可能各有不同用途。需要辨識現有設定類型時,可閱讀Shadowrocket 支援的協定說明。

從測試結果回到實際使用

批次測試會產生額外請求,頻繁執行不一定有助於判斷。日常只需在問題發生時挑選少數相關項目測試,並搭配記錄進行定位。若測試目標本身故障,請更換目標後重新比較,不要因此判定整份訂閱都無法使用。現有訂閱更新成功,只代表已取得內容,不代表其中每筆伺服器資料都能在目前網路下運作;更新與連線驗證應分開進行。

測試完成後,請恢復日常使用的伺服器與 Global Routing,避免把臨時比較狀態留在背景。對於長期反覆發生的問題,記下當時網路、測試方式、錯誤類型與實際失敗操作,比只存一張延遲數字的截圖更有幫助。最後以可重複完成的實際操作驗收,例如開啟同一頁面並完成必要操作;若只有測試按鈕通過,但實際用途仍失敗,應繼續檢查 Log 與規則,不能視為問題已解決。

[Log]

六、Log、Data 與故障排查

透過記錄還原請求過程

Log 的用途是找出請求在哪個環節失敗,而不是讓記錄越多越好。開始診斷前,先寫下可重現的操作條件:目前網路、選取的設定檔、伺服器、Global Routing,以及無法存取的目標。接著從目前介面可用的入口查看或開啟所需記錄,再執行一次相關操作。不要在大量無關請求持續產生時尋找單筆失敗記錄,尤其避免同時開啟多個 App,造成難以辨認的背景活動。

記錄欄位會因記錄類型與平台而異,閱讀時應著重目標名稱、目標位址、比對策略、連線狀態與錯誤訊息。先確認記錄對應目前的測試,再解讀內容。時間接近不代表一定是同一個請求,頁面也可能同時呼叫多個 API。單筆失敗記錄不一定會讓整個頁面失效,單筆成功記錄也不代表頁面所有資源都已載入;仍須配合實際看到的情況判斷。

依發生環節排查,不要只憑關鍵字猜測

名稱查詢相關錯誤,優先檢查 DNS 與網路條件;建立連線逾時,需核對目標位址、連接埠與處理路徑;驗證失敗則應回查現有伺服器資料;TLS 相關錯誤需核對系統時間、名稱與憑證條件。錯誤訊息只是線索,不能直接推定唯一原因。例如逾時可能發生於本機到伺服器之間,也可能出現在後續連線目標;應比對前後記錄判斷位置,而不是一看到「逾時」就更改所有設定。

對於 Trojan 等包含 TLS 條件的設定,請依使用者現有的伺服器資料核對密碼、SNI 與相關選項。不要把 Allow Insecure 當成通用修復開關;略過驗證會改變連線的安全界線,也可能掩蓋名稱填錯或伺服器端設定問題。欄位用途請參閱Trojan 參數逐項說明。記錄應協助找出正確欄位,而不是促使你放寬與故障無關的設定。

線索下一步應保留的資訊
名稱查詢失敗檢查 DNS 與目前網路查詢目標與完整錯誤訊息
規則結果不符預期檢查 Config 與規則順序命中項目與實際策略
驗證或 TLS 失敗逐項核對伺服器資料協定類型與相關錯誤
連線中途中斷比較網路切換與中斷的時間順序發生條件與重現步驟

Data 統計不等於連線服務的計費資料

Data 顯示的流量或連線統計,應依目前介面標示的範圍理解。統計可能對應某個時段、某次連線或 App 記錄,不能直接等同於服務供應商帳戶中的用量。通道封裝、重試、統計起訖時間與伺服器端計算方式,都可能造成差異。若數值看起來異常,先核對統計範圍及是否曾清除,再檢查背景活動;不要只憑累計值判定某個目標產生了全部流量。

需要比較前後差異時,先記錄初始數值,再進行單一操作並觀察變化。若要清除本機統計,請先確認不會失去仍需保留的診斷資料。不要為了讓數字看起來正常而不斷清除,這會破壞排錯所需的時間關聯。若懷疑有請求持續產生,可暫時減少其他 App 活動,並比較停止連線前後的變化;但仍須配合實際請求記錄才能確認來源。

診斷記錄的隱私與保存

記錄可能包含存取網域、伺服器位址、區域網路位址、訂閱資訊或請求參數。分享前請只擷取必要片段,移除驗證欄位、完整訂閱連結及可識別個人帳戶的資訊,同時保留錯誤類型與必要上下文。只遮住部分敏感文字,仍可能讓人還原原本內容;較安全的做法是用明確的範例值取代,並註明已替換,避免他人誤將範例當成真實連線資料。

診斷結束後,請將記錄詳細程度恢復為日常所需狀態,並視需要清理本機記錄。長期保留大量詳細記錄會增加儲存空間用量,也會擴大需要保護的資訊範圍。若問題仍未解決,請整理最小可重現說明:修改前後狀態、單次操作、相關錯誤及已排除的可能原因,再參閱常見問題。這類資料比未篩選的完整記錄更容易閱讀,也較不容易漏掉關鍵條件。

[iCloud]

七、iCloud、備份與 Widget

同步、備份與匯出用途不同

iCloud 同步會在符合條件的裝置間傳送 App 支援的資料;備份用來保留可還原的狀態;匯出則會產生明確的檔案副本。三者不能直接互相取代。同步中的刪除或修改也可能傳播,因此「另一台裝置看得到」不代表已保留獨立的歷史備份。重要調整前,請先保存可辨識的本機副本並確認其中包含哪些內容,而非只確認同步開關已開啟。

本章的 iCloud 說明適用於支援該功能並符合系統條件的裝置,不代表所有平台都使用相同的同步機制。首次設定時,請先核對系統帳戶、iCloud 可用狀態、網路與剩餘空間,再查看 App 實際提供哪些同步項目。是否啟用預設同步,請以目前裝置為準;尤其是從舊裝置移轉或重新登入帳戶後。建議先確認資料範圍再啟用,並以一項可辨識且不含敏感資訊的修改,驗證同步流程。

哪些內容需要另外保存

設定檔通常包含規則與相關設定,但不要預設匯出的檔案會包含所有伺服器、訂閱、App 偏好與系統授權。匯出前請查看目前介面的說明,匯出後再檢查實際內容;含驗證資訊的檔案應妥善保存,不要放在公開目錄或公開分享。若檔案只有規則,換到新裝置後可能仍需重新取得使用者現有的訂閱或伺服器資料;匯入成功不代表所有內容都已還原。

現有訂閱的更新網址也需要妥善保護。網址可能含有帳戶識別資訊,任何能存取網址的人都可能取得相關設定。備份時請清楚區分設定檔副本與訂閱來源紀錄,避免將真實網址貼到公開回報中。若只是說明格式,使用範例值即可;需要還原時,則從自己妥善保存的紀錄取回真實內容。本站只說明匯入與保存方法,不提供任何訂閱或伺服器資料。

多裝置修改與還原驗證

兩台裝置同時編輯同一份設定檔,可能造成內容被覆蓋、時間差或產生衝突副本。遇到這種情況,請先停止同時編輯,分別保存兩邊目前的內容,再選定一份作為基準逐項合併。不要只因檔名相同就認定內容一致,也不要反覆切換同步開關來期待自動修復衝突。先確認要保留哪些規則、伺服器引用與備註,可降低誤覆蓋後無法還原的風險。

更換裝置時,建議先在舊裝置獨立匯出,再於新裝置確認同步或匯入結果,最後測試連線。依序檢查伺服器清單、訂閱更新、目前 Config、Global Routing、On Demand 與必要的系統權限。部分系統授權需要在新裝置重新確認,無法只靠複製檔案完成。詳細步驟請見設定檔備份與換機還原;完成驗證前,請勿急著清除舊裝置的資料。

Widget 的狀態與操作範圍

Widget 可在系統允許的位置顯示或快速操作 App 支援的項目。它是輔助入口,不是獨立的連線引擎,也不能取代 Home 中的伺服器選取與 Config 檢查。可顯示的內容、更新時機與操作能力,取決於系統及目前介面的支援範圍。若狀態沒有立即更新,請開啟 Shadowrocket 查看實際連線情況,再判斷是否只是 Widget 尚未刷新;不要只憑主畫面上的文字推斷連線已中止。

新增 Widget 後,先進行一次受控測試:記下 App 內的狀態,使用 Widget 提供的操作,再返回 App 核對結果並存取測試目標。若同時啟用 On Demand,手動中斷後可能再次符合觸發條件,因此看似 Widget 操作沒有維持,實際上可能是自動連線再次生效。此時應先檢查按需條件,而不是反覆移除再新增 Widget。兩者用途不同:Widget 用於快速操作,On Demand 用於依條件觸發。

若不需要快速操作入口,可以不新增 Widget,這不會改變規則本身。若 Widget 顯示的伺服器名稱或狀態不適合讓旁人看到,請調整顯示內容或擺放位置。日常維護時,建議減少重複的自動化入口,讓連線控制方式保持清楚:在 App 內操作以便核對,Widget 提供快速存取,On Demand 則依條件觸發。每種入口都應用途明確,避免多個控制來源疊加後難以判斷最終狀態。

[Proxy]

八、Proxy 連接埠與區域網路範圍

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

Proxy 相關連接埠是本機提供代理服務給其他 App 使用的監聽入口,與 Add Server 中連線至遠端伺服器所用的連接埠不同。修改本機連接埠不會修復遠端驗證或傳輸參數;修改遠端連接埠也不會自動改變本機 App 的代理設定。排錯前,請先確認請求從哪裡發出、要連線至哪個位址與連接埠,以及該入口接受何種協定。完整記下這三項,比只記得一個連接埠數字可靠。

並非所有平台都提供相同的本機監聽項目,名稱與位置請以實際介面為準。HTTP 與 SOCKS5 入口不能只因連接埠相近就互換;使用端設定的代理類型必須與監聽端一致。預設連接埠請查看目前 Settings,本頁不指定適用於所有裝置的通用數值。若平時只使用裝置內的連線方式,沒有其他 App 需要明確設定代理,建議先維持原狀,不要為了排錯而額外開啟網路入口。

位址範圍決定可存取的裝置

僅供本機使用與允許區域網路裝置存取,代表不同的安全範圍。迴路位址用於本機通訊,區域網路位址則用於網路裝置互連;若監聽範圍較廣,同一網路中的其他裝置可能也能連到此服務。若介面提供允許區域網路存取的選項,啟用前應確認使用者與網路環境,並檢查系統防火牆及 App 支援的存取控制。同一個 Wi-Fi 網路中的裝置,不代表都應獲得存取權限。

建議優先限制在實際需要的最小範圍。若確實要讓自己的另一台裝置使用,先確認兩台裝置位於可互通的網路,記下提供服務裝置目前的區域網路位址,再於使用端填入正確的協定與連接埠。不要將該位址誤填為遠端伺服器位址,也不要在另一台裝置上填入迴路位址;對另一台裝置而言,迴路位址指向的是該裝置本身,不會指向執行 Shadowrocket 的裝置。

連接埠衝突與代理迴圈

若監聽無法啟動,可能是連接埠已被其他程序使用、位址無法使用或系統權限不足。先查看目前錯誤訊息與本機現有服務,再決定是否更換連接埠。更換後,所有使用該入口的 App 都必須同步修改,否則仍會連線至舊連接埠。不要用連續嘗試大量連接埠來取代問題定位,也不要關閉不熟悉的系統服務;先確認衝突對象與用途,才能避免影響其他正常功能。

明確設定代理也可能形成迴圈:某個請求被送到本機入口,而設定又將與該入口相關的連線送回相同處理路徑。可能出現連線反覆建立、請求無法完成或資源使用異常。遇到這種情況,先撤銷最近新增的使用端代理設定,恢復單一連線路徑,再逐層加入需要的環節。不要同時啟用多處系統代理、App 代理與區域網路轉送,再猜測請求實際經過哪裡。

檢查項目建議基準失敗時優先處理
監聽位址只開放實際需要的範圍確認本機位址與區域網路位址的差異
代理類型使用端設定須與監聽入口一致核對 HTTP 或 SOCKS5
監聽連接埠保留可用的目前值,避免衝突核對連接埠占用情況與使用端設定值
連線路徑確認每一層的連線去向撤銷新增環節,排除迴圈

遠端解析與使用端差異

某個 App 是否透過代理解析網域名稱,也取決於使用端的實作方式與代理類型。只在 Shadowrocket 修改 DNS,不代表所有明確設定代理的 App 都會採用相同的解析路徑。若本機 App 正常,但區域網路中的使用端無法使用,請分別確認使用端是否先自行解析、網路是否允許裝置互通、監聽是否已啟動,以及目標請求是否出現在記錄中。若記錄中完全沒有相關請求,應先檢查入口路徑,而不是修改遠端伺服器。

行動裝置的網路位址、背景條件與連線狀態都可能改變,因此不應將暫時可用的區域網路入口視為永久固定的服務。網路切換後,先核對新位址與目前連線,再測試使用端。臨時工作完成後,請關閉不再需要的區域網路存取,並移除使用端留下的代理設定,以免日後連線至已不存在的入口。對於不受信任的網路,更不應開放超出需求的存取範圍。

全頁設定核對順序

最後依相依順序逐項核對:先確認底層網路與現有伺服器資料,再檢查 Config、Global Routing 與 DNS,接著檢查 On Demand,最後驗證 Widget 或本機 Proxy 等輔助入口。每一步都使用相同目標記錄結果;若失敗,回到最近一次有效狀態。需要重新取得用戶端或查看系統允許步驟,請使用下載頁的安裝說明;若只是還不熟悉日常操作,請回到快速上手即可,不必重設所有設定。