Shadowrocket 訂閱與伺服器管理

第一章 · 匯入對象

Subscribe：新增既有訂閱

訂閱是一個用來取得伺服器清單的網址，不是某一台伺服器本身。Shadowrocket 向該網址提出請求後，會解析回傳內容，再將可辨識的伺服器項目加入清單。訂閱網址用來說明「從哪裡更新」，項目則說明「如何連線」。先分清這兩種對象，才能理解為什麼重新輸入單一伺服器無法修復整份訂閱的更新失敗，也能避免把登入網頁誤當成訂閱網址。

先確認取得的是訂閱網址

匯入前，先確認既有資料的用途說明。訂閱網址通常是完整網址，可能帶有較長的路徑和查詢參數；管理網頁則可能需要登入才能查看內容。兩者外觀相似，回傳資料卻不相同。不要只因網址含有某個英文單字就判斷用途，也不要刪除看似隨機的參數。這些參數可能用來識別存取權限，少一個字元就可能取得錯誤內容。

複製時，從網址開頭一路選到結尾，並留意聊天軟體或文件是否將長網址折成多行。畫面上的換行不一定是原始文字的一部分，但手動拼接容易插入空格。優先使用原始資料提供的複製功能，之後在輸入欄確認通訊協定、網域及末尾參數。不要將訂閱網址貼到搜尋欄，也不要將它附在公開提問中；持有完整網址的人可能取得相同的伺服器資料。

從 Add Server 建立 Subscribe 項目

進入 Home，開啟 Add Server，在 Type 中選擇 Subscribe，再將既有訂閱網址填入 URL。介面配置可能因裝置或 App 內文案而異，判斷重點是目前類型為 Subscribe，而非某種單一伺服器通訊協定。填入方便辨識的備註後儲存，並等待清單載入完成。首次操作建議一次只新增一筆訂閱，發生問題時才容易確認對應的網址。

儲存後返回 Home，確認是否出現預期的訂閱群組與伺服器項目。顯示訂閱名稱只代表管理對象已建立，不能僅憑名稱判定遠端內容已成功解析。接著檢查項目數量是否大致符合既有資料、通訊協定是否可辨識，以及是否出現錯誤提示。清單為空時，先保留訂閱對象並記下提示，再檢查網址與網路，不必立刻重複新增相同訂閱。

若匯入成功，請選取一台已知參數正確的伺服器作為目前選擇，再依教學完成連線與驗證。訂閱更新成功、選取伺服器、開啟連線開關，以及實際請求可用，是四種不同狀態。只完成第一項，並不表示整條連線已確認可用。關於選取伺服器與開關的先後順序，請參閱首次連線檢查說明。

依失敗階段排查

出現網址錯誤或無法提出請求時，先檢查複製內容是否完整，以及目前網路能否完成網域解析並正常連線。若出現驗證或權限相關提示，請確認既有網址是否仍有效，不要連續修改通訊協定、連接埠等無關欄位。若回傳內容其實是網頁、登入提示或一般文字，即使用戶端能存取該網址，也不代表能將其解析為伺服器清單。此時應確認原始資料的匯出用途。

同一網址在不同網路下結果不一致時，先記錄兩次測試的網路條件，再判斷是否與 DNS、存取路徑或連線狀態有關。不要一邊切換網路，一邊修改網址參數，又同時更換目前伺服器；一次改動多個變數，成功或失敗的結果就難以解讀。也不必預設更新一定要透過 Proxy，實際可用路徑取決於目前網路與網址是否可連線。

訂閱能匯入，不代表其中每個項目都可用，也不表示它包含規則設定。伺服器清單與 Config 中的分流規則需要分別確認。進入下一章前，建議記下這筆訂閱的本機名稱、最近一次實際更新結果，以及目前選取的項目；之後手動新增、更新或排序時，就有明確的參照。

第三章 · 輸入方式

Scan QR Code 與剪貼簿匯入

