官方手冊 · 設定參考

Shadowrocket
Settings 設定項目參考

依設定項目查閱用途、預設狀態、調整條件及驗證步驟。

本頁適用於已建立連線後查閱系統設定;首次使用者若要匯入現有訂閱、選擇伺服器並建立連線,請先閱讀快速入門教學,完成基本操作後再回到相關章節。以下以 iPhone / iPad 的介面用語為參考,其他平台的項目位置與適用範圍請以實際介面為準。

先記錄原值 一次調整一項 驗證後再保留

設定基準與 Config 適用範圍

調整設定前,應先建立可供復原的基準。Shadowrocket 的行為可能同時受到 Settings、目前選取的伺服器、正在使用的 Config 及系統網路狀態影響;看到某個開關已開啟,並不能單憑這點判定目前請求的流向。先在 Home 記下伺服器名稱與連線狀態,再檢查 Global Routing,最後進入 Config 確認目前使用的設定檔。記錄時只保留方便辨識的名稱,勿將訂閱網址、密碼或金鑰貼到公開筆記。之後每次測試都從相同條件開始,才能判斷變化是由哪個項目造成。

預設值:以目前安裝狀態為準

本手冊不會將所有裝置的初始值設定為同一組固定數值。首次安裝、還原備份、匯入設定或系統升級,都可能讓目前狀態有所不同;某些選項也只會在符合條件時顯示。此處所說的「確認預設狀態」,是指尚未修改項目前,記錄目前介面顯示的值及其來源,而非先還原所有設定。建議值則依用途說明:沒有明確問題時保留原值;需要驗證假設時一次只調整一項;確認沒有改善時就還原。不要為了讓介面與文章截圖一致,而更動原本正常的連線。

Global Routing:先確認三種模式

Global Routing 決定整體路由模式,但不能取代對每條連線的觀察。Config 模式會依目前設定中的規則處理請求;Proxy 模式可用來比對伺服器路徑;Direct 模式則可用來觀察目前網路直接存取時的情況。這三種模式是排查時的條件,不代表速度等級。使用 Proxy 時仍須考量本地網路、伺服器位址及 DNS 是否可連線;使用 Direct 也不能因此認定所有 App 都一定能成功。實際測試應使用相同目標、相近時間與相同網路,避免將目標本身的變化誤認為模式差異。

模式主要用途確認重點
Config 模式依設定規則分流目前使用的設定、命中規則、策略流向
Proxy 模式比對伺服器路徑選取的伺服器、通訊協定參數、連線結果
Direct 模式比對目前網路網路認證、直接存取、解析結果

規則片段與設定檔的界線

規則通常依序比對,因此排在前面的寬泛規則可能先於後面的精確規則生效。下方只是用來理解語法的片段,並非可取代現有檔案的完整設定;其中 PROXY 必須對應實際可用的策略或設定定義。DOMAIN-SUFFIX 用於比對網域後綴,GEOIP 依位址所屬地區條件處理,FINAL 則接手先前未命中的請求。修改前請先另存設定副本,再於副本中調整規則順序。若某個網域仍有連線維持中,修改後應重新建立測試請求,避免繼續觀察舊連線。

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

記錄結果,而非累積變更

建議每次記錄「原始狀態、修改項目、測試目標、觀察結果、是否還原」五項。例如,只切換 Global Routing,伺服器與網路維持不變;若結果沒有差異,先還原原本模式,再測試 DNS。訂閱更新與手動編輯也應分開進行,否則檔案更新後,很難確認手動修改是否仍然存在。設定中遇到不熟悉的關鍵字,先到術語手冊查閱,不要一次大量刪除。完成一項測試後,再用原本正常的 App 進行回歸測試,避免只修好單一目標,卻改變日常使用路徑。

DNS:解析來源與連線路徑

DNS 的作用是將網域名稱轉換成可供連線使用的位址;解析成功與連線成功是兩個不同環節。頁面無法開啟,可能是沒有取得位址,也可能是已取得位址卻無法連線,還可能是在後續加密交握時失敗。因此,不要把所有連線錯誤都歸咎於 DNS。先確認問題是否只影響特定網域,再檢查相同目標在目前網路下的情況,最後搭配 Log 判斷失敗階段。設定已正常運作時,建議保留現有 DNS 方案,不要只因某個解析服務被形容為「更快」就更換所有設定。

