Shadowrocket 訂閱與伺服器管理

Subscribe 入口與訂閱記錄

先區分訂閱網址與伺服器網址

訂閱網址用來取得伺服器清單；伺服器網址則是某個連線設定實際連線的主機。兩者可能都含有網域名稱，但不能填在同一個欄位。開始前先確認手上的資訊是完整的訂閱 URL、單一伺服器分享連結，還是可供手動輸入的一組參數。只有取得清單用的訂閱網址時才選擇 Subscribe；不要只因網址以 HTTPS 開頭，就認定它是訂閱，普通網頁也會使用這種格式。

從 Home 開啟 Add Server，在 Type 選擇 Subscribe，依目前畫面提供的 URL 等欄位填入已有的訂閱網址，並為記錄設定容易辨識的名稱。不同介面版面中的入口位置可能不同，請依英文名稱確認。貼上後檢查網址開頭、結尾與查詢參數是否完整，尤其留意通訊 App 自動加入的空格與換行。儲存前不要將訂閱網址改成其中某部伺服器的網域，也不要自行刪除看似多餘的參數。

記錄儲存成功，不代表清單已取得

訂閱記錄成功儲存，只代表客戶端接受這筆記錄，不表示遠端請求已成功。儲存後使用訂閱記錄提供的更新功能取得內容，再回到 Home 確認是否出現對應的伺服器。若只有訂閱名稱，沒有伺服器項目，請繼續確認更新結果，不要立刻開啟連線。若清單已有內容，也要確認這些項目是否來自這次訂閱，避免把先前匯入的手動記錄誤認為更新結果。

訂閱回應必須包含客戶端可辨識的伺服器描述。若回傳的是登入頁面、說明網頁或錯誤訊息，即使瀏覽器能開啟 URL，也不代表內容可供匯入。檢查時先參考客戶端顯示的錯誤訊息，並向您現有服務的管理方確認網址用途與支援格式。不要將含有憑證的訂閱網址貼到公開查詢工具，也不必為了排除問題而反覆將完整連結貼到不同地方。

確認訂閱與 Config 的差異

伺服器清單與 Config 中的規則各有不同用途。前者決定連線到哪裡、使用什麼協定與憑證；後者決定請求應走 PROXY、DIRECT 或 REJECT。匯入訂閱後，不要預設目前的規則檔也已替換；同樣地，切換 Config 也不等於重新取得伺服器。分開驗證這兩項操作，才能避免清單正常，卻因規則路徑不同而誤判連線失敗。

完成匯入後，記下訂閱名稱、匯入方式與目前選取的伺服器，再依首次連線步驟進行測試。若清單為空，先檢查 URL、回傳內容與網路連線；若清單完整但無法連線，再查看參數與測試章節。排查時依序確認「取得清單、檢視參數、建立連線、連線至目標」，不要同時更換訂閱、Config 與 DNS，否則很難判斷是哪項修改造成結果變化。

Add Server 手動輸入欄位

Type 決定所需參數

若您已有完整伺服器參數，且需要逐項核對，可以手動新增。從 Home 開啟 Add Server 後，先選擇 Type，再填寫後續欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 所需資訊各不相同；切換 Type 後出現或消失的欄位並非可任意替換的別名。請以原始設定明確標示的協定為準，不要試選不同類型來補足缺漏的參數。

Address 通常填入伺服器主機名稱或 IP，Port 則填入對端提供的連接埠。除非欄位明確要求 URL，否則不要將協定前綴、網頁路徑與查詢字串一併填入 Address。網域名稱與 IP 也不一定能互換：使用網域名稱時可能牽涉 DNS 解析、憑證名稱與伺服器路由。若原始資料提供的是網域名稱，應先照原值填寫，不要為了減少變數就直接改用解析出的 IP。

分層檢查驗證、傳輸與 TLS

Password、UUID 等內容屬於驗證資料，必須完整保留字元與大小寫。Shadowsocks 的 Method 必須與對端一致，不能假設所有加密選項都能互通。VMess 或 VLESS 若另有指定傳輸方式，也要核對對應欄位；傳輸層的 Host 與 Path 也可能影響請求匹配。即使地址、連接埠與驗證資料都填正確，也不代表其他必要參數已自動補齊。

