官方手冊 · 系統查閱

Shadowrocket 訂閱手冊

匯入、維護、測試及備份既有的訂閱與伺服器資料。

本頁依管理工作分類,適合需要進一步核對欄位、更新結果或整理操作時查閱。首次建立連線請先閱讀入門指南,依序完成匯入、選擇 Global Routing、開啟連線,再回到本頁處理日常維護。

Shadowrocket 是透過 App Store 發行的 Apple 平台付費用戶端,主要使用裝置為 iPhone 與 iPad;系統需求請以 App Store 頁面標示為準。購買前可在App Store 正版核對頁確認開發者 Shadow Launch Technology Limited 與 App ID 932747118。一次買斷用戶端不等於線路方案;下文皆以使用者已有自己的訂閱或伺服器資料為前提,僅說明如何在用戶端中使用。

01 · Subscribe:建立可維護的訂閱記錄

先判斷取得的是入口,還是伺服器資料

開始前,先確認既有資料的用途。訂閱網址是用來取得一組伺服器記錄的遠端入口,通常採用 HTTPS 網址;單筆分享連結則包含一部伺服器的協定與參數。兩者都可能是很長的字串,不能只憑長度判斷。請依資料附帶的說明,確認它是供 Subscribe 使用,還是直接匯入伺服器。不要將帳戶管理網頁網址當成訂閱入口,也不要把單一伺服器網域直接填入訂閱 URL。

在 Home 點選右上角的新增入口進入 Add Server,找到 Type 後選擇 Subscribe。介面配置可能隨應用程式調整,請以目前顯示的英文標籤為準。將既有訂閱網址完整填入 URL,並為這筆記錄設定容易辨識的備註。備註建議說明用途與歸屬,例如「個人日常訂閱」,避免包含存取憑證。儲存後回到 Home,確認是否顯示對應訂閱及其中的伺服器記錄;如果只儲存了入口、尚未取得內容,請再手動更新一次。

網址前後的空格、換行,以及聊天軟體替換過的符號,都可能導致取得失敗。貼上後請特別檢查問號後的參數是否完整、英文符號是否遭到替換,以及複製內容是否混入說明文字。網址中的查詢參數可能用於存取授權,不應為了縮短內容而刪除,也不要貼到公開的線上解碼網站。核對時可比較開頭、結尾與參數名稱,不必在共用螢幕上完整顯示。

儲存後確認集合與目前選取項目

訂閱內容匯入用戶端後,先確認它是否歸入預期群組,再檢查伺服器名稱、協定類型與數量變化是否符合既有資料。名稱只是備註,無法證明兩筆記錄完全相同;同名記錄可能使用不同連接埠或傳輸設定。首次匯入時,可選取其中一筆並開啟詳細資料核對基本欄位,再返回 Home 確認目前選取項目。清單中已出現記錄,不代表可以跳過連線所需的設定選擇與系統授權。

Subscribe 的作用是維持遠端集合與本機清單之間的管理關係,而非將所有記錄變成互不相關的手動項目。之後更新時,集合中的伺服器可能新增、移除或替換。若直接修改由訂閱產生的項目,下次更新時這些修改可能被遠端內容覆寫。若要暫時診斷,請先記下原值;如有需要長期保留的自訂內容,應在應用程式允許的獨立記錄中管理,並註明該記錄不會再隨原訂閱自動維護。

觀察結果下一步核對
入口已儲存,清單仍為空手動更新一次,確認回傳內容是否為有效訂閱資料。
清單有記錄,但連線失敗確認目前選取的伺服器、Global Routing 與伺服器參數。
再次匯入後出現重複群組比較訂閱入口,保留管理關係清楚的一組。

匯入失敗時,分層定位問題

如果儲存時即遭拒絕,先檢查 URL 欄位與輸入格式;如果儲存成功但取得內容失敗,則應著重檢查入口是否可連線、授權是否有效,以及回傳內容。遠端服務若回傳登入頁面、提示頁面或空白文字,瀏覽器可能仍顯示請求成功,但這些內容並非可解析的伺服器集合。不要只憑「網頁能開啟」就認定是用戶端解析出錯。請先確認既有資料中該網址確實是訂閱入口,再對照應用程式顯示的錯誤訊息。

