OFFICIAL MANUAL / SETTINGS REFERENCE
Shadowrocket 設定指南,依連線行為查找設定值
先確認目前的設定,再一次只修改一個變數。本頁依解析、連線、分流、測試與本機入口整理各項設定,說明每項設定會帶來什麼變化,以及如何確認是否生效。
本頁是 Shadowrocket 官方手冊的系統化查閱頁。首次匯入自己已有的訂閱、選擇伺服器並連線,請先閱讀快速入門教學;已能連線、需要調整 Settings 或排查異常時,再依下方目錄查閱。本頁以 iPhone / iPad 的介面用語撰寫;其他平台的選項位置、系統授權與可用功能,請以實際用戶端為準,勿直接將行動版操作路徑套用至桌面版。
取得方式:iPhone / iPad 版於 App Store 售價 $2.99,為一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。系統需求請以 App Store 頁面標示為準;各平台的取得方式與安裝放行步驟請見下載頁。用戶端一次性買斷不等於線路方案;本站不提供、不販售、不推薦節點或訂閱,以下操作均以使用者已有自己的訂閱或伺服器資料為前提。
- DNS
- On Demand
- Connectivity Test
- Log
- Proxy
01 / BASELINE
Settings 基準:區分預設、目前與生效狀態
先確認設定所屬的層級
Shadowrocket 的連線結果並非只由 Settings 決定。Home 中選取的伺服器決定連線出口,Global Routing 決定是否依規則處理目標,Config 中目前使用的檔案提供規則及部分網路參數,Settings 則儲存測試、連線輔助與應用程式偏好等選項。系統 VPN 授權、網路環境與背景排程也會影響結果。排錯前應先釐清各個層級,避免伺服器憑證失效時反覆修改 DNS,或在 Direct 模式下判斷某條 PROXY 規則是否正確。
「預設值」是在特定環境下的初始值;「目前值」是介面此刻顯示的值;「生效值」則是連線實際使用的值。三者可能不同:匯入 Config 後,檔案中的解析設定可能改變實際路徑;編輯了某個檔案卻沒有選用它,編輯內容便不會成為本次連線的依據。閱讀本頁建議時,先確認該選項是否適用於目前平台,再核對應用程式內的說明、所選 Config 與正在執行的連線,不要只憑舊版介面截圖判斷。
建立可復原的設定記錄
開始前記錄目前的網路類型、伺服器名稱、Global Routing 模式、Config 檔案名稱及準備修改的欄位。已有設定請先保留副本,訂閱產生的檔案與手動維護的檔案分開命名;名稱可註明用途,但不必寫入帳號或完整位址。若匯出內容含有伺服器密碼、訂閱參數或身分資訊,只儲存在自己能掌控的位置。提供他人協助時,截圖應遮蔽這些欄位,尤其不要漏掉看似一般查詢參數的網址憑證。
一次只修改一項,並為修改設定可觀察的目標。例如「修改 DNS 後,相同網域能夠解析」比「最佳化網路」更容易驗證;「切回 Wi-Fi 後不再自動連線」也比「關閉背景活動」更明確。選一個先前能正常存取的目標作為對照,再選一個異常目標。兩者都失敗時,優先檢查網路與連線本身;只有異常目標失敗時,再檢查規則、解析結果與目標服務,不要立刻重設所有設定。
| 項目 | 記錄內容 | 驗證重點 |
|---|---|---|
| Settings | 原開關狀態、原文字或數值 | 離開頁面後是否已儲存 |
| Config | 目前選取的檔案與副本 | 編輯中的檔案是否正在使用 |
| Home | 伺服器與 Global Routing | 重新連線後選取項目是否一致 |
| 系統網路 | Wi-Fi、行動網路或其他連線 | 切換網路是否改變結果 |
建議起點與復原條件
已能正常使用的設定應保留為基準,不必因某個選項名稱看起來較進階就啟用。尚未建立穩定連線時,先依照自己已有的設定需求操作,減少額外的自動化條件與手動覆寫項目。修改後儲存,並依該設定的要求中斷連線再重新連線;只重新開啟設定頁面,無法證明網路工作階段已重新建立。重新測試時使用相同網路、相同伺服器與相同目標,才能判斷變化是來自設定還是環境。
出現新問題時,先還原剛修改的項目,不要繼續疊加補償設定。若還原後問題依舊,檢查是否受到舊連線、系統 DNS 快取、應用程式快取或網路切換影響,再建立新的連線。復原也應有明確範圍:不要為了重現一次測試結果,就清除所有伺服器、刪除訂閱或重新安裝用戶端。若要回到匯入與首次連線的流程,請參照教學中的操作順序,將系統化排錯與初次使用分開處理。
02 / NAME RESOLUTION
DNS 設定:先確認解析路徑,再更換解析方式
系統 DNS、自訂 DNS 與 DNS over HTTPS
DNS 會將網域名稱轉換為連線所需的位址,但不能取代代理伺服器,也無法修正錯誤的協定參數。系統 DNS 通常沿用目前網路提供的解析設定,適合作為觀察網路原始行為的起點;自訂 DNS 會指定解析服務,但是否可連線仍受目前網路與設定影響;DNS over HTTPS 則透過 HTTPS 傳送查詢,還需要解析端點、建立連線並完成憑證驗證。選擇解析方式前,先確認問題發生在解析階段,不要一看到網頁載入失敗就更換所有 DNS 設定。
預設狀態應在目前用戶端與所選 Config 中一併確認。不要直接將「輸入框空白」解讀為「不進行解析」;空值可能代表沿用系統設定、使用 Config 值或採用用戶端內建行為,具體含義請以欄位說明為準。若 Config 的相關段落已指定解析參數,請先保留副本,再決定要在檔案或應用程式中修改。同一用途應明確指定單一管理來源,避免介面值與檔案值不一致,之後又誤以為設定沒有儲存。
建議值取決於網路條件
一般排錯時,建議先保留目前可正常運作的解析方式。需要自訂時,只填入自己確認可用且符合欄位格式的位址;傳統解析位址與 HTTPS 端點不能任意互換,不要將完整 URL 貼到只接受 IP 位址的輸入框。若欄位支援多個值,也應依照應用程式提示的分隔方式填寫,不要自行猜測要用逗號、空格或換行。一次新增一個解析入口,確認能解析並存取後,再考慮是否需要額外的備用項目。
內網網域是常見的特殊情況。印表機、公司內部服務或路由器管理名稱,可能只有目前網路提供的解析器能辨識;全部改用外部解析方式後,公用網站可正常使用但內網名稱失效,不代表代理伺服器故障。反過來說,某個解析器在家中可用,在旅館或辦公室網路中可能無法連線。切換網路後應重新檢查解析路徑,必要時保留內網專用的處理方式,不要把只在單一網路有效的設定當成所有網路的通用建議。
| 方式 | 適用起點 | 失敗時優先檢查 |
|---|---|---|
| 系統 DNS | 觀察目前網路與內網解析 | 網路提供的設定、驗證狀態 |
| 自訂 DNS | 已有明確可用的解析位址 | 位址格式、連接埠可連線性 |
| DNS over HTTPS | 需要透過 HTTPS 傳送解析請求 | 端點網域、時間與憑證、連線路徑 |
解析成功不代表存取成功
驗證時先觀察相同網域是否取得位址,再確認請求是否套用預期策略,最後確認目標服務是否回傳內容。網域規則可在連線前依名稱比對,IP 類規則則可能需要位址資訊,兩者的結果不能混為一談。解析出 IPv6 位址也不代表目前網路或伺服器路徑能完成 IPv6 連線。遇到偶發失敗時,應分別記錄回傳的位址類型、使用的策略與實際錯誤,不要只憑一次重試成功就認定 DNS 已修復。
修改後,舊結果可能暫時留在系統、瀏覽器或應用程式快取中。先重新建立連線,再發出新的目標請求;必要時關閉並重新開啟目標應用程式,避免沿用舊工作階段。不要反覆快速切換解析器來比較效果,這會讓快取、交握與網路波動互相干擾。更完整的路徑比較請參閱DNS 設定技術筆記。復原時請恢復原本的解析方式與設定來源,並再次測試內網名稱,確認公用網路存取恢復的同時,本機服務仍可使用。
03 / CONNECTION CONDITIONS
On Demand:明確設定自動連線條件
它決定何時連線,不決定使用哪條規則
On Demand 會依系統網路條件觸發連線,與 Global Routing 處理的是不同問題。前者關注「何時需要建立連線」,後者關注「連線建立後,某個目標應採用哪種策略」。啟用 On Demand 不會自動補齊伺服器資料,也不會替 Config 加入缺少的規則。初次使用時,應先手動完成一次穩定連線,再加入自動化條件;若手動連線本身就失敗,自動觸發只會重複同樣的失敗過程,也會讓現象更難判斷。
預設開關狀態與既有系統設定,請以裝置實際顯示為準。本頁不會將「永遠開啟」列為通用建議。需要手動控制的使用者,先維持手動連線較容易建立基準;確實需要依網路條件連線時,再依實際介面支援的條件逐項設定。若目前平台不支援某項條件,不要照搬其他裝置上的操作路徑,也不要將系統自動連線權限與用戶端中的開關視為完全相同的設定。
條件應可個別驗證
設定前先寫下明確需求,例如「在指定網路中維持手動連線,在其他網路中依條件觸發」。若介面支援依 Wi-Fi 名稱區分,請完整核對名稱,並留意名稱相似、網路同名與隱藏網路的影響;名稱相同不代表可信程度相同。依網路名稱比對只是連線條件,不是身分驗證機制。若加入多個條件,也應閱讀目前介面對優先順序與比對順序的說明,不要只看清單上的排列位置就推斷系統必定依該順序執行。
建議依照「一個網路、一項條件、切換一次」的方式測試。先在目前 Wi-Fi 確認行為,再切換到行動網路,最後切回原本的 Wi-Fi,分別記錄系統 VPN 狀態與應用程式內的連線狀態。測試期間維持相同伺服器與 Config,避免同時更新訂閱或更換伺服器。系統狀態圖示只代表隧道相關狀態,不能證明特定目標已可使用;觸發後仍要發出明確請求,確認連線成功且採用預期策略。
驗證網路、休眠與手動中斷
旅館、車站或訪客 Wi-Fi 可能要求先開啟驗證頁面。此時網路名稱雖符合條件,網際網路連線卻尚未完成,自動連線可能因此逾時。請先完成網路要求的驗證,再依既定條件測試;不要把驗證頁面無法開啟直接歸因於伺服器失效。若需暫時關閉 On Demand 才能完成驗證,請記錄原本狀態,完成後再恢復。網路由可用轉為受限時,也要分辨是「系統未觸發」還是「已觸發但連線失敗」。
裝置鎖定、應用程式切至背景或系統進入省電狀態,都可能改變觀察到的時序。不要因為「離開應用程式幾秒後沒有變化」就認定設定一定錯誤,也不要保證固定的背景觸發時間。手動中斷後是否重新連線,取決於目前系統條件與設定;若發現剛中斷又恢復,先檢查 On Demand,不要反覆刪除 VPN 設定。若要暫時維持中斷,應先關閉自動觸發條件,再確認系統狀態,避免把符合條件後重新連線誤判為開關故障。
| 情境 | 觀察項目 | 下一步 |
|---|---|---|
| 切換網路後未連線 | 條件是否符合、系統權限 | 先嘗試在相同網路手動連線 |
| 中斷後再次連線 | 自動觸發是否仍啟用 | 暫時關閉條件後重新測試 |
| 已連線但目標失敗 | 伺服器、DNS 與規則 | 依後續章節檢查資料路徑 |
復原時先停用剛新增的條件,恢復成容易釐清的手動連線流程,再重新檢查原伺服器與 Config。不要一次刪除所有系統網路設定,以免一併移除其他用途的設定。若手動連線正常,只有切換特定網路時異常,請保留切換前後的記錄,並在相同條件下重複驗證。能穩定重現的單一條件,比一組看似完整卻互相覆蓋的條件更適合作為長期設定。
04 / ROUTING AND CONFIG
Global Routing 與 Config:確認規則確實參與連線
設定、代理、直連三種模式
Global Routing 的 Config、Proxy、Direct 分別代表依設定處理、代理、直連三種模式。Config 會依目前選取的設定處理目標;Proxy 適合暫時檢查目標經代理路徑時的狀況;Direct 則用來觀察不經代理路徑的存取情形。這些模式名稱與規則中的大寫策略詞屬於不同層級,不要因為兩者都出現 PROXY 或 DIRECT,就認為可以互相取代。DNS 與系統網路行為仍須另外檢查;切換模式並不能完整說明整條網路路徑。
一般使用既有規則時,建議先確認目前為 Config 模式且選取了正確檔案,不要急著新增規則。目前預設模式應以 Home 的實際選項為準,檔案預設內容也應以使用者已有的設定為準。切換到 Proxy 後目標恢復,只能說明兩條路徑的表現不同,不能直接證明某個網域規則有誤;也可能與解析位址、規則涵蓋範圍或目標服務對出口的處理有關。測試結束後應恢復原模式,避免長期停留在暫時診斷模式。
| 介面用語 | 中文模式 | 主要用途 |
|---|---|---|
| Config | 設定 | 依選取的設定驗證規則比對 |
| Proxy | 代理 | 暫時比較代理路徑的表現 |
| Direct | 直連 | 建立直連路徑的對照結果 |
規則由上而下比對,先具體後兜底
規則通常依順序比對,較具體的例外應放在較廣泛的條件之前,最終策略則放在末尾。DOMAIN 用來精確比對網域,DOMAIN-SUFFIX 比對網域後綴及相關子網域,DOMAIN-KEYWORD 依名稱中的關鍵字比對。關鍵字規則涵蓋範圍較廣,容易攔截原本不打算處理的名稱,新增時應搭配實際請求記錄驗證。IP-CIDR、IP-CIDR6 與 GEOIP 著重於位址範圍或位址歸屬,不能只因名稱相似就與網域規則互換。
以下是用於了解比對順序的 Shadowrocket .conf 規則片段,不是完整連線設定,也不含伺服器資料。範例網域僅用於示範語法,不能當作測試服務。第一條將符合的網域後綴交由 PROXY 處理;第二條將指定的私有網路位址範圍交由 DIRECT 處理;第三條依 GEOIP 條件選擇 DIRECT;其餘請求則由 FINAL 交由 PROXY 處理。是否採用這種最終策略,應由使用者自己的設定目標決定,不要將整段規則直接覆蓋到既有檔案。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
避免設定更新覆蓋手動修改
Subscribe 用來管理使用者既有訂閱的更新,不代表 Config 中的規則檔會依預期自動合併。訂閱產生的伺服器資料、遠端設定內容與本機編輯內容應分別確認。若某個檔案會在更新時重新產生,直接寫入其中的修改可能會被覆蓋。建議保留原始檔案與本機測試副本,先在副本中驗證;確實需要長期維護的規則,應使用目前用戶端支援的管理方式,並明確列出更新後要檢查的內容,不要假設任何檔案都會自動保留手動編輯。
規則看似未生效時,依序確認四件事:是否選取剛編輯的 Config、Global Routing 是否設為 Config、請求是否使用預期的網域或位址,以及是否已有較前面的規則先比對成功。應用程式可能沿用舊連線,也可能另外請求其他網域,不能只憑瀏覽器網址列判斷實際比對的對象。儲存並重新連線後,從 Log 找出這次請求,再對照規則;若仍不明確,可先建立一條範圍明確的暫時規則進行驗證,完成後刪除,避免排錯規則長期改變流量路徑。
05 / CONNECTIVITY TEST
Ping 與 Connectivity Test:釐清數值測量的是哪一段
測試結果不能單獨代表線路品質
不同測試方式中的 Ping 可能代表不同的探測流程。請先閱讀 Settings 中目前選取的測試方式與目標,再解讀結果;不能只看清單中的單一耗時數值,就把它當成實際網頁的完整載入時間。往返伺服器、建立傳輸連線、完成代理驗證與存取測試目標,屬於不同階段。某種探測成功,只能證明該探測涵蓋的階段有回應;另一種探測逾時,也不一定代表伺服器完全無法使用,必須依測試方式與實際請求一併判斷。
預設測試方式、測試位址與逾時設定,請以目前用戶端的實際值為準;本頁不提供跨平台通用的固定預設數值。建議先保留目前可用的測試設定,確保同一組結果能相互比較;確實需要修改時,先記下原值與修改原因。若介面允許設定目標位址,請選擇自己確認可連線、回應穩定且適合該測試方式的目標,不要把任意網頁首頁都當成同等的探測點。目標服務若主動拒絕某類請求,也可能造成結果異常。
逾時、並行測試與結果可比較性
逾時時間過短,可能將正常但較慢的交握判定為失敗;過長則會拉長整組測試的等待時間。建議從用戶端目前的數值開始,根據同一網路下的重複結果小幅調整,而非直接追求最短時間。行動網路切換、裝置剛喚醒或伺服器網域尚未解析時,首次測試可能包含額外準備流程,應與後續結果分開記錄。若設定項目標示了單位,修改前先確認是毫秒還是秒,不要直接複製其他欄位的數值。
若目前平台提供並行測試設定,一次測試太多伺服器可能同時占用網路與裝置資源,也可能觸發遠端限制。排查單一伺服器時,優先個別測試,再與少數已知可用的對照項目比較。排序改變本身不代表故障,短暫波動就足以影響順序。不要為了讓清單看起來整齊而不斷更換測試目標;這會讓前後資料失去共同基準,無法判斷是網路真的改善,還是只換了回應較快的探測端點。
| 現象 | 可能的特殊情況 | 驗證方式 |
|---|---|---|
| 測試成功,網頁失敗 | 探測未涵蓋實際目標與規則 | 檢查實際請求採用的策略與錯誤 |
| 測試逾時,網頁可用 | 測試目標或探測方式受限 | 維持連線,單獨確認測試設定 |
| 所有項目都失敗 | 目前網路或共用測試目標異常 | 測試網路基本連線與對照項目 |
| 只有單一項目反覆失敗 | 該伺服器資料或對應路徑異常 | 核對參數,不要先修改全域設定 |
串聯測試與實際存取結果
一次完整驗證應包含三項獨立觀察:伺服器探測是否成功、連線是否建立、目標請求是否完成。先對使用者已有的伺服器執行 Connectivity Test,再選取該伺服器建立連線,最後請求固定目標並查看 Log。三個步驟都應使用相同網路,中途不要更新訂閱。若探測失敗但連線與目標請求正常,記錄測試設定即可,不要只為了修正清單狀態而破壞原本可用的實際連線。
網頁能開啟但大型檔案傳輸緩慢時,探測耗時也不能取代持續傳輸的表現。傳輸量還會受到目標服務、網路壅塞、協定參數與遠端處理能力影響;同樣地,單次耗時很短也不能證明長連線一定穩定。需要比較時,請使用自己指定的相同目標與相近時間範圍,記錄上傳、下載及中斷情形。Hysteria2 等協定的傳輸背景可參閱Hysteria2 協定技術筆記,但協定說明不代表對任何線路表現的保證。
測試結束後,請恢復原本的測試目標、逾時與並行測試設定,或明確記錄保留變更的理由。尋求協助時,提供測試方式、網路類型、異常是否可重現,以及實際存取是否成功,會比只提供一個數值更有幫助。不要附上完整訂閱網址或伺服器驗證欄位。若異常只出現在某種網路,請保留同一裝置在另一種網路下的對照結果,下一步應檢查網路條件,而不是直接推斷所有伺服器資料都已失效。
06 / LOG AND DATA
Log 與 Data:依請求記錄定位失敗階段
先限定時間範圍,再閱讀錯誤
Log 的用途是將一次連線過程拆解為可觀察的事件,而不是收集越多文字越好。開始排錯前先記下時間,盡量減少其他應用程式的活動,只重複一次明確的失敗操作,再查看對應記錄。若沒有限定時間範圍,背景請求、系統網路檢查與目標應用程式的重試就容易混在一起。記錄中出現錯誤,不代表它一定是目前問題的原因;應先確認目標、伺服器、時間與本次操作是否相符。
日誌開關、層級與保留方式,請以目前 Settings 與實際平台支援為準,不要假設所有平台都有相同的層級選項。日常使用建議保留用戶端既有設定;需要更詳細資訊時,暫時提高記錄範圍,重現問題後儘快恢復。長時間記錄可能增加儲存與處理負擔,也會累積更多敏感資訊。若調整日誌設定需要重新建立連線,請先保存相關記錄,再重新連線驗證,避免在重新啟動期間遺失原本能說明問題的事件。
依解析、連線、驗證與目標回應區分
閱讀時可先從解析開始,再確認遠端連線是否建立、協定驗證是否完成,最後檢查目標請求與回應。名稱無法解析時優先檢查 DNS;連線階段反覆逾時時,檢查目前網路與伺服器是否可連線;驗證相關錯誤應核對使用者已有的資料;若目標已回傳內容或狀態,則應進一步確認目標本身的行為。不要把所有 timeout 都歸為同一種原因;相同字詞可能出現在不同階段,處理方式也不相同。
診斷規則時,應一併查看請求目標、命中規則與策略。瀏覽器開啟頁面時,可能同時連線至圖片、指令碼與其他網域,不能只搜尋網址列中的名稱。某項請求被 REJECT,也不一定會導致整個頁面失敗;應先確認它是否為必要資源。若目前記錄未顯示某個欄位,不要自行推測補上;可縮小重現範圍,以相同目標重新請求,再於 Config 中核對最可能命中的規則位置。
| 觀察來源 | 可以回答的問題 | 無法單獨證明的事項 |
|---|---|---|
| Log | 某次請求經過哪些階段、發生何種錯誤 | 長期傳輸量或所有應用程式的使用體驗 |
| Data | 統計範圍內的上傳、下載與累計變化 | 特定網頁已成功載入、每條規則都正確 |
| 系統 VPN 狀態 | 系統隧道相關的連線狀態 | 遠端目標已可連線 |
解讀 Data 數值時應確認統計範圍
Data 中的數值應連同目前檢視畫面、統計起點與重設操作一併解讀。依伺服器或應用程式檢視,回答的問題不同,不應將兩種畫面中的數值直接視為完全相同的流量統計方式。少量上傳與下載可能來自交握、重試或背景請求,不代表網頁已載入完成;總量增加也無法單獨證明目標採用了哪條規則。查看時先固定伺服器與應用程式,再透過一段可控制的操作觀察增量,不要用過去累計的數值解釋剛發生的故障。
需要歸零時,先確認目前按鈕會影響的統計範圍,並保存歸零前的對照資料。不要每次失敗後就立刻清除所有統計,否則會失去時間上的關聯。若未顯示應用程式歸屬或統計項目,先確認平台功能、流量是否經過目前連線,以及目前的檢視畫面;不要自行補出不存在的應用程式層級證據。讀數的詳細解讀請參閱Data 流量統計說明,可搭配日誌定位問題,但不能取代請求記錄。
分享前盡量減少敏感資訊
日誌可能包含完整網域、請求路徑、訂閱參數、伺服器位址、裝置資訊與身分欄位。分享前只保留與問題相關的短片段,遮蔽驗證資訊及可識別個人的內容;即使是自己的訂閱,也不要將完整網址當作一般文字公開。保留階段名稱、錯誤文字與相對時間,通常已足以說明問題。完成診斷後,請恢復原本的日誌記錄範圍,並依實際需要清理匯出檔案,避免排錯資料長期留存成憑證副本。
07 / WIDGET AND ICLOUD
Widget 與 iCloud 同步:區分操作入口、狀態與設定副本
Widget 是操作入口,不是網路檢測結果
Widget 可讓使用者從系統提供的位置查看或操作用戶端相關狀態;實際樣式、可用操作與重新整理行為,請以裝置系統與用戶端支援為準。它不是獨立的連線設定,也不能取代 Home 中的伺服器選取。看到 Widget 顯示已連線,仍應透過目標請求確認存取結果;看到狀態尚未更新,也不能立刻推斷連線已中斷。系統可能限制重新整理頻率,因此顯示狀態與實際網路變化之間可能存在時間差。
是否新增 Widget 是使用者的系統介面選擇,不應描述為用戶端一律預設啟用。建議先在應用程式內確認連線,再新增需要的操作入口;若系統提供多種尺寸或操作項目,依實際需求選擇即可,不必全部加入。執行連線或中斷操作後,請回到 Home 並確認系統 VPN 狀態。若 On Demand 仍符合觸發條件,手動中斷後可能再次連線;此時應檢查自動連線條件,而不是反覆移除 Widget。
同步前先確認要同步哪些內容
iCloud 同步可讓支援範圍內的資料在裝置間保持關聯,但不能假設所有 Settings、系統授權、Widget 版面與執行狀態都會一併移轉。目前用戶端可同步哪些內容,請以同步介面的說明與實際結果為準。系統 VPN 授權屬於裝置本機設定;某台裝置上的伺服器可用,不代表另一台裝置已完成相同授權。初次移轉時,應將「資料已出現」與「已能建立連線」分成兩項檢查。
啟用同步前,先保留本機設定副本,並確認裝置使用預期的 iCloud 帳號、系統允許應用程式使用 iCloud,且網路能完成同步。不要將帳號相同視為同步已完成;系統限制、儲存空間狀態與背景執行條件,都可能延後同步結果。預設同步開關與資料範圍請以實際介面為準;若只是要複製少量設定,沒有必要倉促啟用整組同步。若只需要某個檔案,也可使用用戶端支援的匯入與匯出流程,並妥善保管其中的敏感資料。
透過單項變更觀察同步範圍
建議先選擇不含憑證、容易辨識的設定名稱或一般偏好作為觀察項目,在一台裝置修改,等待另一台裝置顯示變化,確認同步方向與範圍後,再處理重要內容。不要同時在兩台裝置編輯同一個檔案,否則難以判斷哪一份才是預期副本。若發生衝突或出現重複項目,先停止繼續編輯並保留兩端內容,逐項比較後再決定要保留哪一份;不要直接把「最後看到的那份」認定為最新且完整的資料。
| 層級 | 應確認的內容 | 驗證方式 |
|---|---|---|
| 資料 | 伺服器項目、Config 與名稱 | 逐項比對本機副本 |
| 權限 | 系統 VPN 授權與相關存取權限 | 依裝置提示確認後手動連線 |
| 行為 | Global Routing、On Demand | 使用固定目標並切換網路重測 |
| 入口 | Widget 與本機顯示 | 重新新增並確認實際操作 |
若另一台裝置已顯示伺服器但無法連線,先確認該裝置的網路與權限,再檢查伺服器參數是否完整;不要立刻關閉再重新啟用同步。若相同資料在兩台裝置上的結果不同,系統網路、DNS 與可用的協定功能都可能是原因。需要復原時,請使用先前保留的本機副本,並確認復原內容是否會繼續同步到其他裝置。先了解刪除、取代與同步範圍再操作,避免本機排錯變成跨裝置資料異動。
分開處理購買項目復原與設定同步
iPhone / iPad 的購買項目復原,請依下載頁中的已購項目復原說明操作。iCloud 中存在設定不代表商店購買狀態已復原;反過來說,復原應用程式也不代表本機資料一定完整。iPhone / iPad 版於 App Store 售價 $2.99,為一次性付費;Mac、Windows、Android、Linux 版免費。購買用戶端與使用者已有的線路資料是兩回事。換機前請保留設定,換機後確認授權,再參閱已購項目復原與重新取得說明,避免將不同系統的帳號與資料流程混為一談。
08 / LOCAL PROXY AND RECOVERY
Proxy 連接埠與最終排錯:限定監聽範圍,分層復原
本機入口與遠端伺服器連接埠不同
Proxy 相關連接埠應先區分用途:Add Server 中的連接埠屬於使用者已有的遠端伺服器資料;本機代理監聽連接埠則是用戶端提供給其他程式使用的入口。兩者名稱都有連接埠,但不能互相照抄。遠端連接埠應依既有資料填寫,本機連接埠則須與實際使用該入口的程式一致。目前平台是否提供 HTTP、SOCKS5 或其他本機入口,以及是否需要額外開關,請以 Settings 中實際選項為準,不要假設所有平台都完全相同。
監聽位址與連接埠沒有跨平台通用的建議數值,應先查看目前設定與應用程式說明。若本機代理只供同一裝置使用,優先維持僅本機可存取的範圍;沒有明確用途時,不要擴大至區域網路監聽。若需要讓其他裝置存取,請確認用戶端確實支援、系統網路允許,並檢查存取控制與驗證選項。擴大監聽範圍不只是「讓連線更方便」,也會讓同一網段的裝置可能接觸此入口;必須先確認哪些裝置可以連線,以及如何停止提供服務。
位址、協定與連接埠必須搭配正確
使用本機入口的程式,必須同時填入正確的協定、位址與連接埠。HTTP 入口不能只因數字相同就當成 SOCKS5 入口,遠端伺服器位址也不能取代本機監聽位址。同一裝置存取迴送位址,與另一台裝置存取該裝置的區域網路位址,是兩條不同路徑。另一台裝置若填入自己的迴送位址,只會連到它本身,不會自動指向執行 Shadowrocket 的裝置。排錯時先確認請求來自哪台裝置,再確認入口實際在哪台裝置上。
連接埠衝突通常會導致監聽無法啟動,或請求被其他本機程式接收。更換連接埠前先記錄原值,並確認新連接埠未被占用;修改後同步更新所有使用該入口的程式,再重新測試。若只改其中一端,用戶端可能已正常運作,但呼叫端仍在連線舊入口。停止提供本機代理後,也應恢復呼叫端的代理設定,否則它可能持續連線至已關閉的連接埠,造成整體網路似乎失效的錯覺。
依失敗範圍決定檢查順序
若所有應用程式都無法使用,先確認基本網路、系統 VPN 狀態、所選伺服器與驗證資料;若只有使用本機入口的程式失敗,先檢查協定、監聽位址、連接埠與存取範圍。若只有特定目標失敗,再檢查 DNS、Global Routing 與規則比對結果。依此分流可減少不必要的修改。區域網路裝置無法連線至入口時,還要確認裝置是否位於同一網路、是否啟用訪客網路隔離,以及系統防火牆設定;不能只因遠端伺服器測試成功,就認定區域網路入口也應可連線。
| 異常範圍 | 先復原 | 再驗證 |
|---|---|---|
| 修改連接埠後,單一程式失敗 | 呼叫端與監聽端一致的原始設定 | 入口協定與本機連線狀態 |
| 切換網路後失敗 | 手動連線與原本的 DNS 基準 | 網路驗證與 On Demand 條件 |
| 更新設定後目標失敗 | 原 Config 副本與原本模式 | 規則順序與實際請求目標 |
| 跨裝置資料不一致 | 保留兩端副本,暫停同時編輯 | 同步範圍與系統權限 |
完整復原不等於全部重設。先撤銷最近的修改,再恢復原本的 Global Routing 與 Config,接著確認 DNS 與 On Demand,最後檢查呼叫端是否仍保留本機代理設定。每復原一個層級,就使用固定目標發出一次請求;找出結果開始改變的位置後,停止擴大操作。若回到基準後問題仍在,保留相關 Log 的短片段與測試條件,再確認使用者已有的訂閱是否更新、伺服器資料是否變更,不要為了碰運氣而刪除所有內容。
若需重新安裝或改用其他平台,請統一從全平台下載入口取得,並閱讀系統安裝放行說明;Windows 請確認來源後依 SmartScreen 提示操作,Mac 請確認來源後依系統「隱私權與安全性」中的提示放行,Android 則依系統提示授予相應的安裝來源權限。安裝完成後,先依照快速入門教學恢復基本連線,再逐項恢復本頁設定。需要了解模式差異時,可繼續閱讀代理模式說明;不要把暫時有效的診斷參數直接當作長期設定。