官方手冊 · 伺服器管理
Shadowrocket 訂閱與伺服器管理手冊
首次連線請依使用說明完成匯入、連線與驗證。本頁為系統查閱手冊,適合已有訂閱或伺服器資料,並需要核對欄位、更新項目或移轉紀錄時使用。以下以 iPhone / iPad 上的介面用詞定位,其他平台請以裝置上顯示的相應功能為準。
取得 Shadowrocket:iPhone / iPad 可在 App Store 以 $2.99 一次性購買,系統需求以 App Store 頁面標示為準;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費,安裝檔由本站 /dl/ 提供。購買用戶端不等於購買線路方案。本站不提供、不販售、不推薦節點或訂閱;本文僅說明如何處理你已有的資料。
Subscribe:新增訂閱並核對項目
在 Home 開啟 Add Server,選擇 Subscribe,新增你已持有的訂閱網址。訂閱網址請向你的服務供應商取得。這裡儲存的是可重新讀取的訂閱入口,讀取後才會產生可供選擇的伺服器項目。請勿將單一伺服器分享連結填入訂閱網址欄位,也不要因為某個網址能在瀏覽器開啟,就認定它能在 Subscribe 中使用。
先判斷手上的資料類型
同一個服務可能同時提供訂閱網址、單一伺服器連結及參數清單,各自用途不同:訂閱適合管理一組會變動的項目;單一連結用來複製目前這台伺服器的參數;參數清單則可在 Add Server 中逐項填寫。設定檔則在 Config 中管理,主要用於儲存路由規則及相關設定。副檔名、QR Code 外觀和備註名稱都不能取代資料分類;不確定時,請先查看原始資料對其用途的說明。
| 已有資料 | 輸入位置 | 儲存後核對 |
|---|---|---|
| 訂閱網址 | Subscribe | 訂閱中是否出現預期的伺服器 |
| 單一分享連結 | 掃碼或從剪貼簿匯入 | 項目的協定與位址是否相符 |
| 伺服器參數清單 | Add Server | 必填欄位是否與清單逐項相符 |
| 規則設定檔 | Config | 使用的設定與規則是否正確 |
儲存後先檢查清單,再進行連線
複製完整網址,保留原有的協定前綴、路徑與查詢參數。若不小心在結尾貼入換行或多餘空格,可以刪除;但不要刪掉網址中看似無意義的字元。備註請使用容易辨認的簡短名稱,不要填入帳號、憑證或完整連結。若要在多台裝置辨認同一份訂閱,可統一使用相同備註,再於各裝置的維護紀錄中註明用途。
儲存後返回 Home,展開相應的訂閱,依備註、協定與位址核對熟悉的項目。如果只看到訂閱名稱,沒有底下的紀錄,先確認是否已展開,再查看是否有可用的更新結果。核對完成後,選擇一台你認識且獲准使用的伺服器,並以實際連線驗收。清單中出現項目、選取伺服器、實際請求成功是三個不同結果,不能互相替代。
分開處理訂閱讀取異常與連線異常
如果首次讀取失敗,先確認裝置的一般網路可正常使用,再對照手邊的原始資料,檢查複製內容是否被通訊軟體分行、截短或加上引號。如果確認已完成讀取卻沒有項目,應先核對資料類型是否正確,以及回傳內容是否與 Subscribe 相容。若更新後收到帳戶提示或一般網頁,表示需要檢查訂閱本身的存取狀況;反覆更改 Global Routing 並不能將網頁轉成可匯入的清單。
如果清單完整,但選取的伺服器無法連線,請回頭檢查伺服器本身。先確認 Home 目前選取的確實是剛核對的項目,再使用相同網路測試同一訂閱中的另一個已知可用項目。若只有一個項目失敗,先保留這組紀錄,再核對位址、連接埠與協定欄位;若同組多個項目都失敗,再檢查網路、訂閱狀態與路由。每次只修改一處並記錄結果,重試成功時才知道是哪個步驟有效。
Add Server:依協定手動填寫伺服器欄位
只有在掌握完整伺服器參數時,才使用 Add Server 手動填寫。先選擇協定,再依原始資料填入位址、連接埠、驗證資訊與傳輸參數。選錯協定時,即使表單允許儲存,也可能將看似正確的值放在錯誤欄位。已有可用項目時,建議保留原項目並新增測試紀錄,確認新紀錄可用後,再決定是否取代。
區分通用欄位與協定專屬欄位
位址欄填入主機名稱或 IP,連接埠欄填入伺服器指定的數值。除非介面明確要求完整 URL,否則不要將協定前綴、路徑、查詢參數與連接埠一併填入位址欄。如果資料提供含連接埠的 IPv6 位址,請先分辨位址與連接埠各是哪一部分;用來括住完整端點的方括號不是位址內容,也不要任意依冒號將 IPv6 位址截成兩段。備註只用來辨認項目,不會參與連線。
| 協定 | 驗證或設定重點 | 請勿混填 |
|---|---|---|
| Shadowsocks | 加密方式與密碼都必須與伺服器端一致 | 加密方式不是密碼的一部分 |
| VMess / VLESS | UUID 與資料指定的傳輸參數 | 共用 UUID 格式不代表協定可以互換 |
| Trojan | 密碼與資料指定的 TLS 參數 | 不要用備註或位址欄代填密碼 |
| Hysteria2 | 驗證資訊與資料指定的 TLS 參數 | 不要照搬其他協定項目的設定 |
| WireGuard | 金鑰、介面位址與對端參數 | 公鑰、私鑰與對端位址各有用途 |
區分位址、SNI、Host 與 Path
伺服器位址決定連線要連到哪裡;在相關協定和傳輸啟用 TLS 時,SNI 是握手過程中傳送的伺服器名稱。資料也可能提供 Host 或 Path,這些屬於相應的應用層傳輸設定。例如伺服器位址是 IP,而 TLS 使用網域名稱,並不表示所有填寫網域名稱的欄位都應複製同一個值。只有資料明確指出對應關係時,才重複使用。先選擇正確的傳輸方式,再填入所需欄位;如果找不到欄位,應回頭核對協定與傳輸方式,而非找名稱相近的輸入欄位代填。
留白也是一種設定。資料未指定的選用項目不必逐一啟用;已有預設值,也不代表適用於所有端點。若資料明確指定為空值,請保留空白,不要拿其他項目的參數補上。複製密碼、UUID 或金鑰時,請檢查是否多帶空格或換行,但不要擅自更改大小寫。能夠儲存只表示用戶端接受這組輸入,不代表伺服器端認可驗證方式、傳輸方式或憑證名稱。
依錯誤發生階段回頭檢查
儲存後在 Home 選取新項目,使用相同網路進行測試。若完全逾時,先檢查位址、連接埠及目前網路是否能連到該端點;若能連到端點但驗證失敗,再檢查協定、密碼或 UUID;若已開始握手,卻在 TLS 或上層傳輸階段失敗,則回頭核對 SNI、Host、Path 等相應參數。提示訊息不一定能精確指出原因,因此不要只因為一般性的逾時提示就修改密碼。若要與已匯入的同一台伺服器比對,請先確認兩筆紀錄確實指向同一端點。
調整時一次只修改一個欄位,改完後以相同請求重新測試。如果舊紀錄可連線、新紀錄仍失敗,比較兩筆紀錄中可見的協定與傳輸選項,比重建整份訂閱更省事。新紀錄確認可用後,請加上清楚的備註,並記下哪些值來自原始資料、哪些維持預設。日後連接埠或憑證輪替時,這份不含敏感值的紀錄可協助找出需要修改的欄位。
掃碼與剪貼簿:匯入後核對內容
QR Code 和剪貼簿只是傳遞資料的方式,匯入後建立的項目取決於內容。一個 QR Code 可能包含單一伺服器連結、訂閱網址或網頁;掃描成功不代表已新增伺服器。先確認手上的 QR Code 或文字屬於哪種資料,再從目前裝置可用的入口匯入。匯入前若應用程式正在使用其他連線,請記下目前選取項目的備註,方便匯入後恢復原本的工作狀態。
使用 Scan QR Code,先檢查辨識結果
在 Home 開啟 Scan QR Code。掃描另一個螢幕上的 QR Code 時,請讓整個 QR Code 和四周留白都清楚可見,避免裁切、反光或顯示過小。如果系統詢問相機權限,只有在確實要使用相機掃描時,才依裝置提示授權。QR Code 若存於本機,且掃描入口提供選取圖片功能,可選取現有圖片;若該入口不支援圖片,請改用同一份資料的原始文字,不要將圖片上傳到線上解碼網站。
辨識後先查看應用程式顯示的內容,再決定是否繼續。如果辨識結果是一般網址、非預期的訂閱或不認識的協定,請退出並回頭核對原始資料。有些 QR Code 顯示在附有文字說明的頁面上,旁邊也可能有網頁跳轉用的 QR Code;不要把旁邊那個能順利辨識的 QR Code 當成伺服器紀錄。儲存後返回 Home,確認出現的是單一項目,還是包含多個項目的訂閱,並檢查可辨認的位址與備註是否相符。
使用剪貼簿匯入完整的單筆紀錄
從原始文字中只複製要匯入的一筆資料,不要連同標題、序號、程式碼圍欄或前後說明一起複製。聊天視窗自動換行未必真的插入換行字元,但手動換行可能會破壞連結。先檢查複製內容的開頭與結尾,再使用應用程式提供的剪貼簿匯入方式;系統詢問是否允許貼上時,只有在剪貼簿確實是剛複製的內容時才繼續。不要從來源不明的剪貼簿記錄中還原舊的伺服器憑證。
批次文字先用單筆紀錄驗證,不要假設所有格式都支援整段匯入。如果整段文字含有多行網址、說明或備註,請從原始資料中單獨複製目標項目,再檢查是否誤將它加入既有訂閱。不要為了確保一次成功,同時用掃碼和剪貼簿匯入同一條連結:重複匯入可能留下兩筆相同紀錄,也會讓後續測試無法確認實際選取的是哪一筆。
區分未讀取、已讀取但未新增,以及新增後無法連線
所謂未讀取,是指掃描沒有反應,或貼上後連協定前綴都無法辨識;此時可改用同一份原始資料的另一種形式。已讀取但未新增,通常需要檢查辨識內容的類型、欄位是否完整,以及是否已完成儲存。若已新增但無法連線,則應選取剛匯入的紀錄,再核對協定、連接埠、驗證資訊與傳輸設定。重新掃碼最多只能重做輸入流程,無法修復無法使用的端點。
有時匯入成功卻看不到新項目,可能是相應群組仍收合、篩選條件將它隱藏,或匯入後的備註與原本顯示名稱不同。先展開群組並依類型尋找項目,再開啟紀錄核對實際位址;不要為了讓它出現在清單前面,就先刪除同名紀錄。若要向他人說明失敗情況,請寫明使用 QR Code 還是剪貼簿、停在哪個確認步驟,以及儲存前後清單有何變化。不要在回報內容中附上實際連結或 QR Code。
更新訂閱:比較差異後再切換
更新訂閱會重新讀取該訂閱的伺服器清單,不是更新 Shadowrocket 應用程式,也不等於下載新的規則設定。更新前先記住目前使用的項目和一筆已驗收的備用項目,只記錄不含憑證的辨識資訊。更新後先檢查清單變化,再檢查連線與規則。若裝置近期有重要工作,請勿在尚未準備好還原資料時,同時變更位址、更新訂閱並切換 Config。
手動更新時一次只處理一個項目
在 Home 找到目標訂閱,使用該訂閱提供的更新功能。若有多個訂閱,先確認群組備註與相應網址,確定要更新的是哪一份。等待本次讀取完成;出現載入狀態時,不要連續點按或更新其他群組。若網址已變更,先確認新資料與原訂閱的對應關係,保留原始紀錄,再單獨驗證新網址;不要把排查中的臨時網址誤當成長期設定。
更新成功後,分別比較新增、移除與修改三類變化。新增項目不一定適合立即切換;原項目名稱未變,也可能已更換連接埠或傳輸方式。對目前選取的伺服器,尤其要核對更新後是否仍存在,並檢查 Home 的選取狀態。若應用程式未保留原選取項目,請手動選擇已核對的項目,再於相同網路下送出實際請求。清單總數不變,並不能證明原本的連線仍有效。
依變更頻率安排更新
剛收到已知變更,或需要驗證設定調整時,先手動更新目標群組,並預留驗收時間。如果目前介面提供訂閱自動更新選項,可依平時的變更頻率與可用網路安排;不要將自動更新視為故障修復工具。裝置進入休眠、網路尚未就緒或背景執行條件不符,都可能導致更新未在預期時間進行。若接下來有操作要執行,請返回前景核對實際結果,不要只依設定的間隔判斷。
如果目前使用的伺服器同時是讀取訂閱所需的連線,更新失敗時應分別驗證兩條路徑:讀取訂閱網址所需的網路是否可用,以及現有伺服器的服務連線是否正常。兩者可能同時失敗,也可能只有其中一項有問題。例如一般請求正常,但讀取訂閱時出現存取提示,此時應檢查訂閱狀態和回傳內容,而不是先清空伺服器清單;若更新正常但新項目無法連線,則逐項核對協定與端點。
更新後分別驗證伺服器與策略
先在 Home 確認實際選取的項目,再檢查 Global Routing。若使用 Config,除了確認單一伺服器可正常運作,也要核對目前設定是否仍將預期請求送往合適的策略。若規則參照特定策略或群組名稱,更新造成該物件變動時,應檢查參照是否仍有效;不要只因新項目名稱相似,就認為舊參照會自動調整。測試時先使用固定請求,避免不同網站本身的狀態差異影響判斷。
若更新只影響其中一個群組,先暫停更新其他群組,保留仍可用的對照組。切回已知可用的紀錄後請求若恢復,應著重檢查本次清單變化;若目前可用的紀錄也失敗,則檢查裝置網路、DNS 或路由。對照步驟請參閱開關已開啟但無法上網的排查說明。故障排除後,記下哪些項目已恢復、哪些仍待核對,避免下次將先前的臨時調整當成正常設定。
管理多個訂閱:命名、去重與設定參照
管理多個訂閱時,先區分群組來源,再處理項目名稱重複的情況。訂閱備註、訂閱中的伺服器名稱,以及 Config 中的策略名稱是三種不同標識;即使名稱剛好相同,也不代表指向同一個物件。整理前記錄目前選取的伺服器、所屬訂閱及正在使用的設定;若接下來要調整群組或刪除重複項目,請先保留可還原的紀錄。
命名時要讓下次排查找得到同一筆紀錄
為訂閱設定穩定且容易辨認的本機備註,並將用途與項目顯示名稱分開記錄。伺服器名稱可能隨訂閱更新而變動,不適合單獨用於長期辨識,也不建議將原始顯示名稱全部改成相同名稱。若從訂閱複製手動紀錄作為診斷用途,請使用一眼可辨識的測試項目備註,並在測試結束後清理,以免日後誤認為是原訂閱持續維護的紀錄。
若介面允許收合群組,日常可只展開正在使用和需要處理的部分。收合不會改變群組是否參與更新,也不能取代中斷連線。整理表可記錄群組備註、項目備註、協定、使用情境及最近一次核對結果,無須抄錄完整存取網址或任何金鑰。紀錄中的時間用來比對維護操作,不適合據此推斷伺服器端是否已完成變更。
名稱相同不代表重複,位址相同也不代表重複
兩筆名稱相同的紀錄,可能使用不同連接埠、傳輸方式或驗證資訊。反之,名稱不同的兩筆紀錄也可能指向同一端點,但由不同訂閱管理。先比較協定、位址、連接埠與必要的傳輸欄位,再確認訂閱歸屬;若無法安全核對敏感欄位,請保留兩筆紀錄並註明待確認。即使目前參數相同,日後憑證輪替時,兩份訂閱中的紀錄也可能在不同時間更新。
若同一份訂閱登記了兩次,先確認目前使用的是哪一份,以及哪一份在備份中有可還原資料。將目前連線切換至決定保留的那一份並完成測試後,再考慮刪除另一份。若清單只是因篩選或排序而顯示相似項目,先切回能清楚辨認群組歸屬的檢視畫面;不要只因位置相鄰、名稱相同或延遲接近就判定為重複。
檢查 Config 中的策略,不要用規則管理伺服器清單
訂閱提供伺服器紀錄,Config 則決定哪些請求使用預先設定的策略。以下是用來說明比對關係的 Shadowrocket .conf 規則片段,不包含伺服器憑證,也不會新增、更新或刪除任何項目。若要修改目前使用的設定檔,請先儲存副本,並確認是在修改既有規則區段,而不是在同一個檔案中再新增重複的規則區段。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
在 Global Routing 使用 Config 時,規則會依序參與比對。符合後綴條件的請求會走 PROXY;未符合前面規則且目的 IP 符合此 GeoIP 條件時會走 DIRECT;未符合前面規則的連線則由 FINAL 作為最後處理。這裡的 PROXY 是策略用詞,不是名為 PROXY 的訂閱。更多比對條件請參閱規則關鍵字說明。
清理前若發現設定中使用了特定策略群組,請先確認群組如何選擇可用項目,再核對準備刪除的紀錄是否正被參照。調整後,分別驗證預期直連與預期透過代理的請求;一個頁面能開啟,並不能證明另一種策略也正常運作。若只有部分請求不如預期,先還原原設定或相關參照,不必立即重建整份訂閱。
Connectivity Test:比較延遲並驗證連線
延遲可用來篩選目前值得嘗試的項目,但不能單獨決定長期選擇。Connectivity Test 的結果取決於目前網路、測試方式、目標及伺服器當下狀態。單次測試成功,只表示它通過本次測量,不代表所有應用程式都能透過它連線至每個目的地。逾時也只代表這次未取得結果;先建立可重複測試的條件,不要急著刪除伺服器。
先固定網路與測試條件
在 Home 找到要比較的項目或群組,使用介面提供的 Connectivity Test。第一次只選少數已知紀錄,並記下測試使用的是 Wi-Fi 還是 Cellular。若目前設定允許選擇不同的測試方式或目標,請在比較期間維持不變。筆記只需記錄測試方式、網路與對應的伺服器備註,不必保存位址或驗證資料。更換網路或測試目標後,另開一組紀錄,不要將兩組數值混在一起排名。
先測試一筆近期已知可用的紀錄,再測試剛匯入或剛更新的紀錄。若多筆結果差異很大,等本輪測試完成後再測一次,觀察排序是否穩定、是否反覆逾時。批次測試時盡量避免同時大量傳輸資料:裝置和目前網路的負載會影響測量結果。若一組紀錄中只有一筆反覆失敗,優先檢查該筆;若連對照項目也全部失敗,先檢查網路與測試目標。
分開檢視排序、選取與路由
若目前清單提供依延遲排序,可用排序將候選項目排在前面,但仍須確認 Home 的選取狀態。排序靠前的紀錄不一定是實際連線使用的項目;也不要以手動排序推斷策略群組會自動切換。剛更新的項目可能尚無有效讀數,逾時值也不應視為可與成功結果直接比較的一般數字。先重新測試未取得有效結果的項目,再決定是否暫時擱置。
| 介面用詞 | 請求處理方式 | 驗證重點 |
|---|---|---|
| Config | 依目前設定檔規則選擇策略 | 核對命中規則與實際選取的伺服器 |
| Proxy | 以代理模式處理連線 | 確認選取的伺服器能處理目標請求 |
| Direct | 以直連模式處理連線 | 核對目前網路的直接連線結果 |
以實際請求驗收,不要只看測試結果
選好候選項目後,先查看 Global Routing,再存取一個平時會使用且允許測試的目標。若使用 Config,請確認目標確實符合要驗證的策略;否則網頁能開啟,可能只是直連成功,不能證明新伺服器可用。如果為了診斷而暫時切換模式,測試結束後請恢復原設定,尤其不要讓臨時使用的 Proxy 取代日常使用的 Config。比較時盡量使用相同請求,不要拿一個能開啟的目標與另一個失敗的目標來比較伺服器。
測試顯示成功,但實際請求失敗時,先確認測試與實際請求是否走不同路徑。若路徑判斷正確,則檢查目標 DNS、握手及 Config 是否有影響該請求的規則。只有速度不理想時,再判斷問題是偶發延遲、傳輸不穩定,還是目標端回應較慢。此時保留一筆在相同網路下已知可用的對照紀錄,比不斷切換選取項目更容易找出真正的變動條件。
刪除與備份:先確認可還原,再移除
刪除前先確認要移除的是單一伺服器、整個訂閱,還是 Config;三者影響範圍不同。單一伺服器只是一筆連線紀錄;移除整個訂閱可能一併移除由其管理的項目;移除 Config 則會影響規則與策略。若要刪除目前正在使用的項目,先記下原本的選取項目,切換到要保留的項目並確認運作正常,再執行刪除。不確定影響範圍時,請先保留或暫時切換,不要批次清除。
依資料類型準備備份
訂閱備份應能重新登記原有訂閱,不能只保留目前伺服器的截圖或名稱。手動建立的伺服器與單筆分享紀錄需要保留可重新輸入的參數;規則則應另存 Config 檔案或可重新匯入的副本。備份清單可另外記錄目前選取的項目、相應的訂閱備註與 Global Routing 模式;這些狀態未必會隨檔案一併移轉。不要假設一次匯出就會包含所有伺服器、訂閱網址、策略選擇與系統權限。
若目前介面提供匯出或同步功能,請先確認匯出範圍與還原入口是否相符。有些檔案只適合還原規則,不能用來恢復 Home 中的伺服器清單;有些匯出資料包含憑證,不可當成一般文件傳送。請將備份存放在你能控管存取權限的位置,並將不含敏感資訊的清單與備份檔分開管理。檔名應能區分用途與先後順序,不要在檔名中寫入完整訂閱網址、帳號或伺服器金鑰。
刪除時逐項確認歸屬與相依項目
在 Home 先辨識目標所屬的訂閱群組,再執行刪除。若目標是訂閱中的單一紀錄,日後更新時可能再次出現,因為遠端清單仍包含該項目;若只是暫時不用,改選其他紀錄會比反覆刪除更合適。刪除整個訂閱前,請確認不再需要保留,也沒有打算繼續透過它取得更新。清理設定檔前,先確認目前模式與替代設定,並保留可還原正常分流的副本。
每刪除一個項目就返回清單核對,並進行必要的連線檢查,不要一次確認多項。若發現目前選取的是已刪除紀錄,先切換到已知可用的項目,再確認 Global Routing 與 Config 是否仍符合預期設定。若誤刪訂閱,請依備份資料重新登記並讀取;若誤刪手動建立的紀錄,則使用保留的參數重新建立。刪除本機紀錄不會撤銷伺服器端憑證,也不會讓已傳出的連結自動失效。
更換裝置後依清單分批驗收
更換裝置時,先在新裝置取得 Shadowrocket,再依序核對訂閱、獨立伺服器與 Config。先還原一份訂閱並實際讀取,接著選取一筆已知可用的紀錄進行測試;再還原獨立紀錄與目前使用的設定,最後核對 Global Routing 與 On Demand。裝置層級的連線授權或按需觸發條件,可能需要在新裝置上重新確認。還原已購項目與還原伺服器資料是兩回事;前者不保證後者也會一併移轉。商店與更換裝置相關問題請參閱已購項目還原說明。
新裝置出現重複群組時,先判斷是同步已有項目,還是手動匯入後又新增一份。確認其中一份可正常更新,且目前設定運作正常後,再處理多出的項目。至少在正常網路下重新測試一次實際請求;若平時會在兩種網路間切換,也要分別核對相關的觸發行為。伺服器、設定與使用狀態都確認無誤後,再處理舊裝置資料。其他取得、連線與使用問題請參閱FAQ。