Shadowrocket 匯入與連線教學

開啟 Shadowrocket，進入 Home，找到 SERVER 分組附近的 Add Server 入口；部分介面也可透過右上角的新增按鈕進入。開啟後先查看 Type，不要直接填寫 Host。Type 會決定後續欄位的用途，同一組位址和密碼不能任意套用至其他協定。輸入前，請確認取得的是訂閱連結、單一伺服器參數，還是單筆伺服器分享連結，這三種資料的匯入方式不同。

已有訂閱連結：在 Type 選擇 Subscribe

1. 複製自己持有的完整訂閱連結，返回 Add Server，並在 Type 選擇 Subscribe。
2. 將連結貼到該類型的 URL 欄位；若有備註欄位，可填寫方便辨識用途的名稱。請勿將完整訂閱連結拆成 Host 和 Port，也不要刪除連結中的查詢參數。
3. 確認貼上的內容沒有混入說明文字、空格或換行，再使用頁面右上角的儲存功能，等待訂閱內容載入。
4. 返回 Home，確認訂閱分組及其伺服器項目已顯示，並選取其中一個目標項目。若只看到分組名稱而沒有伺服器，表示匯入尚未完成。

Subscribe 的用途是讀取連結所回傳的伺服器資料，並非取得連線服務。連結可能包含個人存取憑證，不應貼到公開聊天室、截圖或故障排除紀錄中。若回傳內容是登入頁面、提示頁面，或格式與應用程式不相容，即使儲存連結也不會出現可選伺服器；此時應確認原始資料，而非一再新增相同分組。

已有伺服器資料：依照對應的 Type 手動填寫

一樣從 Add Server 進入，並在 Type 選擇資料明確標示的類型。Host 填寫伺服器網域名稱或位址，Port 填寫連接埠；Password、Method 或其他驗證欄位，請依該類型顯示的項目逐一填寫。官方配圖展示的是包含 Password 與 Method 的欄位組合，不代表所有 Type 都使用相同欄位。若看到 UUID、TLS、Server Name 或傳輸選項，請逐一對照自己的原始資料，不要只因名稱相似就自行推測。

手動輸入完成後儲存，返回 Home 查看新增項目並點選。若有自己的 QR code，可使用 Scan QR Code，掃描後確認 Type、位址與驗證資料。Import from Cloud JSON 是讀取相容 JSON 資料的另一個入口，不適用於任意訂閱連結。剪貼簿或分享連結的完整格式、訂閱更新與分組整理方式，請參閱訂閱與伺服器管理手冊。

儲存伺服器後返回 Home，點開 Global Routing。入門時先分辨三種模式：設定（Config）／代理（Proxy）／直連（Direct）。此處的選擇會改變請求的處理路徑，並非測試伺服器速度，也不會取代剛才填寫的驗證資料。為方便排查，請先記下目前選項，再依用途選擇；尚未確認伺服器可用前，不要同時更換多份設定。

使用 Config 前，先確認目前使用哪一份設定

若已有經自己確認的設定檔，請進入 Config，檢查目前選用的檔案。需要查看規則時，開啟該檔案的編輯入口，確認 General、Rule、Hosts 等區段；Rule 中的 Add Rule 可用來新增規則。配圖顯示的是設定檔編輯頁，不是 Home 上的 Global Routing 選擇頁，兩者用途不同：前者儲存設定內容，後者決定是否依設定執行。

首次連線不必急著新增規則。先查看現有規則是否指向已存在的目標，避免將規則中的策略名稱誤認為伺服器位址。以下是真實規則片段，可用來辨認語法，並非適用於所有網路環境的完整設定；example.com 是說明用網域，不是連線位址。

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

在這類規則語法中，DOMAIN-SUFFIX 用於比對網域後綴，DIRECT 代表直接連線，PROXY 代表交由代理處理，FINAL 則用於兜底。實際處理方式仍取決於完整設定與規則順序，因此不能只看最後一行就判定所有請求的路徑。若尚未理解現有設定，請先保留原始檔案，不要刪除 General 或批次覆寫 Rule。

若要暫時分辨「伺服器本身有問題」還是「分流結果不如預期」，可先記下原本選項，再切換至 Proxy 進行一次對照，完成後恢復原模式。模式適用範圍詳見代理模式說明；設定檔的儲存、整理與備份方式，請參閱訂閱手冊。本頁沿用已確認的模式，不深入說明整套規則編輯方式。

現在返回 Home，依序確認三處：SERVER 中是否已選取剛才儲存的目標、Global Routing 是否為預定使用的模式，以及頂端開關是否仍為未連線狀態。官方截圖中的 Not Connected 表示尚未連線，並非匯入失敗；即使清單中已有伺服器，應用程式也不會只因儲存項目就自動連線。

