官方手冊 · 節點管理

Shadowrocket 訂閱與伺服器管理

如果已有自己的訂閱或伺服器資料,請參閱本頁了解匯入、更新、測試與還原細節。第一次操作可先閱讀快速入門教學,完成新增與連線後,再回到本頁確認欄位或管理現有項目。

客戶端有兩種取得方式:iPhone / iPad 可在 App Store 以 $2.99 一次性購買,系統需求請以 App Store 頁面標示為準;Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費,安裝檔由本站下載頁透過 /dl/shadowrocket/ 提供。介面位置依目前使用的裝置而異。

01 訂閱入口

透過 Subscribe 匯入現有訂閱

先確認資料指向清單還是單筆項目

訂閱網址用來取得一組伺服器資料,之後可以更新;單筆分享連結則直接描述一筆連線,通常不會隨訂閱更新。這兩種資料有時看起來都是一長串文字,不能只憑長度判斷。先查看你保存的說明:若資料標示可定期取得清單,請使用 Subscribe;若內容已逐項列出伺服器位址、連接埠和協定,請依Add Server 手動填寫欄位操作。網頁介紹、登入頁面和設定檔網址也可能是一般網頁連結;看到 https:// 不代表它就是訂閱。

範例中的 https://example.com/sub?token=xxxx 僅用來說明網址格式,不會提供可用清單。實際網址的路徑、查詢參數和大小寫都可能影響識別,請完整保留,不要自行刪除問號後的內容。複製時優先從原始文字取得完整網址,避免連同前後引號、清單編號或換行一起選取。網址若含存取憑證,請視同密碼處理;在裝置間傳送資料時,不要將完整網址貼到公開筆記、支援單標題或線上解析頁面。

新增後先確認分組,再確認目前選取項目

從 Home 開啟 Add Server,在類型選單中找到 Subscribe,貼上現有訂閱網址並儲存。若介面提供備註欄,請填寫方便辨識用途的簡短名稱,不要使用網址或帳號作為名稱。回到清單確認是否出現對應項目,並展開檢查其中的伺服器資料。請以看得到子項目作為成功判斷依據:只看到分組名稱,代表入口可能已儲存,但還不能確認清單已成功取得並解析。

若有多組資料,請先匯入一組,確認名稱、預期協定及幾筆代表性資料後,再新增下一組。這樣若出現意料之外的項目,就能查明它來自哪次操作。匯入完成後,確認目前選取的伺服器確實屬於剛才核對的分組。清單可以展開,不代表已選取伺服器,也不代表目前連線已自動切換到新項目。若要確認首次連線,請依教學中的 Global Routing 設定檢查路由方式,不要把儲存訂閱和開始連線當成同一個步驟。

分別處理取得失敗與格式錯誤

更新出錯時,先記下錯誤發生的步驟。若是網路請求失敗,確認裝置本身已連上網路,再檢查網址開頭、主機名稱和原始路徑;若是權限相關錯誤,確認你持有的網址仍有效。若請求已完成卻沒有產生資料,請確認回傳內容是否為支援的伺服器清單:有些網址回傳的是登入頁面、錯誤說明或供人閱讀的文字,即使客戶端收到內容,也不一定能匯入。不要為了確認回傳內容,把含有憑證的網址交給線上檢測工具。

若只出現部分項目,先保留這次結果,並對照原始資料檢查缺少項目的協定與必填欄位,不要靠反覆匯入補齊。某筆資料欄位不完整,不代表整組資料都已失效;同樣地,清單中有一筆測試成功,也不能取代對其他項目的檢查。若更新後舊資料仍留在清單中,先確認它是獨立手動新增的項目,還是舊分組的成員,再決定是否刪除。發生錯誤時保留原分組,有助於比較更新前後的差異。

02 手動新增

Add Server 手動填寫欄位與選擇協定

先選擇協定,再依原始資料填寫

手動新增適用於只有一筆伺服器資料、需要逐項確認參數,或需要保留獨立測試項目的情況。從 Home 開啟 Add Server,先選擇資料標示的協定,再填入位址、連接埠和該協定的必填欄位。表單會依協定變動;若介面沒有資料中對應的欄位,請回到協定選擇處確認,不要把不同欄位的內容混填。不能只憑連接埠猜測協定:兩筆資料可能使用相同連接埠,卻需要完全不同的連線參數。

