Shadowrocket 訂閱與伺服器管理

先確認輸入內容的用途

匯入前，請準備好自己已有的完整訂閱網址，並確認服務提供者標示該網址可用於 Shadowrocket。網址中的路徑、查詢參數與 Token 可能共同決定回傳哪一份清單；只複製網域通常不夠。不要根據頁面標題或連結長度判斷用途，也不要將帳戶說明頁、登入頁或續訂頁的網址填入訂閱欄位。網頁可以開啟，不代表其中含有可解析的訂閱內容。

伺服器項目會儲存連線所需的協定與參數，訂閱則負責從遠端取得這些項目；Config 用來控制規則、DNS 等行為。三種項目可以同時存在，卻不能互相取代。匯入訂閱後清單出現伺服器，只代表取得與解析已完成，尚未證明目前選取的伺服器可連線，也不代表現有規則會依預期處理流量。

從 Home 建立 Subscribe 項目

在 Home 開啟新增入口，進入 Add Server，並在 Type 中選擇 Subscribe；實際入口位置以應用程式內顯示為準。在 URL 欄位貼上完整網址，為訂閱填寫方便辨識的備註，再儲存。若應用程式詢問是否取得或更新訂閱，請依提示操作。操作期間請留意系統網路是否可用；不要等待時連續新增相同網址，以免留下多個外觀相似的訂閱群組。

儲存前，先檢查網址首尾是否混入空格、換行、引號或中文標點。聊天訊息中自動換行的長網址，複製後不一定會缺漏，但透過截圖辨識文字可能發生字元誤判。請特別核對問號後的內容、區分大小寫的 Token，以及百分比編碼。網址屬於存取憑證，請直接貼到應用程式，不要為了檢查格式而提交至不明網頁。

https://example.com/sub?token=xxxx

以上僅為格式範例，並非可用訂閱。實際網址請向自己的服務提供者取得。範例中問號後的 token 表示查詢參數，不代表所有訂閱都使用相同的參數名稱。有些網址會將識別資訊放在路徑中；檢查時請保持原樣，不要為了讓網址看起來整齊而刪除任何一段，也不要自行加上範例中的參數。

儲存後確認四項結果

首次取得完成後，依序檢查是否出現訂閱群組、是否有伺服器項目、項目的協定是否符合已有資訊，以及備註是否足以辨識該群組。若清單為空，先保留原網址並查看應用程式提示，再確認服務提供者是否變更了訂閱入口。不要立即修改每台伺服器，也不要先刪除舊清單；匯入失敗與伺服器連線失敗應分開處理。

如果清單正常顯示，卻包含不熟悉的名稱，請先對照現有訂閱說明，而不要將名稱視為連線品質或地理位置的保證。備註由訂閱內容決定，之後更新時可能有所變更。若需要追蹤特定項目，應一併記錄其所屬訂閱與協定類型，不要只記住清單中的顯示順序。

[Check]

訂閱匯入成功、伺服器測試成功與實際請求成功，是三個不同的檢查點。請依序確認，不要以其中一項取代其他項目。

遇到解析失敗時，先檢查完整網址與目前網路，再確認回傳內容是否仍為訂閱資料。遠端若回傳登入提示、錯誤頁面或空內容，即使請求本身有收到回應，也無法建立伺服器清單。詳細排查步驟請參閱訂閱清單為空或解析失敗的自我排查。保留錯誤訊息即可；向他人求助時，請勿附上完整 Token。

已有相同訂閱時，優先更新原有項目，不要重複匯入。若要測試新網址，可先用不同備註建立臨時群組，並保留原群組作為比較。確認新清單完整且能完成實際請求後，再決定是否移除舊項目。依此順序操作，可區分遠端內容變更與本機操作的影響，降低誤刪後無從判斷原因的情況。

Scan QR Code 不代表能辨識所有頁面

