Shadowrocket
匯入與連線教學

Add Server / Subscribe：新增與匯入

開啟 Shadowrocket 後先停留在 Home，暫時保持連線開關關閉。接著只需選擇一種輸入方式：手邊有訂閱連結，就使用 Subscribe；手邊有伺服器位址、連接埠與驗證參數，就在 Add Server 中手動填寫。兩種方式的目標相同，都是讓 Home 中出現可供選擇的伺服器，首次連線不需要同時完成兩種操作。

已有訂閱連結：在 Subscribe 中儲存 URL

在 Home 點選右上角的加號進入 Add Server，開啟 Type 選項並選擇 Subscribe。返回填寫頁面後，將自己的訂閱連結完整貼到 URL 欄位；如需填寫備註，使用容易辨認的名稱即可。儲存前請檢查連結開頭、結尾和查詢參數是否遭聊天軟體或複製操作截斷，尤其不要一併貼入連結說明文字、空格或換行。

儲存後返回 Home，等待訂閱內容讀取完成。出現訂閱群組及其中的伺服器項目，才表示已取得可供選擇的內容；若只有群組名稱卻沒有伺服器，請勿立即開啟連線開關。先檢查網路能否連線至訂閱位址，再確認連結是否仍有效。訂閱 URL 可能包含個人存取憑證，請勿將完整位址放入公開截圖或故障排查紀錄。

訂閱用於批次提供伺服器資訊，並不等同完整的規則設定檔。匯入成功後，仍須在下一步確認 Global Routing。之後更新訂閱可能會改變清單內容，因此首次測試時請先記下所選項目的名稱，更新後再確認它是否仍存在，避免將清單變化誤認為連線開關失效。

已有伺服器參數：依協定填寫 Add Server

若沒有訂閱，但已有單台伺服器資訊，同樣從 Home 的加號進入 Add Server，在 Type 中選擇資訊提供者註明的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan。接著逐項填寫位址、連接埠及該協定要求的驗證資訊。介面中的密碼、識別碼、加密方式和傳輸選項並非可互換的欄位，不能照著其他協定的說明猜填。

位址欄填入提供的主機名稱或 IP，請勿自行增加網頁路徑；連接埠也必須使用對應服務的數值。涉及 TLS、SNI 或傳輸參數時，請依既有資料逐字確認；留白與填入特定值可能會產生不同結果。資料缺漏時，請先向自己的服務提供者確認，不要把多個來源的參數拼成一筆記錄。

儲存並返回 Home 後，檢查項目名稱和協定是否符合預期。此時請先不要批次修改伺服器參數：清單中看得到項目，只表示資訊已儲存，尚未證明伺服器可連線。接著進入 Global Routing，確認本次連線採用的路徑，再進行連線測試。更多匯入格式問題請見FAQ。

Global Routing：選擇路由模式

伺服器出現在 Home 後，找到並開啟 Global Routing。這裡決定請求如何處理，不會修正伺服器位址或驗證參數。首次操作請先了解三種模式：設定檔(Config)、代理(Proxy)、直連(Direct)。它們適用於不同的驗證目的；選擇其中一項後返回 Home，再繼續連線。測試前請勿來回切換。

設定檔(Config)：依目前設定檔中的規則分流

日常需要依規則分流時，請選擇設定檔(Config)。接著前往 Config 頁面檢查目前選取的設定檔，確認它確實是自己準備使用的檔案，而不只是出現在檔案清單中。設定檔可為不同請求指定不同策略；因此，在 Config 下開啟某個網頁，不能單憑網頁是否成功就判斷預設伺服器是否有被使用。

如果還沒有準備規則設定檔，不必為了首次驗證而臨時抄入一大段規則。先使用下一項代理(Proxy)確認伺服器與連線流程，成功後再回到 Config 學習分流。設定檔匯入、選取和規則順序屬於另一層問題，詳細內容可繼續閱讀疑難手冊，本頁不要求先完成複雜設定。

代理(Proxy)：先驗證代理路徑

