透過 Subscribe 匯入現有訂閱
先確認資料指向清單還是單筆項目
訂閱網址用來取得一組伺服器資料,之後可以更新;單筆分享連結則直接描述一筆連線,通常不會隨訂閱更新。這兩種資料有時看起來都是一長串文字,不能只憑長度判斷。先查看你保存的說明:若資料標示可定期取得清單,請使用 Subscribe;若內容已逐項列出伺服器位址、連接埠和協定,請依Add Server 手動填寫欄位操作。網頁介紹、登入頁面和設定檔網址也可能是一般網頁連結;看到 https:// 不代表它就是訂閱。
範例中的 https://example.com/sub?token=xxxx 僅用來說明網址格式,不會提供可用清單。實際網址的路徑、查詢參數和大小寫都可能影響識別,請完整保留,不要自行刪除問號後的內容。複製時優先從原始文字取得完整網址,避免連同前後引號、清單編號或換行一起選取。網址若含存取憑證,請視同密碼處理;在裝置間傳送資料時,不要將完整網址貼到公開筆記、支援單標題或線上解析頁面。
新增後先確認分組,再確認目前選取項目
從 Home 開啟 Add Server,在類型選單中找到 Subscribe,貼上現有訂閱網址並儲存。若介面提供備註欄,請填寫方便辨識用途的簡短名稱,不要使用網址或帳號作為名稱。回到清單確認是否出現對應項目,並展開檢查其中的伺服器資料。請以看得到子項目作為成功判斷依據:只看到分組名稱,代表入口可能已儲存,但還不能確認清單已成功取得並解析。
若有多組資料,請先匯入一組,確認名稱、預期協定及幾筆代表性資料後,再新增下一組。這樣若出現意料之外的項目,就能查明它來自哪次操作。匯入完成後,確認目前選取的伺服器確實屬於剛才核對的分組。清單可以展開,不代表已選取伺服器,也不代表目前連線已自動切換到新項目。若要確認首次連線,請依教學中的 Global Routing 設定檢查路由方式,不要把儲存訂閱和開始連線當成同一個步驟。
分別處理取得失敗與格式錯誤
更新出錯時,先記下錯誤發生的步驟。若是網路請求失敗,確認裝置本身已連上網路,再檢查網址開頭、主機名稱和原始路徑;若是權限相關錯誤,確認你持有的網址仍有效。若請求已完成卻沒有產生資料,請確認回傳內容是否為支援的伺服器清單:有些網址回傳的是登入頁面、錯誤說明或供人閱讀的文字,即使客戶端收到內容,也不一定能匯入。不要為了確認回傳內容,把含有憑證的網址交給線上檢測工具。
若只出現部分項目,先保留這次結果,並對照原始資料檢查缺少項目的協定與必填欄位,不要靠反覆匯入補齊。某筆資料欄位不完整,不代表整組資料都已失效;同樣地,清單中有一筆測試成功,也不能取代對其他項目的檢查。若更新後舊資料仍留在清單中,先確認它是獨立手動新增的項目,還是舊分組的成員,再決定是否刪除。發生錯誤時保留原分組,有助於比較更新前後的差異。
Add Server 手動填寫欄位與選擇協定
先選擇協定,再依原始資料填寫
手動新增適用於只有一筆伺服器資料、需要逐項確認參數,或需要保留獨立測試項目的情況。從 Home 開啟 Add Server,先選擇資料標示的協定,再填入位址、連接埠和該協定的必填欄位。表單會依協定變動;若介面沒有資料中對應的欄位,請回到協定選擇處確認,不要把不同欄位的內容混填。不能只憑連接埠猜測協定:兩筆資料可能使用相同連接埠,卻需要完全不同的連線參數。
若表單將主機和連接埠分開填寫,主機欄只填指定的主機名稱或位址,連接埠欄填入對應數字;不要把網址前綴、路徑或連接埠一併填進主機欄。若資料分別提供位址和網域名稱,即使兩者看起來相同,也要依各自用途填入。主機欄決定連線目的地;TLS 伺服器名稱、傳輸相關主機名稱等欄位則可能用於不同環節。不要把這些欄位一律改成伺服器位址,也不要透過關閉憑證檢查來判斷欄位是否正確。
| 協定 | 優先確認 | 常見欄位誤填 |
|---|---|---|
| Shadowsocks | 伺服器位址、連接埠、加密方式與密碼 | 加密方式和密碼是不同欄位 |
| VMess / VLESS | 位址、連接埠、UUID,以及原始資料指定的傳輸與安全參數 | 將傳輸路徑填入位址,或混用兩種協定的參數 |
| Trojan | 位址、連接埠、密碼及對應的 TLS 參數 | 將 TLS 伺服器名稱與連線位址視為同一欄 |
| HTTP / SOCKS5 | 位址、連接埠,以及資料明確要求的驗證資訊 | 誤將位址前綴填成主機名稱的一部分 |
| WireGuard | PrivateKey、對端 PublicKey、Endpoint、AllowedIPs | 將隧道內位址與對端連線位址互換 |
| Hysteria2 | 位址、連接埠、驗證資訊及 TLS 相關設定 | 照搬其他協定的密碼或傳輸參數 |
分別檢查驗證、傳輸與路由參數
以 Shadowsocks 為例,加密方式和密碼應來自同一筆原始資料;更換位址時,也要確認這些參數是否隨資料一同變更。VMess、VLESS 或 Trojan 的資料除了識別欄位,也可能指定連線所用的傳輸方式。若有路徑要求,請保留開頭斜線及原有大小寫;未提供的選填欄位,不要自行猜測補上。從豐富文字筆記複製時,留意全形標點和尾端空白,尤其不要混合不同環境的參數。
在 WireGuard 中,Endpoint 是對端的連線位址與連接埠,AllowedIPs 則指定哪些目標位址範圍交由該對端處理。後者不是用來填寫伺服器主機名稱的欄位,也不應為了測試而任意擴大網段。PrivateKey 應留在預定使用它的裝置或受保護的備份中,不可當作對端公鑰傳送。密鑰、位址與 MTU 的對應關係,請參閱 WireGuard 參數說明。
保留獨立項目,每次只修改一個欄位
測試新參數時,先為它設定獨立備註,並保留已知可用的原始項目。儲存後重新開啟該項目,確認協定仍與原始資料相符,必填欄位沒有填錯位置,再回到清單選取該項目進行測試。一次只調整一個疑似錯誤的參數,並記錄修改前後的結果。若同時更換位址、傳輸方式和憑證相關設定,即使問題消失,也無法判斷應保留哪項變更。
留意錯誤發生的階段:若無法解析主機名稱,優先檢查主機文字和裝置的解析狀況;若無法建立連線,檢查連接埠、目前網路及傳輸參數;若連線已建立但無法存取目標,再確認路由與目標網域的解析。不要使用含憑證的完整設定製作排錯截圖。若手動新增的項目只是用來對照訂閱中的某筆資料,請在名稱中註明用途,測試結束後依備份章節處理,避免長期與訂閱項目混在一起。
透過 Scan QR Code 與剪貼簿匯入
QR Code 只是載體,能否匯入取決於內容
QR Code 可能包含單筆伺服器分享連結、訂閱網址,也可能只是一般文字。掃描只負責讀取內容,不保證讀出的資料可以新增為伺服器。先確認自己的記錄中,QR Code 對應哪一類資料,再從 Home 開啟 Scan QR Code。若要掃描另一部可信任裝置上的畫面,請讓完整邊框進入取景範圍並避免反光;若 QR Code 圖片存於本機,只有在目前介面提供圖片選取功能時才使用,否則請以手邊的原始文字匯入。
若未開啟相機權限,掃描入口可能仍會顯示,但不一定能讀取畫面。請先確認系統允許目前的應用程式使用相機,再返回客戶端重試。若取景正常卻無法辨識圖案,先調整焦距和螢幕亮度,確認 QR Code 邊緣沒有被裁掉。若應用程式已讀取內容,並提示格式不受支援,問題就不在焦距或權限;請回到原始資料,確認它是訂閱網址、分享連結或其他文字,再使用相應入口處理。
剪貼簿只保留這次要匯入的文字
從自己的原始記錄複製一筆完整內容,再切回客戶端。若目前介面提示從剪貼簿匯入,先確認剪貼簿內容就是剛複製的文字,再依提示操作;若沒有提示,請依資料類型處理:訂閱網址貼入 Subscribe,逐欄提供的資料則進入 Add Server。不要以為複製後就已完成新增。剪貼簿內容可能被其他應用程式覆寫,也可能仍留著上次複製的網址,尤其是在連續處理多筆資料、跨裝置複製或剛切換帳號時。
若來源是聊天訊息或豐富文字筆記,請留意訊息中的換行究竟只是畫面折行,還是複製後的實際換行。請從原始記錄重新複製完整的一筆,不要連同標題、附件預覽文字或其他連結一起選取。若內容含編碼字元,別刪除看似多餘的百分號或等號,也不要讓輸入法自動替換半形標點。處理多筆資料時請逐筆操作,確認清單中的所屬分組和資料類型無誤後,再複製下一筆。
比較匯入前後的清單,不要只看提示訊息
完成匯入後,回到清單確認新增項目。若預期匯入的是訂閱,請確認訂閱入口已出現,並在成功取得資料後看到該組項目;若預期匯入的是單筆伺服器,請核對協定、可見備註和主機是否符合原始資料,不要只憑相同名稱判斷。若匯入後看不到可辨識的新項目,先確認現有清單是否已包含相同資料,再檢查錯誤發生於讀取、解析或儲存哪個步驟。若不確定是否已儲存,連續掃描可能只會產生更多重複項目。
排查時,可以分別透過 QR Code 和文字匯入同一筆已知資料進行比較。若文字匯入正確但圖片無法讀取,優先檢查圖片清晰度和掃描權限;若兩種方式讀出的文字相同,卻都無法新增,應先檢查格式及協定是否受支援,而不是更換掃描工具。若同一筆資料透過兩種方式匯入後內容不同,請回到可確認的原始記錄比對,不要只根據備註或 QR Code 旁的說明判斷實際內容。
訂閱更新策略與變更確認
將更新訂閱與更新客戶端分開處理
更新訂閱是透過現有網址重新取得清單,可能新增、移除或調整該組資料;更新 Shadowrocket 則是更新應用程式本身,兩者不能互相取代。如果只有某組訂閱內容過期,請先更新該組,不要因為清單沒有變化就重新安裝應用程式。反之,若要確認應用程式是否有更新,也不應靠反覆更新訂閱來判斷。客戶端取得方式與常見問題請參閱下載頁,不需要在伺服器編輯表單中調整任何應用程式更新設定。
手動更新前,記下目前選取項目及其所屬分組、上次正常使用時的網路,以及幾筆可辨識的相關資料備註。不必記錄密碼,也不要把訂閱網址貼進筆記。接著只操作目標訂閱,等請求完成後再檢查分組;不要同時切換網路、修改網址和更新多個分組。更新前的記錄有助於確認兩件事:這次取得的清單與原清單有何差異,以及連線異常是否正好發生在目前使用的項目變更之後。
依維護情況安排更新頻率
初次匯入、剛更換網址或正在排查不穩定問題時,適合手動更新。一次只處理一組,確認請求的目標及完成後的狀態。若目前介面提供自動更新選項,建議先手動更新一次,確認這組資料能正常取得,再依清單變動頻率安排更新。剛完成驗證的新裝置,不必在無法查看結果時同時啟用所有分組的自動更新;若發生衝突,將難以判斷是哪一組先變更。
更新頻率不等於連線品質。清單通常穩定時,維護重點是留意有用的變化,而不是縮短兩次請求之間的間隔。若設定依賴特定項目,更新後先確認該項目仍存在,且分組名稱與選取關係沒有改變。若目前網路在背景切換,或裝置限制背景活動,自動更新未必會在預期時間完成;需要使用最新資料時,請以手動查看的清單結果為準,不要把設定中的排程間隔當成最後一次成功更新的時間。
區分內容未變、請求失敗與選取項目失效
更新後收到原本的內容可能是正常情況,不必期待每次都有新增項目。若介面顯示錯誤,但清單仍顯示舊內容,保留的舊資料不能證明這次更新成功。遇到權限錯誤,請重新確認原網址的狀態;遇到網路請求失敗,檢查目前的網路連線和網域解析;若結果為空或格式有誤,則重新確認網址類型。不要透過清空舊分組來確認更新,否則會同時失去可用的回復選項和比較樣本。
若原先選取的項目已被移除,先確認目標訂閱是否提供明確的替代項目,再檢查客戶端目前的選取項目及設定中的引用。名稱相似不能證明是同一條連線,重新選取前可比較協定、主機和用途。若伺服器清單可正常更新、原項目也仍存在,但網頁無法開啟,請繼續檢查路由和目標解析,不要反覆更新訂閱。相關差異請參閱 DNS 解析失敗排查。
整理多組訂閱與規則引用
依維護用途命名,不依臨時排序命名
整理多組訂閱時,首先要釐清各項目的歸屬,而不是替整份清單排名。為每組訂閱保留穩定且簡短的備註,足以說明是日常使用、測試對照或待確認的移轉分組即可。備註不要包含完整網址、帳號或暫時的測速結果。若同一筆資料出現在不同分組,先視為不同歸屬的項目:兩邊可能分別更新,名稱相同也不代表連線參數相同。手動新增的項目應加上容易辨識的備註,避免更新後誤認為是訂閱新增的資料。
整理時先區分幾種名稱:訂閱備註方便在清單中找到入口,伺服器備註用來標記單筆資料,設定檔中的策略名稱則供規則引用。這些名稱看起來可能相同,但不能互相取代。在清單修改備註前,先查看目前的 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 下會如何比對。
移轉時保留舊分組,最後再清理重複項目
若要將日常使用的項目換到另一組訂閱,先讓新舊分組並存,再從新分組中找出用途相符的項目。確認設定中的預設路徑、指定策略及目前選取的伺服器,逐一驗證後再切換。若需要保留某項目的原始參數作為故障對照,請另存為獨立項目並標示用途,不要修改訂閱產生的資料後,期待更新時永遠保留變更。後續檢查時,要確認更新會重新提供哪些資料,而不只是查看清單目前顯示的內容。
整理完成後,透過兩種路徑驗證:先檢查平時使用的目標,再檢查一個應採用不同策略的目標。這樣能找出「伺服器可用,但流量走錯分組」的問題。若切換後立刻發生異常,先還原原先的選取項目或設定副本,再重新進行最後一項變更。定期清理也請依此順序:先確認引用和選取項目,再刪除獨立測試項目,最後移除不再需要的訂閱分組。只調整清單中的拖曳順序,不能取代這些檢查。
Connectivity Test、延遲與排序
先確認測試範圍,再比較結果
Connectivity Test 用來確認項目在目前網路和測試條件下是否可連線。結果會受到裝置網路、測試目標、連線方式和當時負載影響。這不是下載速度,也不能代表所有網站都會得到相同結果。比較一組資料時,盡量使用同一部裝置、同一個網路和同一種測試方式;測試期間不要從 Wi-Fi 切換到行動網路,也不要一邊讓多個項目承載大量傳輸,一邊將延遲數值視為固定排名。
從伺服器清單執行 Connectivity Test。先選取一組或少量用途相同的項目作為樣本,等結果完整後再擴大測試範圍。首次請求可能遇到解析、交握或連線暫時波動,必要時可間隔一段時間重新測試。兩筆資料數值相近時,觀察是否能重複得到可用結果,優先排除狀態不穩定的項目,不必因單次讀數些微差異就立刻更改預設選取項目。若只能取得單次結果,請視為當下觀察,不要據此下長期結論。
區分逾時、波動與實際服務無法使用
若只有單筆資料逾時,可先從該筆資料的主機、連接埠和協定著手,並與同組可用項目比較;若整組或多組都逾時,先檢查裝置網路及測試目標是否可連線,不要同時修改所有伺服器。若切換網路後能重現明顯差異,請分別記錄兩種網路下的結果,不要混在同一份排序中。重新測試前不要先刪除失敗項目,以免失去後續比較的樣本。
若有延遲結果但網頁無法開啟,先確認實際請求是否使用受測伺服器。查看目前選取項目和 Global Routing,再檢查規則與解析結果。測試使用的目標可能與實際服務不同,因此讀數正常不代表服務網域一定能解析;服務無法使用也不一定表示伺服器已離線。此時可參考教學中的 Data 與診斷步驟,只在自己能控制的測試範圍內比較變更前後的連線狀況。
用排序篩選項目,不要把它當成切換開關
若目前清單提供延遲排序,請等同一輪測試完成後再使用,方便比對結果相近的項目。逾時和未測試是不同狀態:前者代表已進行測試但未完成,後者則是本輪沒有結果。優先檢查已測試、可重複測試且符合實際用途的候選項目。整體排序只會改變清單的顯示順序,不能取代選取項目;若設定中有自己的策略組,也要另行確認它實際引用哪筆資料。
維護記錄只需保留測試網路、項目備註、測試方式及成功或失敗結果。備註應與所屬分組一併記錄,避免混淆同名項目。先實際測試候選項目,再考慮更改預設路徑;切換前記下原本的選取項目,以便需要時還原。若問題只出現在某個目標網域,請繼續檢查該目標的規則和解析,不必因此將整組資料重新排序。測試結果只供這次選擇參考,不必把單次結果固定為日後所有連線的優先順序。
刪除伺服器、備份與還原確認
先確認要刪除的是資料、訂閱還是設定檔
整理前先確認操作對象。刪除一筆手動新增的資料,只會移除本機這筆伺服器資料;移除訂閱入口,則可能同時移除該訂閱產生的清單項目;刪除 Config 中的檔案,影響的是規則與策略設定。請分別確認這三類項目,尤其不要把切換目前選取項目誤認為刪除。對於訂閱分組中的資料,若客戶端允許只從本機移除,而原訂閱仍會提供該筆資料,下次更新時它可能再次出現。這不代表刪除沒有生效,而是清單依訂閱內容重新產生。
清理前先找出目前使用的伺服器和所屬分組,並確認使用中的設定是否還有其他依賴。準備刪除目前使用的項目時,先切換到已驗證的替代項目,測試一個常用目標,並確認原項目已有可用備份。接著從清單中該項目的管理入口開啟刪除操作,確認提示中的刪除範圍。若只是想停止使用某組資料,不必立即刪除;保留一段觀察時間,更容易發現先前遺漏的規則引用或備用用途。
分開保存還原所需的資料
備份至少要區分三部分:可用來重新更新清單的訂閱資料、無法透過更新取回的獨立伺服器資料,以及目前實際使用的設定檔。設定檔可能包含規則和策略定義,但不能只因為能匯出一個檔案,就假設其中包含所有伺服器、訂閱入口和憑證。反過來說,使用分享連結保存一筆伺服器資料,也不代表已保存 Global Routing 的選取項目或設定檔。請以實際匯出的範圍為準,並在自己的記錄中註明哪些內容可以還原。
需要保護的備份,請存放在由自己控制且存取受限的位置。清單中記下備份對應的裝置、包含哪些分組及哪份設定檔,不要在檔名中寫入密碼、訂閱查詢值或密鑰。匯出後確認檔案可讀,且沒有誤留在公開同步資料夾中。完整備份也應註明哪些項目需要手動重建,例如未包含的局部設定或預設選取項目;更換裝置時,才不會把尚未設定的選項誤認為還原失敗。
分批還原,並確認下次更新仍可正常使用
還原時先匯入一組容易辨識的訂閱,或一筆已知的獨立資料,確認它出現在預期位置。接著還原設定檔,檢查其中引用的伺服器或策略名稱能否對應到目前清單,再恢復路由選擇。建議分兩步驗證:先確認基本連線,再以原本的 Config 模式確認目標流量是否依預期處理。只確認介面顯示「已新增」,不能證明設定、伺服器和實際規則都已正確連結。
最後手動更新一組已移轉的訂閱,確認備份不只找回舊項目,也保留後續維護所需的入口。若更新失敗但仍看得到舊清單,請保留現況,依訂閱章節檢查憑證與回傳格式。若只是在更換裝置後發現裝置上沒有安裝應用程式,請先重新取得應用程式,再還原資料。使用 iPhone 或 iPad 可參閱從已購項目重新下載的說明;找回應用程式和找回伺服器資料是兩件事,不能以其中一個步驟取代另一個。