TLS、SNI 與連線網址彼此相關，但並非同一概念。連線網址決定要連線的端點；必要時，SNI 用來傳送伺服器名稱；憑證驗證則用來確認連線身分。原始設定明確提供名稱時，請依原值核對，不要將停用憑證驗證當成一般修復方式。若錯誤與憑證有關，先檢查裝置時間、名稱是否一致及對端憑證狀態，再確認傳輸設定，而不是只更換連接埠。

不同協定的參數不可混用

WireGuard 的私鑰、對端公鑰、Address、Allowed IPs 與 MTU 屬於另一套設定關係。這裡的 Address 可能指隧道位址，不能直接套用一般伺服器 Address 的意思；Endpoint 才是用來指定對端的位置。Hysteria2 的驗證與傳輸選項也應依原始資料逐項填寫。若要了解 WireGuard 欄位，可繼續閱讀WireGuard 參數說明，不要用其他協定的欄位推測缺漏值。

儲存前逐項對照原始資料，優先檢查容易忽略的前後空格、全形標點與自動換行。儲存後重新開啟編輯頁，確認欄位確實依預期保留，再測試連線。若錯誤發生在驗證階段，先檢查憑證；若無法連上端點，再檢查網路與地址。每次測試只修改一個欄位，並記下修改前的值，才能避免多次嘗試後忘記伺服器實際提供的參數組合。

掃描 QR Code 與剪貼簿匯入

Scan QR Code 讀取的是內容

QR Code 只是文字載體，圖案本身無法說明內容是訂閱、單一伺服器，還是一般網頁。使用 Scan QR Code 前，請確認 QR Code 來自您自己的設定資料，並確保邊緣完整、亮度適中且影像清晰。首次使用相機時，系統可能會要求存取權限；是否允許，請依操作需求自行決定。若辨識失敗，先檢查影像品質與權限，不要立刻修改既有伺服器，更不要為了「騰出位置」而刪除原有記錄。

辨識成功後，先確認匯入結果屬於哪種記錄。若 QR Code 包含單一伺服器連結，通常會新增一筆連線資訊；若內容是訂閱網址，還需要取得清單。若出現確認頁面，請核對 Type、Address 與名稱是否合理，不要只憑「辨識成功」就認定參數齊全。QR Code 也可能包含過期憑證，因此匯入後仍須測試連線；掃描成功無法證明遠端設定仍然有效。

剪貼簿須保留完整文字

使用剪貼簿匯入時，只複製要匯入的連結或設定文字，避免連同介紹文字、編號、程式碼區塊標記與句尾標點一起複製。若目前介面提供剪貼簿匯入入口，請依提示確認；系統詢問貼上權限時，確認是由哪個 App 發起操作。複製後立即匯入，可減少其他複製動作覆蓋內容的機會。若剪貼簿內容為空或已被新內容取代，請回到原始資料重新複製，不要憑記憶手動拼湊字元。

長連結在聊天視窗中常會因顯示寬度而換行，但視覺上的換行不一定是實際換行；反過來說，複製多段文字時也可能真的帶入換行符號。若出現格式無法辨識的提示，先檢查前綴與結尾，再確認中間是否遭到截斷。不要一律取代所有空格，因為名稱部分與編碼內容的處理方式不同。最穩妥的方式是從原始文字重新複製完整的一筆，再對照匯入後的關鍵欄位。

處理重複、批次匯入與辨識失敗

批次匯入前先確認目前入口是否支援該文字格式。多筆連結逐行排列，不一定會被當成訂閱；有些入口只接受單筆記錄。可以先用一筆自己已有的有效資訊測試入口，再處理其餘內容。匯入後依協定、地址與連接埠核對數量及項目關係，不要只計算名稱；兩筆同名記錄可能指向不同端點，不同名稱的記錄也可能儲存完全相同的連線參數。