排查時盡量一次只變更一個條件:先重新複製原始入口,再嘗試更新;若仍失敗,比較目前 Wi-Fi 與行動網路的結果,並記錄問題發生的階段。避免連續刪除再重建,以免遺失群組與目前選取項目的脈絡。若舊清單仍可使用,可先保留並暫停重複操作,確認遠端內容後再更新。首次連線的完整步驟請見入門指南;若要依錯誤情況繼續查找,請參閱常見問題。

02 · Add Server:逐一核對手動輸入欄位

先選擇 Type,再填寫通用欄位

Add Server 適合將使用者已有的一筆完整伺服器資料建立為獨立記錄。請先選擇 Type,再填寫對應欄位,因為協定類型會決定後續需要哪些參數。不要先將所有內容填入預設表單,再任意切換協定;切換後,部分欄位可能不再適用,也可能需要重新確認必填項目。如果資料只有訂閱網址,請回到 Subscribe 流程,不要從網址猜測伺服器參數。

Address 填寫伺服器網域或 IP 位址,Port 填寫資料指定的連接埠。除非目前欄位明確要求完整 URL,否則 Address 不應包含協定前綴、路徑或連接埠。複製時容易混淆網域中的連字號與數字,Port 也不可依常見慣例自行補填。伺服器名稱或備註僅供本機辨識,可依用途命名;通常不會參與伺服器驗證,修改備註也無法修正位址、密碼或傳輸參數錯誤。

驗證資料必須符合所選協定。部分協定使用 Password,部分需要 UUID,也可能需要使用者名稱、金鑰或其他專用欄位。空白字元也會成為實際輸入內容,尤其要留意從文件末尾複製到的換行。填寫完成後,先逐項比對原始資料,再儲存並測試;如果資料不完整,應先補齊再繼續,不要拼湊其他協定的欄位。手動輸入的目的,是準確還原既有資料,而非嘗試各種選項直到偶然連線成功。

分別核對協定欄位與傳輸欄位

Type核對重點注意事項
ShadowsocksAddress、Port、加密方式、Password加密方式必須與伺服器設定一致。
VMess / VLESSUUID、傳輸方式、TLS 相關參數不能只憑 UUID 判斷設定是否完整。
TrojanPassword、TLS、伺服器名稱憑證驗證名稱可能與連線位址不同。
Hysteria2驗證資料、TLS、專用傳輸參數依既有資料填寫,不要套用其他協定的設定。
WireGuard金鑰、Peer、位址及相關網路參數需一併核對,不能只複製連接埠。

協定驗證與傳輸方式是兩種不同的資料。同為 VLESS 或 VMess 的記錄,可能使用不同傳輸方式;即使 Address、Port 與 UUID 完全相同,缺少路徑、Host 或 TLS 相關欄位仍可能導致連線失敗。只有既有資料明確要求時才填寫這些附加項目,不要因為表單出現輸入框就任意填值。核對時先確認基本驗證資料,再檢查傳輸方式,最後檢查憑證相關設定,可減少反覆修改造成的混亂。

TLS 的伺服器名稱會用於憑證驗證等程序,不一定與 Address 相同,但必須符合伺服器設定。遇到憑證錯誤時,不應先關閉驗證來規避問題;請檢查網域、裝置時間、憑證有效性,以及資料中對名稱的要求。有些錯誤看似「無法連線」,實際上發生在驗證或交握階段。保留完整的錯誤訊息,比只描述連線開關是否開啟更有助於判斷。

儲存一筆方便日後核對的記錄

儲存前,建議依照「位址與連接埠、驗證、傳輸、TLS、備註」的順序逐項檢查。儲存後返回 Home 選取這筆記錄,確認目前選取狀態,再進行測試。成功儲存不代表成功連線:表單驗證只能檢查部分格式,無法證明遠端伺服器正在接受請求。如果匯入與手動輸入產生的結果不同,請開啟詳細資料逐欄比較,特別留意預設值,以及分享連結中未包含的附加參數。