使用 Scan QR Code 前，先確認 QR Code 來自自己已有的伺服器資訊或訂閱說明。QR Code 可能包含單一分享連結，也可能只是網頁網址；掃描器讀取到內容，不代表應用程式一定能將其轉換成伺服器。掃描後若開啟一般頁面或顯示無法解析，請回到原始說明確認用途；不要只因 QR Code 旁標示伺服器名稱，就認定它是匯入碼。

從另一個螢幕掃描時，請讓 QR Code 完整出現在取景範圍內，避免反光、邊角遭裁切，或讓多個 QR Code 同時入鏡。內容較長的 QR Code 通常較密，縮得太小可能影響辨識。優先使用清晰的原始圖片，不要使用經過多次壓縮的聊天縮圖。辨識失敗首先可能是影像或內容問題，不能據此判斷伺服器已失效。

系統要求相機權限時，請依實際操作需要授權。若先前拒絕過，請在系統設定中檢查 Shadowrocket 的相機存取權限，再重新掃描。權限問題與伺服器驗證無關，不必因此修改訂閱網址。若應用程式另有圖片辨識入口，也請以目前介面為準，不要假定所有系統或裝置上的按鈕位置都相同。

從剪貼簿匯入時保留原始字串

複製分享連結時，應從協定前綴開始，一直到參數與備註結束。訊息中的說明文字、編號、項目符號與程式碼區塊都不屬於連結。若應用程式提供剪貼簿匯入入口，複製後請在應用程式內主動執行，並依系統提示允許所需存取。不要因系統未跳出提示就認為複製失敗，也不要連續複製其他內容，覆蓋剛準備好的連結。

一次複製多條連結是否能批次匯入，取決於該入口如何辨識內容。為方便核對，初次操作建議先匯入一條，確認解析結果後再處理其餘內容。多行文字中若夾有說明段落、空白行或網頁標記，部分行可能會被忽略。匯入後應逐項檢查實際項目，不要只憑「已匯入」提示就認為所有資訊都已儲存。

若系統詢問是否允許貼上，拒絕後請重新透過應用程式提供的入口操作，並留意權限提示。複製功能與訂閱網路請求是兩條獨立流程：剪貼簿沒有讀到內容，屬於輸入階段；已建立訂閱但取得失敗，則屬於請求階段。先判斷失敗發生在哪個步驟，才能避免反覆修改原本正確的網址或伺服器參數。

匯入後比對欄位，不要只看名稱

匯入單一分享連結後，請核對 Type、位址、連接埠，以及必要的 TLS 與傳輸欄位。備註正確只能代表名稱部分已讀取，不能證明其他參數完整。有些格式會將備註轉為百分比編碼；名稱出現編碼字元或顯示不同，不一定會影響連線，但應檢查是否誤將連結參數寫進備註，或將備註留在位址欄位中。

匯入訂閱 QR Code 後，還要確認建立的是可更新的訂閱項目，而不是只留下當次清單中的一台伺服器。判斷依據是應用程式儲存的項目類型與更新入口，不是 QR Code 圖片標題。若之後需要持續更新，保留正確的訂閱項目會比複製其中一台伺服器更合適；匯入單一項目通常不會自動保留訂閱的更新關係。

[Privacy]

QR Code、分享連結與剪貼簿內容可能包含完整憑證。請勿將其上傳至公開辨識網站；透過截圖求助前，先移除 QR Code、密碼與查詢 Token。

重複掃描容易產生多個相似項目。清理前先比較所屬群組、協定與位址，再確認目前選取的是哪一項。名稱相同但參數不同，不應直接當成重複項目刪除；名稱不同但位址相同，也可能使用不同的驗證或傳輸設定。無法確認時先保留兩份，用清楚的臨時備註加以區分，再依測試章節逐一比較。