重複匯入後，不要立刻依名稱批次刪除。先確認哪些記錄由訂閱管理、哪些是手動匯入，再查看目前使用的是哪一筆。若掃描 QR Code 與剪貼簿匯入的結果不同，請比較兩份原始內容是否完全一致，尤其留意是否複製到 QR Code 旁的另一條連結。相同資料用兩種方式都無法辨識時，問題較可能出在格式或內容，而非相機；此時請查看分享連結章節，檢查連結結構。

匯入完成後回到 Home，選取新記錄並重新驗證。先前建立的連線不一定已切換到新伺服器，瀏覽器舊頁面也可能仍顯示快取內容。測試時請明確記下目前選取的項目，並以新的請求判斷結果。若只想確認能否匯入，完成參數檢查即可，不必為了測試而同時開啟 On Demand。將輸入與連線操作分開，才能將失敗現象對應到具體步驟。

分享連結格式與 Config 的差異

前綴、主體、參數與名稱

伺服器分享連結通常由協定前綴、承載連線資訊的主體、選用的查詢參數與顯示名稱組成。常見前綴包括 ss://、vmess://、vless:// 與 trojan://，但能辨識前綴不代表後續欄位一定完整。有些主體使用編碼文字，有些則直接包含驗證資訊與地址；不同格式不能只靠替換前綴轉換。匯入時應保留完整連結，不要先依外觀自行整理成另一種協定。

連結中的問號通常用來引入查詢參數，井字號後面可能是顯示名稱，百分比編碼則用來表示某些特殊字元。這些位置具有語法意義，不只是裝飾符號。手動改寫時，若刪除參數連接符，或解碼後再複製編碼字元，客戶端讀取的內容可能因此改變。若要更改名稱，建議在匯入後透過編輯介面修改顯示名稱，避免連帶破壞驗證或傳輸參數。

單筆連結與訂閱不是同一種資料

單一分享連結通常描述一筆伺服器記錄；訂閱 URL 則用來從遠端取得清單。訂閱回傳內容可能包含多筆伺服器描述，也可能採用其他支援格式；這是回應內容的格式，與訂閱網址本身的寫法不同。不要將瀏覽器顯示的整頁文字隨意填入 Address，也不要把單筆伺服器連結當成可持續更新的清單網址。先確認資料類型，再選擇匯入入口，後續才能正確維護。

若匯入後關鍵欄位為空，應先檢查格式不符、文字遭截斷或連結缺少參數，不要預設客戶端顯示的預設值就是正確值。尤其傳輸、TLS 與驗證資訊，預設值可能與原始設定不同。可逐項比對已有的結構化參數，但不要只依可讀名稱推測協定。名稱中寫著某個地區或用途，只是標籤，不能作為地址、協定或可用性的技術依據。

規則檔管理與請求路徑

Shadowrocket 的 .conf 檔案可以包含規則內容，但不能把規則片段當成伺服器分享連結。以下範例僅說明匹配順序與動作，不含伺服器參數，也不是可直接取代個人設定的完整檔案。使用前應先了解現有檔案的其他段落與策略關係；修改既有設定時，請先建立備份，再找到相應部分，避免用一小段範例覆蓋整份檔案。

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

DOMAIN-SUFFIX 依網域後綴匹配，GEOIP 依相關 IP 地理資料判斷，FINAL 則處理先前未匹配的請求。規則會依序執行，前面的匹配結果會影響後續是否繼續檢查。範例中的 PROXY 表示相應的代理動作，並未在此指定任何伺服器。即使規則語法正確，伺服器憑證失效時，也無法靠修改 FINAL 恢復驗證。

分享前請確認接收裝置是否真的需要完整憑證，並選擇自己能掌控的傳送方式。若只是協助排錯，通常提供協定名稱、錯誤類別與已遮蔽的參數結構即可，不必傳送整條連結。含有憑證的文字一旦被他人取得，刪除本機訊息不代表憑證已失效；若要撤銷存取權，請在自己的服務管理範圍內更換相應憑證，再更新客戶端記錄。

訂閱更新方式與失敗處理

更新會改變清單，不代表所有設定都會變更