預設狀態:同時檢查 Settings 與 Config

開始前,分別查看 Settings 中與 DNS 有關的選項,以及目前使用的 Config 中的 DNS 設定。介面顯示的某個位址,不一定是所有查詢最後使用的位址,因為設定檔、系統網路與特定規則可能共同影響結果。記下原有位址、順序及相關開關;若某項沒有明確顯示,不要自行猜測並補上數值。匯入的設定檔若包含 DNS 設定,先閱讀其說明,再決定是否修改。排查時只更動一個明確可辨識的來源,並確認該設定檔已選取;只編輯未啟用的檔案,不會改變目前的連線行為。

先區分一般解析與加密解析

一般 DNS 與加密 DNS 的傳輸方式不同,不能只因兩者都會回傳位址,就認為設定條件相同。使用以網域名稱表示的加密解析端點時,還必須先處理該端點如何解析,以及目前網路能否連線等問題;系統時間明顯不正確,也可能影響憑證驗證。建議使用來源可確認、傳輸方式清楚且目前網路可連線的解析設定。不要將多個來源不明的位址堆疊使用作為排錯方式,這會讓回傳結果與等待失敗的情況更難判讀。更換網路後,也應重新確認相同解析方案是否仍可正常運作。

IPv4、IPv6 與規則比對

同一網域可能同時回傳 IPv4 與 IPv6 位址。若某條路徑的 IPv6 連線能力不足,可能會等候較久才成功,也可能部分 App 正常、部分失敗;但不能只憑這種現象,就斷定應關閉所有 IPv6 功能。先在目前網路與另一個可用網路分別重現,再查看連線記錄中的位址類型。若設定使用 IP-CIDR 或 IP-CIDR6 比對,也要確認實際位址是否落在預期範圍內。以網域為基礎的規則與以位址為基礎的規則,觀察角度不同;排查時應保留完整網域與位址類型的對應資訊。

觀察到的情況優先確認不宜直接下的結論
只有一個網域無法連線該網域的解析結果與目標服務所有 DNS 都無法使用
切換網路後恢復正常網路認證、解析端點是否可連線伺服器參數一定有誤
解析後連線逾時目標位址、路由與傳輸路徑再增加解析位址就能修復

依序驗證每次修改

先結束目前正在測試的請求,記錄目前使用的設定檔,然後只修改一項 DNS 設定。儲存後依介面要求重新建立連線,再用相同網域發出新請求,同時查看日誌中的解析與連線記錄。App、系統與瀏覽器都可能保留快取,因此重複重新整理不一定會產生新的解析查詢;若沒有看到新查詢,不要立刻認定修改無效。可以關閉測試 App 後再試一次,並比較新的時間點。若無法連線的網域變多,先還原記錄的原值,再檢查位址、通訊協定格式或端點路徑是否輸入錯誤,不要繼續疊加其他修改。

保留能解釋的結果

完成 DNS 調整後,應同時測試一個原本正常的目標,以及一個原本異常的目標,確認修改沒有擴大影響。若只有特定 Wi-Fi 無法使用,先完成該網路的登入認證;若只有某項服務異常,則繼續檢查規則命中情況與目標服務狀態。不要直接用伺服器 IP 取代網頁網址進行測試,因為 HTTPS 還涉及主機名稱與憑證,測試結果並不相同。仍無法找出原因時,可依照問答頁的故障分類繼續檢查,並保留已去除敏感資訊的失敗階段與網路條件,不要公開整份設定。

On Demand:觸發條件與自動連線

On Demand 會依條件決定連線行為,不負責判斷伺服器是否適合目前用途,也無法取代 Global Routing。前者回答「何時建立或變更連線」,後者回答「連線建立後如何處理請求」。若手動連線尚不穩定,建議先維持手動連線,完成伺服器與設定驗證後再設定 On Demand。否則自動觸發、手動切換與伺服器端失敗會交錯發生,讓「為什麼又連上了」與「為什麼無法存取」變成同一個難以解釋的問題。測試自動行為前,應先確認基本連線可正常使用。

