Shadowrocket 使用教學

開啟 Shadowrocket 後，先進入 Home。手上的資料如果是會定期更新伺服器清單的連結，請按訂閱處理；如果是包含協定、位址、連接埠和驗證資料的一組資訊，請手動新增。兩種方式都是讓應用程式知道要連到哪裡、使用什麼協定及如何驗證，不必重複匯入。

訂閱連結：選擇 Subscribe 類型

在 Home 點選 Add Server，進入新增頁面，於 Type 選擇 Subscribe，再將完整的訂閱連結貼到對應的 URL 欄位。填入方便辨識的備註後儲存，返回 Home 等待讀取訂閱內容。訂閱連結屬於敏感資料，複製時請確認開頭、結尾與查詢參數完整；不要把通訊軟體附上的說明文字或換行一併貼入。

匯入完成後，確認 SERVER 群組中已出現伺服器項目，再點選要使用的項目。訂閱名稱只是整理清單的方式，不代表已選取其中某台伺服器。服務商更新內容後，請更新既有訂閱，不要一再新增相同連結。更新失敗時，先保留現有可用項目，確認原因後再處理。

手動填寫：依 Type 核對欄位

如果已有單一伺服器的資料，請在 Add Server 先選擇正確的 Type，再填寫 Host、Port 及該協定要求的驗證資料。Shadowsocks 的 Password、Method 必須與伺服器端一致；其他協定顯示的欄位可能不同，請逐項比對原始資料。Host 通常填寫網域名稱或 IP 位址，不要把整段網頁連結當作伺服器位址。

儲存前再確認一次連接埠是否完整、密碼前後有沒有多出空格，以及協定是否選對。頁面出現選填欄位，不代表每台伺服器都必須填寫；TLS、傳輸方式等參數也不能只憑名稱猜測。資料不齊時，請向你的服務商取得所需資訊，不要靠逐一嘗試選項代替核對。

請區分掃描 QR Code 與設定檔

已有 QR Code 時，可以使用 Scan QR Code 讀取連線資料，接著核對解析出的 Type 和 Host。Import from Cloud JSON 適用於相應格式的資料，並非可匯入任何網頁或訂閱的通用入口。匯入前先確認資料類型，匯入後仍須檢查建立的項目。

伺服器訂閱與 Config 中的設定檔用途不同：前者主要管理連線項目，後者用來管理規則等設定。看到 Config 或 Subscribe 字樣時，應依目前處理的資料判斷用途，不能只憑按鈕名稱互換入口。請先完成伺服器匯入，再進入下一步選擇 Global Routing。更多詞義請參閱術語表。

伺服器項目儲存成功後，返回 Home，點選 Global Routing 查看目前模式。這裡設定的是要求的處理方式，不是切換伺服器協定。三種模式分別為 Config、Proxy、Direct；開始前先記下目前選擇，排查時才能釐清前後結果的差異。

Config：依設定檔分流

選擇 Config 時，應用程式會依目前生效的設定檔處理要求。進入 Config 查看正在使用的檔案，確認其中的 Rule 與策略符合預期。檔案出現在清單中，不代表一定已生效；請確認其是否已選取或正在使用。初次使用時，建議先使用自己已有且了解用途的設定檔，編輯前先保留副本。

規則可以將特定網域交由 PROXY，讓區域網路網段使用 DIRECT，並在末尾透過 FINAL 指定其他要求的處理方式。以下 Rule 片段用於說明比對順序，不是伺服器資料，也不應直接取代整份設定檔。只有經過應用程式處理的相應要求，才會套用規則比對。

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

此片段會將 example.com 及其子網域交由 PROXY，將指定的私人網段交由 DIRECT，其他要求則套用 FINAL。規則通常由上而下比對，具體條件應排在較寬泛的條件之前。請先保留現有規則進行連線驗證，初次使用時不必同時修改 General、Hosts 或 URL Rewrite。

Proxy 與 Direct：用來明確比對

Proxy 會以代理模式處理由應用程式接管的要求。已有正確的伺服器資料時，可暫時用它排除設定檔分流對結果的影響；但不保證每項服務都允許從該出口存取。Direct 會讓要求直接連線，不能用來驗證代理伺服器是否可用。即使頂端連線開關已開啟，選擇 Direct 也可能得到與代理模式不同的出口結果。