首次檢查既有伺服器能否運作時，可以選擇代理(Proxy)，減少規則分流對判斷的影響。這裡的「代理」指 Global Routing 的路由模式，不是新增伺服器的入口；仍須在 Home 選擇一台既有伺服器，再開啟開關。Proxy 不代表能自動修復失效的線路，也不表示裝置上的每種流量都必然採用完全相同的處理方式。

直連(Direct)：建立本機網路對照

直連(Direct)用於觀察不經代理伺服器時的連線結果。若 Direct 能開啟某個常用網頁，而 Proxy 不能，表示應優先檢查伺服器及代理路徑；若兩者都失敗，則先檢查裝置本身的 Wi-Fi、行動網路或網頁服務狀態。Direct 下能上網不代表代理伺服器已可使用，測試結束後請主動切回原本要使用的模式。

完成選擇後，請記住目前模式。之後每次驗證，都應一併記錄「使用哪台伺服器」和「目前是哪種 Global Routing 模式」，才能比較結果。只記得開關已開啟，往往無法區分伺服器問題與分流問題。

Home：選擇伺服器並開啟開關

返回 Home，在伺服器清單中選擇剛才確認過的項目。點選伺服器左側的圓形選取區域，確認選取標記位於目標項目上；不要把進入編輯頁面誤認為已切換預設伺服器。若訂閱中有多個名稱相似的項目，首次請只選定一台進行測試，避免每次操作都更換伺服器，最後無法判斷究竟是哪項變更生效。

確認伺服器和 Global Routing 後，開啟 Home 頂端的連線開關。首次使用時，系統可能會跳出新增 VPN 設定的確認視窗，請依照提示允許，並使用裝置要求的驗證方式確認。此授權用於建立系統網路連線，不是訂閱匯入成功的提示；若取消，返回客戶端時開關可能無法保持開啟，需重新發起連線並完成系統確認。

完成授權後返回 Shadowrocket，確認開關和連線狀態是否維持開啟。系統狀態列或控制中心中的 VPN 狀態可作為輔助資訊，但只能說明系統連線狀態，不能單獨證明所選伺服器能正常開啟網頁。此時請先保留目前設定，進入下一步執行 Connectivity Test，不要因為看到 VPN 標示就跳過驗證。

如果開關剛開啟就關閉，請先確認系統授權是否已完成，以及裝置上是否有另一個正在運作的 VPN 連線。由學校或單位管理的裝置也可能有網路設定限制，請依裝置管理規定處理，不要反覆刪除管理設定。若需要修改目前的伺服器參數，建議先關閉連線，儲存變更後再重新開啟，以免混淆修改前後的狀態。

iPad 的可用空間較大，部分頁面可能以分欄方式顯示。操作順序仍是透過 Home 選擇伺服器、透過 Global Routing 選擇模式，再開啟頂端開關連線；不要因為左側仍顯示清單，就重複新增同一台伺服器。確認本次使用的項目後，再繼續檢查實際連線。

Connectivity Test：確認是否生效

開啟連線後，在 Home 找到 Connectivity Test，執行測試並查看目前伺服器對應的結果。測試需要等待結果返回，剛點下去時的空白或進行中狀態不應直接視為失敗。若結果逾時，先保持伺服器和模式不變，再測試一次；持續逾時才進入下一步排查，請勿依據瞬間狀態下結論。

Connectivity Test 用於檢查測試目標的連線狀況。測試成功表示這個測試有回應，不代表所有網站、所有協定或持續傳輸都已正常；顯示的時間也不等於實際下載速度。首次使用無須反覆比較數字，先穩定驗證一條路徑，比只看某個測試結果更有意義。

再用瀏覽器驗證實際請求

保持 Shadowrocket 連線開啟，切換至瀏覽器，開啟一個平時使用且能確認服務正常的網頁。盡量新開頁面並重新整理，不要只看已載入的內容，因為即使網路已變化，快取頁面仍可能顯示。接著再開啟另一個不同的網頁，判斷問題是只出現在單一網站，還是所有新請求都失敗。

