Shadowrocket 快速入門

步驟 01 · 匯入資料

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

開啟 Shadowrocket，進入 Home。先確認手上的資料類型：如果是用來更新伺服器清單的網址，請使用 Subscribe；如果是單一伺服器的位址、連接埠、協定及驗證資訊，請手動新增。依照手上的資料選擇其中一種方式即可，不必為了完成教學而各新增一次。訂閱網址可能包含存取憑證，應像密碼一樣妥善保管，不要貼到公開頁面或任意轉傳。

已有訂閱連結時

在 Home 點選右上角的新增按鈕，進入 Add Server。點選 Type，選擇 Subscribe，再將完整訂閱連結填入 URL，確認後儲存。貼上時請檢查開頭與結尾，特別留意複製時夾帶的空格、換行和說明文字；不要刪除網址中問號後的參數，也不要把服務帳戶的登入頁面當成訂閱網址。

返回 Home 後，等待訂閱內容載入。正常情況下，清單中會出現相應的群組及伺服器項目。如果只看到訂閱名稱，卻沒有可選擇的伺服器，請先確認目前裝置能否存取訂閱網址，再檢查訂閱是否仍有效、回傳內容是否適用於用戶端。此時應先處理匯入問題，不要急著調整 Global Routing，因為切換模式無法修復無法讀取的訂閱網址。

已有單一伺服器資料時

同樣從 Home 開啟 Add Server，在 Type 中選擇資料上標示的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan，再逐一填入位址、連接埠及驗證欄位。不同協定所需欄位不同，密碼、UUID、加密方式和 TLS 設定不能互相替代。不要因名稱相似而猜測協定，也不要將帶有協定前綴的完整分享資訊直接填入伺服器位址欄。

如果資料附有 QR Code，可從應用程式提供的 Scan QR Code 入口讀取，並依系統提示允許相機存取。讀取後仍要檢查識別出的協定與位址是否符合原始資料，再儲存。手動填寫時，TLS 的伺服器名稱等欄位可能與連線位址不同，請以原始資料為準，不要為了讓欄位看起來一致而自行修改。

本步完成標準：Home 中已出現可選擇的伺服器，並已選取接下來要測試的項目。清單名稱只是備註，不能證明伺服器目前可用。請保留原始資料，以便連線失敗時逐項比對。欄位含義不清楚時，請先查閱概念速查；協定設計與參數說明請參閱協定手冊。

步驟 03 · 開啟連線

Home：連線開關與系統授權

返回 Home，再次確認目前選取的伺服器與 Global Routing。確認資料與模式後，開啟 Home 頂端的連線開關。首次建立連線時，iPhone / iPad 可能會出現新增 VPN 設定的系統提示。確認提示是由剛才的操作觸發後，選擇允許，並依系統要求完成裝置密碼或生物辨識驗證。

此處的系統授權是讓應用程式建立裝置上的 VPN 設定，不是登入訂閱帳戶，也不是伺服器驗證。裝置密碼應在系統提供的驗證畫面中輸入，不要填入 Add Server 的 Password 欄位。反過來，伺服器密碼也不能用來解鎖裝置；遇到輸入框時，請先確認它屬於系統提示，還是應用程式內的伺服器表單。

完成授權後返回 Shadowrocket，確認開關是否維持開啟。如果系統狀態列顯示 VPN 標記，可將它作為連線狀態的參考之一，但不要據此認定目標網頁一定能存取。系統設定已建立、伺服器是否可連線，以及規則是否符合預期，是三個不同層面；下一步仍需實際檢查存取情況。

如果開啟後立即關閉，先停止反覆點按，查看是否尚未完成授權或出現明確錯誤提示。接著檢查 Home 中是否確實選取了伺服器，以及先前填寫的連接埠、密碼等欄位是否完整。如果裝置上還有其他 VPN 連線正在使用，請先結束其他連線，再重新嘗試，避免同時操作而無法判斷目前是哪一項接管網路。

首次手動驗證期間，先維持 On Demand 設定不變。On Demand 用於依條件觸發連線，並非每次手動連線都必須開啟的前提。如果關閉開關後又自動連線，再進一步檢查現有的隨選連線條件；不要為了排查單一問題而同時修改多項自動化設定。

本步完成標準：系統授權已完成，Home 的連線開關維持開啟，且沒有待處理的提示。如需編輯目前的伺服器，請先關閉連線，儲存修改後再開啟。這樣能明確掌握每輪測試使用的參數，也方便在失敗時還原上一個狀態。

步驟 05 · 定位問題

依匯入、連線、規則三個環節排查

遇到問題時，回到最早未完成的步驟。不要一開始就重新安裝應用程式：重新安裝無法修復過期訂閱、錯誤的伺服器密碼或不相符的規則，還可能導致現有配置難以找回。先記錄錯誤訊息和最近的變更，再依照以下順序檢查。每次只調整一項，儲存後以相同目標重新測試。

匯入後沒有伺服器項目

先確認 Subscribe 中儲存的是完整訂閱網址，而不是帳戶首頁、說明頁面或單一伺服器的備註。檢查連結是否遭截斷、是否包含多餘字元，以及訂閱是否有效。如果回傳內容是登入提示或網頁，就不能當作伺服器清單使用。資料本身有疑問時，請向你現有服務的提供者確認正確網址及適用格式，不要將完整連結貼到公開討論區。

項目存在，但測試或連線失敗

對照原始資料檢查 Type、伺服器位址、連接埠與驗證欄位，再確認 TLS 相關參數是否遭到意外修改。裝置日期與時間也應正確，時間偏差可能影響憑證驗證。不要為了消除錯誤而任意關閉憑證驗證；應先核對伺服器名稱與憑證要求。如果保留了另一個自己已有且確認可用的伺服器，可以在相同網路中進行對照測試，但不必為了測試而反覆匯入陌生資料。

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

先確認是單一頁面異常，還是多個已知正常的目標都異常。單一目標失敗可能與目標服務、解析或比對策略有關，不足以證明所有連線都失敗。檢查 Global Routing 是否誤留在直連(Direct)，或 Config 中是否選取了另一份配置。若只有網域存取異常，再檢查 DNS 設定，避免將多組不熟悉的設定疊加在一起。

只有配置(Config)下的結果異常

確認啟用配置後，檢查規則由上至下的比對順序，以及兜底規則 FINAL 的策略。排在前面的廣泛規則可能先符合請求，使後面的精確規則無法生效。訂閱更新成功也不代表配置規則同步變更。請先還原自己已知可用的配置進行比對，再逐條調整；具體規則關鍵字請參閱概念速查，協定與傳輸欄位問題請參閱協定手冊。

排查完成後，將暫時使用的代理(Proxy)切回自己預計使用的模式，並重新執行一次驗證。若仍需進一步定位，請保留裝置系統、網路類型、協定類型、出錯步驟，以及移除敏感內容後的錯誤說明；不要公開密碼、完整訂閱連結或含有驗證資訊的 QR Code。如此既能保留診斷線索，也不會讓連線憑證出現在問題說明中。