官方手冊 · 系統化參考

Shadowrocket
完整使用手冊

從安裝與權限開始,逐步檢查伺服器、規則、連線記錄和日常設定。操作以 iPhone/iPad 介面為例;安裝章節也說明 Mac、Windows、Android 和 Linux。

iPhone/iPad 版由 App Store 取得,$2.99 一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。

本頁供系統化查閱,不必在初次使用時一次讀完。使用教學依照可執行的步驟完成首次連線;本手冊則說明每個步驟的前置條件、如何確認結果,以及遇到異常時應回到哪個階段。已完成匯入的使用者可從 Global Routing 或連線驗證開始,避免重複修改原本正常的設定。

以下步驟以使用者已有自己的訂閱或伺服器資訊為前提。設定檔、伺服器資訊與訂閱網址是三種不同資料,儲存位置和用途不可混用。介面用語保留英文;實際顯示項目請以裝置上目前的 Shadowrocket 介面為準。

01 / ACQUIRE

取得與安裝:先確認裝置與下載管道

先安裝應用程式,再處理伺服器與設定,才能區分系統安裝問題和連線問題。iPhone/iPad 版由 App Store 取得,$2.99 一次性付費;Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費。各平台下載入口集中於全平台下載頁;電腦與 Android 安裝檔由本站 /dl/shadowrocket/ 路徑提供。請勿將教學中的設定文字當成安裝檔,也不要以訂閱網址取代下載入口。

iPhone/iPad:確認 App Store 商品頁

開啟下載頁中的 App Store 商品連結,確認應用程式名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,且商品網址中的應用程式 ID 為 932747118。官方圖示與這些文字資訊應相符,不要只憑搜尋結果中的名稱判斷。系統需求以 App Store 頁面標示為準;購買前也請查看目前帳號所屬商店顯示的價格與相容性。若商店顯示不支援目前裝置,應先確認系統與裝置條件,而非反覆嘗試匯入設定。

中國大陸的 App Store 商店未上架此應用程式。搜尋不到時,請先確認 Apple 帳號所屬商店的地區,不要因此認定應用程式已停止供應。可在系統設定中的 Apple 帳號、媒體與購買項目、檢視帳號、國家或地區確認帳號地區,項目名稱可能因系統介面而異。更改地區可能涉及餘額、有效訂閱和付款方式,請先閱讀系統提示。詳細說明請參閱App Store 地區與商店顯示說明。

電腦與 Android:選擇適用的安裝檔

Mac 可先在「關於這台 Mac」查看晶片資訊:顯示 Apple 晶片時選擇對應版本,顯示 Intel 時選擇 Intel 版,不能只憑檔案大小判斷。Windows 請在下載頁選擇對應的安裝入口;Android 請選擇提供的 arm64 安裝檔。Linux 則依發行版的套件格式選擇 deb 或 rpm;使用 AppImage 時,還須允許檔案作為程式執行。檔案下載完成不代表安裝已完成,請依系統提示安裝並確認程式能正常開啟。

桌面版與 Android 安裝檔沒有程式碼簽章,首次啟動時可能遭系統封鎖。只對從本站下載、且裝置使用政策允許執行的檔案解除封鎖;受組織管理的裝置請先詢問管理員。macOS 顯示「無法驗證開發者」時,可在系統設定的「隱私權與安全性」中查看「仍要打開」。若出現「已損毀」提示,確認應用程式已放入 Applications 後,可使用下方指令清除隔離屬性;此指令無法修復未完整下載的檔案。

xattr -cr /Applications/Shadowrocket.app

Windows 的 SmartScreen 若顯示封鎖,可先展開「更多資訊」,確認檔案來源後選擇「仍要執行」;若沒有此按鈕,請檢查系統原則,不要變更組織限制。Android 需為實際開啟安裝檔的瀏覽器或檔案管理員啟用「允許安裝未知應用程式」,安裝後可關閉此權限。Linux 的 AppImage 請先加入執行權限,再執行檔案;deb、rpm 則交由系統套件工具處理相依項目。完整的解除封鎖步驟請參閱安裝解除封鎖指南。

安裝後需要準備哪些資料

