Shadowrocket 使用教學

開啟 Shadowrocket 後，先停留在 Home，不要急著開啟上方的連線開關。查看下方的 SERVER 區塊；首次使用時，須先將自己的伺服器資料加入其中。如果手邊有完整的訂閱連結，請使用 Subscribe；如果有一組位址、連接埠、協定與認證資料，則使用 Add Server 手動填寫。一般網頁網址不是訂閱連結，也不要將訂閱網址填入伺服器的 Host 欄位。

已有訂閱連結：選擇 Subscribe

在 Home 點選右上角的新增入口或清單中的 Add Server，進入新增頁面後，在 Type 選擇 Subscribe。找到輸入訂閱網址的 URL 欄位，貼上自己的完整連結，並為這組訂閱設定容易辨識的名稱。貼上後檢查連結開頭與結尾是否多了空格或換行，尤其確認複製時查詢參數沒有遭到截斷；不要自行刪除不熟悉的參數。

儲存後返回 Home，等待訂閱內容讀取完成，再確認 SERVER 中是否出現對應的群組與伺服器項目。看到訂閱名稱不代表已成功讀取伺服器，請展開群組確認其中確實有項目。若清單空白，先暫停後續連線步驟，確認連結是否有效、目前網路能否讀取該網址，以及自己的訂閱狀態。請勿反覆匯入同一連結，否則重複群組會讓後續選取更難辨識。

已有單筆伺服器資料：逐欄填寫

進入 Add Server 後，先選擇 Type，再依該協定顯示的欄位填寫。Host 是伺服器網域或位址，Port 是連線埠；例如 Shadowsocks 還須確認 Password 與 Method。不同 Type 的認證與傳輸欄位各有差異，請依已有資料完整填寫，不要只因名稱相似就更換協定，也不要根據其他伺服器推測加密方式。截圖展示的是其中一種欄位組合，並非所有協定都使用相同欄位。

確認後儲存，返回 Home 找到剛新增的項目。也可使用已有的 QR Code，透過 Scan QR Code 匯入；系統詢問時，允許存取相機。匯入後同樣要檢查 Type、Host 與 Port。Import from Cloud JSON 適用於已有相應格式設定的情況，一般訂閱無須為此轉換格式。剪貼簿內容、QR Code 與訂閱連結可能包含認證資料，請勿將完整內容貼到公開頁面或交給他人協助排錯。

完成這一步的標準是：SERVER 中有可選取的實際伺服器項目，而不只是群組名稱。訂閱更新、多個訂閱的整理與備份，請接著參閱節點管理手冊；首次連線建議先保留一組容易辨識的設定，再進入下一步選擇路由模式。

儲存伺服器後返回 Home，點選 Global Routing，查看目前選取的模式。常用選項有設定 (Config)、代理 (Proxy)、直連 (Direct)。首次設定時先釐清目標：是要確認既有伺服器能否使用，還是依現有規則分別處理不同網站。模式與伺服器選擇是兩個獨立條件；只更換伺服器而未檢查模式，結果可能與預期不同。

設定 (Config)：依目前設定比對規則

選擇設定 (Config) 後，請求會依目前啟用設定中的規則與策略處理。接著開啟底部的 Config，確認已有可用設定，並核對目前啟用的檔案；只將檔案加入清單，不代表它已生效。進入設定編輯頁面後，可看到 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 等區段。首次使用時，請優先檢查 Rule；不必為了建立連線而修改所有區段，也不必先啟用 HTTPS Decryption。

規則通常依排列順序逐一檢查，較明確的比對條件應置於前面，最終策略則放在末尾。以下片段用來說明「指定網域後綴走 PROXY，其餘走 DIRECT」的結構；example.com 是教學用網域，不是伺服器位址。只有在自己的設定中，相應策略有效且規則位置正確時，這種寫法才會符合預期；請勿將範例整段覆蓋到尚未備份的現用設定中。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理 (Proxy) 與直連 (Direct)：指定連線路徑

代理 (Proxy) 會讓經由客戶端處理的請求採用代理路徑，適合暫時確認選取的伺服器是否可用；這不代表會逐一套用 Config 中的分流規則。直連 (Direct) 則採用直接連線路徑，不能用來證明代理伺服器已正常運作。如果先前一直在 Direct 模式下測試，即使網站可以開啟，也無法據此確認剛匯入的伺服器有效。