需要測試某個欄位時,先複製記錄或保存原值,再一次只修改一個項目,並記錄修改後的情況。若同時變更多個項目,即使恢復連線,也很難找出真正原因。對於由訂閱維護的伺服器,若要長期修正,應先確認遠端資料是否需要更新;本機修改可能在下次重新整理時被取代。如對 Hysteria2 的傳輸概念有疑問,可閱讀Hysteria2 協定說明;實際填寫仍須依據使用者既有的伺服器資料。

03 · Scan QR Code 與剪貼簿:預覽後再儲存

掃描只會改變輸入方式,核對責任不變

Scan QR Code 用來讀取 QR Code 中的文字,再由應用程式判斷能否將其作為伺服器或訂閱資料處理。操作前先確認 QR Code 來自使用者既有資料,並判斷內容描述的是單筆伺服器,還是訂閱入口。QR Code 外觀看似相同,內含內容卻可能截然不同;帳戶網頁、一般文字與伺服器分享連結都能產生 QR Code,因此「掃描成功」只表示已讀取內容,不代表取得了有效設定。

在 Home 開啟掃描入口進入 Scan QR Code,依系統提示授予必要的相機權限,並將完整 QR Code 放入取景範圍。若應用程式接著顯示詳細資料或匯入確認畫面,請先核對 Type、Address、Port 與備註,不要立即連續確認。QR Code 若遭裁切、壓縮或反光遮擋,可能無法辨識;請先改善清晰度與取景距離再試,不要將辨識失敗誤認為伺服器無法使用。

若 QR Code 儲存在同一部裝置上,且目前應用程式確實提供從相簿讀取的入口,可使用該功能;若介面沒有此功能,就不必反覆尋找。更直接的方式是使用資料中對應的原始分享文字,透過剪貼簿匯入。不要將含憑證的圖片上傳至公開辨識工具,也不要為了方便辨識而在公開頁面展示完整 QR Code。QR Code 中的內容通常具有與明文憑證相同的存取權限。

剪貼簿匯入時,請保留完整文字

複製時只選取一筆完整的分享連結或一個明確的訂閱網址,不要連標題、編號、引號或說明段落一起複製。返回 Shadowrocket 後,使用目前介面提供的剪貼簿匯入或新增提示;若出現系統的貼上授權提示,請確認此次確實要讀取剛才複製的資料。如果沒有匯入提示,可進入新增流程查看是否提供對應入口;不要將整段編碼內容直接貼入 Address 欄位。

長連結顯示時可能自動換行,畫面上的換行不一定是實際換行。常見問題通常是複製時遭截斷、插入空格,或只複製到連結顯示標題,沒有複製底層內容。匯入失敗後,先回到原始資料重新複製,不要手動刪除看不懂的編碼。若資料經由文件傳送,請確認使用一般文字複製,避免智慧標點將英文引號、加號或斜線替換為其他字元。

一次匯入多筆內容時,先確認應用程式如何處理目前的格式。多行分享文字與訂閱回傳的編碼集合並非同一種內容,不能只因為「都有很多伺服器」就混用入口。建議先匯入一筆可核對的記錄,確認欄位正確後再處理其餘內容。匯入完成後,立即檢查新記錄的歸屬,避免與既有同名項目混在一起,以免下次選擇伺服器時誤用舊參數。

分開驗證辨識、解析與連線

此流程可分成三個檢查點:第一,是否讀取到完整文字;第二,是否解析為正確記錄;第三,記錄是否能建立預期連線。掃描後沒有反應通常屬於第一步;提示不支援的內容多半屬於第二步;記錄已出現但請求失敗,才進入第三步。依階段排查,可避免反覆掃描,卻始終沒檢查 Port 或 TLS 欄位。

解析成功後,請開啟新記錄的詳細資料與既有資料比對。名稱顯示亂碼,可能只是備註編碼問題,也可能表示連結遭到重複編碼;仍須繼續檢查驗證與傳輸欄位,不能只憑名稱判斷。如果 QR Code 與剪貼簿匯入得到相同記錄,但兩者都無法連線,應優先檢查原始參數、伺服器狀態與本機網路,而不是繼續更換輸入方式。保留一筆記錄即可,重複匯入不會提高連線成功率。