首次開啟前,請準備既有伺服器的位址、連接埠、協定及驗證資訊,或自己的訂閱網址。請勿將敏感網址貼到公開留言或放進截圖。iPhone/iPad 換機重裝時,先到原購買帳號的已購項目中查找;電腦與 Android 可重新前往下載頁取得安裝檔。取得應用程式不包含伺服器資源:一次性購買客戶端不等於購買線路方案。本站不提供任何節點或訂閱;後續章節只說明如何使用已有資料。

返回章節目錄 ↑

02 / PERMISSIONS

首次啟動與權限:建立可供排查的起點

首次啟動的目標是確認應用程式能開啟、找得到介面入口,且系統允許建立連線,而不是立刻調整所有設定。開啟 Shadowrocket 後,先查看 Home 是否已有伺服器項目,再確認 Config、Data、Settings 的入口。Home 用於選擇伺服器和操作連線;Config 用於管理設定檔;Data 用於查看連線與流量記錄;Settings 用於調整應用程式設定。後續操作都會用到這幾處,記住入口比記住按鈕位置更可靠。

先確認裝置目前的網路狀態

先讓 Shadowrocket 的連線開關保持關閉,用瀏覽器開啟平常能瀏覽的頁面,確認 Wi-Fi 或行動網路本身可用。飯店、校園或公共 Wi-Fi 可能需要先在認證頁面登入;尚未完成認證時,伺服器測試和網頁連線都可能失敗。請先完成系統跳出的認證流程,再回到應用程式。若裝置連一般網頁也失敗,請檢查網路連線、飛航模式和目前的網路權限,不要直接修改伺服器密碼或規則。

也請確認裝置上是否有其他正在執行的 VPN 連線,或組織部署的網路設定。系統通常無法讓多個一般 VPN 通道同時依各自預期運作;自動連線功能也可能在使用者操作後重新接手。排查時先確認目前生效的是哪項連線,必要時暫停自己能控制的其他自動連線。不要刪除不熟悉的組織設定;裝置管理原則可能是安裝或連線受限的原因,請保留錯誤提示並交由管理員確認。

了解 VPN 設定授權

第一次啟用連線時,系統可能會提示允許加入 VPN 設定,並要求輸入裝置密碼或進行生物辨識確認。這是允許應用程式建立系統網路通道,不是匯入訂閱,也不是驗證伺服器帳號。只有在使用者主動開啟 Shadowrocket 並執行連線操作後,才應確認相關提示。完成授權後返回應用程式,查看連線狀態是否改變;若取消授權,連線無法完成是預期結果,請重新連線並在系統提示時確認。

VPN 設定授權與伺服器驗證是兩個獨立環節。前者成功,只代表裝置允許建立通道;後者仍取決於遠端位址、連接埠、協定和驗證參數。系統顯示 VPN 狀態標記,也不能直接證明所有目標都能連線。不要為了消除連線錯誤而一再刪除系統中的 VPN 設定,這會失去穩定的排查起點。先記下錯誤是在授權前發生、連線啟用後立即中斷,還是保持連線但請求失敗。

依實際功能授予權限

使用 Scan QR Code 時,系統可能會詢問相機權限;拒絕後無法掃碼,但仍可手動輸入或透過既有連結匯入。若要從照片讀取 QR Code,請依系統提示授予所需的存取範圍。透過剪貼簿貼上資料時,系統可能詢問是否允許貼上,請確認剪貼簿內容確實是自己的伺服器或訂閱資訊。權限應配合實際使用的功能,不必提前開放尚未使用功能的所有權限,也不要把授予相機權限誤認為已完成伺服器設定。

建立首次測試紀錄

開始匯入前,記下目前的網路類型、是否已完成 VPN 授權,以及 Home 是否已有現成項目。若是舊裝置移轉後首次開啟,也要先確認 Config 目前選取的檔案,不要預設移轉內容已全部生效。若介面名稱或位置與教學不同,可依英文詞尋找對應功能,並參考介面英文用語對照表。不要照著舊截圖一直點相同座標,尤其 iPad 的版面可能不同。