完成匯入後，可以將剪貼簿內容替換成一般文字，減少之後誤貼憑證的機會；但這不代表已撤回分享出去的資訊。若完整連結曾出現在公開場合，請透過自己現有服務的管理入口處理憑證變更，再更新應用程式內儲存的內容。輸入方式方便，不代表可以忽略憑證管理；原始分享資訊仍應視為敏感資料保存。

更新前保留可供比較的狀態

更新訂閱可能新增、刪除或重新命名伺服器，也可能替換位址、連接埠或驗證資訊。操作前先確認目前處理的群組，並記下目前選取的項目及其所屬訂閱。如果正在排查連線問題，建議先記錄錯誤情況再更新；否則清單變更後，舊問題與新參數會混在一起，難以判斷是哪個步驟改變了結果。

不要預設更新後一定會保留本機手動修改。訂閱管理的項目來自遠端內容，本機備註、排序或欄位是否保留，應以實際更新結果為準。需要長期維護的獨立參數，應另建手動項目並註明用途。更新前也不必先清空舊群組；保留舊狀態，有助於在取得失敗時判斷應用程式是否仍保留先前資料。

手動更新與自動更新各自的用途

服務提供者明確通知參數變更、清單明顯過時，或初次匯入後需要重新確認時，適合手動更新。在對應訂閱上執行更新，等待操作完成，再檢查提示與群組內容。短時間內連續點選通常無法解決遠端回傳錯誤，反而會讓結果難以對應。操作失敗後先確認錯誤屬於網路、驗證還是解析，再決定下一步。

如果目前應用程式提供自動更新相關設定，可依自己的使用頻率啟用並確認選項。系統背景排程會受網路、裝置狀態與系統限制影響；設定更新週期，不代表每次都會在準確時間完成請求。需要確認重要變更時，仍應回到應用程式檢查實際清單，必要時手動更新，不要只依賴背景工作的預期執行時間。

訂閱更新使用哪一條網路路徑，可能受目前連線狀態、路由模式與應用程式設定影響。若開啟連線時更新失敗，關閉後卻能完成，表示值得檢查路徑差異，但不能立刻斷定某台伺服器已失效。請先在相同基礎網路下比較，並一次只變更一個條件，避免同時切換網路、替換網址並重新匯入整份訂閱。

依失敗階段處理，不以重建取代診斷

請求階段失敗，常見情況包括無法建立連線、逾時或名稱解析問題；此時先確認裝置能否正常使用目前網路。驗證或存取階段失敗，應核對網址中的憑證是否完整，以及遠端是否已撤銷舊網址。解析階段失敗，則應檢查回傳內容是否仍符合訂閱格式。不同階段需要檢查的項目不同，不宜一概歸咎於「伺服器不能用」。

若遠端已更換訂閱網址，請在原訂閱的對應欄位中修改，並核對更新結果。只重新命名群組不會改變請求網址；只修改某台伺服器也無法修復整個訂閱入口。變更網址前後可暫時保留兩組以供比較，但應清楚標示哪組是舊紀錄，避免之後仍操作舊群組，誤以為新網址尚未生效。

[Update boundary]

更新提示成功，不代表清單一定會增加，也不代表每台伺服器都能連線。若遠端內容沒有變更，更新後的清單可能維持原樣。

更新後先確認群組是否存在，再檢查項目內容是否變更，最後確認目前選取項目。某台伺服器從遠端清單移除後，可能需要重新確認本機原先的選擇；不要只看連線開關仍開啟，就認為流量仍經過更新前的同一筆紀錄。如果規則指向某個命名項目，也應確認相關引用仍對應到預期項目。

清單數量變化也不能直接用來判斷服務品質。遠端可能只是拆分、合併或重新命名項目，應依實際參數與說明核對。多次更新仍無法取得預期內容時，請整理錯誤訊息、操作順序與已完成的檢查，再向自己現有服務的管理者確認回傳內容。提供問題描述即可，不要在公開交流中提交完整訂閱網址。

