Shadowrocket 入門指南

手動填寫 Add Server

開啟 Shadowrocket，進入 Home，在 SERVER 區域找到 Add Server；若目前版面使用頂端新增按鈕，也可點選該按鈕進入新增頁面。先點選 Type，選擇與現有資料相符的協定類型，再返回填寫其他欄位。Type 會決定後續顯示的認證與傳輸選項，請勿只因某個選項看起來熟悉就直接套用。

Host 填入伺服器主機名稱或 IP 位址，Port 填入連接埠。是否顯示 Password、Method 等認證欄位，取決於所選的 Type。以 Shadowsocks 為例，Method 與 Password 必須和伺服器設定一致；其他協定則應依各自提供的資料核對。請勿將完整分享連結貼入 Host，也不要在僅接受主機名稱的欄位中加入網頁路徑。

若資料還包含 TLS、伺服器名稱或傳輸路徑等參數，請逐項填入目前表單中對應的欄位。連線位址與用於憑證驗證的名稱可能不同，請勿為了讓兩者一致而自行修改。若不確定欄位的用途，請回頭查閱現有服務的設定說明；不建議反覆猜測參數或關閉憑證驗證來嘗試連線。

透過 Subscribe 匯入訂閱

如果你持有的是訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，再將完整訂閱網址填入 URL。也可為項目設定方便辨識的備註，儲存後等待取得資料。複製時請確認網址開頭、結尾及查詢參數完整，特別留意聊天 App 或文件是否插入空格、換行，或只複製了顯示文字而非實際網址。

訂閱網址通常包含存取憑證，請像保管密碼一樣妥善保存。教學不需要你的真實網址；請勿將完整網址貼在公開留言、截圖或診斷記錄中。訂閱取得成功後，返回 Home，確認 SERVER 分組下方出現預期項目。若只看到訂閱名稱而沒有伺服器，請先確認更新結果，不要立即重複新增相同訂閱。

已有分享連結或 QR Code 時

單一分享連結與訂閱是不同類型的資料。前者通常對應一台伺服器，後者則用於取得一組可更新的項目。請使用用戶端提供的連結匯入入口，或在 Add Server 中點選 Scan QR Code，掃描自己的 QR Code；掃描前請確認來源可信。Import from Cloud JSON 僅適用於你確實持有相應 JSON 資料的情況，並非通用的連結匯入入口。

無論採用哪種方式，最後都請返回 Home，選取準備使用的伺服器，並重新開啟其詳細資料檢查 Type、Host 與 Port。選取項目代表後續連線會使用該伺服器，不代表伺服器已可正常使用。完成後請繼續設定 Global Routing，不要只憑伺服器名稱或地區備註判斷實際連線結果。協定欄位的說明請參閱協定參考。

匯入伺服器後，返回 Home 並點選 Global Routing，查看目前選項。這裡控制的是整體路由模式，不是伺服器的協定類型。切換此選項不會變更伺服器的 Type，也無法修正填錯的認證資料。初次驗證時，請先確認目前選用的模式，避免將模式差異誤認為連線故障。

設定檔(Config)：依目前設定檔執行規則

設定檔(Config)適合依規則區分不同請求。進入 Config，確認準備使用的設定檔已選為目前啟用項目；僅匯入、儲存或開啟編輯頁面，不一定代表設定檔已生效。設定檔中的 Rule 會依序比對，符合後採用對應策略，例如 PROXY、DIRECT 或 REJECT。請求沒有經過伺服器，也可能只是符合 DIRECT 規則，並非用戶端未運作。

若還不清楚目前規則來自哪個檔案，請先不要任意新增大量規則。記下目前啟用的項目，再檢查相關 Rule 及其順序。下方片段僅用來說明「比對條件後接策略」的結構，並非完整設定檔，初次連線時也不必貼上取代現有檔案。

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

此範例中，符合 example.com 網域後綴的請求使用 PROXY，指定的區域網路位址範圍使用 DIRECT，其餘請求由 FINAL 處理。較前面的規則可能影響後續規則是否有機會執行。截圖中也可看到 General、Hosts、URL Rewrite 與 HTTPS Decryption 等區段；初次連線不必逐一修改，也不需要啟用 HTTPS Decryption。

代理(Proxy)：減少分流變因

代理(Proxy)會將一般由此模式處理的請求交由目前選取的代理路徑，適合用來短暫確認伺服器是否可用。若某目標在 Config 下失敗、切換至 Proxy 後恢復正常，通常應從規則、策略或相關解析設定著手排查。Proxy 不保證能完全接管裝置上的所有活動，也無法自動修正伺服器憑證或服務狀態。

直連(Direct)：不透過所選伺服器轉送

直連(Direct)適用於直接存取的情境。若目標需要透過現有伺服器提供的路徑，在 Direct 下測試成功或失敗，都不能據此評估該伺服器。要建立明確的比較基準，可先記下原本模式，短暫切換至 Proxy 進行驗證，再切回實際需要的 Config。每次切換後都請重新發出請求，避免將先前已建立的連線結果當成新模式的測試結果。

確認模式後返回 Home，確認 Global Routing 顯示預期選項，再繼續開啟連線。設定檔的區段與規則管理可進一步參閱功能與設定；初次操作請保持設定簡單，並確認設定來源明確。

返回 Home，確認 SERVER 中已選取的項目，再檢查 Global Routing。若剛編輯伺服器，請先確認變更已儲存；若剛切換 Config，請確認目前啟用的項目確實是準備測試的檔案。確認兩項設定後，再開啟 Home 頂端的連線開關。官方截圖顯示的是尚未連線的 Not Connected 狀態，並非成功連線的證明。