訂閱更新會重新請求網址並解析回傳內容，可能新增伺服器、移除舊項目或變更既有參數。這與 App Store 的 App 更新、Config 檔案更新是三件不同的事。App 功能更新不保證訂閱內容同步，訂閱更新成功也不代表規則檔有所變更。排查時請分別確認是哪一種更新，避免看到伺服器清單變動後，仍以舊名稱判斷目前設定是否完整。

更新前先記下目前使用的項目，並確認是否曾手動修改欄位。訂閱管理的記錄在重新取得內容時可能會重建或覆蓋，因此重要的本機修改不應只保存在其下屬項目中。若要保留測試設定，請先另存副本並註明用途，再執行更新。訂閱端如何識別項目，以及客戶端如何呈現變化，可能受內容格式影響；不要假設名稱相同就一定會保留同一筆內部記錄。

手動確認與自動更新的分工

手動更新適合首次匯入、收到明確設定變更通知，以及排錯後再次確認時使用。若目前設定提供自動更新選項，請依實際需求選擇，並確認它會作用於哪些內容。自動更新不是持續連線監控，背景執行也可能受系統狀態影響；因此重要使用前仍應主動查看清單與最近一次可見的更新結果，不要把開啟設定等同於內容已按時更新。

更新失敗後不必快速連續重試。短時間內反覆請求通常無法修正網址錯誤，還可能讓記錄充滿相同現象。先保留錯誤訊息，確認本機網路正常，再判斷問題出在網域解析、連線、回應狀態或內容解析。若訂閱 URL 已變更，請編輯正確記錄並重新核對完整參數，不要不斷新增訂閱，留下多組來源相同但狀態不同的清單。

更新成功後檢查目前使用的記錄

顯示更新成功後，查看訂閱下的項目是否符合預期，尤其確認目前選取的項目是否仍存在。若原項目已移除，請重新選擇有效項目，再測試連線。若客戶端仍保留先前結果，請分辨「清單仍看得到」與「本次請求成功」；本機留有舊清單，只能表示資料曾儲存在本機。反過來說，清單內容未變也不一定代表失敗，遠端可能確實沒有修改，應一併參考更新回饋。

若基本網路與代理路徑的結果不同，請先確認更新請求實際使用哪條路徑，再進行針對性檢查，不要假設請求必然經過目前選取的伺服器。若延遲正常但訂閱網域無法解析，可參考DNS 與解析失敗排查。不要在未記錄原始值的情況下，同時修改 DNS、路由模式與訂閱網址，否則很難釐清成功或失敗的原因。

維護完成後，簡單記錄本次是否取得內容、哪些項目有變化，以及是否已重新驗證即可。記錄中不要包含完整訂閱憑證。若更新導致目前連線無法使用，先以確認有效的備份記錄進行比對，再核對新參數；不要直接將舊清單重新匯入同一筆訂閱，並期待之後的更新都能永久保留它。長期維護仍應以有效的訂閱內容為準。

多筆訂閱命名與伺服器整理

依管理用途命名，不要依當下表現命名

有多筆訂閱時，先為訂閱記錄設定能區分用途的名稱，例如個人測試、日常設定或備用記錄，再為獨立的手動記錄標示來源類別。名稱應方便查找，不必寫入憑證、完整網址或臨時測試結果。將某次延遲寫進名稱很容易過時；把「可用」當成永久標籤也可能誤導後續維護。穩定的命名方式應說明歸屬與用途，而非承諾即時效能。

訂閱名稱與其下屬伺服器名稱代表不同層級的資訊。維護時先確認伺服器屬於哪一筆訂閱，再檢查連線參數，不要只依顯示名稱判斷是否重複。不同訂閱可能回傳同名項目，同一筆訂閱也可能包含多個名稱相近的項目。建議將需要保留的本機測試項目另外標示，確保日後更新或清理時，能分辨哪些由遠端管理、哪些需要自行維護。

比對關鍵欄位，確認是否為重複項目

