在 Shadowrocket(小火箭)新增伺服器前,先確認手邊資料的形式:需要定期更新的連結選 Subscribe;逐項參數選 Add Server;QR Code 選掃描;完整且受支援的分享文字可嘗試從剪貼簿匯入。本文依資料類型說明入口、欄位核對方式,以及匯入後清單空白時應先檢查的項目。
先分清伺服器項目、Subscribe 與 Config
「新增伺服器」通常是指將現有伺服器資料加入 Shadowrocket 的 Home 清單。伺服器項目記錄連線所需的協定與參數;Subscribe 會依使用者已有的訂閱網址取得一組項目;Config 則用來檢視及管理設定檔。三者並非同一種檔案:將單一伺服器分享連結填入 Subscribe,或把訂閱網址當成伺服器的 Address,通常都無法達到預期效果。
操作前,先確認資料來自自己正在使用的服務,並查看對方提供的是訂閱 URL、完整參數、QR Code,還是可複製的分享文字。只有協定名稱,卻沒有 Address、Port 及相應憑證,無法完成手動新增。Shadowrocket 負責讀取並使用輸入的資料;項目能否連線,仍取決於資料是否有效及當下的網路環境。
Subscribe
建議已有會更新的訂閱 URL 時,先透過對應入口匯入,再確認取得的項目。
適用情況:已有完整訂閱網址,且之後需要取得資料更新
Add Server
逐項新增一台伺服器;欄位內容須符合現有資料中的協定與參數。
適用情況:只有單台伺服器的逐項參數
掃描 QR Code
讓 App 讀取 QR Code 中的內容,再確認辨識結果是否為目標項目。
適用情況:已有可掃描的伺服器分享碼
從剪貼簿匯入
讀取已複製的分享文字;前提是目前的入口支援該文字格式。
適用情況:已有完整分享文字,且方便複製
方法一:使用 Subscribe 匯入現有訂閱
如果手邊有一個以 https:// 開頭、用來取得伺服器清單的網址,請優先使用 Subscribe。網址中的路徑、查詢參數及 token 都是原始資料的一部分;複製時不要自行刪減,也不要把範例網址當成可用服務。以下僅示意訂閱 URL 的格式,並非實際訂閱:
https://example.com/sub?token=xxxx
確認原始資料
從現有資料複製完整訂閱 URL,確認開頭、結尾及查詢參數都有一併複製;貼上前留意是否多了空格或換行。
開啟入口
在 Home 使用新增入口,並在 Type 中選擇 Subscribe;在 Config 檢視設定檔時,請勿將設定檔誤認為訂閱伺服器清單。按鈕的實際位置以目前 App 介面為準。
貼上並儲存
將 URL 填入訂閱網址欄位,依畫面提示儲存。名稱可用來辨識這份訂閱,但不能取代實際 URL。
檢查清單
返回 Home 查看訂閱及其伺服器項目;需要取得更新時,使用訂閱項目目前介面提供的更新功能。請分別確認是否儲存成功,以及是否取得項目。
訂閱項目已出現,但伺服器清單仍是空白,未必是選錯新增入口。先確認網址是否完整,再檢查該網址在目前網路下能否取得內容,以及回傳內容是否為 App 可辨識的訂閱格式。若訂閱內容之後有變更,請使用更新功能取得新內容;單純重新選取現有項目並不能取代更新。
方法二:使用 Add Server 逐項手動新增
若現有資料列出單台伺服器的協定、Address、Port 與憑證,卻沒有訂閱 URL,請從 Home 的新增入口選擇相應的 Type,再依欄位填寫 Add Server。先確認協定再填寫:Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 所需欄位各不相同。不要把某個協定的密碼或識別碼填入另一個協定的欄位;只看伺服器名稱也無法判斷 Type。
Address 應填入資料提供的網域名稱或 IP;Port 應填入資料提供的數字,不要依協定猜測。以下的 443 只是端口寫法範例,只有原始資料明確列出 443 時才能使用。TLS、傳輸方式、SNI 等選項也應以原始資料為準;設定不一致時,即使 Address 和 Port 看起來正確,也可能無法連線。
核對單筆 Trojan 資料
- Type
- Trojan
- Address
- 照填現有資料中的網域名稱或 IP
- Port
- 照填現有資料中的連接埠,例如資料明確列出的 443
- Password
- 使用該筆資料對應的完整憑證
- SNI
- 只有在資料要求時才填寫相應的主機名稱
欄位名稱相近,不代表內容可以互換;儲存前請逐項對照原始資料。
核對單筆 Shadowsocks 資料
- Type
- Shadowsocks
- Address
- 照填現有資料中的網域名稱或 IP
- Port
- 填入資料提供的連接埠數字
- Method
- 選擇資料指定的加密方式
- Password
- 填入該伺服器對應的密碼
Method 和 Password 都必須對應同一筆伺服器資料,不能從其他項目拼湊。
手動新增完成後,返回 Home 檢查項目名稱、Type 和伺服器位址是否符合預期,再選取該項目進行連線測試。若資料使用 VMess 或 VLESS,UUID 應依原文填寫;若還提供傳輸層或 TLS 參數,也須逐項對照相應選項。WireGuard 使用自己的金鑰與網路參數,不能套用上方的密碼欄位範例。
方法三與方法四:掃描 QR Code 或從剪貼簿讀取
QR Code 和剪貼簿是交付資料的方式,並非兩種新的連線協定。QR Code 可能包含單筆伺服器分享內容,也可能只是一般網頁網址;一段文字可能是受支援的分享連結,也可能只是幾行供手動填寫的參數。讀取後應確認 App 實際辨識出的內容,而不是只看掃描或貼上是否完成。
依現有資料選擇讀取方式
QR Code 顯示在另一個螢幕上
- 在 Home 尋找掃描 QR Code 的入口,並依系統提示允許使用相機。
- 將 QR Code 完整放入取景範圍,讀取後確認顯示的是伺服器項目還是連結。
- 若取得的是訂閱 URL,請改用 Subscribe 流程核對並儲存。
可以複製分享內容
- 複製完整文字,再使用 Home 新增入口中目前介面提供的剪貼簿讀取選項。
- 匯入後核對 Type、Address 和 Port;若未能辨識,請重新確認原文是否完整。
- 若原文只有逐項參數,請改用 Add Server 手動新增,不必強行以分享連結格式解析。
結論:先確認讀取結果的內容與格式,再決定是否儲存;掃描或複製成功,不代表伺服器參數已核對無誤。
若 QR Code 顯示在同一台 iPhone 上,相機通常無法直接掃描本機螢幕;可使用現有資料提供的可複製文字,或依目前 App 實際提供的圖片讀取選項處理。iPad 的操作原則相同,但入口外觀可能因裝置版面而異。若辨識後欄位不完整,請勿猜測補上密碼、UUID 或金鑰,應回到原始資料核對。
匯入後如何確認項目可用
先在 Home 確認目標項目確實出現在清單中,再檢查選取的項目是否正確。接著依 App 提示建立連線,並透過 Home 顯示的連線狀態和 Connectivity Test 協助排查。清單中出現項目,只表示資料已儲存或讀取,不代表連線成功;測試結果也須結合目前網路及所選路由模式判讀。
- 項目沒有出現:返回匯入入口,確認資料類型。Subscribe 需著重檢查完整 URL 與更新結果;掃描和剪貼簿匯入需確認內容是否已辨識;手動新增則需確認是否完成儲存。
- 項目出現但無法連線:先核對 Type、Address、Port 和憑證,再確認資料要求的 TLS、SNI 或傳輸參數;若是訂閱取得的項目,可先執行更新,確認資料仍是最新內容。
- 連線顯示正常,但存取路徑不如預期:查看 Home 中的 Global Routing。Proxy、Direct、Config 和 Scene 是不同的路由模式;若停留在 Direct,就不應預期所有流量都經過所選伺服器。
使用 Config 模式時,也須查看目前設定檔中的規則。DOMAIN-SUFFIX 依網域後綴比對,IP-CIDR 依 IP 網段比對,GEOIP 依地理位置條件比對,FINAL 則處理先前未比對到的要求;規則的目標可能是代理,也可能是直連。因此,單一網頁的存取結果不足以證明伺服器項目填寫正確或錯誤,應分別檢查連線測試、所選項目與規則結果。
常見問題:重複項目、清單空白與格式不符
遇到以下問題時,請優先透過目前的 App 介面和自己的原始資料核對。修改前可記下原項目的名稱及來源,避免混淆訂閱產生的項目與手動新增的獨立項目;即使兩筆內容看起來相同,也可能由不同入口管理。
已儲存 Subscribe,為什麼清單還是空白?
先確認儲存的是完整訂閱 URL,再對該訂閱執行更新並查看結果。若清單仍是空白,請核對原網址在目前網路下回傳的內容及格式;不要用手動填寫 Address 的方式處理訂閱 URL。
掃描後開啟了網址,卻沒有伺服器項目?
檢查 QR Code 實際包含的內容。若是訂閱網址,請透過 Subscribe 儲存並更新;若只是說明網頁,則需回到自己的現有資料中尋找可匯入的連結或逐項參數。
剪貼簿裡有文字,為什麼沒有辨識結果?
重新複製完整原文,避免遺漏開頭、結尾或查詢參數。逐項列出的 Address、Port、密碼等資料不一定能直接解析為分享文字,這類資料應改用 Add Server 對照欄位填寫。
同名項目出現兩次,應該修改哪一個?
分別檢查項目的來源與欄位。從訂閱取得的項目會隨訂閱更新;手動新增的項目則由自己逐項維護。先確認要使用的資料來源,再整理重複項目,避免只憑顯示名稱判斷。
首次在 iPhone 或 iPad 操作前,可先確認取得的是 App Store 上的 Shadowrocket,開發者標示為 Shadow Launch Technology Limited,App ID 為 932747118;系統需求以 App Store 頁面標示為準。此 App 採一次買斷,購買 App 與取得自己的連線資料是兩回事。確認 App 後,再依本文選擇符合現有資料格式的匯入方式。