預設狀態:查看現有開關與條件

進入 On Demand 後,先記錄總開關、已有條件及排列順序,不要假設新裝置一定是關閉狀態。系統還原或設定遷移後,目前狀態可能與初次安裝時不同。若已有規則,先了解每條規則涵蓋的網路範圍,再新增條件;不要只看到某個 Wi-Fi 名稱,就認定它是唯一的觸發來源。建議從最少條件開始,先在一個明確的網路環境驗證行為,再擴展到其他情境。需要暫時排查連線時,可先停用自動觸發並記錄原狀態,測試結束後再恢復。

Wi-Fi 名稱與行動網路條件

依 Wi-Fi 名稱設定時,應確認實際連線的網路名稱,包括大小寫、空格及容易混淆的字元。不同地點可能使用相同名稱,因此名稱比對不等於網路可信度認證,也不能視為安全界線。行動網路條件應在確實離開 Wi-Fi 後驗證,不能只根據狀態列短暫變化就下結論。雙 SIM 卡切換、個人熱點及網路認證頁面都可能改變測試前提。建議先寫清楚預期:「連上這個網路時應維持什麼狀態,離開後應如何變化」,再對照實際結果,不要只看開關是否亮起。

網域條件不等於完整的網站存取規則

網域觸發通常與解析或系統網路請求有關,不能理解為逐字檢查瀏覽器網址列中的每個操作。單一網頁可能呼叫多個網域,App 也可能重複使用既有連線或快取結果,因此開啟同一頁面,不一定每次都會以相同方式觸發。測試網域條件時,應使用容易辨識的新請求,並查看事件發生時間,而非快速重複重新整理。也不要把 On Demand 的網域條件當成 Config 中的 DOMAIN-SUFFIX 規則;兩者用途不同,分別需要驗證觸發結果與請求最後的流向。

比對順序與後備條件

有多條條件時,應依介面顯示的順序逐一檢查,並確認目前規則動作的意義。範圍較廣的條件可能涵蓋後面的精細條件,導致例外條件始終無法生效。建議分別列出具體條件與後備條件,再於實際網路中逐一驗證,不要只因清單看起來完整就認為設定已完成。若某個平台或系統版本沒有顯示預期條件,不要照抄其他裝置上不存在的入口。更多網路切換範例請參閱On Demand 按需連線設定;本頁著重於驗證順序與排查範圍。

自動重新連線與網路認證排查

手動中斷後又再次連線時,先檢查 On Demand 是否仍符合觸發條件,不要反覆點擊總開關。為了區分觸發行為與連線失敗,可暫時關閉 On Demand,並在 Home 手動連線一次;若手動連線也失敗,應先回頭排查伺服器、DNS 與規則。連上需要網頁認證的 Wi-Fi 時,先確認認證流程已完成,再測試自動連線,否則可能將認證未完成造成的無法連線誤認為規則錯誤。不要不斷新增條件,試圖彌補尚未解決的基本網路問題。

最終驗收至少應涵蓋停留在目標網路、離開目標網路及再次返回三種情況,並在每次切換後等候系統完成網路變更。觀察記錄應包含網路名稱、觸發條件、預期動作與實際動作。鎖定螢幕後是否立即變化可能受系統排程影響,不應承諾每次都能在幾秒內回應。測試完成後移除臨時條件,只保留用途清楚的規則;更換網路名稱或遷移裝置後,應再次檢查。自動連線的重點是條件明確、行為可預期,而非開啟所有看得到的選項。

Connectivity Test 與 Ping 判讀

Connectivity Test 用於觀察特定測試條件下的連線能力,不是伺服器的整體品質排名。清單中的單一時間數值,只能表示該次測試測得的結果,不能代表下載速度、影片播放穩定度或所有網站的回應速度。判讀 Ping 時也應考量實際測試方式,不能把所有延遲數值都當成 ICMP 往返時間。建議先確認所選的測試項目、目標與網路,再解讀結果。只要條件不同,兩次數值就未必能直接比較;尤其不要拿 Wi-Fi 下的結果與行動網路下的結果比較伺服器優劣。

