SETTINGS REFERENCE

Shadowrocket Settings 設定項目參考

先確認設定的作用範圍,再調整設定值。本頁是依問題查閱的官方手冊;首次匯入現有訂閱、選擇節點及建立連線,請先閱讀使用說明,完成基本流程後再回到相關章節。

Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 和 Linux。本頁以 iPhone / iPad 的 Settings 介面用語為查閱基準,其他平台僅在確實提供相應功能時參考,不將系統專屬功能視為各平台都有。

iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。取得方式與系統允許步驟請參閱全平台下載頁;iPhone / iPad 的系統需求以 App Store 頁面標示為準。客戶端一次性買斷不等於線路方案:訂閱或伺服器資訊請向你的服務商取得,本網站不提供、不銷售也不推薦此類服務。

預設值不代表建議值

現有安裝可能曾還原備份、匯入設定或保留舊設定。本頁不會臆測未經確認的開關預設值;「保留預設」是指維持目前安裝中未修改的初始狀態,並先記錄介面顯示的內容。每次只調整一個變數,驗證後再決定是否保留。

01 / SCOPE

適用範圍、預設狀態與修改順序

先區分 Settings、Config 與系統權限

疑難排解設定前,先將問題分成三個層面。Settings 管理客戶端行為,例如測試方式、日誌與應用程式偏好;Config 中的目前設定檔決定規則及部分網路處理方式;系統權限則決定客戶端能否建立系統網路連線、存取區域網路或使用雲端功能。同一種現象可能源自不同層面:連線開關無法維持開啟,不代表 DNS 一定有誤;網頁無法開啟,也不能直接認定是規則失效。先記錄目前頁面、所選設定檔與實際提示,再檢查相關設定,可避免反覆修改卻不清楚哪項生效。

本頁所說的「核對預設狀態」是一項操作,不是要求將所有開關還原成某種固定組合。初次查看時,記下欄位目前內容、是否留白、是否由設定檔提供,以及是否出現系統權限提示。曾經移轉資料的裝置,其介面值不代表全新安裝的預設值;從雲端還原的內容也未必適用目前網路。不要為了取得所謂的標準值而刪除正在使用的設定檔或重新安裝 App,這會同時改變多個條件,讓問題更難重現。

Global Routing 決定規則是否參與判斷

Global Routing 的 Config、Proxy、Direct 分別對應設定檔、代理、直連。Config 依目前設定檔的規則處理請求;Proxy 讓相關流量透過代理處理;Direct 則採直連方式。三者都無法修正伺服器參數,也不代表一定能連上目標。疑難排解規則時應使用 Config;短暫切換至其他模式,只是為了比較同一目標在不同路徑下的結果。測試完成後請恢復原本模式,否則後續修改規則可能看起來沒有作用。

模式查閱重點適合驗證的問題
Config目前設定檔、規則順序與策略這個請求符合哪條規則?
Proxy所選節點及其連線參數代理路徑本身是否可用?
Direct本機網路與目標可連線性不經代理時,情況是否有所不同?

以可復原的紀錄取代連續切換開關

建議記錄四項基本資訊:目前使用 Wi-Fi 或行動網路、使用中的設定檔與節點、Global Routing 所處模式,以及故障發生在連線前還是連線後。接著寫下準備調整的單一欄位與預期變化。例如準備調整 DNS,就先設定驗證目標為「同一個網域能否解析並開啟」,而不是籠統觀察網路是否變快。固定測試對象,才能將結果與這次設定變更連結起來。

修改後先重新發出請求;若設定影響隧道建立階段,可先中斷連線,再重新連線測試。使用長連線的 App 可能繼續沿用現有工作階段,因此舊頁面仍然顯示錯誤,不一定代表新設定未生效。關閉受影響的頁面再重新開啟,比連續重新整理更容易判讀。若結果沒有改善,先還原剛才記錄的值,再檢查下一項。不要在一次測試中同時更換節點、設定檔、DNS 並啟用 On Demand;即使問題恢復,也無法判斷原因。

建議的初始設定原則

運作正常的欄位維持不變;服務商明確要求的協定參數依原始資料填寫;自動重新連線、對外監聽等額外功能,等基本連線驗證通過後再啟用。未知欄位先保留目前初始狀態,不要只看名稱就猜測用途。

