官方手冊 · 首次連線

Shadowrocket 使用教學

依照「新增 → 選擇路由 → 連線 → 驗證」的順序完成基本設定。確認每個步驟的結果後再繼續，不必一開始就調整所有 Settings。

圖片為 App Store 官方截圖，可用來辨認頁面與欄位。請以裝置上實際顯示的介面為準；截圖中的示範項目不是可用的服務資料。

STEP 01 / IMPORT

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

開啟 Shadowrocket，進入 Home。先確認手上資料的類型：如果是用來更新伺服器清單的完整連結，請透過 Subscribe 匯入；如果資料包含協定、伺服器位址、連接埠及認證資訊，則新增單一伺服器。兩種資料用途不同，請勿將訂閱連結填入 Host，也不要把網站網址當成訂閱網址。

已有單一伺服器資料

  1. 在 Home 點選 Add Server，進入新增頁面。先選擇 Type，使其符合自己的伺服器資料。Type 會決定接下來要填寫哪些欄位；若類型選錯，即使位址與連接埠正確，也可能無法連線。
  2. 依資料填寫 Host 與 Port。Host 是伺服器主機名稱或位址，不是訂閱連結；Port 是該服務使用的監聽連接埠。貼上資料後，請檢查開頭或結尾是否多了空格或換行。
  3. 填寫該類型所需的認證欄位。官方截圖中的 Password、Method 是依截圖所選類型顯示，其他類型可能會有不同欄位。認證資訊、加密方式及其他連線參數都應與現有資料逐項相符，勿只因名稱相似就自行替換。
  4. 檢查資料後儲存並返回 Home，確認 SERVER 分組中出現剛新增的項目，再點選要使用的伺服器。看得到項目只代表資料已儲存，是否能連線仍須在後續步驟驗證。

已有訂閱連結

在 Add Server 的 Type 中選擇 Subscribe，將完整的個人訂閱連結貼到相應的 URL 欄位，儲存後返回 Home。等待匯入完成，再展開對應分組確認伺服器是否出現。若項目尚未載入，可使用該訂閱項目的更新功能重新請求；首次等待時間較長時，請勿連續建立多筆相同訂閱。

訂閱連結可能包含存取憑證，請妥善保存於可信任的位置，勿放入公開截圖、留言或排錯紀錄。連結中的參數不可任意刪除；透過通訊軟體傳送時被換行，或複製不完整，也可能導致匯入失敗。更新成功後，選取一台現有伺服器，再繼續選擇路由方式。更新訂閱清單與更新 Config 設定檔是兩回事：前者主要更新伺服器資料，後者則會影響規則等設定。

Scan QR Code 適合掃描自己已有的有效伺服器 QR Code；Import from Cloud JSON 則是用來匯入相應格式的入口。這些功能不代表能辨識任意文字。若不確定資料格式，請先確認原始格式，不要反覆切換入口嘗試。其他匯入格式與更新異常說明，請參閱疑難排解。

Shadowrocket Add Server 頁面，顯示 Type、Host、Port、Password、Method 與底部的匯入入口
Add Server：先選擇 Type，再依現有資料填寫欄位。不同類型可能會顯示不同的認證項目。

STEP 02 / ROUTING

Global Routing：選擇設定、代理或直連

儲存並選取伺服器後，返回 Home，點選 Global Routing。這裡用來決定流量採用哪種整體路由方式，不是選擇協定，也不會自動修正伺服器資料。三種模式分別是設定(Config)/代理(Proxy)/直連(Direct)；首次使用時，先了解各自用途，再選擇符合目前測試目的的模式。

設定(Config)：依目前設定判斷流量策略

選擇設定(Config)時，流量會依目前啟用的設定處理。進入 Config 確認實際使用的設定檔，再查看其中的 Rule。官方截圖展示的是設定編輯頁面，可看到 General、Rule、Hosts 等區段，以及 Add Rule 入口；此頁用於檢視設定內容，並非 Global Routing 的選擇選單。

規則通常依序比對，最先符合的規則會決定該請求採用的策略。PROXY 表示使用相應的代理策略，DIRECT 表示直連；因此在設定(Config)模式下，部分網站走代理、部分網站直連，可能正是預期結果。尚未確認目前使用的設定前，請勿直接將「某網站未經伺服器」判定為連線失敗。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

以上僅為規則語法範例：example.com 及其子網域符合 PROXY，其餘未符合規則的請求則由 FINAL,DIRECT 作為預設處理。這不是完整設定，也不需要照抄來覆蓋現有內容。