判斷是否重複，至少應比較 Type、Address、Port 與相關傳輸參數；需要驗證的協定也要確認憑證是否相同，但不必將憑證抄寫到一般筆記中。即使端點相同，不同憑證或傳輸選項也可能有不同用途。反過來說，名稱不同但所有連線欄位都相同的記錄，可能只是重複匯入。刪除前先確認目前選取的項目，避免誤刪正在使用的獨立記錄。

整理訂閱時，不要為了表面一致而將所有項目複製成手動記錄，否則會失去更新關係，日後參數變更時只能逐筆修正。需要保留為獨立記錄的情況，是明確要固定參數的測試副本，並應註明它不會隨原訂閱自動更新。若同一網址被重複新增為多筆訂閱，先確認是否有不同的篩選或管理需求，再決定是否合併；不要只因 URL 相似就批次移除。

將清單整理與 Global Routing 分開處理

伺服器排序是為了方便查找與選擇；Global Routing 則決定請求如何處理。清單中排在最前面的記錄，不會因此自動成為所有請求的出口；目前選取項目、設定中的策略關係與路由模式仍須分別確認。整理完成後，回到 Home 查看目前選取項目，再開啟所用的 Config 檢查規則動作。單純更改名稱或順序，通常不構成重寫整份規則檔的理由。

清單較長時，先利用目前介面提供的分組、搜尋或排序功能縮小範圍，再檢查參數。實際入口請以目前介面為準，不要為了重現特定版面而重新建立所有記錄。每次只整理一筆訂閱，完成後確認其項目仍容易辨識，再處理下一組。分批操作的優點是發生異常時，能明確回復到最近一次變更，而不是面對整頁同時改動的記錄。

整理時也要留意敏感資訊：說明用途的備註不應包含 Password、UUID 或完整訂閱 URL，公開截圖前也要確認訂閱名稱沒有暴露私人識別資訊。若要在多部裝置上維持相同的整理方式，先在一部裝置上決定命名規則與備份範圍，再移轉到另一部裝置並檢查差異。多部裝置同時手動改名容易造成混淆，維護順序應比名稱本身更明確。

Connectivity Test 與排序判讀

先確認測試的對象

解讀 Connectivity Test 結果時，須一併考量目前採用的測試方式。不同方法可能檢查端點連線、經代理存取測試目標，或其他特定環節，因此單一數字無法代表完整使用體驗。測試前請查看相關設定，確認測試目標、方法與目前網路，再比較結果。不要將不同網路、不同目標或不同方法取得的數據直接排序，當成相同條件下的效能結論。

端點有回應，不代表驗證、TLS、傳輸與目標存取都成功。某筆記錄即使顯示延遲，也可能因憑證失效或參數不符而無法完成實際請求；反過來說，測試目標暫時無法連線，也不一定表示伺服器完全不可用。請將測試結果當作線索，再用自己需要存取的正常目標進行驗證。若結果不一致，先找出失敗環節，不要立刻刪除所有顯示逾時的項目。

在相同條件下比較與排序

排序前先固定裝置網路與測試設定，避免測試途中從 Wi-Fi 切換到行動網路。針對少數候選項目重複觀察，比一次替整份清單下結論更容易解讀。排序只代表當下條件下的結果，無法保證之後的頻寬、穩定性與目標存取情況相同。不要過度解讀短時間差異，也不要只依單次最低數值決定後續所有請求的路徑。

測試後選取某筆記錄時，請確認選取狀態確實已變更，再視需要重新建立連線並發出新請求。瀏覽器快取、既有長連線與其他 App 的工作階段都可能造成觀察延遲，因此舊頁面仍看得到，不能證明新伺服器已成功運作。驗證時請執行明確的新操作，並留意目前的 Global Routing 模式；若設定為 Direct，直接存取成功不能證明代理記錄正常。

將故障拆解成可驗證的步驟

建議依序檢查基本網路、伺服器參數、連線狀態、DNS、規則與目標服務。基本網路異常時，先讓裝置恢復正常連線；參數有誤時，回到 Add Server 逐項核對；只有目標網域解析異常時，再處理 DNS。若所有候選項目的結果都相同，應優先檢查共通變數，例如目前網路、測試目標或 Config，而不是逐筆修改各伺服器的驗證欄位。