需要精確定位問題時,可為每次測試寫下一句結論:修改了什麼、如何發出請求、結果如何,以及是否已還原。紀錄不必包含訂閱網址或密碼。比較不同裝置時也應分別記錄,因為系統權限、網路與設定檔副本都可能不同。更多介面用語請參閱術語表;本頁其他章節也會依照這套紀錄方式逐項說明。

02 / DNS

DNS:解析路徑與網頁無法開啟的排查

DNS 負責解析名稱,不會取代連線或規則

DNS 會將網域名稱解析為 IP 位址,是造訪網站前常見的步驟。一次連線還可能經過規則比對、連線至伺服器、TLS 交握及內容傳輸,因此「延遲正常但網頁無法開啟」不能只憑一次測試數值就歸因於 DNS。先查看日誌是否取得目標位址,再確認連線階段是否失敗。如果已解析出位址但連線逾時,繼續更換 DNS 伺服器通常無法修正線路無法連線或協定參數錯誤;如果連所選節點的伺服器網域都無法解析,則應先處理建立代理連線前的基本解析問題。

DNS 設定可能受到目前 Config 中相關內容影響。修改前也要檢查目前設定檔,避免在 Settings 改了一處,實際行為仍由另一處設定決定。欄位留白不應直接解讀為「沒有 DNS」;也可能表示沿用系統或設定檔提供的處理方式。預設狀態以目前安裝的介面及所選設定檔為準。網路運作正常時,建議維持原有解析方式;只有出現可重現的解析錯誤,才需要進行對照測試與調整。

填入位址前,先確認欄位接受的格式

先確認介面需要的是 DNS 伺服器位址、含通訊協定的端點,還是設定文字中的單行參數。不同欄位不能只因名稱都含有 DNS 就互相複製。填寫前檢查前後空格、全形標點與換行;若使用加密解析端點,也要確認目前欄位接受這種格式,且該端點可以連線。位址文字正確不代表整條路徑可用,連線至解析服務也會受到目前網路、憑證驗證及裝置時間影響。

建議優先使用現有設定明確要求、且目前網路可以連線的解析方式。需要更換時,先保留一條可用的基本路徑,不要一次填入多個來源不明的位址。解析器較多不代表更穩定:其中一項回應異常,最終結果可能因請求而異。測試期間固定網路與節點,分別造訪一個先前出錯的網域和一個平常正常的網域,記錄是否都能取得位址,不要只看某個頁面是否偶然開啟。

觀察結果優先核對下一步
節點網域無法解析連線前的系統網路與基本解析先恢復基本網路,再建立連線
目標網域解析失敗目前 DNS 設定及設定檔中的相關項目只調整解析方式後重新發出請求
已有位址,但連線逾時所選策略、節點與目標可連線性改查連線日誌,不要繼續盲目更換 DNS
只有部分網路連線失敗網路限制、位址類型與解析端點的可連線性分別記錄 Wi-Fi 與行動網路的結果

快取、位址類型與規則的交互影響

系統與 App 都可能保留解析結果,修改後立即重新整理舊頁面,可能仍會使用舊位址。先重新建立連線並重新發出請求;若目前介面提供清除 DNS 快取的操作,可先記錄狀態再使用,但不要將清除快取當成長期解決方案。問題偶爾恢復後又重現,表示仍需檢查上游回應或網路變化。若問題只出現在特定 App,也要考慮該 App 是否採用自己的解析路徑;不能只因瀏覽器正常,就認定所有 App 都使用同一組設定。

網域可能同時回傳 IPv4 與 IPv6 位址,而兩種位址在目前網路中的可連線性不一定相同。不要一看到 IPv6 就直接關閉,也不要把某種位址類型的問題誤判成整個 DNS 失效。先透過日誌確認實際連線使用的位址,再比較更換網路後的結果。涉及 IP-CIDR 或 IP-CIDR6 規則時,也要確認解析結果是否改變規則命中;解析成功與分流符合預期,是兩項需要分別驗證的結果。

不要用固定位址取代所有網域測試