本階段完成的標準是:應用程式能穩定開啟、基本網路正常、權限提示能順利完成,而且使用者知道如何回到 Home 和 Settings。此時即使還沒有可連線的伺服器,也不應把空清單視為應用程式故障。接著閱讀下一章,加入已有資料;若授權後立即退出、無法確認系統限制,或裝置管理阻止連線,請先處理權限問題。分層檢查權限、伺服器和規則,可避免日後每次連線失敗都從重新安裝開始。

返回章節目錄 ↑

03 / IMPORT

伺服器與訂閱:先辨識資料,再選擇匯入方式

先確認拿到的是單一伺服器資訊、單節點分享連結,還是訂閱網址。單一伺服器需要填寫協定參數;分享連結通常以協定前綴開頭;訂閱網址則通常透過網路取得一組伺服器資料。三者不能因為都能複製成文字,就使用同一個匯入入口。若既有資料附有參數說明,請先確認資料類型與適用協定。不要把網頁說明網址、帳號管理頁面網址或設定檔下載網址直接當成伺服器位址。

Add Server:逐項填寫伺服器資料

在 Home 開啟 Add Server,先選擇與既有資料相符的協定,再填入伺服器位址和連接埠。位址欄通常填網域名稱或 IP,不應包含瀏覽器網址中的路徑、查詢參數或頁面標題。連接埠必須使用資料提供的數值,不要依協定名稱猜測。備註只供本機辨識,不能取代伺服器位址。填寫後儲存,返回 Home 確認項目已出現,再開啟項目檢查協定類型,避免建立過程中切換協定後仍沿用不相符的欄位。

協定核對重點常見混淆
Shadowsocks位址、連接埠、Password、MethodMethod 與伺服器設定不一致。
VMess / VLESS位址、連接埠、UUID、傳輸參數只填 UUID,漏掉傳輸或 TLS 設定。
Trojan位址、連接埠、Password、TLS、SNI混淆連線位址與憑證名稱。
HTTP / SOCKS5位址、連接埠、驗證要求把網頁登入資訊當成代理驗證資訊。

協定欄位必須依照既有伺服器設定填寫。UUID、Password、Method 是不同的驗證參數,不可互換;TLS、SNI、Host、Path 也各有不同作用。以 Trojan 為例,連線位址用來找到伺服器,SNI 則在 TLS 交握時指定名稱;兩者可能相同,也可能依伺服器設定使用不同值。不要透過關閉憑證驗證來掩蓋名稱填寫錯誤。相關欄位可參閱Trojan 參數說明。

分享連結與 QR Code

已有的單節點分享連結可透過應用程式提供的匯入入口處理;QR Code 則使用 Scan QR Code。掃描前請確認 QR Code 來自自己的伺服器資料;掃描後仍須檢查建立項目的協定、位址和連接埠。QR Code 只是資訊載體,不會替使用者驗證伺服器是否有效。若辨識後出現一般網頁,表示 QR Code 內容可能不是節點格式,請回到資料來源確認,不要把網頁網域填進 Add Server 的位址欄。

複製時請避免漏掉開頭或結尾,或連同說明文字一起複製。通訊軟體自動換行、全形標點,以及連結外層的引號,都可能導致解析失敗。匯入成功後,參數可能隱藏在項目詳細資料中,不應只憑項目名稱判斷內容正確。想了解不同前綴,請閱讀分享連結與訂閱連結的差異;手動修改編碼後的連結容易破壞結構,建議重新取得完整原始文字。

Subscribe:加入並更新既有訂閱

若要加入自己的訂閱網址,請進入新增入口並選擇 Subscribe,填入完整 URL,再替訂閱設定容易辨識的名稱。儲存後執行更新,確認訂閱下方是否產生伺服器項目。更新訂閱會發出網路請求,可能受到基礎網路、網址有效性或遠端回傳內容影響。若清單為空,先查看是否有更新錯誤,再確認網址是否遭截斷;不要連續建立多筆相同訂閱,否則日後不易判斷哪個群組仍在更新。

匯入訂閱不等於匯入規則設定。訂閱通常用來更新伺服器資料,Config 中的檔案則決定規則分流等行為。更新訂閱後,先前選取的伺服器可能已更名或移除,請重新確認 Home 中目前選取的項目。訂閱網址通常包含存取憑證,回報問題時只需描述錯誤類型,不要公開完整網址。本階段完成的標準是:至少有一個參數可供核對的伺服器項目,或既有訂閱能正常更新,而且使用者知道目前選取的是哪一項。