日誌與 Data 中的資訊可協助判斷請求是否實際送出、採用哪條路徑；請先查看與本次操作時間相近的記錄，避免將舊錯誤當成目前結果。分享排錯資料時，只保留必要的錯誤類別與已遮蔽欄位，不要傳送完整憑證。若延遲正常但網頁無法開啟，可繼續閱讀DNS 專項排查，分別驗證解析與請求路徑。

最後請將排序與長期維護分開處理：暫時逾時的記錄可先保留，待確認遠端已移除或憑證已撤銷後，再進入刪除流程。一次測試不應觸發大規模清理，也不應自動修改規則。結果穩定後，記下測試條件與目前選項即可；下次網路環境改變時重新驗證，比長期依賴舊排序更能反映實際狀況。

刪除、備份與換機還原

先確認要備份的項目

備份前先區分訂閱記錄、獨立伺服器、Config 檔案與相關設定。儲存一份規則檔，不代表訂閱網址與憑證也都已備份；儲存伺服器分享連結，也不代表目前規則與裝置設定都完整保留。請確認目前匯出或同步功能明確涵蓋的範圍，再決定是否需要另外備份其他項目。尤其是手動輸入的參數，若已找不到原始資料，刪除前必須確認有可供還原的副本。

使用 iCloud 相關功能時，先確認目前裝置帳號與 App 內的相關設定，再查看實際同步結果。雲端可用狀態、系統可用空間與網路狀況都會影響操作，不要只因開關已開啟就認定備份完成。同步也不一定等同於歷史封存：刪除動作可能在後續同步時反映到其他裝置。若要保留刪除前的狀態，請另存獨立副本，並確認目前的整理操作不會一併變更該副本。

刪除前確認項目歸屬與影響

刪除單一伺服器前，先確認它是否隸屬於訂閱，以及目前是否正在使用。即使在本機移除訂閱下的項目，下次更新時仍可能再次出現；若目的是永久變更遠端清單，單純刪除本機項目不會改變訂閱回應。刪除整筆訂閱的影響範圍也可能更大，請先確認相關記錄與目前選取項目，再依確認提示操作。不要只為了隱藏一筆名稱相似的項目，就誤刪整組資料。

清理獨立伺服器時，先保留必要的參數副本，再檢查 Config 是否引用了相關策略或名稱。名稱與策略的關係應依實際設定確認，不要只看 Home 清單是否整齊。刪除後重新確認目前選項與路由路徑，必要時選取有效記錄並驗證新請求。若只是要停用某筆記錄，保留標示清楚的備份通常比立刻徹底刪除更方便還原。

依序在新裝置還原並驗證

換機時，先依已購項目還原說明從 App Store 取得 Shadowrocket，再還原自己的資料。App 購買記錄與連線資料是不同項目；還原 App 不代表訂閱、伺服器與 Config 都已完整回復。系統需求與購買適用性以 App Store 頁面標示為準。新裝置首次建立連線時，請依實際出現的系統提示處理 VPN 設定授權，不要將授權提示誤認為訂閱已驗證成功。

建議從已有的原始資料開始還原：先確認訂閱網址與獨立參數有效，再還原伺服器記錄與 Config，最後確認 Global Routing、DNS 與 On Demand 等相關設定。每還原一個部分就驗證一次，避免一次匯入多份相似備份後，無法分辨目前啟用的是哪一份。若舊裝置仍可使用，請先保留原狀作為比對，直到新裝置完成清單、連線與目標存取的完整驗證。

還原後若缺少項目，先確認備份範圍與檔案選擇，不要立刻判定資料已損毀；若項目齊全但無法連線，請轉至參數與測試章節。若訂閱憑證已在遠端變更，舊備份只能還原舊值，仍須依自己目前有效的資料更新。同步、匯出與移轉的詳細說明，請參閱設定備份與換機移轉。完成後記錄已還原的項目，並安全處理不再需要的臨時副本。