部分服務依賴網域名稱、TLS 主機名稱與動態位址。直接連線至某個 IP 失敗,不足以證明 DNS 出錯;直接連線成功,也不能證明以網域為基礎的完整連線流程正常。

完成調整後,重新造訪正常網域與故障網域各一次,再查看日誌中的解析與連線階段。若只有特定網站異常,保留發生時間與失敗階段,避免繼續擴大修改範圍。關於「測試有回應,頁面仍無法開啟」的分層判斷,請參閱DNS 問題疑難排解說明。

03 / ON DEMAND

On Demand:自動連線條件與手動開關

先驗證手動連線,再啟用自動條件

On Demand 用於依條件觸發連線行為,並非用來修復伺服器可用性的開關。只有手動選擇節點、開啟連線並成功造訪目標後,才建議設定自動條件。否則自動重試會與原本故障交錯,出現「剛中斷又連上」、「切換網路後不斷嘗試」等現象。初次排查時先記錄原有條件,再暫時停用 On Demand,讓每次連線都由手動操作發起,才能準確判斷在哪個時點發生失敗。

請在目前安裝的 On Demand 頁面核對預設狀態,包括總開關及下方每一項條件。還原設定檔或裝置備份後,不能只看總開關就推斷所有條件都已回到初始狀態。建議從最小範圍開始啟用:只為明確需要的網路情境設定行為,先測試一次符合與離開條件時的狀況,再逐步新增其他條件。不要照抄別人的網路名稱,也不要假設相同名稱的 Wi-Fi 一定具有相同的連線能力。

同時檢查網路條件與系統權限

若目前介面可依網路類型或 Wi-Fi 名稱設定條件,請逐項確認其代表的是需要連線還是中斷,以及是否有涵蓋範圍更廣的條件。請依裝置實際辨識的結果核對網路名稱,空格、大小寫及相似字元都可能影響判斷。系統對網路資訊的存取也可能受到權限限制;若 App 無法取得比對所需資訊,應先查看系統權限與頁面提示,不要反覆新增同名條件。

可先從目前的 Wi-Fi 開始測試:記錄手動連線狀態,啟用一項條件,離開該網路後再重新加入,觀察是否出現預期行為。接著單獨測試行動網路。切換網路時,系統需要重新建立網路連線,不宜在短時間內連續切換多次後只看最後的開關狀態。每一步都等網路穩定後再發出新請求,並將觸發時間與連線日誌對照,才能分辨是條件未符合還是連線建立失敗。

手動中斷後又重新連線,應查明觸發來源

On Demand 仍在生效時,手動中斷不一定代表自動觸發已永久停止。系統在後續網路事件或請求發生時,可能再次依照現有條件處理。因此若需要持續中斷連線,應檢查 On Demand 總開關及相關條件,不要反覆點擊連線開關。修改後再次查看系統 VPN 狀態,確認沒有其他仍生效的自動條件。是否觸發應以實際條件與系統行為為準,不要一概認定是「開關故障」。

也要區分系統儲存的 VPN 設定與目前連線狀態。允許新增設定,代表系統具備相應的連線設定,不表示流量時時刻刻都在傳輸。若先前拒絕權限或刪除系統設定,On Demand 也無法繞過這項前提。先手動連線,依系統提示完成授權,再回到條件設定。授權與系統設定的關係請參閱新增 VPN 設定提示說明。

網路切換故障的復原順序

記錄條件 → 暫停 On Demand → 手動重新連線 → 在穩定網路中驗證 → 逐項恢復條件。不要同時刪除系統設定並修改節點參數,否則無法判斷是哪項變更影響結果。

自動連線不等於自動選擇可用線路

觸發連線、選擇節點及確認目標可連線,是不同的工作。On Demand 成功觸發後,所選節點仍可能已失效或參數不符;即使可以連線,也不代表所有目標都會依預期分流。建議保留一組可重複使用的驗證對象:一個用來檢查本機網路、一個用來檢查代理路徑,再查看目前的規則命中。發生異常時,先依這三個層面定位,不要只為了讓開關維持開啟而不斷放寬自動條件。