預設狀態:確認測試方式與目標

開始測試前,先查看 Connectivity Test 目前選用的方式,以及介面是否提供測試位址、逾時等選項。介面未顯示的參數不要自行猜測,也不要照抄其他版本的數值。若可調整測試目標,應選擇你有權存取、目前可連線且回應穩定的位址,並記錄原值。建議先保留現有測試設定,只有在目標本身無法連線或回應方式不適合測試時才修改。無法存取某個目標,只能說明該目標與目前路徑的組合有問題,不能據此判定伺服器整體無法使用。

區分連線時間與完整請求時間

建立傳輸連線、完成加密交握、傳送 HTTP 請求及接收回應,分屬不同階段。不同測試可能涵蓋其中部分或多個階段,因此即使使用相同單位,測量的對象也不一定相同。伺服器連接埠能建立連線,不代表認證參數正確;能收到測試回應,也不代表特定網站一定可用。建議將 Connectivity Test 作為初步篩選工具,再以實際且輕量的存取測試驗證服務路徑。若要確認通訊協定參數,應核對服務端提供的通訊協定、位址、連接埠與認證資訊,不要只反覆測試延遲。

timeout 與異常結果的意義

逾時表示在本次等待時間內沒有取得預期結果,原因可能出在本地網路、解析、伺服器、測試目標或回程路徑。等待時間過短,可能會將較慢但可用的路徑判定為失敗;等待時間過長則會延後判斷,並不能修復問題。沒有明確測試需求時,不建議只為了取得成功標示就持續延長逾時時間。先用已知正常的路徑作為對照,再測試異常路徑;若所有項目都同時失敗,應優先確認網路是否已完成認證,以及目前裝置是否確實能存取外部服務,而非立刻刪除所有伺服器。

結果組合下一步保持不變的變數
測試成功,服務無法使用確認服務網域的規則與連線日誌伺服器、網路、測試時間
測試失敗,服務可用確認測試目標與測試方式服務目標、路由模式
同一網路下全部失敗檢查網路認證與直接存取伺服器參數與設定副本

如何進行可比較的重複測試

先固定網路、伺服器與測試方式,暫停占用大量資源的傳輸工作,再於條件相近時重複測試幾次。觀察是否持續逾時、結果是否大幅波動,以及實際存取能否完成,不要只挑最小的數值作結論。大量並行測試會增加裝置與網路負載,可能改變原本要觀察的情況,因此不宜一邊持續大量測試,一邊判斷日常使用體驗。若要比較兩台伺服器,應分別維持相同測試條件;若切換網路,請另記為一組測試,不要與前一組混在一起排序。

交叉驗證測試結果與規則

使用 Config 模式時,服務請求的路徑取決於規則;某台伺服器測試成功,不代表目前網站一定經過該伺服器。先查看該網域的連線記錄與策略,再短暫切換至 Proxy 模式作比對,完成後恢復 Config。若測試成功但特定 App 失敗,可進一步確認 App 是否快取舊連線、是否使用不同網域,以及伺服器是否支援該服務所需的傳輸方式。排錯記錄應寫清楚「哪種測試成功、哪種請求失敗」,不要籠統寫成「網路正常」。這樣後續檢查才能聚焦於具體環節。

驗證結束後,將臨時測試位址、逾時設定與模式還原為有記錄的原值,或明確記下保留修改的理由。測試記錄不必永久累積所有數值,只需保留具代表性的失敗階段與重現條件。若延遲表現正常卻持續斷線,應轉而檢查 Log 與網路切換,不要繼續從 Ping 數字中尋找答案。伺服器持續無法使用時,向現有服務提供者確認狀態與參數,比修改所有本地測試項目更直接。

Log 與 Data:找出失敗階段

