Shadowrocket 匯入訂閱
與首次連線

已有訂閱連結：使用 Subscribe

先確認從服務商取得的連結是否完整。複製時須保留網址中的路徑、問號及後續參數，不要連同網頁標題、說明文字或聊天訊息中的標點一起複製。訂閱網址可能包含個人存取憑證，應只儲存在自己的裝置中；排除問題時，請勿在截圖或求助訊息中公開完整網址。

開啟 Shadowrocket 的 Config，找到 Subscribe，進入後新增訂閱並填入完整 URL，再儲存並更新。完成後返回 Home，檢查 SERVER 分組是否出現匯入的伺服器。判斷匯入成功的依據是實際出現可選取的項目，而不是只看到已儲存的訂閱名稱。若服務商提供的是設定檔網址，而非伺服器訂閱，請依對應的設定檔入口匯入；不能只因網址以相同副檔名結尾，就判定資料類型相同。

更新訂閱的作用是重新讀取服務商傳回的內容，不代表用戶端會自動取得新的服務權限。首次更新失敗時，先確認目前網路可以存取該網址，再檢查連結是否失效或遺漏參數。重複點選更新無法修正錯誤網址，也不要嘗試以修改協定名稱的方式轉換不相容的內容。

已有單一伺服器：使用 Add Server

在 Home 的 SERVER 分組中找到 Add Server，或使用頁面上的新增入口開啟 Add Server。先點選 Type，選擇與伺服器資料一致的協定類型，再填寫頁面要求的欄位。Type 會決定後續需要哪些參數；不能因為某種協定欄位較少，就用它取代服務商提供的協定。

以官方截圖中的欄位為例，Host 是伺服器位址，Port 是服務連接埠，Password 是驗證資訊，Method 是對應的加密方法。不同 Type 也可能需要其他驗證、傳輸或 TLS 參數，請逐項對照服務商提供的資料。不要把訂閱 URL 填入 Host，也不要把網頁存取連接埠當成服務連接埠。輸入完成後，使用頁面上的儲存或完成操作，返回 Home 確認項目已出現。

若資料是 QR Code，可使用 Scan QR Code；若資料明確為雲端 JSON，可依說明使用 Import from Cloud JSON。透過 QR Code 匯入不會改變內容格式；掃描到一般網頁網址，也不會自動變成伺服器設定。從剪貼簿匯入前，也須確認複製的是完整連線內容，而非一段介紹文字。

完成這個步驟後，應能在 Home 看到至少一個自己辨識得出的伺服器項目。暫時不必大量測試或重複匯入同一份資料；先保留一個項目，用於接下來的模式與連線驗證。協定欄位的進一步說明請見協定參考，訂閱與設定檔的差異請見名詞解釋。

返回 Home，點選 Global Routing 查看目前選項。首次使用時，先記下目前的選擇，再依自己的設定目的調整。這裡的三種模式分別是 Config、Proxy、Direct，並非速度等級，也不代表伺服器的好壞。

Config：依目前規則分流

選擇 Config 後，請求會依目前啟用的設定檔處理。規則可將不同目標交由 PROXY、DIRECT 或 REJECT 處理，實際行為取決於檔案內容。因此，「選擇 Config」不等於「所有請求都使用伺服器」；若某個目標符合 DIRECT，仍會直接連線。

進入 Config，確認已選取所需的設定檔。開啟編輯頁可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段；可在 Rule 中檢查具體規則，並使用 Add Rule 新增規則。匯入伺服器與啟用規則檔是兩個步驟：Home 中出現伺服器項目，不代表某份規則檔已自動啟用。初次使用不必同時修改這些區段，先使用來源與用途都已確認的設定檔。

Proxy：暫時檢查所選伺服器

Proxy 適合在排除問題時，暫時減少分流規則帶來的變數，以檢查所選伺服器是否能處理存取請求。這不是永久建議使用的模式，也不保證所有系統流量都會經過相同路徑。測試前請確認 Home 目前選取的項目正是要驗證的伺服器；結束後，若日常需要依規則分流，請切回 Config 並再次檢查結果。

Direct：直接連線至目標

Direct 不會將所選代理伺服器作為一般請求的輸出路徑，適合與代理存取結果互相比較。若連線開關已開啟，但某個目標仍顯示本地網路出口，請先檢查是否選擇 Direct，或是否在 Config 下符合 DIRECT，而不是立即認定伺服器資料有誤。