需要先在公共網路登入或確認頁面時,應先確保基本網路可用,再驗證自動連線。若某個網路無法進行基本存取,代表前置條件尚未滿足,不宜用更積極的重新連線條件來掩蓋。測試完成後,將條件用途與適用網路記錄下來;日後網路名稱、裝置權限或使用習慣改變時,依紀錄逐項檢查,比重新匯入整套條件更容易維護。

04 / PING

Ping 與 Connectivity Test:測試結果的判讀範圍

先了解測試方式,再判讀延遲

Ping 是診斷入口,不應將所有測試都視為同一種探測。實際結果取決於所選測試方式、測試目標及目前網路;TCP 連線、一般探測與經過代理的應用層請求,涵蓋的連線路徑並不相同。進入設定後,先記錄目前的測試方式再開始測試。預設測試方式以目前介面顯示為準,未經核對時不要將特定方式當成通用初始值。比較兩次結果時,測試方式與目標必須一致,否則數值無法直接比較。

節點顯示有回應,通常只能表示本次探測涵蓋的階段收到回應。這無法單獨證明認證參數正確、目標網站可存取或連線能持續穩定。反過來說,逾時也不一定代表伺服器完全離線:測試目標無法連線、該類探測受到限制,或逾時時間不足,都可能造成類似結果。建議將測試結果視為縮小問題範圍的線索,再以實際請求驗證,不要把節點清單中的單一數值當成最終結論。

如何選擇測試目標、逾時時間與重複次數

若目前介面允許指定測試位址,請選擇自己有權使用、可穩定連線且回應流程簡單的目標。測試目標若需要登入、會重新導向或限制存取,就會增加其他變數。不要頻繁更換位址,只為找到看起來較小的數值。先保留原有目標作為基準,確認故障可重現後,再只更換目標進行比較;若更換目標後恢復,仍要確認是目標本身不同,還是連線路徑確實恢復。

若有逾時時間設定,建議先保留初始值。時間過短可能將正常但較慢的請求判為逾時;時間過長則會增加每輪測試的等待時間,無法提升伺服器本身的可連線性。只有確認目前網路確實需要較長時間才能建立連線時,才稍微調整並重新測試。重複次數方面,少量且間隔進行的測試通常比連續高頻測試更容易判讀,也能避免將瞬間網路波動誤認為長期狀況。

測試層級可提供的線索無法單獨證明
伺服器連接埠連線位址與連接埠是否能建立連線協定認證及目標存取正常
經過代理的請求本次代理請求是否完成所有網站與 App 都正常
Connectivity Test目前測試條件下的連線狀況日後切換網路後仍可持續使用

逾時後的檢查順序

先確認裝置的基本網路可用,再核對伺服器位址與連接埠,接著檢查協定類型與認證欄位。Shadowsocks 的加密方式與密碼、VMess 或 VLESS 的身分欄位、Trojan 的認證及 TLS 相關設定,都應逐項符合原始伺服器資料。WireGuard 與 Hysteria2 也各有參數,不能只因部分欄位看起來相似就互相套用。若服務商提供的資料不明確,請向你的服務商取得正確參數,不要隨機修改設定值碰運氣。

裝置時間也值得檢查。時間偏差可能影響憑證驗證或有時間要求的連線程序,但校正時間並非所有逾時問題的通用解法。先確認系統時間與時區設定正確,再重做原本的測試。如果只有某個節點異常,維持網路不變並檢查該節點;若所有節點同時異常,優先檢查共同條件,例如網路、解析與測試目標,避免逐一修改原本正確的節點參數。

測試正常後,仍要進行一次實際連線

選擇準備使用的節點,確認 Global Routing 模式,建立連線後發出新請求,並在 Log 中確認請求使用了預期策略。不要只用背景中已建立的長連線作為驗證;新開啟的頁面更容易與特定日誌對應。若有上傳、影音串流或長時間工作階段等需求,也應使用實際服務進一步驗證,短暫探測無法取代這些使用情境。

疑難排解紀錄只需保留測試方式、網路類型、失敗階段與發生順序,通常不必公開完整節點資訊。若要依固定步驟處理節點逾時,請參閱節點逾時與連線失敗排查順序。測試通過後,恢復日常測試頻率,避免為了觀察數值而持續大量探測;能穩定完成所需請求,才是保留設定的依據。