Log 用來還原事件順序,Data 用來查看流量或連線統計;兩者都必須搭配問題重現時間判讀。流量增加只表示統計範圍內有資料傳輸,不能證明目標網頁已完整開啟;沒有看到預期日誌,也可能是記錄範圍、篩選條件或重複使用舊連線所致。建議先記下能穩定重現的問題,再短暫開啟必要的記錄,完成一次操作後立即檢查。持續記錄大量正常存取,不但增加閱讀負擔,也可能留下敏感資訊,不適合作為日常排錯的起點。

預設狀態:先確認記錄範圍,再調整詳細程度

進入相關頁面後,先確認記錄是否已啟用、目前的篩選條件、可見時間範圍,以及是否有清除或匯出選項。不同介面提供的細節可能不同,本手冊不會指定一個適用於所有安裝狀態的日誌層級。日常使用建議保留原有記錄方式;排查時只提高足以觀察問題的詳細程度,完成後再恢復。若要清除舊記錄,先儲存真正有用且已去除敏感資訊的片段,再進行清除。清除日誌不會修復連線,也不能取代重新發出請求;其作用只是縮小下次觀察的時間範圍。

從時間軸判斷失敗發生階段

一次請求可依序從解析、規則比對、建立連線、認證或加密交握、資料傳輸等階段判讀。錯誤訊息應放回這個順序理解:位址解析失敗時,先檢查 DNS;已建立連線但認證失敗時,應確認伺服器資訊;傳輸開始後才中斷,則還要考量目標服務與網路切換。具體錯誤文字以實際顯示為準,不要將不同錯誤都解釋成同一個原因。建議先找出最後一個明確成功的階段,再檢查緊接著失敗的步驟,這比一開始就修改所有設定,更容易得到可驗證的結論。

規則命中與實際流向

請求被分配到哪個策略,是判斷 Config 行為的關鍵。若記錄中可看到網域、位址、規則與策略,應一併判讀:網域可能命中後綴規則,位址可能命中範圍規則,未命中的請求則可能交由 FINAL 處理。修改規則後,應重新發出請求並確認新記錄,不要只看檔案中已寫入目標規則。若同一網頁出現多筆連線,通常表示它存取了多個資源網域,應分別判斷,不要只找到其中一筆就認為整個網頁都走相同路徑。

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

此片段用來說明規則順序:精確網域 example.com 可先命中 DOMAIN,其他符合後綴條件的請求則繼續比對 DOMAIN-SUFFIX。實際使用前,必須確認 PROXY 在你的設定中有有效定義,並將片段合併至正確位置,不可直接取代完整設定。若調換順序,應預期精確網域也可能先由後綴規則處理,並以新請求驗證。規則範例並非建議用來存取任何實際網站,只用於說明設定行為。

Data 不等於服務已完成

Data 中的上傳、下載或連線統計,可能包含 App 背景請求、重試及其他正在執行的工作。要確認某次操作時,先記錄起始狀態,執行單一測試後再查看增量;若介面可重設統計,先確認重設範圍,以免遺失仍需保留的歷史記錄。統計方式與系統電信業者帳單也未必一致,因此不能只因兩者數字不同就判定異常。建議將 Data 作為「是否有傳輸、是否持續重試」的線索,再透過日誌與目標 App 的結果判斷請求是否真正完成。

匯出、去識別化與停止記錄

分享日誌前,應移除訂閱網址、認證資料、私人網域、內部網路位址及可識別個人的請求路徑。只隱藏伺服器顯示名稱通常不夠,查詢參數、錯誤前後文或相鄰記錄仍可能包含敏感資訊。向現有服務提供者說明問題時,優先提供網路類型、失敗時間範圍、通訊協定名稱及已去識別化的錯誤階段,不要傳送整份備份。排查完成後,恢復記錄選項並視需要清理暫存檔案;若打算清除 App 資料,請先閱讀iCloud 同步與備份章節,確認有效設定已另存。

Widget:狀態顯示與快速操作

Widget 是系統提供的快速資訊或操作入口,並非另一套獨立的連線設定。能否顯示特定內容、更新頻率及可執行的動作,取決於目前系統與 App 提供的元件類型。建議先在 Home 確認連線正常,再新增 Widget;若元件狀態與 App 內顯示不一致,重新開啟 App 後的實際狀態才是核對起點。不要只根據元件上的舊標示判斷伺服器故障,也不要將元件未即時更新解讀為整部裝置已中斷網路。顯示狀態與連線狀態應分開驗證。

