Shadowrocket 使用教學
從匯入到連線測試

STEP 01 · 匯入伺服器資料

Add Server：新增伺服器或匯入訂閱

先確認手上的資料類型：用來更新伺服器列表的訂閱連結，或單一伺服器的位址、連接埠與驗證資料。兩者的匯入方式不同，不需要同時操作。開啟 Shadowrocket，前往 Home，點選右上角的新增入口進入 Add Server；儲存後應返回 Home 檢查結果，而不是停留在編輯畫面直接嘗試連線。

已有訂閱連結：使用 Subscribe

在 Add Server 中開啟 Type，選擇 Subscribe，再將現有訂閱連結完整填入 URL。備註可填寫容易辨認的名稱，例如「日常訂閱」；請勿在備註中填入密碼或連結內的驗證資料。確認後儲存，等待訂閱讀取完成。成功後，Home 列表會顯示該訂閱所含的伺服器項目；若只看到訂閱名稱，卻沒有可選伺服器，請先檢查更新結果。

複製連結時，特別留意開頭、結尾與中間的參數。聊天訊息中的說明文字、換行、空格或句末標點都不是連結的一部分，請勿一併填入。以下僅為欄位格式的教學範例，不能用作實際訂閱，也不需要開啟。

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

匯入成功後，先保留這筆訂閱，請勿因列表尚未更新就連續新增多筆相同項目。需要重新取得伺服器列表時，只要更新現有訂閱即可。訂閱網址可能包含存取憑證，請妥善保管，如同保管密碼一樣；將問題截圖傳給他人前，請遮住完整 URL 及其中的參數。更新與管理多筆訂閱的詳細方法，請參閱訂閱手冊的更新策略。

已有單一伺服器資料：依協定填寫

若取得的是伺服器欄位資料，請在 Add Server 的 Type 中選擇資料明確指定的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan。接著填寫位址、連接埠與該協定所需的驗證資料。不同協定的欄位也不同，不可將某種協定的密碼、UUID 或傳輸參數直接套用到另一種協定。請依照資料內容及目前表單填寫。

儲存前逐項核對位址是否多了空格、連接埠是否完整，以及驗證資料是否漏字。若資料還要求 TLS、傳輸方式或伺服器名稱，也請照原資料填寫，不要為了簡化表單而刪除這些參數。若不確定某個欄位的填法，請向服務供應商確認，不要反覆嘗試不同組合。表單可以儲存，只代表輸入內容已被接受，不代表一定能連上遠端伺服器。

透過 QR Code 或剪貼簿匯入：先確認內容類型

若已有可供匯入的 QR Code，可使用 Scan QR Code，並依系統提示授予必要的相機權限。QR Code 可能包含單一伺服器的分享連結，也可能包含訂閱網址；辨識後先檢查結果，確認類型、備註與網址符合現有資料，再儲存。從剪貼簿匯入時，也請先確認複製的是完整分享內容，而非網頁標題或一般說明文字。詳細整理方式請參閱掃描 QR Code 與匯入說明。

完成任一匯入方式後，返回 Home，找到剛新增的伺服器並選取。此時先不要連續變更其他設定；下一步要確認的是請求如何處理。訂閱提供伺服器列表，規則設定則決定流量的處理方式；成功匯入訂閱，不代表也已匯入或啟用適合自己的規則設定。

STEP 03 · 建立系統連線

Home：開啟連線開關並授權 VPN 設定

返回 Home，確認已選取伺服器，且 Global Routing 符合這次測試目的，接著開啟連線開關。首次連線時，系統可能會詢問是否新增 VPN 設定。這項授權是讓 App 使用系統網路功能處理流量所需的步驟，並非再次匯入伺服器。請先確認提示是由目前操作觸發，再依系統畫面選擇允許，並在裝置上完成密碼或生物辨識驗證。

完成授權後返回 Shadowrocket，確認連線開關是否維持開啟。若剛才未完成系統確認，App 可能仍未連線；請先處理權限提示，再重試一次即可。若開關立刻跳回關閉狀態，請勿快速反覆點選，也不要連續新增多筆資料。先檢查是否有尚未處理的系統提示，以及裝置是否允許建立目前的 VPN 連線。

區分 VPN 設定與規則設定

系統中的 VPN 設定記錄，用於建立 App 與系統網路功能之間的連結；App Config 中的檔案則用來設定規則、DNS 等處理方式。兩者名稱都可能包含「設定」，但用途不同。刪除系統 VPN 設定無法修正寫錯的規則；更換 Config 檔案也不能取代系統授權。確認問題所在的層級後，才考慮採取相應操作。