如果正在使用設定檔(Config)，還應檢查目標請求是否依預期分流。可搭配客戶端的請求記錄，確認目標網域和處理策略；不同規則可能讓兩個網頁走不同路徑，因此其中一個網頁開啟成功，不能取代另一條路徑的驗證。若暫時不熟悉記錄內容，先用代理(Proxy)重新測試同一個網頁，再返回 Config 對照，將範圍縮小至規則層面。

留下可重現的最少紀錄

一次有效的驗證應能回答四件事：選擇的是哪台伺服器、Global Routing 選的是哪個模式、Connectivity Test 回傳什麼結果，以及實際網頁能否載入。可以在本機記下項目備註和結果，但不要記錄完整訂閱連結、密碼或驗證內容。之後若要排查，請繼續使用同一個網頁作為對照，避免測試目標變動影響判斷。

測試正常且網頁表現符合預期，即可完成首次連線流程。之後若要切換至設定檔(Config)進行日常分流，切換後再做一次相同驗證即可。不要把單次測試成功當成日後無須檢查的保證；網路環境、訂閱內容或設定檔變更時，仍應依相同順序重新測試。

常見失敗原因：每次檢查一項

遇到問題時，從最早未完成的步驟開始回查，而不是一次重設所有設定。清單沒有內容屬於匯入問題，開關無法維持開啟屬於連線建立問題，測試逾時屬於連線能力問題，測試有回應但網頁失敗則須繼續區分模式、DNS 和目標服務。請依下列順序處理，每次變更後都回到同一個測試目標驗證。

匯入後沒有伺服器：先檢查輸入內容與訂閱回應

返回 Add Server 中儲存的訂閱記錄，檢查 Type 是否為 Subscribe、URL 是否完整，以及參數之間的符號是否保持原樣。若誤將服務說明頁面的位址當成訂閱位址，即使儲存成功也不會取得有效的伺服器清單。裝置須先有可用的基本網路才能取得訂閱；請先確認一般網頁能開啟，再嘗試更新訂閱內容。

若連結已過期、權限已變更或回傳內容不符預期，請向自己的服務提供者確認既有連結狀態。不要為了排查而將完整 URL 貼到公開頁面，也不要反覆建立多個相同群組。儲存一筆已確認的記錄並查看更新結果，通常更容易找出錯誤。

Connectivity Test 持續逾時：回頭檢查伺服器參數

手動輸入的項目，請先檢查位址、連接埠和驗證欄位，再檢查協定對應的傳輸設定。對照原始資料時請逐項確認，不要只看備註名稱；備註相同也可能指向不同連接埠。既有訂閱中的項目可以先更新一次，再選擇自己清單中的另一台伺服器進行對照。如果只有某一台持續失敗，請優先檢查該項目的服務狀態。

同時留意目前的網路環境。從 Wi-Fi 切換至行動網路後結果不同，表示網路路徑可能與問題有關，但仍須保持相同伺服器、相同模式和相同測試目標才能比較。沒有依據時，請勿同時更換協定、伺服器和 DNS，否則很難解釋成功或失敗的原因。

測試有回應但網頁失敗：確認模式與 DNS

先返回 Home 查看 Global Routing，排除誤停留在直連(Direct)的情況。若代理(Proxy)可用而設定檔(Config)失敗，請前往 Config 確認目前使用的檔案，再檢查目標請求命中的規則與策略；此時不應優先修改伺服器密碼。如果只有一個網頁失敗，也應先確認網頁本身是否正常，而不是據此判定整個連線無法使用。

DNS 排查應在取得對照結果後進行。先儲存原設定，查看目前 Config 的 DNS 設定，確認解析路徑是否符合預期。不要從不明來源複製一組位址來取代所有設定，也不要同時修改系統網路與客戶端設定。更多網域解析、規則順序和網路切換問題，請見DNS 問題排查。

若依照本頁步驟仍無法恢復連線，可前往FAQ依症狀繼續查找，或閱讀疑難手冊中的系統化流程。描述問題時只需提供必要資訊：裝置類型、發生失敗的步驟、Global Routing 選項，以及移除敏感內容後的錯誤文字。保留原有設定的副本，能讓後續檢查與還原更容易。