若表單將主機和連接埠分開填寫,主機欄只填指定的主機名稱或位址,連接埠欄填入對應數字;不要把網址前綴、路徑或連接埠一併填進主機欄。若資料分別提供位址和網域名稱,即使兩者看起來相同,也要依各自用途填入。主機欄決定連線目的地;TLS 伺服器名稱、傳輸相關主機名稱等欄位則可能用於不同環節。不要把這些欄位一律改成伺服器位址,也不要透過關閉憑證檢查來判斷欄位是否正確。

常見協定的重要欄位
協定優先確認常見欄位誤填
Shadowsocks伺服器位址、連接埠、加密方式與密碼加密方式和密碼是不同欄位
VMess / VLESS位址、連接埠、UUID,以及原始資料指定的傳輸與安全參數將傳輸路徑填入位址,或混用兩種協定的參數
Trojan位址、連接埠、密碼及對應的 TLS 參數將 TLS 伺服器名稱與連線位址視為同一欄
HTTP / SOCKS5位址、連接埠,以及資料明確要求的驗證資訊誤將位址前綴填成主機名稱的一部分
WireGuardPrivateKey、對端 PublicKey、Endpoint、AllowedIPs將隧道內位址與對端連線位址互換
Hysteria2位址、連接埠、驗證資訊及 TLS 相關設定照搬其他協定的密碼或傳輸參數

分別檢查驗證、傳輸與路由參數

以 Shadowsocks 為例,加密方式和密碼應來自同一筆原始資料;更換位址時,也要確認這些參數是否隨資料一同變更。VMess、VLESS 或 Trojan 的資料除了識別欄位,也可能指定連線所用的傳輸方式。若有路徑要求,請保留開頭斜線及原有大小寫;未提供的選填欄位,不要自行猜測補上。從豐富文字筆記複製時,留意全形標點和尾端空白,尤其不要混合不同環境的參數。

在 WireGuard 中,Endpoint 是對端的連線位址與連接埠,AllowedIPs 則指定哪些目標位址範圍交由該對端處理。後者不是用來填寫伺服器主機名稱的欄位,也不應為了測試而任意擴大網段。PrivateKey 應留在預定使用它的裝置或受保護的備份中,不可當作對端公鑰傳送。密鑰、位址與 MTU 的對應關係,請參閱 WireGuard 參數說明。

保留獨立項目,每次只修改一個欄位

測試新參數時,先為它設定獨立備註,並保留已知可用的原始項目。儲存後重新開啟該項目,確認協定仍與原始資料相符,必填欄位沒有填錯位置,再回到清單選取該項目進行測試。一次只調整一個疑似錯誤的參數,並記錄修改前後的結果。若同時更換位址、傳輸方式和憑證相關設定,即使問題消失,也無法判斷應保留哪項變更。

留意錯誤發生的階段:若無法解析主機名稱,優先檢查主機文字和裝置的解析狀況;若無法建立連線,檢查連接埠、目前網路及傳輸參數;若連線已建立但無法存取目標,再確認路由與目標網域的解析。不要使用含憑證的完整設定製作排錯截圖。若手動新增的項目只是用來對照訂閱中的某筆資料,請在名稱中註明用途,測試結束後依備份章節處理,避免長期與訂閱項目混在一起。

03 移轉資料

透過 Scan QR Code 與剪貼簿匯入

QR Code 只是載體,能否匯入取決於內容

QR Code 可能包含單筆伺服器分享連結、訂閱網址,也可能只是一般文字。掃描只負責讀取內容,不保證讀出的資料可以新增為伺服器。先確認自己的記錄中,QR Code 對應哪一類資料,再從 Home 開啟 Scan QR Code。若要掃描另一部可信任裝置上的畫面,請讓完整邊框進入取景範圍並避免反光;若 QR Code 圖片存於本機,只有在目前介面提供圖片選取功能時才使用,否則請以手邊的原始文字匯入。

若未開啟相機權限,掃描入口可能仍會顯示,但不一定能讀取畫面。請先確認系統允許目前的應用程式使用相機,再返回客戶端重試。若取景正常卻無法辨識圖案,先調整焦距和螢幕亮度,確認 QR Code 邊緣沒有被裁掉。若應用程式已讀取內容,並提示格式不受支援,問題就不在焦距或權限;請回到原始資料,確認它是訂閱網址、分享連結或其他文字,再使用相應入口處理。

剪貼簿只保留這次要匯入的文字

從自己的原始記錄複製一筆完整內容,再切回客戶端。若目前介面提示從剪貼簿匯入,先確認剪貼簿內容就是剛複製的文字,再依提示操作;若沒有提示,請依資料類型處理:訂閱網址貼入 Subscribe,逐欄提供的資料則進入 Add Server。不要以為複製後就已完成新增。剪貼簿內容可能被其他應用程式覆寫,也可能仍留著上次複製的網址,尤其是在連續處理多筆資料、跨裝置複製或剛切換帳號時。