05 / LOG

Log 與 Data:依請求順序讀取故障線索

將日誌視為過程紀錄,而非結論清單

Log 的用途是還原一次請求經歷的階段:接收目標資訊、進行解析、比對策略、建立連線,最後完成或失敗。不同協定與日誌層級顯示的細節可能不同,不必要求每次都出現完全相同的行。閱讀時先找出時間接近剛才操作的紀錄,再依同一目標或工作階段查看後續事件。單獨截取一行錯誤容易遺失上下文,例如先前已發生解析失敗,後續的連線失敗可能只是連帶結果。

日誌預設是否記錄、保留多少內容及可選層級,請以目前 Log 頁面為準。建議日常維持足以進行基本排查的設定,不要長期使用最詳細的紀錄。需要診斷時,暫時提高詳細程度,重現一次後立即恢復。日誌越詳細,越可能包含造訪目標、網路資訊與設定線索,也會增加閱讀負擔。先明確要定位的階段,比開啟所有紀錄後逐行搜尋更有效。

透過一次乾淨的重現,對照發生時間

開始前記錄目前網路、設定檔、節點與 Global Routing 模式。若準備清除舊日誌,先保存仍有參考價值的排查結論;清除紀錄只會移除內容,不會修復網路。接著減少其他 App 的網路活動,只開啟一個故障目標,記下操作時間,再回到 Log 查找。系統背景仍可能產生請求,因此日誌不一定只包含這項操作;應結合目標網域、時間與請求順序判讀,不要直接把最新一行當成故障請求。

找到目標後,先確認它是否進入客戶端處理範圍,再檢查策略。若規則預期走 PROXY,紀錄卻顯示 DIRECT,應優先檢查規則與 Global Routing;若已走預期策略但認證失敗,則檢查節點參數;若連線成功後 App 仍顯示錯誤,還要考慮目標回應、App 工作階段或其他相關請求。一個網頁通常會連線至多個網域,主頁成功不代表圖片、登入或 API 請求也成功;必要時應依造訪流程繼續追蹤。

日誌階段優先檢查應避免的誤判
解析階段失敗DNS 與基本網路直接重新填寫所有認證參數
策略不符預期Global Routing、目前設定檔、規則順序將分流問題誤認為伺服器離線
認證或 TLS 階段失敗協定欄位、主機名稱、系統時間只因連接埠可連線就排除參數錯誤
連線建立後中斷網路切換、目標回應與工作階段持續性將單次中斷概括為所有請求都失敗

Data 統計與單一請求日誌不能互相取代

Data 統計用來觀察特定範圍內的流量狀況,不等於逐一請求的成功率。有流量只代表發生資料活動;資料可能來自背景服務,也可能是失敗前已傳輸的內容。累計值還會受到統計期間與重設操作影響,不適合直接比較兩組設定的效率。要判斷特定網頁是否依規則處理,仍應查看對應請求的 Log,而非只看總流量是否增加。

同樣地,系統狀態列顯示已連線,也不代表每個 App 的請求都成功。隧道狀態、規則命中與目標回應分屬不同層面。建議先透過狀態確認是否已建立連線,再用 Log 判斷請求路徑,最後透過實際 App 確認功能是否恢復。三者結果一致,結論才較完整。若只有統計數值變動卻找不到目標日誌,請重新確認重現方式、日誌記錄狀態,以及觀察的資料是否來自目前連線。

分享排查資料前,先移除敏感資訊

不要公開訂閱連結、認證欄位、完整 QR Code 或雲端設定網址。保留錯誤階段、策略類型與必要上下文即可;網域與位址可換成明顯的範例文字,但請註明已替換哪些欄位。

排查結束後,將暫時調整的日誌層級恢復原狀,並保留精簡結論:問題如何重現、哪個欄位改變了結果,以及最後採用什麼設定值。若某次修改沒有改善,也要記錄已還原,避免下次重複相同測試。清楚的過程紀錄比大量未整理的日誌更容易維護;涉及規則順序時,可接著閱讀自訂規則與 FINAL 說明。

06 / WIDGET

Widget:快捷入口、狀態顯示與系統更新

Widget 是操作入口,不是獨立的連線引擎