QR Code 與剪貼簿是輸入管道，不是獨立的伺服器通訊協定。內容可能是單一伺服器分享連結、訂閱網址，甚至只是一段一般文字。匯入前應先確認既有資料預期新增哪種對象，匯入後再檢查結果。能辨識 QR Code，只表示圖像內容已讀取；能讀取剪貼簿，也不代表內容適用於目前的匯入入口。

掃描前確認畫面清晰與資料用途

使用 Scan QR Code 時，讓 QR Code 完整進入取景範圍，四周保留必要留白，並避免強烈反光或模糊。若 QR Code 顯示在另一台裝置上，可適度提高螢幕亮度並調整距離。不要只截取中央圖案，缺少邊緣定位區會影響辨識。多次壓縮過的圖片，放大只會讓模糊像素更明顯，建議改用既有資料中的清晰原圖。

首次使用相機掃描時，系統可能會要求相機權限。只在準備掃描時授予必要權限；若先前已拒絕，可到系統設定檢查 Shadowrocket 的權限，再返回重試。權限只決定 App 能否讀取相機，不會決定 QR Code 內容是否有效。授權後仍無結果，應分別排查畫面清晰度與編碼內容，而不是反覆切換所有系統權限。

辨識後，先查看 App 預備建立的項目類型與可見參數。如果原本要匯入 Subscribe，結果卻只有一般網址或單台伺服器，請暫停儲存並核對原始資料。不要只因畫面出現辨識結果，就直接取代現有訂閱。若 QR Code 原本用於登入網頁或管理用途，不會因為由 Shadowrocket 掃描，就自動變成可用的伺服器資料。

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

在既有資料中複製完整分享文字，再返回 Shadowrocket 使用相應的剪貼簿匯入提示或入口。系統可能詢問是否允許貼上，請依目前操作決定。若文字包含多行，先確認每行的界線與原始格式，避免一併帶入說明句、清單編號或引用符號。長字串中間多出一個不可見空格，也可能改變解碼結果。

部分資料在聊天視窗中會自動產生預覽卡片，點選卡片與複製原始文字取得的內容不一定相同。需要匯入時，應複製真正的分享連結，而不是卡片標題。遇到「無法辨識格式」一類提示，可先在本機確認開頭識別字是否完整，以及結尾是否遭到省略。不要將驗證文字上傳至線上轉換頁面測試，以免擴大敏感資料的暴露範圍。

若一次複製多個項目，匯入後應逐一檢查是否遺漏、重複，以及通訊協定類型是否符合預期。少數項目匯入成功，不代表整段文字都已解析。建議先用一筆完整資料確認輸入方式，再處理較長的清單。批次操作前先記錄目前可用的項目，匯入後依備註核對新增範圍，避免之後清理時無法分辨新舊對象。

辨識後仍須完成連線驗證

儲存後返回 Home，確認新增項目的備註、類型、位址與連接埠，再選取一台進行連線。若只顯示名稱而缺少重要參數，請回到原始資料確認分享內容是否完整。若欄位齊全但無法建立連線，應轉而排查驗證、TLS、傳輸與目前網路；繼續調整掃描距離不會改變已儲存的參數，也無法修復伺服器端的拒絕。

重複掃描同一個 QR Code 可能會建立重複項目，不會自動修復既有項目。再次掃描前，先確認是否已有對應記錄。同名項目也不一定完全相同，應比較通訊協定、位址、連接埠及所屬群組後再決定保留哪一筆。暫時無法確認時，請用不同備註標示測試對象，不要立即刪除原本可用的記錄。

匯入完成後，剪貼簿可能仍保留原始資料。可用一般文字覆寫剪貼簿，並檢查是否有設定會將剪貼簿內容同步至其他裝置。自行保存的 QR Code 圖片也應納入備份保護範圍。掃描只是減少手動輸入，不會降低原始憑證的重要性；後續更新與撤銷仍應依項目實際所屬的訂閱或伺服器處理。

第五章 · 資料更新

訂閱更新策略與失敗處理