返回章節目錄 ↑

04 / GLOBAL ROUTING

Global Routing:設定、代理與直連三種模式

Global Routing 決定請求採用哪種處理方式,不負責修正伺服器參數。介面中的 Config、Proxy、Direct 分別代表依設定檔、透過代理、直接連線三種模式。日常依規則分流通常使用 Config;要暫時確認選取的伺服器能否處理請求,可使用 Proxy;要排除代理因素時,可用 Direct 作為對照。切換模式後,請重新發出請求並查看記錄;不要用切換前已建立的長連線判斷新設定是否生效。

模式處理依據適合檢查的項目
Config目前設定檔中的規則與策略。目標是否符合預期規則。
Proxy以代理方式處理適用的請求。所選伺服器與目標之間的基本連線狀況。
Direct透過目前的本機網路直接連線。不經過所選代理時的對照結果。

Config 與設定檔的關係

選擇 Config 前,先進入 Config 頁面確認目前使用的檔案。下載檔案不代表它已成為目前設定;編輯後未儲存,也不會產生預期結果。設定中可能包含 DNS、規則和策略參照等內容,不能只檢查檔名。下方片段示範基本結構,範例網域僅用於說明語法,不代表需要連線的服務,也不應未經確認就將範例改成一整套日常設定。

[General]
bypass-system = true
dns-server = system

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

規則會依序檢查,第一條符合條件的適用規則決定處理結果。因此,具體例外通常應放在範圍較廣的規則之前,FINAL 則放在末尾作為備援。若太早放入範圍過廣的規則,後面的細部規則可能不會執行。GEOIP 判斷依據是目標 IP 與相應資料庫,不等於辨識網站使用的語言,也不等於辨識公司的註冊地。預期所有中文網頁都採用同一策略,是常見的規則理解誤區。

規則關鍵字與策略屬於不同類型

DOMAIN 表示精確網域,DOMAIN-SUFFIX 表示網域後綴,DOMAIN-KEYWORD 表示網域中包含的關鍵字;IP-CIDR 和 IP-CIDR6 則分別適用於對應的位址範圍。這些欄位描述「比對什麼」,末尾的 PROXY、DIRECT、REJECT 則描述「比對後如何處理」。策略關鍵字不能填在網域欄位,協定名稱也不能取代策略名稱。修改時請保留英文逗號,並確認關鍵欄位中沒有混入中文說明或多餘空格。

PROXY 將符合條件的請求交由代理處理,仍須有可用的伺服器;DIRECT 透過本機網路直接連線,不代表目標一定可連線;REJECT 會拒絕符合條件的請求,這可能正是某些請求失敗的預期原因。若設定引用自訂策略群組,還需檢查群組成員與選取狀態。規則命中不代表整個連線路徑已成功;策略之後的 DNS、連線和遠端回應仍可能出錯。

透過三種模式確認問題範圍

同一目標在 Proxy 下正常、在 Config 下失敗時,優先比較命中的規則、策略群組和設定中的 DNS 行為,不要立刻重新填寫伺服器資料。若 Direct 正常而 Proxy 失敗,先檢查伺服器連線與遠端路徑。三種模式都失敗時,應回頭檢查基礎網路、目標服務狀態和 DNS。對照測試請使用同一裝置、同一網路與同一目標,並盡量在相近時間進行,否則網路切換會讓結果失去可比性。

返回章節目錄 ↑

05 / VERIFY

連線與驗證:區分通道、伺服器與目標請求

連線驗證至少分為三個層次:系統是否允許啟動通道、所選伺服器是否能通訊,以及目標請求是否如預期完成。Home 的開關保持開啟,只能作為第一層狀態的線索,不能據此推論後兩層都正常。驗證時先確認所選伺服器,再確認 Global Routing,最後發出明確的請求。每次只變更一個項目,並記錄修改前後的結果,比同時更換伺服器、DNS 和規則更容易找出原因。

啟用連線前的最後檢查