預設狀態:以已新增的元件為準

預設主畫面是否已有 Widget,取決於裝置版面與先前的還原狀態;不要假設安裝 App 後一定會自動出現。先查看系統元件選擇畫面是否列出 Shadowrocket,再確認可用尺寸與說明;若系統未提供某種元件,不要照著另一台裝置的截圖尋找同名按鈕。建議選擇能清楚顯示所需資訊的尺寸,而不是盡量塞入更多欄位。新增後先保留元件原有設定,確認對應的 App 與設定,再逐一調整顯示選項。若支援編輯元件,應記錄目前選取的項目,避免誤以為它一定會跟著 Home 中的選擇變動。

狀態更新與系統排程

系統可能限制背景更新頻率,因此元件顯示延遲並不少見。螢幕鎖定、低電量狀態、近期是否執行過 App,以及系統資源排程,都可能影響更新時間。建議先開啟 Shadowrocket 確認狀態,再返回主畫面查看元件是否更新;若 App 內的連線穩定但元件暫時落後,應優先檢查顯示更新流程,不要更動 DNS 或伺服器。不要連續快速點擊來強制更新,因為這些點擊可能實際切換連線狀態,反而讓原本單純的顯示問題變成新的連線問題。

快速切換與 On Demand 的關係

透過 Widget 執行的操作,可能與 On Demand 自動觸發前後發生。若點選中斷後很快又顯示連線,應進入 On Demand 檢查條件,而不是先移除元件。為了驗證快速操作入口,可暫時停用自動觸發,在 Home 確認初始狀態,再透過 Widget 執行一次操作,最後回到 App 檢查結果。測試完成後恢復原有 On Demand 狀態。此處要確認的是操作是否成功送出,不是要求元件上的每段文字都立即更新;應分別記錄操作結果與畫面更新,才能判斷問題位於哪一層。

切換設定後確認參照項目

新增伺服器、刪除舊項目或還原設定後,可能需要重新確認快速入口所參照的項目。若元件提供伺服器或動作選擇,請開啟編輯畫面,確認仍指向有效項目;若沒有這類選項,則以元件實際說明為準。不要只憑兩個伺服器同名就認定內容完全相同,訂閱更新可能會改變項目內容。建議為常用項目設定方便自己辨識、又不會洩露敏感資訊的名稱;修改後先在 App 內測試,再檢查快速入口。這樣能將資料參照問題與網路連線問題分開處理。

主畫面與鎖定畫面的隱私界線

他人看得到螢幕時,Widget 可能會顯示連線狀態、流量或項目名稱,實際內容取決於元件類型與系統設定。新增前建議先檢查實際預覽,不要在顯示名稱中填入私人服務網址或帳號資訊;需要分享裝置截圖時,也應確認元件是否洩露使用習慣。鎖定畫面的顯示與操作權限也受系統設定影響,不能假設主畫面上可執行的操作,在鎖定畫面上也相同。若裝置用於工作或受管理,應同時遵守裝置管理要求,不要為了快速操作而更改不理解的系統限制。

元件持續空白時,可依序確認 App 是否能正常開啟、元件類型是否仍可使用、參照項目是否存在,再嘗試移除並重新新增元件。重新新增是針對顯示層的排查,不應先刪除 App 或清空設定。若重新新增後仍異常,但 Home 中的連線與存取都正常,可暫時改由 App 內操作,並保留重現條件以供後續確認。無須為了單一快速入口重建所有網路設定;排查範圍應始終限於發生問題的層級。

iCloud 同步、備份與還原

同步用來在裝置間傳送狀態,備份則是保留可還原的歷史副本,兩者不能混為一談。同步可能傳播修改或刪除,因此啟用 iCloud 不代表任何時候都能找回誤刪的內容。修改主要設定前,建議先依 App 提供的方式匯出一份容易辨識的設定副本,再確認同步狀態。匯出的 Config 也不應自動視為包含所有伺服器、訂閱與 App 設定;各種匯出內容的範圍都應實際確認。更換裝置前,應一併考量還原 App、還原設定及重新確認服務資訊這幾個不同步驟。