操作完成後,可複製一般文字以覆蓋剪貼簿中的敏感內容,並依裝置本身的隱私設定管理剪貼簿存取權限。若匯入時曾共用螢幕或傳送截圖,請檢查是否洩漏完整 QR Code 或授權參數。若誤匯入記錄,先確認它不是目前正在使用的項目,再依本頁刪除與備份章節處理。首次連線仍須選擇 Global Routing 並完成系統授權,相關步驟已在入門指南中依序說明。

04 · 分享連結格式:分辨記錄、訂閱與 Config

協定前綴決定後續文字的解讀方式

單筆伺服器分享連結通常帶有協定前綴,例如 ss://、vmess://、vless:// 或 trojan://。這些前綴不是一般網頁網址,而是告訴應用程式如何解讀後續的伺服器資料。各協定的編碼與參數規範並不相同;有些會將多個欄位放入編碼內容,有些則分開表達驗證資料、位址與查詢參數。因此,不應以替換前綴的方式將一種協定連結改成另一種。

也不能只憑外觀判斷 HTTPS 網址的用途。它可能是訂閱入口、設定檔網址,也可能只是一個網頁。匯入前應依據既有資料確認目標:伺服器分享資料使用伺服器匯入流程,訂閱入口交由 Subscribe 處理,規則設定則交由 Config 處理。若將 Config 文字當作伺服器清單解析,或將伺服器訂閱載入為設定檔,錯誤通常發生在內容解析階段,而非網路連線階段。

分享連結中,井字號後的內容常用作備註,問號後的內容常用作附加參數,但實際含義須依格式規範判斷。修改備註通常無法修復驗證問題,查詢參數則可能影響傳輸方式、路徑或 TLS 行為。不要為了縮短連結而刪除後半段,也不要將所有編碼字元替換成看起來較容易閱讀的字元。百分比編碼、Base64 與一般文字混用時,重複解碼可能改變實際欄位值。

了解 .conf 的用途範圍

Shadowrocket 的 .conf 可包含規則與其他設定。下方只展示一段 [Rule],網域僅供說明語法,並非可用的伺服器資料,也不是能獨立完成連線的完整設定。這段內容描述的是如何處理請求,而非如何取得伺服器憑證。使用既有設定時,應先保留原始檔案,再確認這些規則與其他設定之間的關係;不可只複製三行就取代目前使用的整份設定。

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

DOMAIN-SUFFIX 用於比對網域後綴,GEOIP 依目標 IP 的地理分類進行比對,FINAL 則提供最後的處理方式。規則通常依序檢查,因此具體條件與預設條件的排列位置會影響結果。PROXY 和 DIRECT 是規則中的處理關鍵字,不應翻譯。此處的 example.com 僅用於示範比對對象,不代表需要填入任何伺服器記錄。

Global Routing 的 Config、Proxy、Direct 會決定整體如何處理請求。選擇 Config 時,還須檢查目前設定中的規則;選擇 Proxy 時,不能只憑網頁可存取就判定網域規則正確;選擇 Direct 時,也不能以結果證明代理伺服器可用。訂閱管理與規則設定應分開核對:先確認目前記錄,再確認路由模式,最後檢查實際請求是否依預期處理。

分享前先檢查範圍與敏感資料

匯出單筆伺服器記錄與匯出整份設定,包含的資訊範圍不同。單筆記錄可能含有驗證資料,設定檔則可能包含自訂規則、DNS 設定、遠端網址及其他個人化內容。傳送前先確認接收者實際需要哪些資料:排查欄位名稱時可提供已遮蔽的截圖,說明規則時可提供最小必要的規則片段,不必一併傳送整份帳戶相關內容。即使備註看起來很普通,連結本文仍可能具備直接存取能力。

跨裝置整理時,若使用應用程式提供的分享功能,應在接收裝置上檢查匯入結果,不要以為產生連結就代表遷移完成。部分附加設定可能依賴本機設定或訂閱關係,單筆分享記錄不一定包含所有脈絡。特別是從訂閱項目分享出的獨立記錄,匯入後是否仍會依原訂閱維護,須以實際分組與入口為準;不要將「參數相同」與「維護關係相同」混為一談。