在 Home 確認所選伺服器是否來自剛匯入的項目,尤其是訂閱更新、名稱變更或群組較多時。不要只看清單頂端的名稱,也要確認實際選取狀態。接著查看 Global Routing;若要測試規則,請選擇 Config 並確認目前使用的檔案。若需暫時排除規則影響,再切換至 Proxy。開啟連線開關,依系統提示完成 VPN 授權,待狀態穩定後再切換到瀏覽器;狀態變化期間不要連續點按開關。

若一啟用就立即中斷,先查看應用程式是否顯示設定錯誤或系統授權錯誤。此時用瀏覽器測試的參考價值不高,因為請求可能尚未進入預期通道。請檢查是否取消過權限、設定檔是否包含無法解析的內容,以及系統中是否有自動接手的連線。若開關能保持啟用但請求逾時,排查重點應轉向伺服器、DNS 和規則。這兩種情況應分別記錄,不要一概稱為「連不上」就直接重新安裝應用程式。

Connectivity Test 能告訴你什麼

Connectivity Test 用來觀察應用程式所提供測試方式下的連線狀況。不同測試方式檢查的目標與環節可能不同,請先查看目前選項;不要把顯示的單一時間值當成所有網站的實際速度。測試成功只表示相應測試路徑收到回應,不能保證目標網頁的憑證、登入、內容載入及其他網域請求都成功。測試失敗也要搭配實際網頁請求判斷,不能只憑一次測試結果認定整個訂閱已失效。

重新開啟一個自己熟悉的一般網頁,查看主要文件和必要資源是否都能載入。若文字顯示但圖片載入失敗,可能涉及不同資源網域或既有連線;若應用程式能登入但某項功能失敗,也可能是該功能連線至獨立目標。請記錄失敗的具體請求,而不只是產品名稱。瀏覽器可能重用連線和快取;切換設定後可重新開啟頁面,必要時關閉該頁再試,以減少舊連線對判斷的干擾。

依失敗現象逐層檢查

若網域請求失敗但基礎網路正常,請檢查目前的 DNS 設定,以及連線記錄中的錯誤。DNS 負責將名稱解析為位址;解析失敗與連上位址後逾時是不同問題。不要隨意輸入來源不明的 DNS 位址,也不要認為更換解析方式一定能改善連線。若出現 TLS 或憑證錯誤,請確認裝置日期與時間、伺服器名稱、SNI,以及既有資料中的要求。關閉驗證只會掩蓋問題,不應作為一般處理方式。

若只有某個 Wi-Fi 無法連線,但行動網路正常,請檢查該 Wi-Fi 是否需要認證、是否限制相關協定,或本機 DNS 與網路策略是否不同。切換網路後重新建立連線,再以同一目標測試;不要只憑兩次網路條件不同的結果,就認定伺服器狀態不穩。若需要 UDP、即時音訊或視訊等功能,還要確認伺服器與實際協定支援相應傳輸;網頁能開啟不代表這些功能也一定正常。

驗證完成後保存基準

有效的驗證應留下明確基準:使用什麼網路、選了哪個本機備註的伺服器、採用哪種模式、連線至哪個目標,以及結果如何。不必記錄真實密碼或公開完整位址。確認運作正常後,再逐步啟用需要的自動化設定;出現新問題時,就能回到已知可用的狀態。若仍無法找出原因,可前往疑難排解依現象繼續檢查,並在尋求協助前整理錯誤文字與已執行的測試,不要只提供一張連線開關已啟用的截圖。

返回章節目錄 ↑

06 / DATA

Data 與連線記錄:從現象追查到具體請求

Data 和相關連線記錄的用途,是把「某個頁面失敗」縮小到「哪個目標、採用什麼策略、在哪個階段失敗」。不同介面提供的統計範圍和欄位可能不同,請以目前應用程式實際顯示為準。先看欄位名稱,再解讀數值;不要把裝置上的所有流量、通道內流量、應用程式記錄的請求和伺服器計量視為同一範圍。記錄有助於定位問題,但不能取代對伺服器狀態和目標服務本身的檢查。

先設定一次可重複的觀察

