Shadowrocket 訂閱匯入：Subscribe、Add Server、掃描 QR Code 與剪貼簿

先分清伺服器訂閱與 Config 設定檔

Shadowrocket（小火箭）的 Home 主要用來選擇伺服器、管理伺服器訂閱及連線；Config 用來管理規則設定檔；Settings 用來調整 App 設定。伺服器訂閱提供連線項目，規則設定則決定請求如何分流，不能只憑一個 HTTPS 網址就把兩者視為相同內容。

Config 頁面的 Subscribe 用於遠端設定檔；如果手上的是服務商提供的伺服器訂閱網址，請從 Home 右上角的「+」進入 Add Server，並將 Type 設為 Subscribe。若把伺服器訂閱當成規則設定檔匯入，可能會解析失敗，或匯入後仍找不到預期的伺服器清單。

判斷格式時，先查看提供者對連結用途的說明，再檢查回傳內容；不要只看副檔名。HTTPS 網址也可能回傳登入頁面、錯誤訊息或已過期通知，這些都無法作為伺服器訂閱解析。訂閱中的 token 通常可作為存取憑證，排查時請遮蔽完整網址、密碼與 UUID。

方式一：使用 Subscribe 建立可更新的訂閱

需要持續同步伺服器項目時，請使用 Type 為 Subscribe 的訂閱記錄。此記錄會保存訂閱網址，之後更新時重新取得伺服器清單；它與逐一儲存單筆伺服器參數的差別，在於是否保留可重複請求的資料來源。

1. 複製網址

   從自己的服務資訊複製完整訂閱網址，保留 https://、路徑與查詢參數。不要連同說明文字、換行或末尾標點一起複製。

2. 選擇類型

   依序進入 Home → 右上角「+」→ Add Server → Type → Subscribe，確認沒有選到單一伺服器的協定類型。

3. 填入網址

   將訂閱網址貼到 URL 欄位，並在備註中填寫方便辨識的名稱。確認 token 完整無缺後再儲存。

4. 更新清單

   返回 Home，下拉以更新訂閱。等待請求完成後，展開對應的訂閱群組，確認已產生伺服器項目，而不是只看到空的群組。

5. 檢查項目

   開啟某個項目的編輯資訊，確認 Type、伺服器網址與 Port 符合已有資料，接著在 Home 選取該伺服器。先完成一次驗證，再調整自動更新設定。

如果取得的是遠端規則設定網址，請前往 Config → Subscribe 新增並取得設定檔，再於 Config 檢查內容後選用。更新遠端設定與更新伺服器訂閱是兩個不同動作；更新其中一項，不代表另一項也已同步。

方式二：在 Add Server 手動填寫參數

如果只有伺服器位址、連接埠和驗證資訊，沒有可匯入的連結，請前往 Home →「+」→ Add Server。先選擇 Type，再依協定填寫欄位；Type 不同，所需的驗證、傳輸與 TLS 參數也會不同。手動新增的是單一連線項目，不會自動成為可更新的訂閱。

例如，只有資料明確標示 Port 為 443 時才填入 443；不要因為啟用了 TLS 就自行把連接埠改成這個值。連線 IP、SNI 和 HTTP Host 可能各有不同用途，請分別依原始設定填寫。若 TLS 驗證錯誤，優先檢查裝置時間、伺服器名稱與憑證資訊，不要把停用驗證當成一般修復方式。

• 儲存前確認 Type：伺服器位址與連接埠相同，不代表驗證協定也相同。
• 儲存後返回 Home 並選取該項目；清單中有項目，不代表它已被選為連線目標。
• 修改參數後，請重新連線再測試，避免把修改前的連線狀態誤當成修改後的結果。

方式三與四：掃描 QR Code、從剪貼簿匯入

QR Code 和剪貼簿是傳遞資料的入口，不是新的連線協定。QR Code 可以包含單一伺服器 URI，也可以包含訂閱網址；剪貼簿中的內容也是如此。最後是否建立訂閱群組，取決於解析出的內容，而非採用哪種匯入方式。

掃描 QR Code

1. 將自己已有的 QR Code 顯示在另一個螢幕或紙張上，再從 Home 開啟掃描功能；首次使用時，請允許存取相機。
2. 保持 QR Code 邊緣完整、畫面清晰，掃描後檢查解析結果。若是單一伺服器，請核對 Type 與 Port；若是訂閱網址，請核對 URL。
3. 確認後儲存，再返回 Home 檢查新增的項目或訂閱群組。如果 QR Code 只是一般網頁入口，請先取得真正的連線資料，不要硬把網頁網址存成訂閱。

如果 QR Code 顯示在同一台裝置上，可優先改用對應的文字連結，避免反覆擷取和轉傳含有憑證的圖片。QR Code 也可能包含密碼、UUID 或訂閱 token，請當作連線憑證妥善保管。

從剪貼簿匯入

1. 只複製完整連結文字，例如以 ss://、vmess://、vless:// 或 trojan:// 開頭的單筆分享連結；不要複製整段聊天內容。
2. 返回 Shadowrocket，依剪貼簿辨識提示匯入；系統詢問貼上權限時，只在這次主動操作中允許即可。
3. 如果沒有出現辨識提示，先確認剪貼簿中仍有原始文字。一般 HTTPS 訂閱網址可直接前往 Home →「+」→ Type → Subscribe，貼到 URL 欄位，不必依賴自動辨識。
4. 儲存後檢查項目數量與名稱。多次複製匯入可能產生重複的單一記錄，請逐一辨識並保留需要的項目。

伺服器訂閱網址格式範例：
https://example.com/sub?token=xxxx

遠端設定網址格式範例：
https://example.com/profile.conf

常見的單一伺服器分享連結前綴：
ss://
vmess://
vless://
trojan://

上述網域與 token 僅為格式範例，不是可連線的資料。請勿手動拆改分享連結中的編碼內容；尤其是 +、/、=、% 等字元若遭聊天工具替換或截斷，可能無法還原原始參數。

匯入後檢查 Global Routing 與連線結果

匯入只完成「將資料加入 App」這一步。接著在 Home 選取伺服器，檢查 Global Routing，開啟連線開關，並在系統提示時允許新增 VPN 設定。然後執行 Connectivity Test，再測試實際需要存取的目標；單次測試成功，只代表該次測試請求取得了結果。

在 Config 模式下，可透過以下規則片段了解由上而下、採用首條符合規則的邏輯。這不是完整設定；PROXY 所引用的策略必須已在實際設定中啟用，不能只貼上幾行規則就認為所有設定都已完成。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

DOMAIN-SUFFIX 比對網域及其子網域；IP-CIDR 比對 IP 網段；GEOIP 根據 IP 地理位置資料庫比對；FINAL 接手處理先前都未符合的請求。規則會由上而下比對，因此具體規則應放在廣泛規則之前。首次驗證時，可先前往 Settings → On Demand 檢查是否啟用自動連線條件，避免手動中斷後又被條件重新觸發。

匯入失敗或更新異常的排查方式

先區分三種情況：沒有產生項目，屬於取得或解析階段；已產生項目但無法連線，屬於伺服器參數或連線路徑階段；連線後只有部分目標異常，才進一步檢查規則與 DNS。依階段處理，避免把所有問題都歸因於「訂閱失效」。