Shadowrocket 本身的更新應透過 App Store 查看與安裝，不能靠更新訂閱完成。應用程式是否需要更新、相容性與系統需求，請以 App Store 頁面標示為準。正版取得入口與核對 App ID 的方式，請參閱正版核驗說明；若遇到清單為空，則應回到訂閱請求與解析流程排查。

先確認測量對象與測試方式

使用 Connectivity Test 或清單中的測試功能前，先確認應用程式目前採用的測試方式與目標。不同方式測量的內容可能是建立伺服器連接埠連線的過程，也可能包含透過代理存取測試目標的過程，兩者代表的意義不同。只有方法、目標、基礎網路與時間條件相近時，數值才適合互相比較；不要將不同模式下的結果直接排出優劣。

測試數值反映一次或一組測量結果，不代表往後每次請求都會相同。目前網路負載、無線訊號、服務端狀態、名稱解析與目標回應都可能影響結果。一次數值偏高，不必立即刪除項目；一次偏低，也不代表它適合所有用途。請先保持網路不變，進行少量重複測試，觀察結果是否一致，再決定是否切換。

逾時或失敗也要依測試方式解讀。如果測試目標無法連線，可能會出現多台伺服器同時失敗；如果某個協定欄位錯誤，則可能只有對應項目異常。測試失敗不一定代表伺服器位址完全無法存取；測試成功也不能證明特定服務請求一定成功。請先將測試功能視為排查線索，再透過實際請求確認。

建立可重現的核對順序

第一步確認基礎網路正常，排除尚未完成網路登入或訊號不穩等狀況。第二步核對選取的項目與協定參數，避免測到名稱相近的舊紀錄。第三步固定測試方式，執行測試並等待結果。第四步核對 Global Routing 與目前 Config，最後再存取需要確認的目標。每一步都應能清楚說明檢查了什麼。

如果所有項目同時失敗，優先檢查基礎網路、共用測試目標與一般設定；如果只有某個訂閱中的項目失敗，再檢查該訂閱是否剛更新、驗證資訊是否變更；如果只有一台失敗，則回頭檢查其位址、連接埠、TLS 與傳輸參數。逐步縮小範圍，比先重新安裝應用程式或清空所有訂閱更容易保留線索，也不必重新建立已正確的設定。

為比較實際請求而暫時變更模式時，請先記下原本狀態，驗證後再恢復。不要為了得到一次成功結果，就長期保留不理解的模式。尤其在 Config 模式下，目標請求可能符合 DIRECT 或其他策略；此時即使伺服器清單顯示延遲很低，也不能證明該請求正在使用相應伺服器。

排序只改變顯示順序，仍須確認選取項目

依延遲排序有助於找出本次測試中回應較快的項目，但排序不等於自動選取，也不代表持續健康檢查。排序後請確認目前選取標記，不要把清單第一項當成正在使用的項目。如果本次只有部分項目完成測試，也不要將未測、逾時與已測結果混為一談；請先確認結果涵蓋的項目範圍。

批次測試期間，盡量不要同時更新訂閱或移動項目。清單變動後，測試對象、名稱與位置可能無法直接對應。請先完成測試並記下需要比較的項目，再進行更新或整理。重新測試時，採用相同網路與方法，才能判斷變化是否來自新參數，而不是裝置剛好從一種網路切換到另一種網路。

[Evidence]

記錄測試方式、基礎網路、選取項目與實際錯誤，比只記下一個延遲數字更有助於排查。分享紀錄時，請移除所有憑證。

實際使用時，還要區分延遲與速度：回應時間較短不代表大型檔案傳輸更快，也不能證明長時間連線一定穩定。本頁不設定統一的合格數值，因為測試目標、網路與使用需求各不相同。若結果持續波動，先在固定條件下重現，避免高頻批次測試產生額外請求；再依失敗階段回到參數、訂閱或規則章節逐項核對。