更新訂閱是重新向遠端取得內容，並據此更新本機伺服器集合。這不等於更新 Shadowrocket App，也不等於重新連線至目前伺服器。App 本身透過 App Store 購買、安裝與更新，相關入口請見App 取得說明。管理伺服器時，應先釐清目前操作對象是訂閱、個別項目還是連線狀態，避免在錯誤層級反覆重試。

手動更新可建立可追蹤的檢查點

首次匯入後，先手動更新一次並觀察結果。更新前記下群組名稱、目前選取的項目與重要參數；更新後檢查提示、清單變化，以及原本選取的項目是否仍存在。遠端可能新增或刪除伺服器、變更名稱或調整驗證資訊，因此項目數量改變不一定代表異常。反之，即使提示成功但內容沒有變化，也可能只是遠端這次未調整，不能只看清單外觀就判斷請求沒有送出。

若先前曾在訂閱項目上進行本機編輯，應先保存修改紀錄。不要假設所有本機修改都會在更新後保留；重新整理可能重建項目，或覆蓋由遠端管理的欄位。需要長期保留的獨立測試參數，可另建註明用途的手動副本，並記錄它與原訂閱的關係。副本不會自動跟隨原訂閱變更，之後仍須人工核對。

更新時盡量避免同時修改規則、切換網路與刪除伺服器。先在穩定的網路下執行一次，等待明確結果後再決定下一步。若更新後目前選取的伺服器消失，請重新選擇清單中參數有效的項目並驗證連線。連線開關仍顯示開啟，不代表原本的選擇已由新伺服器無縫取代；應以實際請求結果判斷。

自動更新須配合裝置與網路條件

若 App 內提供自動更新或相關週期設定，可依需求啟用，並以目前介面提供的選項為準。更新頻率並非越高越好；頻繁請求可能增加無效流量，也會讓暫時性錯誤反覆出現。選擇策略時，應考量遠端內容通常多久變更、裝置何時連上網路，以及是否需要在使用前主動檢查。重要操作前手動確認一次，往往比假設背景已完成更新更可靠。

行動裝置的背景執行會受系統排程、網路狀態與電量條件影響。設定自動更新，不代表任何時候都會嚴格依排程執行。長時間未開啟 App、網路剛恢復或裝置處於受限狀態時，請先進入 App 確認實際清單。不要因為沒觀察到背景更新就認定訂閱失效，也不要依裝置上的時間推斷上次請求一定成功。

若遠端網址必須經由特定可達路徑存取，更新結果可能隨目前網路與連線狀態改變。排查時記錄更新當下是否已連線、選取哪台伺服器，以及使用 Wi-Fi 或行動網路。每次只改變一個條件再試一次，才能判斷失敗是否與路徑有關。不要為了讓更新成功，長期保留用途不明的路由變更。

依請求、驗證、解析三個階段處理錯誤

請求階段失敗時，優先檢查網路連線、DNS、網址拼寫與連線逾時。驗證階段失敗時，核對網址中的存取參數是否完整、是否已更換，以及既有權限狀態。解析階段失敗時，檢查回傳內容是否符合用途，是否變成登入頁面或錯誤說明。不同階段的處理方向各異；反覆點選更新不會自動補上遺失參數，也不會改變遠端回傳的資料格式。

某次更新失敗後，若原清單仍保留，不要為了「重新整理乾淨」就立刻刪除訂閱。原記錄可能仍有可用項目，刪除反而會增加還原難度。先保存錯誤提示與原有參數，確認網址後再重試。若更新成功但所有伺服器同時異常，應比較更新前後的共同欄位，例如驗證或傳輸設定，而不是逐一修改所有項目的備註。

訂閱狀態與實際請求狀態應分別記錄：更新時間反映清單刷新，Connectivity Test 反映特定測試條件，實際存取則反映目前請求結果。綜合三者才能判斷問題範圍。訂閱長期無法更新時，提供已遮蔽敏感參數的錯誤階段與網路條件，以便核對既有資料；這比提交完整訂閱網址更能保護資訊。

第七章 · 診斷數據

Connectivity Test、延遲測試與排序