Widget 可在系統允許的位置提供快捷操作或狀態資訊,實際功能依目前裝置提供的元件而定。它不能取代首次授權、有效設定檔或可用節點。初次使用時,先在 Shadowrocket 內手動完成連線,再從系統元件入口新增可用的 Widget,確認能否正確開啟 App 或執行介面提供的操作。若系統未顯示某種元件,不應推斷設定檔缺少某一行,也不要透過網路規則尋找與系統元件無關的解法。

Widget 的預設狀態需在兩處核對:App 內的相關設定,以及系統桌面或元件頁面中實際新增的項目。App 提供 Widget 入口,不代表系統已放置元件;已放置元件,也不代表其中資訊會持續即時更新。建議先保留 App 的初始選項,只新增日常確實需要的入口。元件數量與尺寸應方便辨認與操作,不必為了排查連線而一次新增所有形式。

狀態文字可能晚於實際連線變化

系統會安排元件更新時機,因此 Widget 中的文字可能短暫不同於 App 內的目前狀態。點選連線後,應回到 App 並查看系統 VPN 狀態,再發出一次實際請求。不要只因元件仍顯示舊狀態就連續點擊;多次操作可能讓連線狀態反覆變動,反而難以判斷哪次操作生效。先完成一項操作並確認結果,再進行下一步,是處理元件互動問題的基本方式。

若狀態長時間未更新,先開啟 App 確認目前連線,再返回系統元件頁面查看;仍不一致時,可在保留 App 設定檔的前提下移除並重新新增 Widget。重新放置元件只是重建顯示入口,不會修復節點或 DNS。若 App 內的連線也失敗,應停止排查元件,改查基本網路、權限與節點參數。元件問題尚未定位前,不要刪除所有 Config,以免將顯示問題擴大成設定檔復原問題。

鎖定畫面、系統權限與顯示資訊

鎖定畫面或其他系統位置能否放置特定元件,取決於裝置系統與目前提供的元件形式。請使用系統實際提供的新增入口,不要將其他系統版本的版面視為本機必備功能。若元件需要開啟 App 才能完成操作,請依系統互動流程繼續,這不代表連線功能失效。若操作必須解鎖後才能完成,先解鎖再測試,避免將系統存取限制誤判為 App 沒有回應。

也要考慮元件顯示的資訊是否適合出現在他人看得到的位置。節點備註可能包含個人裝置、地區或用途等線索,設定檔名稱也可能透露使用習慣。建議使用自己看得懂但不過度具體的名稱,並在鎖定畫面只保留必要資訊。更改名稱後,確認元件是否更新;名稱只是識別標籤,不要為了讓畫面整齊而修改伺服器位址、認證欄位或訂閱網址,這些欄位用途完全不同。

區分快捷操作失敗與連線失敗

若 App 內可正常連線但 Widget 操作異常,先檢查系統元件與更新狀態;若 App 內也無法連線,則先檢查權限、網路與節點。不要同時修改兩個問題分支的設定。

與 On Demand 連動時,檢查實際觸發條件

透過 Widget 手動中斷後又恢復連線,可能與仍生效的 On Demand 條件有關,不一定是元件重複執行操作。先在 App 中核對自動條件,暫時停用後再透過 Widget 測試一次。若此時操作符合預期,應調整自動連線條件,而不是反覆移除元件。測試時固定網路,避免剛好在切換 Wi-Fi 時觀察,以免混淆手動操作與系統網路事件的影響。

建議將 Widget 放在整個連線流程的最後驗證:基本網路正常、App 內可連線、規則符合預期、自動條件已檢查,最後再測試快捷入口。如此即使元件暫時無法使用,仍可在 App 內操作。首次連線與系統授權的完整流程請回到使用說明;本章僅處理入口、狀態與更新,不將 Widget 視為提升網路效能的設定。

07 / ICLOUD

iCloud 同步:同步範圍、衝突與還原

先確認同步項目,不要將同步視為連線前提