遇到無法辨識的格式時,優先保留原始文字,並確認應用程式是否支援該表達方式;不要貼到公開的轉換服務。可從既有資料取得適用於目前匯入入口的格式,或在欄位齊全時改用 Add Server 手動輸入。特定協定的延伸參數應以目前應用程式介面及原始伺服器資料為準;本手冊不會透過修改編碼文字來猜測驗證欄位,也不提供依缺漏資料還原憑證的方法。

05 · 更新方式:區分請求成功與內容變動

執行一次可核對的手動更新

更新訂閱會重新請求入口,並將回傳的伺服器內容套用至對應集合。這不會逐一修復所有伺服器,也無法讓已失效的授權自行恢復。操作前先記下目前使用的訂閱群組與選取的伺服器,必要時也記錄正在使用的設定。如此一來,即使清單順序改變、名稱調整或某筆記錄遭移除,也能判斷變化原因,而不會把更新後顯示不同誤認為整個用戶端設定遺失。

在 Home 找到目標訂閱,使用目前介面提供的更新功能。不同介面可能將操作放在群組選單、編輯入口或訂閱管理區域,請以 Subscribe 項目為目標,而非逐筆編輯伺服器。啟動後等候請求完成,再查看回饋與清單變化;不要在請求尚未完成時反覆點選。若有多個訂閱,建議先更新一個已知集合,確認結果後再處理其他集合,方便找出發生問題的入口。

更新成功但項目沒有變化,可能只是遠端內容與本機一致;項目變多也不代表連線品質改善。應分別確認「請求已完成」、「內容可解析」、「變化符合預期」及「目前選取項目仍有效」。更新後開啟常用記錄的詳細資料,確認協定與重要參數是否變動,再執行測試。若目前選取項目已遭移除,應從新集合中重新選擇,不要只因連線開關仍開啟,就認為原本的選取項目仍有效。

自動更新與請求路徑

若需要自動維護,可在 Settings 中尋找訂閱相關的自動更新選項,依目前介面說明設定,例如在開啟應用程式時更新。啟用自動功能前,應先手動更新一次,確認入口有效。自動更新只會改變觸發時機,無法保證每次都能在背景完成網路請求;裝置網路、應用程式執行狀態與系統排程都可能影響結果。重要變更後仍應回到訂閱清單核對,不要只依賴開關狀態。

更新請求本身也需要網路路徑。若入口只能在特定連線條件下存取,應依據現有設定了解實際使用的路徑,不要立即將所有流量改用另一種 Global Routing。尤其在舊伺服器已無法使用時,若更新請求仍依賴這條連線,就可能陷入無法取得新清單的循環。排查時記錄切換前後的路由模式與網路環境,每次只變更一個條件,避免為了更新而永久打亂日常規則。

失敗階段檢查重點
無法送出或完成請求本機網路、網域解析、請求路徑與逾時提示。
回傳內容無法解析入口是否正確,以及是否回傳網頁、空白內容或不支援的格式。
清單更新後無法連線目前選取項目、新參數、驗證狀態與伺服器連線能力。

失敗後保留現況,避免反覆重建

發生更新錯誤時,先保留原訂閱與舊記錄,並記下錯誤訊息及當時的網路環境。如果舊清單仍在,就不必立刻刪除;刪除不會改變遠端入口的回傳內容,反而會失去原本可用的參考記錄。應先確認授權參數是否完整、入口是否有變更,再判斷是否需要替換 URL。替換入口與新增第二個訂閱的管理結果不同,操作前請先確認要修正原有集合,還是建立獨立集合。

若更新後大量記錄變動,先檢查是否誤用了另一個既有訂閱入口,或複製時取得了用途不同的網址。不要只根據備註判斷,因為備註可能相同,但 URL 完全不同。若遠端內容原本就調整了伺服器,舊記錄能否繼續使用取決於伺服器的實際狀態;保留舊記錄只方便比較,不代表它仍然有效。請依新資料核對,避免將已失效的舊記錄重新加入長期維護的集合。

日常維護建議採取明確節奏:有需要時手動核對,以自動更新作為輔助,發生異常時保留一份完整錯誤資訊。頻繁連續請求既無法修復格式,也容易讓錯誤回饋混在一起。更完整的操作入口與原因分類,請參閱訂閱手動與自動更新說明。若問題是解析成功但速度緩慢,請改查測試與排序,不要繼續當成訂閱格式問題處理。