1. 確認目前資料與模式後，開啟 Home 頂端的連線開關。
2. 首次建立連線時，系統可能會提示新增 VPN 設定。請確認提示指向的應用程式確實是 Shadowrocket，並在了解此要求後確認。
3. 若系統要求裝置密碼或身分驗證，請依裝置上的提示完成；不要將裝置密碼填入 Add Server 的 Password 欄位。
4. 返回 Shadowrocket，查看頂端狀態是否從 Not Connected 轉為已連線，再進行下一步測試。

此系統授權可讓應用程式透過系統網路機制處理流量，不會修正錯誤的伺服器參數，也不會為訂閱增加可用內容。若拒絕授權，請返回應用程式重新嘗試連線並閱讀提示；若裝置受管理或系統有所限制，應先檢查裝置設定，不要反覆點擊開關試圖略過提示。

連線建立後，系統的 VPN 標示可作為通道已啟用的輔助資訊，但不保證目標服務可存取。伺服器驗證失敗、DNS 解析異常或目標服務本身故障，仍可能在開啟開關後發生。反之，若目前使用 Direct，也不能僅憑開關已開啟就推斷流量正經由所選代理伺服器；必須一併確認 Global Routing。

首次測試期間，建議維持目前網路，不要馬上從 Wi-Fi 切換至行動網路，也先不要設定 On Demand。這樣可減少變因，發生問題時較容易確認是匯入、授權還是連線後的階段出錯。需要停止時，請關閉 Home 頂端開關；若要修改 Type、連接埠等重要欄位，請先中斷連線、儲存，再重新連線。

若前四個步驟未達預期，先停止反覆刪除與重新匯入。記下故障發生的步驟、當時的 Global Routing、本地網路與錯誤提示。接著前往 Settings，查看 Test Method、On Demand 和 Diagnostics 等項目。這些功能分別用於測試、自動連線或診斷，並非能讓任何伺服器都變成可用連線的通用開關。

儲存 Subscribe 後沒有出現伺服器

先確認本地網路可正常連線，再檢查訂閱連結是否完整、是否已失效，以及回傳內容是否為相容的訂閱資料。有些連結包含查詢參數，複製時若遺漏後半段，回傳結果就會不同。若已有相同的訂閱分組，建議優先在原分組中更新，避免重複匯入造成清單混亂。請依自己現有的服務資料確認訂閱內容是否有效；更新入口與多個訂閱的整理方式，詳見訂閱手冊。

無法啟用連線，或啟用後立即中斷

返回第三步，確認已完成系統 VPN 設定授權，再確認 SERVER 中確實已選取目標伺服器。若開關短暫開啟後又關閉，請查看應用程式或系統顯示的具體提示，並檢查 Type、Host、Port 與驗證欄位。不要只因密碼看似正確就忽略協定類型；若資料要求 TLS 或特定傳輸欄位，也不能只填位址與連接埠就儲存。

測試有回應，但頁面仍無法載入

先確認使用的是哪種測試方式。Settings 的 Test Method 會影響測試結果的意義，不能將結果視為完整存取能力的保證。接著依第四步，使用同一個目標比較 Config 與 Proxy，並檢查目前規則是否將請求交給有效目標。若只有網域請求失敗，請根據具體錯誤檢查 DNS；不要在未記錄原始設定的情況下同時更換多個 DNS 位址，也不要只因頁面出現憑證提示就隨意啟用 HTTPS Decryption。

切換網路或返回前景後，狀態不如預期

先手動關閉連線，再於目前網路重新開啟並測試，確認基本連線是否穩定。若已設定 On Demand，請檢查觸發條件是否符合目前網路環境。On Demand 用於依條件觸發連線，無法修復失效的訂閱或錯誤的驗證資料；首次連線尚未成功時，請先維持手動連線，完成基本測試後再單獨設定。

需要繼續排查時，保留必要的最少紀錄

可透過目前介面提供的 Diagnostics 入口查看診斷資訊，並記錄故障時間與目標請求的狀況。診斷內容可能包含目標網域、伺服器位址或個人資料，分享前請檢查並隱藏訂閱連結、密碼與驗證資訊。保留修改前的設定，每次只調整一項，再以相同目標重新測試；若修改後沒有改善，請還原原值，避免長期累積臨時變更。

完成入門操作後，日常使用只需確認訂閱內容有效、SERVER 選擇正確、Global Routing 符合用途，並在需要時開啟連線。更詳細的錯誤分類請參閱常見問題；需要管理多份訂閱、伺服器與備份時，再閱讀訂閱管理完整手冊，首次連線時無須一次設定所有進階選項。