代理(Proxy)與直連(Direct)：依需求明確選擇

代理(Proxy)適合讓由用戶端接管的請求使用代理模式，也可暫時用於比對測試；但選取伺服器不代表所有網站都一定能連線，伺服器本身、網域解析及目標網站仍可能發生問題。直連(Direct)會讓相應流量直接連線，不經過所選的代理伺服器，適合確認原有網路是否正常。

日常使用需要依規則分流時，確認設定有效後選擇設定(Config)。若要判斷問題是否與規則有關，可先記下目前選擇，暫時切換成代理(Proxy)，再對同一目標重試；完成後記得恢復。每次只變更路由模式，不要同時切換伺服器與設定，才能有效比較結果。更完整的規則說明請參閱疑難排解。

Shadowrocket Config 設定編輯頁面，顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config 設定編輯頁：選擇設定(Config)時，需同時確認目前啟用的設定與 Rule，不能只看 Home 中選取的伺服器。

STEP 03 / CONNECT

Home：開啟連線開關

返回 Home，進行連線前最後一次檢查：確認 SERVER 下已選取要使用的伺服器，Global Routing 顯示剛才選定的模式；若使用設定(Config)，也要確認 Config 中啟用的是預期設定。未選取有效伺服器時，單純開啟連線開關無法補上服務資料。

  1. 點選 Home 頂端的連線開關。官方截圖中的 Not Connected 表示截圖當時尚未連線；實際操作時，請觀察狀態是否有所變化。
  2. 首次建立連線時，系統可能會提示新增 VPN 設定。閱讀提示，確認這是剛才由自己主動發起的操作後，依系統流程允許新增，再完成裝置要求的驗證。
  3. 返回 Shadowrocket，等待連線狀態穩定。若開關立即關閉，或狀態持續無法建立，請勿快速反覆切換，先依後續的故障排查步驟檢查。

系統 VPN 授權允許用戶端建立相應的網路連線設定，不代表已購買或取得伺服器服務。授權成功與否，以及能否連上遠端伺服器，是兩個不同層面：前者由裝置系統確認，後者取決於已匯入的資料、目前網路與遠端服務狀態。因此，即使看到連線狀態改變，仍須進行下一步的實際驗證。

若先前已有其他 VPN 連線正在使用，請先在系統設定中確認目前使用的是哪個連線，避免測試途中連線被取代。首次測試不必同時啟用 On Demand；先手動建立一次可重現的連線，確認路由正確後，再視需要了解自動連線條件。

在 iPad 上也依照相同步驟確認 Home、伺服器選擇與系統授權。介面配置可能因裝置顯示空間而異，但判斷依據仍是目前選取的伺服器、Global Routing 與連線狀態，而非截圖中的固定位置。

Shadowrocket Home 頁面，頂端為 Not Connected 連線開關，下方顯示 Global Routing、Connectivity Test、SERVER 與 Add Server
Home：連線前確認 Global Routing 與 SERVER 的選擇；連線後執行 Connectivity Test 並驗證實際連線。

STEP 04 / VERIFY

Connectivity Test：確認測試與連線結果

連線開關保持開啟後，在 Home 使用 Connectivity Test 查看伺服器測試結果。測試可提供連線狀況的參考，但結果會受到測試方法、測試目標與當下網路影響。單一測試結果不能保證所有網站都能連線；測試逾時也應搭配實際請求判斷，不要只憑一次結果就刪除伺服器。

分三個層面確認是否正常運作

  1. 先確認連線是否保持。返回 Home，確認狀態沒有回到未連線。若開關無法保持，請先處理授權或連線建立問題；此時還不能判斷網站規則。
  2. 接著實際連線測試。開啟瀏覽器，造訪自己有權存取且想測試的網站，重新載入頁面。請勿只看先前已載入的頁面或舊快取，也不要只憑裝置狀態列的 VPN 標示判斷遠端連線結果。
  3. 最後確認策略是否符合預期。在設定(Config)模式下，對照目前規則判斷目標應使用 PROXY 或 DIRECT；在代理(Proxy)模式下，確認已選取的伺服器；在直連(Direct)模式下，則不應預期請求會經過所選的代理伺服器。

需要輔助觀察時，可開啟 Data 查看測試期間的流量變化。流量總量增加只能表示有流量被統計，不能單獨證明每個網頁請求都採用相同策略。現代網站可能同時向多個網域發出請求；若主頁面能開啟，但圖片或登入請求失敗，應分別檢查相關網域與規則，而非只檢查網址列中的網域名稱。