06 · 整理多個訂閱:維持歸屬清楚、規則易讀

以名稱說明用途,不要把名稱當成識別依據

使用者已有多個訂閱時,先為每個入口建立清楚的管理用途,再整理其中的伺服器。訂閱備註可說明用途、裝置或管理歸屬,例如「個人常用」、「暫時測試」,但不應包含完整授權參數。伺服器名稱可能由遠端內容產生,並在更新時變更,因此不能將名稱視為永不改變的識別標記。真正需要核對的是所屬訂閱、協定、位址與重要連線參數之間的對應關係。

整理前先列出目前有哪些訂閱入口、哪些記錄是手動新增,以及哪些是透過掃描或剪貼簿匯入。同名伺服器不一定是重複項目,不同名稱的記錄也可能指向相同位址。不要只依名稱批次刪除。可開啟詳細資料,比較 Address、Port、Type 與傳輸參數,再判斷是否確實多餘;驗證資料不同的記錄應分別保留,除非既有資料已確認其中一筆不再使用。

若同一訂閱被匯入多次,通常會形成重複的管理項目,而不是更完整的集合。要保留哪一份,應確認目前選取項目、備註與設定檔的引用關係,不要單純保留清單最上方的一份。刪除前先在預計保留的集合中選取對應記錄並驗證,再處理重複項目。即使有許多同名項目,也能避免誤刪目前唯一可用的記錄。整理操作應與更新分開進行,方便判斷每次變動的原因。

訂閱分組不等於路由策略

Home 中的訂閱分組,首先用來回答「這些伺服器由哪個入口維護」;Config 中的規則則回答「特定請求應如何處理」。將伺服器放進不同訂閱,不會自動讓不同網站使用不同伺服器。如果設定檔還引用策略群組或特定名稱,就須進一步確認設定檔實際如何選擇伺服器。單純調整清單顯示順序,也不會自動修改規則的比對條件。

Global Routing 是確認這項關係的起點。選擇 Config 時,應確認目前啟用哪份設定,再查看相關規則與策略;選擇 Proxy 時,測試重點是代理處理路徑;選擇 Direct 時,結果反映的是直接連線。整理訂閱時不要同時在沒有記錄的情況下切換這些模式,否則同一伺服器前後的測試結果可能來自不同請求路徑,整理結論也就失去可比性。

介面用語管理上的含義另須確認
Config依目前設定處理請求。具體規則、策略引用與目前設定。
Proxy以代理模式處理請求。目前選取項目與實際連線結果。
Direct以直接連線模式處理請求。確認測試是否仍會經過目標代理伺服器。

分批操作,維持長期可讀性

建議依照「確認歸屬、核對重複、統一備註、驗證選取項目、清理多餘項目」的順序整理,每次只處理一個訂閱。完成一組後返回 Home 檢查清單,再繼續下一組。如果應用程式提供篩選、收合或排序功能,可先整理顯示方式以減少干擾,不必急著刪除資料。隱藏或收合只會改變可見範圍,刪除則會移除持有內容,兩者不可混為一談。任何批次操作前,都應確認其作用範圍是目前群組還是所有記錄。

長期保留的手動輸入記錄最好採用獨立命名方式,明確標示它們不依賴 Subscribe 更新。例如在備註中說明用途,而非填入容易過期的測試數字。需要暫時比較兩筆參數記錄時,可在本機備註中說明「原始」與「測試」的關係,測試結束後儘快清理。不要將臨時修改長期留在訂閱產生的項目中卻不作記錄,否則下次更新時可能被覆寫,也可能讓日後排查的人誤以為該內容來自遠端原始資料。

整理完成後,應重新確認目前選取的記錄及 Config 中的引用。特別是設定檔中依名稱引用項目的情況,重新命名或刪除可能影響後續選取,不能只因清單看起來整齊就結束。對於名稱會隨更新變化的集合,更應避免未核對就依賴固定顯示文字。規則與模式的進一步說明請見代理模式;若清單管理正常,但特定網站的處理方式不符預期,應檢查規則,而非繼續調整訂閱分組。