本次入門只需選擇符合目標的一種模式，暫時不要新增複雜規則。選擇後返回 Home，記下 Global Routing 欄位顯示的值，下一步連線時可用來確認模式是否正確。若不清楚規則順序或 FINAL 的作用，可先閱讀規則關鍵字說明；未儲存原始檔案前，請勿連續修改多項規則。

在 Home 的 SERVER 分組中點選本次要使用的伺服器，確認名稱與選取標記。一個訂閱可能包含多個名稱相近的項目，選取某個分組標題不一定代表已選取特定伺服器。若清單為空，請先返回第一步完成匯入，不要以反覆切換頂端開關取代新增資料。

確認 Global Routing 顯示預期模式後，開啟 Home 頂端 Not Connected 旁的開關。首次操作時，系統會詢問是否允許新增 VPN 設定。確認這是由 Shadowrocket 發起的操作，再允許並依裝置提示完成密碼或生物辨識驗證。此授權用於在裝置上建立連線設定，不等同於訂閱驗證，也不會補齊尚未填寫的伺服器參數。

完成系統提示後返回 Home，等待連線狀態變更，並觀察開關是否維持開啟。若剛完成授權仍未連線，在確認設定已加入的前提下，可重新開啟一次。若裝置受管理政策限制，或系統不允許新增 VPN 設定，請先處理裝置權限問題；這類問題無法透過更換伺服器密碼解決。

連線時避免同時啟用其他會接管系統網路連線的功能，以免狀態被另一個連線覆蓋。首次驗證階段也先不要啟用 On Demand，讓連線由手動開關控制，方便分辨是哪一次操作建立連線。需要停止時，返回 Home 關閉開關，並確認狀態已恢復為未連線。

頂端狀態變更只表示連線設定已啟動，不足以證明遠端伺服器驗證成功，更不能證明每條規則都符合預期。保持目前的伺服器與 Global Routing 不變，接著依下一步檢查實際請求；如此發現問題時，便能依同一組設定重現，而不必在多個變數間猜測。

匯入後沒有項目：先檢查回傳內容

若訂閱名稱已儲存，但 SERVER 仍為空，請確認更新是否確實完成，以及服務商回傳的內容是否為用戶端可辨識的訂閱資料。網址過期、遺漏參數、帳號狀態變更或回傳登入頁面，都可能導致匯入失敗。請先向服務商確認連結是否有效，再重新更新；尚未出現伺服器項目時，不要調整 Global Routing。

開關無法保持開啟：檢查授權與參數

若開關立即關閉，先確認系統新增 VPN 設定的授權是否完成，再檢查所選伺服器的 Type、Host、Port 和驗證資訊。需要 TLS 或特定傳輸方式的伺服器，也應核對對應欄位，不能只檢查密碼。若剛更換伺服器項目，請先停止連線再重新開啟，並觀察是否能穩定重現相同問題。

測試有結果但頁面無法開啟：區分規則與 DNS

先使用同一個目標比對 Config 與 Proxy 的結果。只有 Config 異常時，優先檢查目前的設定檔、規則順序和策略目標；兩種模式都異常時，再檢查伺服器與目標本身是否可連線。若問題表現為網域解析失敗，而其他連線仍可建立，再檢查設定中的 DNS 相關選項。不要因為單一網域無法開啟，就直接替換所有 DNS 參數。

進入 Settings 可查看 Test Method 和 Diagnostics。Test Method 用於了解 Connectivity Test 的測試方式；Diagnostics 可協助蒐集故障線索。記錄時保留錯誤類型和發生環節即可；分享前請隱藏訂閱網址中的憑證、伺服器驗證欄位及其他個人資料。協定欄位的差異可參閱協定參考；常見匯入與設定問題整理於常見問題。

連線自動恢復或反覆變化：再檢查 On Demand

若手動關閉連線後又自動開啟，或切換網路時的行為不如預期，請查看 Settings 中的 On Demand。隨選連線會影響連線的觸發方式，適合在手動連線已確認成功後設定。排除問題時，可先停用相關自動觸發條件，確認手動連線穩定後，再逐項恢復，避免將自動重新連線誤認為開關失效。

Settings 中還可看到 Proxy、TCP、UDP 等項目，這些並非首次連線時必須逐一修改的清單。只有明確確認故障所在層級後，才依對應說明調整。保留一份已成功運作的設定，比一次啟用所有選項更容易找出問題。修改完成後，返回 Home 重新連線並重做第四步的驗證；不要只確認設定已儲存就結束檢查。