若同一目標在代理(Proxy)模式下正常、在設定(Config)模式下異常，應優先檢查設定與規則比對順序。若兩種模式都失敗，但直連(Direct)時其他常用網站正常，則應集中檢查伺服器資料、遠端服務狀態與解析問題。保持相同目標與網路，每次只變更一個條件，避免將偶發波動誤判為設定結果。

STEP 05 / DIAGNOSE

Settings：依故障階段逐項排查

發生異常時，先確認問題出在哪個步驟。訂閱無法匯入、伺服器測試失敗、連線無法保持、只有部分網站無法使用，分別需要檢查不同項目。不要先把 Settings 中所有開關都調整一遍，也不要立即覆蓋 Config；先記錄現象，保留一條已知正常的比對路徑。

訂閱匯入失敗或清單未更新

回到訂閱項目，確認連結完整、仍然有效且格式可辨識，並確認目前裝置網路可以連線至訂閱網址。訂閱請求通常也需要正常的基礎網路；如果尚未建立可用連線，別預期開啟失效的連線就能自動恢復訂閱。確認裝置日期與時間正確後，再嘗試更新一次。更新失敗時，舊清單可能仍會保留，因此「看得到原有項目」不代表這次更新成功。

若資料來自自己的服務，請確認其有效狀態與使用條件，不要靠反覆新增相同連結來解決。排錯紀錄只保留必要的錯誤訊息，不要公開完整訂閱 URL、認證欄位或含有憑證的 QR Code。

伺服器已新增，但測試或連線失敗

先確認 Type、Host、Port 與認證欄位是否符合現有資料，尤其要留意複製時遺漏的字元、錯誤的連接埠及不相符的 Method。接著中斷連線，使用常用網站確認目前的 Wi-Fi 或行動網路是否正常；若公共網路要求先登入網頁，請先完成該網路的登入程序。

進入 Settings 可找到 Test Method 等測試相關項目。不同測試方法的結果不能直接視為相同指標；先固定使用一種方法重複測試，再與實際網站連線狀況比對。切換裝置網路時，也請維持相同的伺服器與測試目標，避免一次改變多個條件。

開關無法保持，或關閉後又自動連線

確認系統中的 VPN 設定與授權狀態，並確認沒有其他連線正在取代目前的連線。若關閉後又自動連線，請檢查是否啟用 On Demand 及其條件。手動排錯時，可先記下原有設定，再暫時停用相關的自動連線行為，避免測試過程中連線狀態自行改變。關閉 App 頁面不代表網路連線一定已中斷，請返回 Home 或系統設定確認實際狀態。

只有部分網站無法正常使用

返回 Global Routing，依前述比對方式區分規則問題與伺服器問題。若已確認問題出在設定(Config)，請優先檢查目前使用的設定、Rule 順序與預設策略；若涉及網域解析，再檢查對應的 DNS 設定。不要只為了某個網頁就啟用 HTTPS Decryption，或大幅調整 Proxy、TCP、UDP 設定；這些項目不是首次連線的必要步驟。

Diagnostics 可作為進一步診斷的入口。使用診斷紀錄前，請先移除伺服器認證資訊與訂閱憑證，只保留能說明故障階段的內容。訂閱更新、DNS 與規則問題的詳細說明，請參閱疑難排解；商店地區、購買與換機後還原，請閱讀App Store 取得指南，無須透過修改連線設定來處理購買問題。

Shadowrocket Settings 頁面，顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings：先了解 Test Method、On Demand 與 Diagnostics 的用途，再針對已確認的故障階段檢查設定。

完成首次設定後的檢查清單

返回 Home，確認只選取計畫使用的伺服器，Global Routing 符合日常使用需求，且連線狀態正常。完成一次實際請求後，將暫時用於比對的模式恢復為預期設定。不必為了「設定完整」而逐一啟用所有功能；只保留用途明確、結果可驗證的必要變更即可。

  • 現有訂閱可正常更新，且已確認伺服器資料來源與有效狀態。
  • 設定(Config)/代理(Proxy)/直連(Direct)的選擇符合本次連線需求。
  • 已分別確認連線狀態、Connectivity Test 與實際連線結果。
  • 公開截圖或排錯紀錄中未包含訂閱連結與認證資料。

日後遇到異常，請先回到本頁對應的故障階段，再參閱疑難排解。購買與重新安裝 App 請透過 App Store 處理；現有伺服器或訂閱是否有效，則須依據自己的服務資料確認，兩者不可混為一談。

App Store 下載