開始觀察前,記下目前時間和正在測試的目標,接著只執行一次明確操作,例如重新開啟某個頁面。返回 Data 或連線記錄,尋找時間相近的項目。背景同步、推播訊息和其他應用程式也可能產生連線,因此最新出現的項目不一定來自剛才開啟的頁面。請依目標網域、時間和實際操作篩選,避免看到一筆失敗請求就認定主頁面失敗,或看到一筆成功請求就認為整個頁面已恢復。

一個頁面可能包含主網域、圖片、指令碼、登入介面和統計請求,並分別符合不同規則。排查時先找出與主要功能直接相關的目標,再檢查附屬資源。若無法判斷,可比較操作頁面前後新增的記錄,不要一次修改所有出現的網域。對於重用既有連線的請求,不一定每次都會出現新的連線項目;此時請重新測試,必要時重新建立連線,不要把「沒有新項目」直接解讀為應用程式未接管流量。

將策略結果對照規則順序

若記錄中有策略或規則資訊,先確認實際採用的是 PROXY、DIRECT、REJECT,還是自訂策略群組,再回到目前的設定檔找出對應項目。如果預期使用 PROXY,結果卻顯示 DIRECT,請檢查前面是否有範圍更廣的網域或 IP 規則先行符合。若顯示 REJECT,請確認是否有拒絕規則生效。修改前先儲存原始內容,調整後重新連線並產生新請求;歷史記錄不會因規則修改而自動更新。

[Rule]
DOMAIN,account.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-SUFFIX,ad.example.net,REJECT
FINAL,PROXY

上方順序說明了例外與範圍之間的關係:精確比對的 account.example.com 應排在整個 example.com 後綴規則之前,其餘適用的子網域才會繼續符合後綴規則。範例只用來說明規則順序,不代表這些網域需要加入日常設定。若記錄只顯示目標 IP,不能只憑名稱推測網域規則一定生效;應依 DNS、請求產生方式和實際可見資訊判斷,不要把無法觀察的欄位當成已確認的事實。

流量數值的判讀範圍

上傳與下載統計有助於判斷是否發生資料交換,但有資料交換不代表作業已完成。TLS 交握失敗、重複重試或只載入錯誤頁面,也可能產生流量。反過來說,快取命中可能讓頁面正常顯示,但新增流量很少。觀察前請先確認統計指的是目前連線、累計值,還是某個介面的彙總;切換網路和重新連線也可能改變觀察範圍。不要用短時間內的一組數值推估長期用量,更不要據此直接判斷伺服器計費是否準確。

若要分析流量異常,先停止不相關的大檔案下載或背景工作,再觀察特定操作造成的變化。系統統計、應用程式統計和遠端統計可能採用不同週期與口徑;協定封裝、重傳及連線維持也會造成差異。請先對齊觀察時間,再比較趨勢,不必要求不同介面的數值完全相同。如果裝置閒置時仍有流量,先檢查背景應用程式和自動更新,不要立刻認定規則或伺服器故障。

整理可分享的診斷資訊

提交排錯資訊前,請遮蔽訂閱 URL、伺服器位址、驗證欄位,以及可辨識個人行為的網域,只保留必要的錯誤類型、策略、時間關係和操作步驟。若要清除記錄,先保存已去識別化的關鍵資訊,再使用目前介面提供的清除功能。完成定位後,不必長期保留大量除錯記錄;日常觀察只要能回答「目前是否依預期分流」即可,並將敏感記錄的保存範圍限制在實際需要內。

返回章節目錄 ↑

07 / SETTINGS

Settings 常用項目:連線穩定後再設定自動化

Settings 中的選項應依需求逐項調整,不必把所有開關都打開。先保留一組已驗證可用的基準,再處理 On Demand、測試方式、訂閱更新和記錄相關設定。部分網路行為也可能由 Config 中的設定控制,因此結果不如預期時,請一併確認目前的設定檔。不同介面出現相似詞語,不代表作用範圍完全相同;先確認修改的是全域設定,還是某個伺服器的個別參數。

On Demand:明確設定自動連線時機