若來源是聊天訊息或豐富文字筆記,請留意訊息中的換行究竟只是畫面折行,還是複製後的實際換行。請從原始記錄重新複製完整的一筆,不要連同標題、附件預覽文字或其他連結一起選取。若內容含編碼字元,別刪除看似多餘的百分號或等號,也不要讓輸入法自動替換半形標點。處理多筆資料時請逐筆操作,確認清單中的所屬分組和資料類型無誤後,再複製下一筆。

比較匯入前後的清單,不要只看提示訊息

完成匯入後,回到清單確認新增項目。若預期匯入的是訂閱,請確認訂閱入口已出現,並在成功取得資料後看到該組項目;若預期匯入的是單筆伺服器,請核對協定、可見備註和主機是否符合原始資料,不要只憑相同名稱判斷。若匯入後看不到可辨識的新項目,先確認現有清單是否已包含相同資料,再檢查錯誤發生於讀取、解析或儲存哪個步驟。若不確定是否已儲存,連續掃描可能只會產生更多重複項目。

排查時,可以分別透過 QR Code 和文字匯入同一筆已知資料進行比較。若文字匯入正確但圖片無法讀取,優先檢查圖片清晰度和掃描權限;若兩種方式讀出的文字相同,卻都無法新增,應先檢查格式及協定是否受支援,而不是更換掃描工具。若同一筆資料透過兩種方式匯入後內容不同,請回到可確認的原始記錄比對,不要只根據備註或 QR Code 旁的說明判斷實際內容。

05 更新清單

訂閱更新策略與變更確認

將更新訂閱與更新客戶端分開處理

更新訂閱是透過現有網址重新取得清單,可能新增、移除或調整該組資料;更新 Shadowrocket 則是更新應用程式本身,兩者不能互相取代。如果只有某組訂閱內容過期,請先更新該組,不要因為清單沒有變化就重新安裝應用程式。反之,若要確認應用程式是否有更新,也不應靠反覆更新訂閱來判斷。客戶端取得方式與常見問題請參閱下載頁,不需要在伺服器編輯表單中調整任何應用程式更新設定。

手動更新前,記下目前選取項目及其所屬分組、上次正常使用時的網路,以及幾筆可辨識的相關資料備註。不必記錄密碼,也不要把訂閱網址貼進筆記。接著只操作目標訂閱,等請求完成後再檢查分組;不要同時切換網路、修改網址和更新多個分組。更新前的記錄有助於確認兩件事:這次取得的清單與原清單有何差異,以及連線異常是否正好發生在目前使用的項目變更之後。

依維護情況安排更新頻率

初次匯入、剛更換網址或正在排查不穩定問題時,適合手動更新。一次只處理一組,確認請求的目標及完成後的狀態。若目前介面提供自動更新選項,建議先手動更新一次,確認這組資料能正常取得,再依清單變動頻率安排更新。剛完成驗證的新裝置,不必在無法查看結果時同時啟用所有分組的自動更新;若發生衝突,將難以判斷是哪一組先變更。

更新頻率不等於連線品質。清單通常穩定時,維護重點是留意有用的變化,而不是縮短兩次請求之間的間隔。若設定依賴特定項目,更新後先確認該項目仍存在,且分組名稱與選取關係沒有改變。若目前網路在背景切換,或裝置限制背景活動,自動更新未必會在預期時間完成;需要使用最新資料時,請以手動查看的清單結果為準,不要把設定中的排程間隔當成最後一次成功更新的時間。

區分內容未變、請求失敗與選取項目失效

更新後收到原本的內容可能是正常情況,不必期待每次都有新增項目。若介面顯示錯誤,但清單仍顯示舊內容,保留的舊資料不能證明這次更新成功。遇到權限錯誤,請重新確認原網址的狀態;遇到網路請求失敗,檢查目前的網路連線和網域解析;若結果為空或格式有誤,則重新確認網址類型。不要透過清空舊分組來確認更新,否則會同時失去可用的回復選項和比較樣本。

若原先選取的項目已被移除,先確認目標訂閱是否提供明確的替代項目,再檢查客戶端目前的選取項目及設定中的引用。名稱相似不能證明是同一條連線,重新選取前可比較協定、主機和用途。若伺服器清單可正常更新、原項目也仍存在,但網頁無法開啟,請繼續檢查路由和目標解析,不要反覆更新訂閱。相關差異請參閱 DNS 解析失敗排查。