如果已有可信且用途明確的設定，請選擇 Config 並確認目前使用的檔案；若只想單獨確認「伺服器能否連線」，可暫時選擇 Proxy 測試，完成後再切回預期模式。修改前記下原本的選項，每次只變更一個條件。更完整的規則策略與設定管理說明，請參閱功能與設定；本頁接下來先完成系統連線。

返回 Home，在 SERVER 中點選要使用的伺服器，確認選取標記對應的是目標項目，而非另一筆名稱相同的記錄。訂閱中有多個伺服器時，首次測試先固定使用一筆，避免排錯時同時更換伺服器與模式。再確認一次 Global Routing 目前的選項與上一步選擇一致。

點選 Home 頂端的連線開關。首次建立連線時，系統會詢問是否允許新增 VPN 設定；閱讀提示後確認，並依裝置要求完成密碼或生物辨識驗證。這一步是允許客戶端建立系統網路連線設定，不是登入訂閱，也不會自動補齊缺少的伺服器認證資料。系統提示不應要求你另外將訂閱密碼提供給本站。

完成系統確認後返回 Shadowrocket，觀察頂端原本的 Not Connected 狀態是否改變，以及開關是否維持開啟。若開關立即關閉，先確認系統授權是否完成、選取的伺服器欄位是否齊全，再依本頁的故障排除步驟檢查。若先前取消了提示，可重新嘗試連線；仍有問題時，前往裝置「設定」中的 VPN 管理位置檢查對應設定，實際入口名稱可能因系統版本而異。

頂端的連線狀態代表系統通道是否已建立，不能證明目標網站已成功連線。伺服器認證、網域解析、規則選擇與目標網站回應仍可能在後續請求中失敗。因此，即使連線狀態正常，也應繼續執行 Connectivity Test 並實際測試網頁，不要只看開關變色就停止。

首次測試期間建議保持應用程式在前景操作，暫時不要加入 On Demand 等自動連線條件。需要暫停時，返回 Home 關閉連線開關；重要設定變更後，再依介面需要重新連線並測試。若系統中還有其他正在使用的 VPN 設定，請先確認目前實際啟用的是哪一項，以免將其他連線的狀態誤認為本次結果。

匯入後沒有伺服器項目

返回 Subscribe 對應的記錄，確認 URL 完整，並檢查是否複製了頁面說明文字、漏掉參數或多了換行。確認目前網路可以讀取訂閱，並向自己原有服務的提供者確認訂閱狀態與內容格式。更新訂閱只是重新讀取遠端內容，無法修復遠端已失效的認證資料。請先保留原有記錄與必要備份，再進行修正；不要反覆刪除及重建，以免掩蓋故障原因。

清單有項目，但測試失敗

先比較自己已有的另一台伺服器，判斷是單一項目失敗還是全部失敗。手動填寫的設定請優先確認 Type、Host、Port、Password、Method，以及該協定要求的傳輸與認證欄位。區分數字格式的連接埠與位址，不要將含協定前綴的完整分享連結填入 Host。若所有項目都失敗，先確認裝置網路本身是否正常，再比較不同網路；不要直接批次修改所有伺服器。

進入 Settings 查看 Test Method，確認目前使用的測試方式。測試方式不同，結果的意義也會改變，因此應搭配實際請求判斷，不要反覆切換測試方式，直到出現數字為止。若看到認證失敗或連線逾時等訊息，請記錄具體錯誤與發生階段，再檢查相應設定；不要只記下「無法連線」。

連線已開啟，但部分網站或背景連線異常

確認 Global Routing 與目前的 Config，再檢查目標網域是否符合預期規則。如果暫時改用 Proxy 後可以連線，但在 Config 下失敗，請優先檢查規則、策略與 DNS 相關設定。這種對照是用來縮小問題範圍，不代表應長期維持 Proxy。不要隨意啟用 HTTPS Decryption，或批次修改 TCP、UDP 設定來嘗試解決所有問題。

在 Settings 中，On Demand 用於設定依條件觸發的連線行為，無法提高伺服器本身的可用性。首次手動連線穩定後再設定；若自動重新連線或切換網路後的行為不如預期，請先檢查既有的 On Demand 條件，再重新測試。若要檢查背景耗電，請參照裝置的電池用量與實際使用時段，不要只憑「開關開了多久」下結論。

需要進一步定位時，請查看 Settings 中的 Diagnostics。記錄錯誤發生時間、網路類型、模式與具體故障目標即可；分享診斷內容前，請遮蔽訂閱 URL 中的認證參數、密碼與個人位址資訊。不要公開完整設定。更多分類解答請參閱常見問題；訂閱更新、排序、刪除與備份請參閱節點管理手冊。