Shadowrocket 入門指南

開啟 Shadowrocket，進入 Home。下方的 SERVER 分組會顯示已儲存的伺服器；首次使用時，先找到 Add Server 入口。新增的目的不是讓清單中出現任意一筆紀錄，而是依正確類型儲存既有資訊。先確認手上的資料是訂閱連結、伺服器分享連結，還是分開提供的地址、連接埠與驗證欄位，再選擇相應方式。

已有訂閱連結：使用 Subscribe

進入 Add Server 後，在 Type 中選擇 Subscribe，將完整訂閱連結貼到 URL 欄位。可填寫方便辨識的備註，再使用頁面上的儲存操作返回 Home，等待訂閱讀取完成。若項目尚未展開，請先查看對應的訂閱分組；需要重新讀取時，使用該訂閱項目的更新操作，避免重複新增相同連結。

複製連結時，請從頭到尾完整選取，並留意結尾參數、換行與空格。不要將登入頁面網址或說明頁面網址當成訂閱連結，也不要自行刪除看似多餘的參數。下方僅展示連結格式；實際操作請使用自己的有效連結，勿直接照抄示例。

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

已有伺服器欄位：依 Type 手動填寫

若已有獨立的伺服器資訊，請在 Add Server 中先選擇相應的 Type，再填寫 Host、Port 及該協定所需的驗證欄位。例如，Shadowsocks 需確認 Password 與 Method；其他協定的欄位會因類型而異，不應一概套用同一份欄位清單。地址只填要求的主機名稱或 IP，連接埠只填連接埠值，驗證資料請保持原樣。

涉及 TLS 或傳輸設定時，必須依既有伺服器資訊逐項填寫，不要因欄位看起來可選就任意修改。尤其應保留提供的伺服器名稱、路徑與傳輸類型；若缺少參數，請先向既有服務的提供者確認。儲存成功只代表項目已寫入，不表示遠端驗證與連線已通過。

已有 QR Code 或分享連結：檢查後再儲存

已有 QR Code 時，可使用 Scan QR Code；首次掃描時，依系統提示允許存取相機。若已有完整伺服器分享連結，複製後返回 App；若出現匯入提示，請先確認解析出的類型、主機名稱與連接埠，再進行確認。Import from Cloud JSON 是匯入相應 JSON 資料的入口，並非所有訂閱連結都適用；不要只因入口名稱相似就混用。

返回 Home 後，確認 SERVER 中出現預期項目，並點選準備使用的伺服器。若訂閱包含多個項目，初次驗證時先選一個資訊明確的項目即可，不必立刻整理所有名稱與排序。如需管理多個訂閱、了解更新覆蓋與刪除前備份，請繼續閱讀訂閱與伺服器管理。完成這一步後，再決定流量採用哪種處理模式。

儲存並選取伺服器後，在 Home 點開 Global Routing。此設定決定請求如何選擇處理策略，與剛才填入的伺服器地址屬於不同層級。即使伺服器資訊正確，若模式不符合預期，也可能出現「App 顯示已連線，實際存取結果卻不同」的情況。請先確認這次要驗證伺服器，還是依既有規則日常使用，再進行選擇。

1. 設定檔 (Config)：依目前設定檔中的規則處理請求。命中直連策略的請求會直接連線，命中代理策略的請求則使用相應代理路徑；不能只憑已選取伺服器判斷每個請求的去向。
2. 代理 (Proxy)：將由用戶端處理的請求交由代理策略處理，適合暫時排除規則因素的影響。仍須有可用伺服器，不能取代伺服器驗證，也不會自動修正錯誤參數。
3. 直連 (Direct)：使用直連策略，適合作為對照，檢查基本網路或目標頁面本身是否可存取；不要用它來證明代理伺服器運作正常。

初次驗證既有伺服器時，可暫時使用代理 (Proxy)，完成後再切回符合自身設定的模式。若已有明確的規則檔，請進入 Config 確認目前選取的設定檔，而非只確認清單中是否儲存過檔案。只有目前使用的設定檔中的規則，才會影響設定檔 (Config) 模式下的處理結果。

Config 頁面需要確認哪些項目

開啟相應設定檔的編輯頁面，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。入門階段先留意 Rule 與策略引用，無須為了連線而逐一啟用這些功能。Add Rule 用於新增規則；若現有設定檔可正常使用，不必先改寫整份檔案。

規則通常依序比對，前面的規則可能先決定處理方式，FINAL 則處理先前未命中的請求。以下是規則語法示例，並非可直接取代目前設定檔的完整檔案；PROXY 指向的策略也必須在實際設定檔中有效。請勿將示例網域當成需要測試的真實服務。

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

若不清楚策略名稱與協定名稱的差異，請先查看術語表中的規則與策略說明。首次連線時，記住目前模式、目前設定檔與目前選取的伺服器即可。確認後返回 Home，再開啟連線開關。