預設狀態:確認系統與 App 兩層條件

先在系統設定中確認裝置已登入預期帳號,且可使用 iCloud 相關功能,再進入 Shadowrocket 查看同步選項。實際路徑依系統與 App 目前介面為準,不要把其他裝置的選單位置當成固定路徑。記錄哪些類別明確標示可同步,哪些只儲存在本機;介面未說明的項目,不要假設會自動遷移。建議在舊裝置仍可使用時進行小範圍驗證,例如比較某個設定名稱與內容是否出現在另一台裝置上。只看到開關已開啟,不能證明最近的修改已成功同步。

匯出檔案前確認內容與敏感資訊

匯出 Config 時,先確認選取的是目前使用中的檔案,而非同名舊副本。儲存後確認檔案能否重新開啟、規則是否完整,並使用能區分用途的檔名。設定檔可能包含伺服器位址、認證資訊或遠端資源網址,因此備份應存放在你能管理且具適當存取限制的位置。不要將完整檔案放在公開共用目錄,也不要為了尋求協助而直接傳送全部內容。建議另存簡短說明,記錄檔案用途、目前使用的模式及需要另外還原的項目,不要把敏感憑證寫進說明標題。

多裝置衝突時,先保全再同步

兩台裝置離線修改同一份內容後再次同步,可能發生版本衝突,或同步結果與預期不符。此時應先停止在兩台裝置上繼續編輯,分別匯出仍可存取的副本,再比較實際內容。不要只因檔名相同就認定內容一致,也不要假設修改時間較新的檔案一定正確;裝置時間、同步延遲與局部編輯都可能影響判斷。建議先選定一份已驗證可用的基準,再依 App 目前提供的同步或匯入方式還原。若沒有明確的衝突處理提示,不要反覆切換同步開關來碰運氣。

換機還原後分層驗收

新裝置還原後,先確認 Shadowrocket 能正常開啟,再檢查伺服器清單、訂閱項目、Config 檔案與 Global Routing,最後才測試 On Demand、Widget 等附加功能。使用者原有的訂閱可能需要重新更新,某些授權也可能與裝置或服務狀態有關,請向現有服務提供者確認。建議先在 Home 手動建立一次連線,確認基本存取正常後,再啟用自動連線,避免舊裝置的環境條件直接影響新裝置。還原完成不等於驗收完成,應逐項檢查實際請求,不要只看清單中已出現項目。

層級驗收內容保留舊裝置的原因
服務資訊訂閱、伺服器與認證是否可用方便確認是否有遺漏項目
設定檔規則、策略與目前使用的檔案是否一致方便比較實際內容
自動功能On Demand 與 Widget 是否適用新環境避免直接沿用舊網路條件

同步異常時的檢查順序

沒有看到更新時,先確認兩台裝置是否使用預期帳號、網路是否可用、雲端儲存空間是否不足,以及 App 是否顯示明確錯誤。接著分別開啟 App 並等候同步,再比較一個具體項目,避免一次修改大量內容。不要立刻登出帳號或刪除 App,因為這些操作可能讓尚未同步的本機內容失去復原機會。更完整的分步流程請參閱iCloud 同步、匯出設定與換機還原步驟。確認新裝置的設定與連線都通過驗收前,請繼續保留舊裝置與獨立備份。

Proxy 連接埠與設定復原順序

本地 Proxy 連接埠是供其他程式連線的入口,不是遠端伺服器連接埠。遠端連接埠是使用者現有服務的連線參數;本地監聽連接埠則供目前裝置或獲准存取該裝置的程式使用。即使兩者數值相同,意義也不同。若沒有明確的本地代理需求,建議保留相關選項原狀,不要為了「提升速度」隨意修改。是否支援監聽、允許哪些通訊協定,以及其他裝置能否連線,都應以目前平台實際提供的選項為準,不要直接套用桌面版或另一台裝置的設定。