06 分組與引用

整理多組訂閱與規則引用

依維護用途命名,不依臨時排序命名

整理多組訂閱時,首先要釐清各項目的歸屬,而不是替整份清單排名。為每組訂閱保留穩定且簡短的備註,足以說明是日常使用、測試對照或待確認的移轉分組即可。備註不要包含完整網址、帳號或暫時的測速結果。若同一筆資料出現在不同分組,先視為不同歸屬的項目:兩邊可能分別更新,名稱相同也不代表連線參數相同。手動新增的項目應加上容易辨識的備註,避免更新後誤認為是訂閱新增的資料。

整理時先區分幾種名稱:訂閱備註方便在清單中找到入口,伺服器備註用來標記單筆資料,設定檔中的策略名稱則供規則引用。這些名稱看起來可能相同,但不能互相取代。在清單修改備註前,先查看目前的 Config 是否依舊名稱引用項目,尤其是自行編輯過的策略組。操作時一次只更改一個分組或一類名稱,儲存後回到連線與設定介面確認,不要同時重新命名並大量刪除項目。

用規則片段確認流量的處理方式

伺服器清單是可選連線的集合,規則則決定目標流量交由哪個策略處理。以下片段僅用來說明順序,適合在設定副本中閱讀或驗證,不應覆蓋整份現有設定。前三行的比對順序很重要:先比對網域後綴,再比對地理 IP 條件,最後處理先前未命中的流量。範例中的 PROXY 是規則的策略目標,不是名為「代理」的訂閱分組;分組顯示在清單首位,也不會自動讓流量改走該分組。

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

依照此順序,符合 example.com 後綴的請求會先採用 PROXY;未符合前一條規則,且位址符合 GEOIP,CN 條件的請求會採用 DIRECT;其餘請求則交由 FINAL 處理。確認規則時,在 Global Routing 選擇 Config,再使用可辨識的目標觀察比對結果。若切換到 Proxy 或 Direct 進行比較,那只會改變目前測試的路由方式,不能據此證明此規則在 Config 下會如何比對。

移轉時保留舊分組,最後再清理重複項目

若要將日常使用的項目換到另一組訂閱,先讓新舊分組並存,再從新分組中找出用途相符的項目。確認設定中的預設路徑、指定策略及目前選取的伺服器,逐一驗證後再切換。若需要保留某項目的原始參數作為故障對照,請另存為獨立項目並標示用途,不要修改訂閱產生的資料後,期待更新時永遠保留變更。後續檢查時,要確認更新會重新提供哪些資料,而不只是查看清單目前顯示的內容。

整理完成後,透過兩種路徑驗證:先檢查平時使用的目標,再檢查一個應採用不同策略的目標。這樣能找出「伺服器可用,但流量走錯分組」的問題。若切換後立刻發生異常,先還原原先的選取項目或設定副本,再重新進行最後一項變更。定期清理也請依此順序:先確認引用和選取項目,再刪除獨立測試項目,最後移除不再需要的訂閱分組。只調整清單中的拖曳順序,不能取代這些檢查。

07 測試與排序

Connectivity Test、延遲與排序

先確認測試範圍,再比較結果

Connectivity Test 用來確認項目在目前網路和測試條件下是否可連線。結果會受到裝置網路、測試目標、連線方式和當時負載影響。這不是下載速度,也不能代表所有網站都會得到相同結果。比較一組資料時,盡量使用同一部裝置、同一個網路和同一種測試方式;測試期間不要從 Wi-Fi 切換到行動網路,也不要一邊讓多個項目承載大量傳輸,一邊將延遲數值視為固定排名。

從伺服器清單執行 Connectivity Test。先選取一組或少量用途相同的項目作為樣本,等結果完整後再擴大測試範圍。首次請求可能遇到解析、交握或連線暫時波動,必要時可間隔一段時間重新測試。兩筆資料數值相近時,觀察是否能重複得到可用結果,優先排除狀態不穩定的項目,不必因單次讀數些微差異就立刻更改預設選取項目。若只能取得單次結果,請視為當下觀察,不要據此下長期結論。

區分逾時、波動與實際服務無法使用

若只有單筆資料逾時,可先從該筆資料的主機、連接埠和協定著手,並與同組可用項目比較;若整組或多組都逾時,先檢查裝置網路及測試目標是否可連線,不要同時修改所有伺服器。若切換網路後能重現明顯差異,請分別記錄兩種網路下的結果,不要混在同一份排序中。重新測試前不要先刪除失敗項目,以免失去後續比較的樣本。