日常需要依規則分流時，完成基本驗證後切回 Config，並再次確認目前使用的檔案。三種模式不是「強度」等級，也不會改變服務商端的帳號權限。更多規則類型、FINAL 順序與設定段落說明，請參閱設定欄位參考；本頁僅說明首次使用所需的選擇。

返回 Home，先確認 SERVER 中已選取要使用的伺服器，再確認 Global Routing 與上一步相同。不要在切換模式時快速連續操作開關；先固定伺服器和模式，才能判斷接下來的連線結果對應哪組設定。

點選 Home 頂端的連線開關。尚未連線時會顯示 Not Connected。首次建立連線時，系統會詢問是否允許 Shadowrocket 新增 VPN 設定；請閱讀提示中的應用程式名稱與說明，確認是自己剛才主動操作後再允許，並依裝置提示完成密碼或生物辨識驗證。

這項 VPN 設定授權是允許系統讓應用程式處理相關網路流量，僅涉及本機權限，不代表伺服器已通過驗證。允許後返回 Shadowrocket，查看頂端狀態是否改變，以及開關能否維持開啟。若先前取消提示，可再次手動連線，並依系統實際提示完成授權。

如果開關剛開啟就自動關閉，先確認是否已完成授權，以及系統是否有其他正在接管連線的 VPN 設定。暫時停止可能衝突的連線後再試，不要直接重設所有系統設定。若裝置由公司或學校管理，相關限制可能受管理政策影響，請依裝置允許的方式處理。

狀態維持開啟，只代表本機已建立連線流程，不表示所有遠端網站都能正常瀏覽。接著進行下一步驗證，暫時不必啟用 On Demand。確認手動連線、斷線與重新連線都符合預期後，再視需要設定自動連線行為。

匯入後沒有項目：先檢查資料讀取

返回訂閱項目，確認連結完整，並確認複製的是訂閱內容入口，而不是服務商的帳戶網頁。接著確認既有服務是否可用，以及目前網路能否讀取該連結。連結請向你的服務商取得；若涉及伺服器端解析或帳號權限，應依原始資料核對，不要將含憑證的連結貼到公開討論區。

如果手動新增的項目沒有出現在 SERVER，請返回 Add Server，確認是否已儲存，以及必填欄位是否通過檢查。訂閱讀取失敗與伺服器連線失敗是不同環節：前者尚未取得伺服器項目，後者則是已有項目但無法完成測試或實際要求，處理順序也不同。

測試逾時：分辨測試方式與實際瀏覽

進入 Settings 查看 Test Method，確認目前採用的測試方式。不同方式測量的環節不同，結果不宜直接比較；請先固定一種方式，再對同一項目重複測試。如果實際瀏覽正常，但某種測試一直失敗，可進一步檢查測試目標及該方式適用的網路條件。

實際要求也失敗時，再核對 Type、Host、Port、Password 或該協定對應的驗證欄位，以及服務商要求的 TLS 和傳輸參數。切換 Wi-Fi 與行動網路進行比對，有助判斷問題是否與目前的網路連線有關；比對前後請保持伺服器和 Global Routing 不變。

部分應用程式無法使用：檢查模式與命中規則

先確認沒有誤選 Direct，再檢查 Config 目前使用的檔案。特定網域被 REJECT、較寬泛的規則提前命中，或 FINAL 指向不符合預期的策略，都可能造成部分連線失敗。遇到瀏覽異常時，不要立刻修改所有 DNS 與協定參數；先透過連線記錄確認失敗的要求實際送往何處。

如果需要修改設定，請先儲存副本，再只調整一條與問題相關的規則，並重新發出要求驗證。若涉及網域解析、IP 規則與協定細節，請繼續參閱設定欄位參考；要依具體錯誤狀況尋找處理方式，請前往常見問題。

自動連線異常：最後再檢查 On Demand

Settings 中的 On Demand 用來依條件觸發連線，不是修復伺服器可用性的開關。基本連線尚未確認前，請先用手動開關驗證。如果斷線後系統又自動連線，請檢查既有的 On Demand 設定及裝置 VPN 管理狀態，再決定是否調整。調整後，分別測試開啟應用程式、切換網路與手動斷線時的行為。

如需進一步排查，可查看 Diagnostics。分享診斷資料前，請確認內容是否包含伺服器位址、驗證資料、訂閱連結或存取記錄，並移除敏感資訊。保留問題發生時的模式、網路類型與錯誤狀況，通常比只說一句「無法連線」更有助於縮小排查範圍。