延遲測試用來觀察特定測試請求在當下條件中的回應情形，不等於持續傳輸量、所有網站的可達性或未來穩定性。不同測試方法涵蓋的連線階段可能不同，應依實際測試方式解讀數值。先查看目前介面使用的測試類型，再比較相同網路、相同方法下的結果。不要把不同時間、不同網路測得的數字直接放在一起，據此選出所謂長期最佳伺服器。

先建立一致的測試條件

測試前確認裝置已正常連線，暫停明顯占用頻寬的工作，並記下網路類型是 Wi-Fi 或行動網路。若剛從一種網路切換至另一種，請等連線狀態穩定後再測。裝置與基地台之間的無線品質、目前網路負載及遠端服務狀態都可能影響結果，單次波動不足以判定伺服器參數有誤。

比較一組伺服器時，請使用相同的測試方法。有些方法主要反映建立連接埠連線所需時間，另一些可能還包含 TLS 或應用層回應，數值不可直接比較。若介面未提供足夠的測試方法細節，應將結果視為同一輪篩選的參考，而非精確的網路測量報告。測試目標不同，同一台伺服器顯示的結果也可能不同。

先選一台已知參數正確的伺服器作為參照，再檢查疑似異常的項目。若所有項目同時逾時，優先排查裝置網路、DNS 及公共測試目標是否可達；若只有單一項目異常，再核對其位址、連接埠、驗證與傳輸參數。依共同故障或個別故障分別處理，比一律重填所有密碼更有效，也能保留原本可用的狀態。

測試成功後仍須驗證實際連線

使用 Connectivity Test 後，再選取目標伺服器並提出實際請求。測試成功只表示該測試鏈路在目前條件下取得預期回應，不代表 Config 中每條規則都會選擇相同路徑。若測試正常但某個網域無法連線，應檢查該請求的規則比對、解析與目標服務狀態。不能只因清單顯示延遲較低，就排除 DNS 或規則造成的問題。

測試失敗時同樣要確認發生階段。無法解析位址、連線逾時、驗證遭拒與 TLS 錯誤，各有不同的處理方向。若有明確錯誤訊息，請記下原文並遮蔽敏感參數；若沒有明確提示，先在相同網路下重試，再改變一項條件驗證。頻繁連續測試會產生額外請求，通常不如有計畫地縮小問題範圍有效。

若常用請求無法存取，但其他請求正常，可先比較它們在目前設定中符合的策略。必要時短暫切換 Global Routing 以協助驗證，結束後再恢復原模式。切換後現象有所改變，只能表示值得檢查路徑選擇，不能直接證明所有規則都有誤。DNS 選擇與解析異常可搭配DNS 設定說明進一步核對。

排序只方便查找，不會取代選擇

依延遲排序可將本輪測試中回應較快的項目集中顯示，方便進一步試用。排序後應重新確認目前選取的伺服器，不要假設第一列已自動成為目前選擇。排序方式與自動選擇是不同功能，請以 App 內的實際狀態為準。清單位置也可能在下次更新或測試後改變，日常紀錄應使用容易辨識的名稱與歸屬。

將逾時項目排在後面有助於避免誤選，但不建議只憑一次逾時就立即刪除。暫時性網路故障、測試目標異常或遠端維護，都可能造成類似結果。先重新測試一次，確認故障是否持續，再決定是否清理。若整組伺服器來自訂閱，本機刪除個別項目後，日後更新可能再次加入；長期變動應從訂閱管理關係來理解。

測試後選擇一台適合目前請求且參數明確的伺服器，恢復日常使用的 Config，再以實際操作確認結果。若測試期間暫時修改過 DNS、路由模式或傳輸參數，應逐項還原或記錄最後保留的變更。少了這一步，測得的「可用」狀態可能只在暫時設定組合下成立，下次切換網路時就難以重現。

反覆發生故障時，保留少量可比較的紀錄即可，不必長期堆積包含驗證資訊的日誌與截圖。觀察相同條件下故障是否穩定重現，以及改變單一項目後是否穩定消失。這些紀錄有助於區分偶發波動與設定錯誤，也方便日後更新伺服器資料時重新驗證。