iCloud 相關功能會在系統與 App 允許的範圍內儲存或同步資料,並非建立代理連線的必要步驟。先確認本機現有設定檔可用,再考慮同步至其他裝置。同步入口實際包含哪些資料,請以目前頁面列出的項目與操作為準;不要假設節點、設定檔、偏好設定、日誌與系統權限都會完整複製。尤其系統 VPN 授權仍需在相應裝置上確認;雲端出現設定檔,不代表另一台裝置已能連線。

同樣應在本機核對預設狀態。App 內的開關、系統 iCloud 設定與使用的帳號都會影響結果,不能只憑某個開關已開啟就認定同步完成。建議先保留可用的本機副本,再選一份容易辨認的設定檔進行小範圍驗證。若介面提供匯入、匯出或從雲端選擇檔案等不同操作,應先確認它們是複製一份內容,還是維持後續同步關係;操作名稱相近,不代表之後的更新方式相同。

首次啟用前,先建立可還原的本機基準

操作前記錄目前使用的設定檔名稱、來源,以及最近一次手動修改的內容。需要備份時,使用目前 App 提供的匯出方式,並將檔案存放在自己能管理的位置。備份檔案可能包含訂閱網址與認證資訊,應視為敏感資料處理,不要放在公開目錄或分享截圖。確認備份內容與還原方式後,再處理雲端副本;同步不能取代獨立備份,因為錯誤修改也可能同步至其他裝置。

首次測試可先在一台裝置進行重新命名或其他容易辨認、且不影響連線的變更,等待另一台裝置出現預期變化,再反向驗證。若實際入口只負責匯入檔案,應將它視為一次性複製,而非等待自動更新。不要為了催促同步而反覆切換帳號、連續匯入同一檔案或刪除本機設定檔;這些操作可能產生更多副本,讓有效設定檔變得難以辨認。

兩台裝置同時修改時的處理方式

發生衝突時,先暫停在另一台裝置繼續編輯,並分別儲存兩端的內容。不要只看檔案名稱判斷新舊,名稱相同的檔案內容也可能不同;也不要將系統顯示時間直接視為每項設定的修改時間。比較重點包括伺服器欄位、規則順序、策略名稱及最近修改的部分。確認準備保留哪一份基準後,再透過明確的匯入或儲存操作統一內容;尚未確認方向前,不要選擇覆寫。

訂閱更新與雲端同步是兩條不同的流程。Subscribe 更新通常會從現有服務商網址取得內容;雲端操作則處理裝置之間或不同檔案位置的資料。節點未更新時,先檢查訂閱更新結果,不要先關閉 iCloud;本機規則還原成舊內容時,才檢查匯入來源與同步副本。也要留意訂閱更新是否會取代自行修改的內容,重要自訂項目應另行記錄,不要依賴記憶重新填寫。

現象先核對建議做法
另一台裝置看不到內容帳號、系統雲端權限、實際同步項目以單一設定檔驗證,不要反覆大量匯入
出現多個相似副本是否多次執行一次性匯入確認可用基準後再整理名稱
節點內容沒有更新Subscribe 的更新結果先排查訂閱流程
設定檔存在但無法連線本機授權、網路與伺服器參數依新裝置首次連線步驟驗證

還原後仍須逐項驗證執行環境

還原成功的判斷標準不是檔案已出現,而是能選擇預期設定檔、確認節點資訊、建立連線並符合正確規則。不同裝置的網路環境可能不同,DNS 與 On Demand 條件也可能需要分別檢查。不要因為一台裝置可以使用,就認為另一台裝置的權限提示是多餘步驟;先依系統提示完成本機授權,再按照本頁的分層方式驗證。

若擔心同步繼續覆蓋剛修復的內容,先保留兩份副本並暫停繼續編輯,確認目前入口的同步方向後再恢復日常操作。涉及訂閱網址時,請向你的服務商取得正確資料,不要公開連結尋求協助。Subscribe、手動填寫與掃描 QR Code 入口的差異,請參閱訂閱匯入方式;匯入方式不同,後續更新的位置也可能不同。

08 / PROXY AND CONFIG

Proxy 連接埠、規則連動與最終復原

本機監聽連接埠不是遠端伺服器連接埠