若有延遲結果但網頁無法開啟,先確認實際請求是否使用受測伺服器。查看目前選取項目和 Global Routing,再檢查規則與解析結果。測試使用的目標可能與實際服務不同,因此讀數正常不代表服務網域一定能解析;服務無法使用也不一定表示伺服器已離線。此時可參考教學中的 Data 與診斷步驟,只在自己能控制的測試範圍內比較變更前後的連線狀況。

用排序篩選項目,不要把它當成切換開關

若目前清單提供延遲排序,請等同一輪測試完成後再使用,方便比對結果相近的項目。逾時和未測試是不同狀態:前者代表已進行測試但未完成,後者則是本輪沒有結果。優先檢查已測試、可重複測試且符合實際用途的候選項目。整體排序只會改變清單的顯示順序,不能取代選取項目;若設定中有自己的策略組,也要另行確認它實際引用哪筆資料。

維護記錄只需保留測試網路、項目備註、測試方式及成功或失敗結果。備註應與所屬分組一併記錄,避免混淆同名項目。先實際測試候選項目,再考慮更改預設路徑;切換前記下原本的選取項目,以便需要時還原。若問題只出現在某個目標網域,請繼續檢查該目標的規則和解析,不必因此將整組資料重新排序。測試結果只供這次選擇參考,不必把單次結果固定為日後所有連線的優先順序。

08 清理與還原

刪除伺服器、備份與還原確認

先確認要刪除的是資料、訂閱還是設定檔

整理前先確認操作對象。刪除一筆手動新增的資料,只會移除本機這筆伺服器資料;移除訂閱入口,則可能同時移除該訂閱產生的清單項目;刪除 Config 中的檔案,影響的是規則與策略設定。請分別確認這三類項目,尤其不要把切換目前選取項目誤認為刪除。對於訂閱分組中的資料,若客戶端允許只從本機移除,而原訂閱仍會提供該筆資料,下次更新時它可能再次出現。這不代表刪除沒有生效,而是清單依訂閱內容重新產生。

清理前先找出目前使用的伺服器和所屬分組,並確認使用中的設定是否還有其他依賴。準備刪除目前使用的項目時,先切換到已驗證的替代項目,測試一個常用目標,並確認原項目已有可用備份。接著從清單中該項目的管理入口開啟刪除操作,確認提示中的刪除範圍。若只是想停止使用某組資料,不必立即刪除;保留一段觀察時間,更容易發現先前遺漏的規則引用或備用用途。

分開保存還原所需的資料

備份至少要區分三部分:可用來重新更新清單的訂閱資料、無法透過更新取回的獨立伺服器資料,以及目前實際使用的設定檔。設定檔可能包含規則和策略定義,但不能只因為能匯出一個檔案,就假設其中包含所有伺服器、訂閱入口和憑證。反過來說,使用分享連結保存一筆伺服器資料,也不代表已保存 Global Routing 的選取項目或設定檔。請以實際匯出的範圍為準,並在自己的記錄中註明哪些內容可以還原。

需要保護的備份,請存放在由自己控制且存取受限的位置。清單中記下備份對應的裝置、包含哪些分組及哪份設定檔,不要在檔名中寫入密碼、訂閱查詢值或密鑰。匯出後確認檔案可讀,且沒有誤留在公開同步資料夾中。完整備份也應註明哪些項目需要手動重建,例如未包含的局部設定或預設選取項目;更換裝置時,才不會把尚未設定的選項誤認為還原失敗。

分批還原,並確認下次更新仍可正常使用

還原時先匯入一組容易辨識的訂閱,或一筆已知的獨立資料,確認它出現在預期位置。接著還原設定檔,檢查其中引用的伺服器或策略名稱能否對應到目前清單,再恢復路由選擇。建議分兩步驗證:先確認基本連線,再以原本的 Config 模式確認目標流量是否依預期處理。只確認介面顯示「已新增」,不能證明設定、伺服器和實際規則都已正確連結。

最後手動更新一組已移轉的訂閱,確認備份不只找回舊項目,也保留後續維護所需的入口。若更新失敗但仍看得到舊清單,請保留現況,依訂閱章節檢查憑證與回傳格式。若只是在更換裝置後發現裝置上沒有安裝應用程式,請先重新取得應用程式,再還原資料。使用 iPhone 或 iPad 可參閱從已購項目重新下載的說明;找回應用程式和找回伺服器資料是兩件事,不能以其中一個步驟取代另一個。