首次連線時，系統可能會提示 Shadowrocket 新增 VPN 設定。這是用戶端建立系統網路連線所需的授權程序，與再次購買 App 無關。請閱讀彈出視窗中的 App 名稱與要求內容，確認提示是由剛才的連線操作觸發後，依系統指示允許並完成身分驗證。授權時可能需要裝置密碼或系統支援的驗證方式，請以裝置目前顯示的提示為準。

若不小心點選取消，不必反覆刪除伺服器。返回 Home 再次嘗試連線，確認系統是否重新顯示提示；若仍無法繼續，請在系統設定中檢查是否已有 VPN 設定，以及裝置管理限制是否禁止新增。由學校或公司管理的裝置可能受到政策限制，請先確認裝置使用規範，而非不斷修改用戶端欄位。

完成授權後返回 Home，等待狀態更新。系統顯示已建立 VPN 連線，代表裝置至用戶端網路延伸功能的連線已啟動；但不代表遠端伺服器的認證一定成功，也不保證所有目標服務都能存取。因此，連線開關保持開啟只是下一步驗證的起點，並非整個流程的終點。

若開關很快又恢復關閉，請先記下錯誤提示及發生時機：是在系統授權前、授權後，還是開始存取時。此時應先處理連線建立問題，不要同時調整 DNS、Rule 與伺服器參數。若開關保持開啟但仍無法存取，請保留目前狀態，依下一步分別確認測試結果與實際請求結果。

iPad 的操作順序相同：選取伺服器、確認 Global Routing、開啟開關、完成系統授權，再驗證存取情況。不同螢幕版面上的按鈕位置可能不同，仍可依 Home 與對應的介面名稱辨識。首次連線成功前可先不設定 On Demand，等手動連線能穩定重現後，再考慮自動連線條件。

基本網路無法存取

先關閉用戶端連線，確認目前的 Wi-Fi 或行動網路是否能正常瀏覽。公共 Wi-Fi 可能需要先完成網路登入；系統也可能限制行動數據的使用。基本網路尚未就緒時，訂閱取得、伺服器連線與目標存取都可能同時失敗，請先排除此問題。確認基本網路可用後，再使用原伺服器與原模式返回 Home 重試。

Subscribe 更新失敗或沒有項目

確認訂閱 URL 是否完整、仍然有效，以及目前的基本網路能否存取該網址。訂閱網址與帳戶管理頁面的網址不一定相同；複製網頁登入網址通常無法取得伺服器清單。請勿將含有憑證的網址提交至公開檢測頁面；必要時，僅透過現有服務的支援管道確認網址狀態與回傳格式。保留原有可用項目，確認更新結果後再決定是否清除重複項目。

伺服器存在，但認證或交握失敗

開啟對應項目的編輯頁，逐項比對 Type、Host、Port、認證資料與傳輸參數。手動輸入時，請特別留意字母大小寫、前後空格及相似字元。使用 TLS 的項目也應檢查裝置日期與時間，以及資料指定的伺服器名稱。不要只修改 Password 就認定其他欄位正確，也不要隨意更換 Method 或略過憑證驗證，以免掩蓋參數不一致的問題。

Proxy 可用，但 Config 下部分目標失敗

優先檢查目前啟用的 Config、規則順序與符合的策略。先找到失敗目標的請求記錄，再確認是否被較早的規則指向 DIRECT、REJECT 或非預期策略。若網域與位址解析結果不同，請依實際記錄排查，不要一開始就全面更換 DNS 設定。確認某項修改有效後再保留，其餘測試用修改應予還原，避免不斷累積難以解釋的設定。

Connectivity Test 與實際使用情況不一致

進入 Settings 查看 Test Method，確認所用方法符合目前的比較目的。測試目標與實際服務目標不同，結果本來就可能不一樣；伺服器對某種測試回應較慢，不代表所有實際請求都慢。若文字頁面正常，只有特定服務失敗，請將排查範圍縮小至該服務的連線類型、目標狀態與所需傳輸能力。Settings 中的 Proxy、TCP、UDP 是相關設定入口，請勿為了嘗試而全部修改。

連線自動開啟或自動關閉

在 Settings 檢查是否已設定 On Demand。On Demand 會依條件觸發連線，並非網路加速功能；初次排查時，可先記下現有條件，暫時關閉自動觸發，改用 Home 手動連線，建立可重複的測試流程。測試結束後再恢復所需條件。若裝置上還有其他已啟用的 VPN 設定，也請確認目前實際生效的是哪一項，避免在錯誤的連線狀態下觀察結果。

收集 Diagnostics 時保護個人資料

需要進一步排查時，可在 Settings 查看 Diagnostics 相關功能。記下失敗時間、目前網路類型、所選模式、錯誤原文及問題能否重現，通常比只說「不能用」更有幫助。分享診斷資訊前，請檢查並遮蔽訂閱網址中的憑證、伺服器密碼、認證識別資料及其他私人資訊；保留錯誤類型與必要背景即可，請勿公開整份敏感設定。

完成排查後，返回驗證步驟

每次修改後，都請重新執行連線與實際存取驗證。若問題源於伺服器端狀態或現有訂閱權限，用戶端的本機修改無法取代伺服器端修復，請透過現有服務的支援管道確認。若只有單一目標異常，也應考慮目標服務是否暫時無法使用，不必因此重建所有設定。

首次使用指南到此即可完成：保留一台已驗證的伺服器、確認目前的 Global Routing 與正在使用的 Config，並了解如何手動停止連線。想進一步了解，請閱讀協定參考與功能與設定；需要重新確認完整操作順序時，請返回本頁的新增與匯入步驟。