07 · Connectivity Test:測試、排序與實際請求

先確認測試的測量對象

解讀 Connectivity Test 結果時,須配合所選測試方式。不同方式可能測試伺服器位址與連接埠是否可達,也可能透過代理程式送出指定請求;兩者涵蓋的環節不同。基本網路探測成功,不能證明協定驗證、TLS 交握及目標網站存取都正常。測試前先在目前介面確認測試方法與相關設定,再解讀顯示結果;不要把任何一個數字當成整體連線品質的完整結論。

測試條件應盡量保持一致:使用同一部裝置、同一個網路與同一種測試方式,並避免同時更新訂閱或大量傳輸資料。若一筆在 Wi-Fi 下測試、另一筆在行動網路下測試,結果就會受到本機網路差異影響。批次測試也可能產生並行影響,因此清單中細微的差距不一定有實際意義。應先找出明顯失敗或持續表現異常的記錄,再針對少數候選項目重複檢查。

若顯示逾時,先判斷發生在哪種測試中。伺服器連接埠無法連線、協定驗證失敗、測試目標無法存取,都可能顯示為失敗,但處理方向各不相同。未確認測試方法前,不要直接刪除所有逾時記錄。可選一筆參數已核對的記錄,分別檢查基本連線能力與實際請求,再比較錯誤訊息;這比不斷更換測試目標更容易判斷問題所在層級。

排序是觀察工具,不是長期保證

依測試結果排序有助縮小候選範圍,但排序反映的只是目前條件下的一次觀察。網路負載、目標網站、連線重複使用情況與測試時間都會影響結果,清單第一筆不一定在所有請求中表現最佳。不要將一次較低的延遲記入永久備註,也不要據此推斷持續傳輸能力。若要長期使用,更重要的是多次觀察是否穩定,以及實際使用時的請求是否符合預期。

排序後仍應手動確認目前選取的伺服器。變更顯示順序不一定會改變選取項目,批次測試完成也不代表用戶端會自動採用結果最佳的記錄。若使用的設定檔包含策略群組或其他選擇邏輯,還需要檢查其實際行為。操作完成後返回 Home 確認目前記錄,再送出一次實際請求;不要只憑排序位置判定某部伺服器已生效。

狀況可以表示不能直接表示
基本探測成功該次探測涵蓋的網路環節可連通。所有協定參數與網站請求都正常。
代理請求測試成功測試目標當時可透過此路徑存取。所有網站與持續傳輸的表現都相同。
單次逾時本次測試未能在時限內完成。記錄永久失效或一定要刪除。

透過實際請求完成驗證

測試通過後,選擇一項使用者實際需要的請求進行驗證,同時確認 Global Routing 與目前的 Config。若一般瀏覽正常,但某個應用程式異常,應檢查目標網域、DNS、規則比對及應用程式本身的連線行為,而不是立刻修改所有伺服器參數。既有連線也可能繼續使用原路徑;切換伺服器後,應透過新請求觀察變化,避免將舊連線的結果誤認為新選取項目未生效。

實際存取速度緩慢時,可分別比較伺服器、傳輸路徑、本機網路與目標服務。先在相同網路下更換一筆既有記錄,再於條件允許時比較 Wi-Fi 與行動網路;每次都使用相同請求,避免同時更換目標。若只有網域相關請求失敗,可繼續檢查 DNS 與規則;若所有連線都不穩定,先檢查本機網路。分層排查方式請參閱速度緩慢的分層排查說明。

求助時可提供協定類型、測試方式、失敗階段、目前 Global Routing 與網路環境,但不要包含 Password、UUID 或完整訂閱網址。DNS 相關問題可參考DNS 設定說明;但不要為了追求單次測試結果,同時更換 DNS、規則與伺服器。一次測試只回答一個問題,後續調整才有依據;結果不一致時,少量且可控的重複測試,比反覆批次重新整理更有價值。

08 · 刪除與備份:先確認可還原,再清理記錄

刪除前確認對象與影響範圍