返回 Home，先確認 SERVER 中選取的伺服器，再查看 Global Routing 顯示的模式。頂端顯示 Not Connected 時，表示用戶端尚未建立連線。點按旁邊的連線開關開始連線；匯入訂閱不代表系統會自動開始處理流量。

首次開啟開關時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。這是 App 使用系統網路功能處理裝置流量所需的授權，不代表要再次購買 App，也不是新增伺服器。確認提示對象是 Shadowrocket 後，依系統流程允許，並完成裝置要求的密碼或身分驗證。授權程序會在系統介面中完成，不要將裝置密碼填入伺服器欄位。

若剛才取消了授權，請返回 App 再次開啟開關，確認是否重新出現提示。授權成功後，返回 Home 等待連線狀態變更。連線狀態和系統 VPN 標示可協助確認系統網路通道已建立，但不代表所選伺服器一定能存取所有目標；仍須進行下一步的實際驗證。

連線前後保持條件一致

首次排查時，盡量維持使用同一個 Wi-Fi 或行動網路，不要同時切換網路、伺服器、設定檔與模式。若目前有其他 VPN 連線，請先結束不使用的連線，再返回 Shadowrocket 重試，避免將系統連線切換誤判為伺服器異常。每次變更後都重新確認頂端狀態，不要只看開關曾經亮起。

在 iPad 上操作時，步驟相同：選取項目、確認模式、開啟開關並完成系統授權。畫面配置可能因裝置與 App 顯示方式而異，操作時仍以這些英文介面名稱為準。需要停止時，關閉頂端的連線開關；中斷連線不會自動刪除已儲存的伺服器或訂閱，之後仍可繼續使用原有項目。

若開關很快自行關閉，或連線一直無法完成，請先停在此處記錄系統提示，不必立刻刪除所有資料。可直接前往問題排查區分授權問題與遠端連線問題。若連線狀態能維持，再繼續驗證；不要只憑「已連線」就結束設定。

排查時先確認問題發生在哪個階段：匯入後沒有伺服器、開關無法維持、連線後所有內容都無法存取，還是只有部分請求不如預期。不同階段的檢查入口也不同。先保留原有資料與錯誤提示，每次只調整一項，再依「連線 → 測試 → 實際存取」的順序重新檢查。

匯入後清單空白：重新確認輸入與讀取結果

返回訂閱項目，檢查連結是否完整，有沒有多貼空格或漏掉結尾參數。確認內容確實是既有訂閱網址，而非帳戶登入頁面。若連結須在目前網路下讀取，先確認基本網路能否完成讀取；必要時向既有服務的提供者確認訂閱狀態與回傳格式。不要重複新增同一連結，也不要在公開求助時貼出完整連結。

開關無法維持：先檢查系統授權

先確認是否已完成新增 VPN 設定的系統授權，再檢查是否有其他正在使用的 VPN 連線。若系統顯示明確錯誤，請記下原文再進行操作；不要將所有問題都歸咎於伺服器密碼。重新開啟 App 並再次連線後，觀察是否停在相同階段。只有確認資料備份位置後，才考慮刪除設定或重新安裝。

已連線但無法存取：確認欄位與模式

確認目前不是直連 (Direct)，再核對所選伺服器的 Type、Host、Port，以及驗證、TLS 和傳輸參數。手動新增時，常見問題包括協定選錯、連接埠填錯或密碼中混入空格。訂閱匯入的項目應優先確認訂閱更新結果，不要憑猜測批次修改欄位。若基本網路本身也無法存取一般目標，請先處理網路連線問題。

只有部分請求失敗：檢查規則與測試方式

若代理 (Proxy) 可用，但設定檔 (Config) 異常，請返回 Config 檢查目前設定檔與規則順序。若只有測試結果異常，可前往 Settings 查看 Test Method，確認目前測試方式是否符合實際存取方式；變更測試方式只會改變測試依據，無法修正錯誤的伺服器參數。TCP、UDP 相關設定也應依既有服務的支援情況確認，不要為了排查問題而任意切換。

連線行為與預期不同：檢查 On Demand

在 Settings 查看 On Demand。此設定會影響符合條件時的自動連線行為，不會建立伺服器資訊。首次建立可用連線時，可先採用手動連線並記下目前設定；確認手動流程穩定後，再逐項設定自動連線條件。若關閉後又重新連線，或切換網路後行為改變，請先檢查此處，而不是直接刪除訂閱。

需要進一步分析時，請使用 Diagnostics 提供的診斷資訊，並將問題縮小為一個明確的重現操作。分享診斷資料前，請遮蔽訂閱連結、驗證欄位、個人地址及其他敏感內容；也要檢查截圖中是否包含這些資訊。更多現象分類請參閱常見問題；更新策略、排序與備份請參閱節點管理手冊。