Proxy 相關連接埠應先分清方向。Add Server 中的連接埠是遠端伺服器的連線參數,應與服務商提供的資料一致;本機 Proxy 監聽連接埠則供其他程式連線至本機入口使用,兩者不必相同。若只使用系統連線功能,不必為了「設定完整」而額外啟用本機監聽。若目前平台與介面提供相關入口,再依實際需求設定;不能假設所有裝置都提供某個平台的監聽功能。

預設連接埠、監聽位址及是否允許區域網路存取,請以目前介面為準;本頁不指定適用所有平台的通用初始數值。沒有明確需求時,建議維持原狀。確實需要其他程式使用本機 Proxy 時,先只在本機驗證,並確認 Proxy 類型符合目標程式支援的類型。HTTP 與 SOCKS5 不能任意互換;目標程式選錯類型時,即使連接埠可以連線,也可能無法完成請求。

分別確認監聽位址與存取範圍

監聽回送位址表示僅供本機使用;監聽其他位址則可能擴大可存取範圍。不要為了排查連接埠問題就直接開放整個區域網路。先檢查連接埠是否被其他程序占用、目標程式是否填入正確的本機位址,以及 Proxy 功能是否確實已啟動。若需要讓區域網路中的裝置存取,再檢查系統權限、防火牆、目前網路隔離狀態與 App 提供的存取控制。只在自己管理的網路中測試,不要將監聽連接埠暴露於不受控的網路。

發生連接埠衝突時,選擇目前系統允許且未被占用的連接埠,並同步修改使用該連接埠的程式;只修改其中一端會造成新的故障。修改後重新建立連線,必要時重新啟動相關監聽功能。驗證完成後,關閉暫時開放的存取範圍。區域網路位址會隨網路變動,另一台裝置儲存的舊位址也可能失效;跨裝置存取失敗時,應先核對目前位址,不要立即修改遠端節點。

規則只決定連線路徑,不會修復協定參數

在 Config 模式下,規則通常依照由上而下的順序比對,命中後依相應策略處理。DOMAIN-SUFFIX 適合比對網域後綴,IP-CIDR 與 IP-CIDR6 依位址範圍比對,GEOIP 依據相應的 IP 位址歸屬判斷,FINAL 則作為最後的備援規則。PROXY、DIRECT、REJECT 分別表示代理、直連與拒絕策略。規則正確也無法彌補密碼、憑證主機名稱或伺服器連接埠錯誤,分流驗證與連線驗證必須分開進行。

以下僅展示用來理解順序的規則片段,並非完整設定檔。範例中的網域與網段用於說明比對關係,不應未經檢查就取代目前檔案。實際使用前,請確認策略名稱可用並保留原始檔案副本;尤其 FINAL 的設定會決定其他請求的去向,不能因範例使用某個策略,就認定它適用於所有網路。

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

驗證時,選擇明確會符合目標規則的請求,再從 Log 查看實際命中結果。若規則看似未生效,依序檢查 Global Routing 是否為 Config、是否選取剛編輯的設定檔、前方是否已有範圍更廣的規則,以及請求是否沿用舊連線。若測試只修改網域規則,應發出新的網域請求,不要只依據已建立的工作階段判斷。規則順序的完整說明請參閱規則優先順序與 FINAL。

以最少變更結束疑難排解

最後逐項還原暫時測試的項目:不再需要的本機監聽應予關閉,暫時提高的日誌層級應調回,Global Routing 應恢復日常模式,On Demand 只保留已驗證的條件。接著在穩定網路中重新連線,造訪先前故障的目標,再檢查一次規則與日誌。若恢復某項設定後故障立即重現,該項變更就是下一輪明確的檢查對象,不必重新調整所有選項。

完成標準

能重複建立連線、目標請求使用預期策略、切換網路後的行為符合設定,並保留可還原的設定檔副本。單一開關顯示已開啟,或一次測試收到回應,都不能取代這些驗證。

問題仍未解決時,整理最精簡的重現紀錄:平台、網路類型、目前模式、失敗階段,以及已嘗試並還原的欄位。不要附上完整訂閱或認證資訊。首次連線問題請回到使用說明依序檢查;需要重新取得客戶端或查看系統允許步驟時,請參閱下載頁安裝說明。保留能解釋結果的設定,撤銷沒有證據支持的修改,才是後續維護的穩定起點。