On Demand 會依照設定條件觸發連線,但無法讓錯誤的伺服器資料自動變得可用。啟用前先手動完成一次連線與驗證,再決定希望在哪些網路環境自動連線、在哪些環境保持中斷。若目前介面提供依網路條件設定的選項,請逐項閱讀條件,避免條件重疊而難以判斷結果。首次設定後,分別在預期會觸發和不會觸發的環境測試;不要只看到一次自動連線,就認定所有條件都設定正確。

若手動關閉連線後又自動重新連線,請先檢查 On Demand 和系統中的其他自動連線設定,不要連續點按開關。進入需要網頁認證的公共 Wi-Fi 時,自動連線可能讓認證流程難以判斷;可暫時停用相關自動化,先完成網路認證,排查結束後再恢復原設定。需要中斷連線進行對照測試時,也要確認自動化不會在測試期間重新啟動,否則會混淆 Direct 與未連線狀態的對照結果。

Connectivity Test:固定測試條件

設定測試方式時,先了解測試實際檢查的項目。某種方式收到回應,不代表所有協定和服務都能使用;不同方式測得的時間值也不適合直接比較。要觀察同一伺服器的變化,請盡量固定測試方式、網路和目標。若更改測試設定,請在自己的排錯紀錄中註明。不要只因一次測試耗時較長就重建訂閱,更不要為了追求更低數值而同時更改 DNS、伺服器和路由模式。

測試會產生請求,也會受到裝置目前狀態和遠端回應影響。裝置正在下載、網路剛切換,或公共網路尚未完成認證時,結果可能與平常不同。請先等網路穩定,再少量重測,並搭配實際網頁和應用程式功能驗證。若測試一直失敗但實際目標正常,請檢查測試目標本身是否可連線;若測試正常但服務仍無法使用,請回到連線記錄找出該服務使用的具體網域,不要反覆按同一個測試按鈕。

DNS:先確認設定來源

閱讀 DNS 設定時,應一併檢查目前的設定檔。若設定檔已包含 dns-server 等項目,請先了解其作用,再決定是否調整相關設定。使用 dns-server = system 的範例,表示依此設定使用系統的解析來源,而非固定指定某個公用 DNS 服務。解析錯誤可能表現為找不到名稱,也可能因取得不同位址而影響後續連線;排查時應區分解析階段與連線階段,不能只看最後網頁是否開啟。

不要同時堆疊多項用途不明的 DNS 修改。家用路由器、系統網路設定、組織原則和應用程式設定都可能參與解析流程;修改其中一處後,應重新測試並觀察結果。若涉及內部網域,也要考量該名稱是否只能在對應區域網路中解析。對內部目標誤用外部解析方式,可能導致找不到名稱;把公用網域的解析問題簡單歸因於規則,也可能讓無關的分流項目愈加繁多。保留原始設定有助於快速還原。

更新、記錄與敏感功能

若目前介面提供訂閱自動更新,可依使用頻率設定,不必每次切換應用程式時都重新整理。自動更新失敗後仍須查看錯誤原因;啟用開關不代表遠端資料一定持續有效。記錄相關選項應在診斷期間按需啟用,完成後恢復適當範圍。HTTPS 解密、憑證或指令碼相關功能不是基本連線的必要步驟;請先了解其作用、隱私界線與設定來源,再個別研究,不要從陌生說明中整段複製執行。

每次調整 Settings 後,只測試與該設定直接相關的行為,並記下原值。若出現異常,先還原最近一次修改,查看能否回到基準,不要繼續增加補救設定。Settings、目前的 Config、所選伺服器和 Global Routing 應視為一組狀態;只備份其中一部分,換裝置後未必能重現原本的行為。如果還不確定介面入口,可回到使用教學確認主要流程,再依本章逐項延伸。

返回章節目錄 ↑

08 / MAINTENANCE

日常維護:更新、備份、移轉與還原

維護的目標是保留可用狀態,並能說明最近發生了哪些變化。應用程式更新、訂閱更新和設定檔更新是三件不同的事:應用程式更新會變更程式本身;訂閱更新會重新整理伺服器資料;設定檔更新會改變規則等網路行為。三者不一定會同時發生,也不應在沒有紀錄的情況下一起操作。遇到故障時,先回想最近變更的是哪一層,通常比重新安裝更容易找到問題來源,也能避免覆蓋仍有用的記錄。