若先前拒絕授權，可再次嘗試連線並留意系統提示。若裝置受管理政策限制，或系統提示無法新增 VPN 設定，請先確認裝置管理要求，不要將問題誤判為訂閱失效。需要確認系統記錄時，可在系統設定中搜尋 VPN，查看 Shadowrocket 對應項目；修改前請確認目標，避免影響仍在使用的其他網路設定。

完成授權且開關維持開啟，只能表示連線流程已開始或系統連線狀態已建立，不能據此認定所有網站都能存取。系統狀態標示也不能取代 App 層級的測試。接下來請保持伺服器與模式不變，依下一步檢查實際網頁請求，才能得到可供比較的結果。

STEP 05 · 一次排查一個故障環節

Shadowrocket 無法連線：依現象逐項排查

先記錄故障發生在哪個步驟：無法儲存、無法更新、伺服器測試失敗、連線開關跳回關閉，或連線後網頁無法開啟。保留原有可用設定，每次只變更一個項目，並用同一個頁面重新測試。不要一開始就刪除所有伺服器、清空 Config 或重置所有網路設定，這些操作會同時移除排查所需的線索。

訂閱更新失敗，或列表中沒有伺服器

先確認裝置的基本網路能否開啟一般網頁，再核對 Subscribe 中的 URL 是否完整。若連結參數遺漏，或複製時混入換行與標點，請向服務供應商重新取得完整連結並替換。若資料已有變更，請更新原有訂閱，而不是重複新增多筆副本。問題仍未解決時，記錄 App 實際顯示的錯誤訊息，並向服務供應商確認連結是否有效、回傳內容是否適用於匯入。

訂閱更新失敗與現有伺服器能否連線，應分開判斷。有時伺服器列表仍在，但訂閱暫時讀取失敗；也可能訂閱更新成功，某台伺服器卻無法使用。因此請先檢查目前列表與選取的項目，不要把「可更新」當成「所有伺服器都可用」的證明。更新後項目變化與多筆訂閱管理方式，請參閱訂閱更新說明。

Connectivity Test 失敗

手動新增的伺服器，請返回 Add Server 編輯畫面，對照現有資料核對協定、位址、連接埠與驗證欄位，再檢查 TLS 與傳輸參數。透過訂閱匯入的項目，請先更新一次，確認測試的是仍在列表中的伺服器。若只有一個項目失敗，可改用自己已有的另一個項目比較；若全部失敗，請先檢查目前網路狀態與共用的設定條件。不要靠猜測密碼或連接埠反覆嘗試。

連線開關無法保持開啟

確認是否已完成新增 VPN 設定的系統授權，以及是否還有尚未處理的提示。若系統顯示明確錯誤，請先處理該錯誤，再測試伺服器。裝置切換網路後出現異常時，可先關閉連線，等待基本網路恢復後再重新開啟；每次先觀察結果，再進行下一步。受管理裝置的限制需依裝置管理要求處理，通常無法透過修改伺服器資料解決系統權限問題。

測試有回應，但網頁無法開啟

先確認是所有頁面都無法開啟，還是只有特定網域或 App 發生問題。保持伺服器不變，暫時從 Config 切換至 Proxy 進行比較：若 Proxy 正常、Config 異常，優先檢查目前設定中的規則與 DNS；若兩者皆異常，再檢查伺服器參數、遠端狀態與目前網路。比較完成後恢復原本需要的模式，請勿將暫時測試狀態當成最終設定。

DNS 負責將網域名稱解析為位址；伺服器測試收到回應，不代表網頁所需的所有網域都能正確解析。請先核對目前 Config 中的 DNS 設定是否來自已確認的設定，避免同時變更多項解析選項。詳細的分層檢查方法，請參閱網頁無法開啟但延遲正常：DNS 排查說明。

回報問題前，整理必要資訊

記錄裝置類型、目前網路、Global Routing 選項、故障環節與錯誤訊息，並說明是否只有特定目標受到影響。請勿傳送完整訂閱連結、密碼、UUID 或其他驗證資料；日誌與截圖也應先檢查並遮蔽敏感欄位。描述「Proxy 可以存取，切回 Config 後特定網域失敗」，比只說「無法連線」更有助於定位問題。

需要重新檢查前面的操作，可返回新增與匯入、選擇 Global Routing或連線授權，從第一個未通過的步驟繼續。