預設值:確認連接埠、通訊協定與監聽位址

檢查時應一併記錄連接埠、代理通訊協定、監聽位址,以及是否允許區域網路存取。不要假設 HTTP 與 SOCKS5 共用同一入口,也不要將範例數字當成產品固定預設值。用戶端程式設定的通訊協定必須符合監聽入口,否則可能出現連接埠可連線、但不接受請求格式的情況。連接埠也須避免與其他本地服務衝突;若啟用後立即提示連接埠已被占用,先找出衝突來源,不要連續更換多個數字。建議保留原有設定記錄,確認哪個程式需要使用此入口,再進行最小幅度的調整。

本機存取與區域網路存取的界線

監聽本機迴路位址時,通常只有目前裝置能存取;允許其他裝置連線,則會涉及監聽範圍、網路隔離、防火牆,以及裝置是否持續保持連線。不能因為本機使用成功,就認定同一 Wi-Fi 下的另一台裝置也一定可用。建議優先採用符合需求且暴露範圍最小的設定;只供本機使用時,不要擴大到區域網路。確實需要跨裝置存取時,先確認網路可信、存取控制與認證選項符合要求,並在使用結束後還原設定。不要預設公共網路中的其他裝置有權存取本地代理。

避免代理迴圈與重複轉送

讓程式使用本地代理時,應確認其連線不會再次送回同一入口而形成迴圈。常見跡象包括請求持續重試、連線數異常增加,以及開啟代理後所有相關請求都停滯。建議先只讓一個測試程式使用此入口,並確認其目標位址與連接埠,不要同時修改系統代理、App 代理與 Config。若要還原,先撤銷測試程式中的代理設定,再恢復 Shadowrocket 的監聽選項。如此一來,即使本地入口停止運作,程式也不會繼續指向已不存在的位址。

依失敗層級還原設定

若修改多個項目後無法判斷原因,先將最近一次記錄的單一項目還原為原值,再由外而內依序檢查:目前網路能否直接使用、Home 是否能手動連線、Global Routing 是否明確、目前使用的 Config 是否正確、DNS 結果是否合理,以及目標請求是否命中預期策略。接著才恢復 On Demand 與 Widget 等自動或顯示功能。不要把刪除所有資料當成第一步,因為這會同時移除排查依據與可用設定。確實需要重新匯入時,先匯出仍有價值的內容,並確認使用者原有的訂閱與伺服器資訊可以重新取得。

分開處理取得管道與安裝問題

需要重新取得 App 時,請前往全平台下載頁確認取得管道。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費,桌面版與 Android 安裝檔由本站 /dl/ 提供。iPhone / iPad 的系統需求請以 App Store 頁面標示為準;核對開發者 Shadow Launch Technology Limited 及 App ID 932747118。重新安裝不能取代伺服器端參數確認,也不會自動解決訂閱失效問題,操作前仍應先保全設定。

桌面版與 Android 版首次開啟時若遇到系統封鎖,先確認檔案來自本站下載頁,再依該頁說明處理:macOS 請在「隱私權與安全性」確認後選擇「仍要打開」;Windows 請在 SmartScreen 確認後選擇「更多資訊」;Android 僅為實際下載檔案的瀏覽器開啟「允許安裝未知應用程式」,完成後即可關閉該權限。Mac 應依「關於這台 Mac」的晶片資訊選擇安裝檔,不要猜測裝置架構。完整安裝步驟請參閱安裝解除封鎖說明,不要透過修改 DNS、Ping 或 Proxy 連接埠處理系統安裝提示。

留下可再次重現的結論

排查結束時,用一句話描述有效修改及其條件,例如「只在指定網路下還原原本 DNS 後,目標請求便重新完成」,不要只寫「全部開關都打開後正常」。接著驗證一個原本正常的 App、一次網路切換及一次手動重新連線,並清除測試規則、暫存日誌與不再使用的本地入口。若問題仍存在,帶著已去除敏感資訊的失敗階段前往問答頁繼續排查;需要重新走完整操作流程時,請返回快速入門教學。本設定手冊的目的是讓每項變更都有依據、可驗證且可復原。