刪除單筆手動輸入記錄、刪除訂閱入口,以及刪除 Config,是三種不同操作。刪除單筆記錄通常只影響該伺服器;刪除訂閱項目可能會一併移除其管理的集合;刪除設定檔則會影響規則與相關設定。操作前務必閱讀目前的確認提示,了解實際影響範圍。不要因為幾個項目顯示在相鄰位置,就認為能用相同方式還原;也不要把「離開編輯畫面」誤認為已取消刪除。

刪除正在使用的記錄前,先選擇另一筆已驗證可用的既有記錄,並確認目前設定仍能依預期運作。若有策略引用或固定名稱關聯,也要檢查是否需要調整。訂閱中的單筆記錄即使在本機刪除,下次更新時仍可能再次出現,因為遠端內容仍包含該項目;若只是想減少畫面上的干擾,應先查看應用程式提供的整理方式,不要將刪除當成永久篩選規則。

確認要清理重複訂閱時,先比較入口與歸屬,再備份需要保留的本機資料。兩個群組名稱相同,不代表內容完全相同;兩個 URL 看似相近,也可能含有不同授權參數。若不再使用舊入口,先確認新入口已完成更新及實際連線測試,再移除舊項目。清理過程中保留簡短操作紀錄,註明刪除的項目及替代關係,可減少更換裝置或還原時的猜測。

分層備份資料

備份應涵蓋四類資料:訂閱入口與備註、獨立伺服器參數、目前使用的 Config,以及必要的本機設定。應用程式購買記錄無法取代這些內容;從 App Store 重新取得 Shadowrocket,不代表所有個人設定都已還原。實際可匯出的範圍取決於目前應用程式提供的備份或匯出功能,請檢查實際包含的項目,不要只憑檔名認定所有資料都已備妥。

如果目前介面提供 Data 或相關備份入口,可依介面說明匯出,並確認匯出結果是否包含所需項目。若部分內容須分別儲存,請逐項處理:保留原始訂閱資料、儲存獨立設定檔、記錄手動輸入欄位與選取關係。不要將敏感參數放入公開筆記或隨意共用的資料夾;備份檔案應視為存取憑證,存放於使用者可控且有適當保護的位置。

備份時也應記錄相關脈絡,例如目前使用哪份 Config、Global Routing 的選擇、常用記錄的歸屬,以及是否啟用訂閱自動更新或 On Demand。這些資訊不一定會包含在單筆分享連結中。On Demand 涉及依條件建立連線,遷移後應重新確認條件與系統授權;在伺服器與規則尚未驗證前,不要直接依賴此功能。備份不只是保存「可匯入的文字」,也須保留足以理解其管理關係的資料。

還原順序與備份有效性

還原時先確認 Shadowrocket 已從 App Store 正確取得;購買與重新安裝說明請參閱已購項目還原。接著依照「匯入訂閱與獨立記錄、還原 Config、檢查本機設定、選取目前記錄、驗證實際請求」的順序操作。若涉及訂閱,先檢查既有備份內容,再決定何時更新;立即更新可能使清單變動,影響與舊裝置逐項比較。

備份檔案能夠儲存,不代表一定能完整還原。應在合適時機進行一次可控的驗證,確認應用程式能讀取檔案、記錄是否齊全、Config 是否存在,以及敏感欄位是否完整。若要在自己的另一部裝置上驗證,請避免覆寫該裝置原有設定;先保留原狀,再進行還原。驗證完成後比對重要欄位與一項實際請求,不要只因清單數量一致就認定還原成功。

訂閱入口或驗證資料日後若有變更,舊備份可能仍保留舊值。重要變更完成且確認可用後,應更新備份,並清楚區分目前版本與歷史版本。保留歷史資料有助於比對,但不代表舊伺服器仍然有效。如果完整訂閱資料或驗證資訊曾遭洩漏,只刪除本機記錄無法撤銷已洩漏的存取權限;應依既有帳戶的管理方式處理相關憑證,再更新用戶端與備份。

若要重新依序完成連線流程,可返回入門指南;若要依具體錯誤繼續查找,請前往常見問題。日常管理不必頻繁重建所有設定;保留清楚的入口、欄位與操作紀錄,通常更容易判斷下次異常發生在哪個環節。

下載 Shadowrocket