分別處理三類更新

iPhone/iPad 的應用程式更新透過 App Store 處理;Mac、Windows、Android 和 Linux 請前往下載頁重新取得對應安裝檔。更新前請備份自己的設定和必要資料,尤其是在裝置空間不足、系統中斷安裝或移轉裝置之前。電腦和 Android 重新安裝時,仍可能出現系統解除封鎖提示,請依下載頁說明確認來源後再操作。不要用應用程式更新取代訂閱更新,也不要因為訂閱中的某個項目失效,就認定應用程式需要重裝。

訂閱更新後,檢查伺服器數量、名稱和目前選取項目的變化,但不要把項目增加視為更新品質更好。某個伺服器遭移除時,可能需要重新確認原本的選擇;即使名稱未變,內部參數也可能已更新。更新失敗時,先確認基礎網路和訂閱網址是否有效,並保留具體錯誤;不要刪除現有訂閱後才發現原網址沒有保存。自行維護的伺服器,應以實際伺服器設定為準。

更新設定檔前,先保存一份目前可用的副本,並記下自己新增的例外規則。重新下載遠端設定後,不要假設本機修改一定會保留,也不要認定新檔案已自動選取。請回到 Config 確認目前使用的檔案,再以固定目標驗證 DIRECT、PROXY 和拒絕規則的效果。若更新後只有某項功能異常,先比對相關規則與 DNS 項目,只還原受影響的部分;不要立刻將整份舊設定覆寫到所有裝置。

備份時區分內容與憑證

備份至少應包含目前的設定檔、必要的伺服器資料、訂閱來源,以及自己修改過的設定說明。匯出內容實際包含哪些項目,請以應用程式目前提供的匯出方式為準;不要假設單一檔案已包含所有密碼、訂閱和偏好設定。備份後先確認檔案能開啟、名稱能辨識用途,再存放於自己管理的安全位置。設定檔也可能含有敏感資訊,即使副檔名只是文字檔,也不應公開上傳或當成一般附件任意轉傳。

訂閱 URL、UUID、Password 和部分伺服器連結都具有存取權限,分享時不能只遮住備註名稱。若憑證已公開,請到自己的服務管理介面撤銷或更換相關資料,再更新裝置中的項目;刪除聊天記錄或更改本機備註,都不會讓舊憑證失效。日常保存問題截圖時,也請檢查頂端名稱、詳細欄位和完整 URL。對外說明可提供錯誤類型與操作順序,不必附上足以重建連線的完整資料。

換機與重裝後的還原順序

新裝置先安裝應用程式並完成基本權限設定,再還原既有資料,最後還原自動化設定。iPhone/iPad 可在原購買帳號的已購項目中查找;iPhone/iPad 版由 App Store 取得,$2.99 一次性付費;Mac、Windows、Android、Linux 版免費。購買紀錄與本機設定是兩個獨立部分,還原應用程式不代表伺服器和規則也會一併恢復。還原後重新確認目前伺服器、Config 檔案與 Global Routing,完成一次完整連線驗證,再啟用 On Demand。

移轉時不宜只測試一個網頁。請選擇幾種日常使用的目標,確認需要直連的本機資源、需要代理的請求,以及原設定主動拒絕的目標是否符合預期。不同裝置所處的網路可能不同,內部網路位址和 DNS 條件也可能不同;舊裝置正常不代表新裝置可以略過網路檢查。在確認新裝置運作穩定之前,請保留舊裝置上可用的設定與備份,不要在移轉第一步就清除原裝置資料。

養成可還原的維護習慣

每次維護只進行一類變更,先保存變更前狀態,完成後依第五章驗證,必要時依第六章檢查記錄。遇到異常先還原最近一次修改,再確認是否為基礎網路或遠端服務變化。向他人說明問題時,提供裝置類型、網路環境、路由模式、錯誤現象和已測試步驟,並移除所有敏感欄位。之後可透過疑難排解快速定位常見現象,或參閱技術文章了解個別概念;需要重新檢視完整流程時,再回到本手冊對應章節。

返回章節目錄 ↑
Shadowrocket 官方下載