官方手冊 · 首次連線

Shadowrocket 使用教學

匯入既有訂閱、選擇 Global Routing 並驗證連線。依五個步驟完成首次檢查，再調整規則細節。

操作前提：已安裝 App，並備妥自己的連線資料
本教學假設你已從 App Store 安裝 Shadowrocket，並備有自己的訂閱連結或伺服器資料。本網站不提供、不販售，也不推薦節點或訂閱。客戶端一次性買斷 ≠ 線路方案；購買 App 與備妥連線資料是兩回事。

尚未安裝時，請先閱讀App Store 正版核驗與購買說明。iPhone 與 iPad 的系統需求以 App Store 頁面標示為準。以下保留英文介面用語，實際位置可能因介面配置而異，請依對應名稱辨識。

先確認輸入資料
再選擇流量策略
最後核對實際請求

01 / INPUT

新增伺服器或匯入訂閱

先確認手邊資料屬於哪一種類型：單一伺服器參數、單一伺服器分享內容，或用於更新一組伺服器的訂閱連結。這三種資料不能只憑外觀互換。訂閱通常是一個網址，客戶端需要連線取得清單；伺服器參數則直接描述連線目標。開始前請保留原始資料，不要先刪除網址中的參數，也不要把設定檔網址填入伺服器地址欄位。

Add Server：手動填入既有資料

開啟 Shadowrocket 的 Home，在 SERVER 區域找到 Add Server，進入新增頁面。先選擇 Type，再依該協定填寫欄位。右側官方截圖展示的是包含 Host、Port、Password、Method 的表單；並非每種 Type 都需要相同欄位。以 Shadowsocks 為例，請逐項填入既有的地址、連接埠、密碼與 Method；選擇其他協定時，則依目前表單及原始資料核對，不要照搬截圖中的欄位組合。

Host 填入伺服器地址或網域名稱，不要將包含完整路徑的訂閱連結貼入此欄位；Port 填入連接埠數值，並檢查複製時是否帶入空格。密碼、識別資料及加密選項都要完整保留，尤其注意大小寫。填妥後使用頁面上的儲存功能，返回 Home，確認剛新增的項目已出現在 SERVER 中。清單中出現名稱只代表資料已儲存，尚不能證明伺服器可以連線。

Scan QR Code 與 Subscribe：依內容類型匯入

如果已有 QR Code，請在 Add Server 中使用 Scan QR Code；系統要求相機權限時，依需要授權。掃描後先查看辨識出的 Type 與伺服器欄位，再儲存。QR Code 只是承載資料的方式，不保證內容一定是單一伺服器，也不保證其中的網址仍有效。若結果不如預期，請回頭核對原始資料，不要反覆儲存以免產生重複項目。

如果已有訂閱連結，請使用與內容類型相符的 Subscribe 入口。Config 頁面的 Subscribe 用於相應的遠端設定檔訂閱；用來產生 SERVER 清單的伺服器訂閱，則應在新增入口依訂閱類型匯入。不要因為兩者都是以網址開頭就混用。貼上時保留完整查詢參數，移除前後空白，並確認沒有連同說明文字一起複製。匯入後返回 Home 查看伺服器清單；匯入設定檔後則前往 Config 確認檔案已儲存。

剪貼簿辨識到分享內容時，也要先確認類型再接受匯入。Import from Cloud JSON 適用於相應格式的資料，並非通用的訂閱連結入口。完成這個階段後，只保留本次準備測試的明確項目，先不要同時調整大量伺服器或規則。更多入口差異請參閱訂閱匯入四種入口說明。

Shadowrocket 的 Add Server 頁面，顯示 Type、Host、Port、Password、Method，以及 Scan QR Code 和 Import from Cloud JSON 入口 — Add Server：先選擇 Type，再核對相應欄位。截圖中的欄位並非適用於所有協定。

02 / ROUTING

選擇 Global Routing

伺服器儲存後，下一步不是立刻修改規則，而是先決定流量要如何選擇策略。返回 Home，開啟 Global Routing，查看目前選取的模式。這裡有三個選項：設定檔 (Config)、代理 (Proxy)、直連 (Direct)。它們決定流量的整體處理方式，與 SERVER 中選取哪台伺服器是不同設定：前者決定如何分配請求，後者提供可用的連線目標。

設定檔 (Config)：依目前規則處理

若要指定網站使用代理、其他請求則直連，請選擇設定檔 (Config)，並前往 Config 確認目前使用的設定檔。開啟該檔案後，可看到 General、Rule、Hosts、URL Rewrite 等區段；先檢查 Rule，不要順手啟用與首次連線無關的功能。規則通常依由上而下的順序檢查，先符合的項目會決定策略，因此相同網域相關規則的位置會影響結果。

以下僅示範規則結構，並非可直接套用於所有環境的完整設定。example.com 是教學用網域，使用前應替換為確實需要處理的目標；PROXY 也必須在目前設定中有相應的可用策略。第一行處理該網域及其子網域，最後一行則為未匹配的請求指定 DIRECT。編輯前先備份現有設定，使用 Add Rule 時也要核對插入位置，而不只檢查關鍵字拼法。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理 (Proxy) 與直連 (Direct)：明確指定處理方向

代理 (Proxy) 會將適用流量交由代理策略處理，適合暫時用來確認已選伺服器是否能承載請求；直連 (Direct) 則讓適用流量直接連線，不應將其視為代理已生效的證據。進行對照時，先記下原本的選項，只切換 Global Routing，再造訪同一個目標。測試結束後，恢復預計長期使用的模式，避免忘記切回而誤以為規則失效。

首次操作只要分清「模式」與「伺服器」，不必立刻撰寫複雜設定。若已有可信且符合自身用途的設定檔，先使用並確認選取狀態；若要進一步了解 DOMAIN、GEOIP、IP-CIDR 與 FINAL 的適用範圍，請前往規則手冊。完成此步驟時，應能說明目前選擇的模式，以及 Config 下正在使用的設定檔。

Shadowrocket 的 Config 設定檔編輯頁面，包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段及 Add Rule 入口 — Config：此處顯示設定檔內容；Global Routing 的選擇入口位於 Home。首次使用時，請優先核對 Rule。

03 / CONNECT

選擇伺服器並授權連線

確認模式後返回 Home，在 SERVER 清單中選擇本次要使用的伺服器。若清單來自訂閱，請先確認選取的是參數完整的實際項目，而不只是分組標題。首次驗證時盡量固定使用一台伺服器；連線期間頻繁更換項目，之後就很難判斷問題來自伺服器、規則或目前網路。

確認 Home 上的 Global Routing 與上一步相同，再操作頂端的連線開關。尚未連線時可能顯示 Not Connected；請以目前頁面顯示的狀態為準。首次建立連線時，系統會要求新增 VPN 設定。這是 Shadowrocket 接管裝置網路流量所需的系統授權，不是要你在表單中補填訂閱密碼。確認提示中的 App 來源後允許，並依系統要求完成裝置身分驗證。

如果先前拒絕授權，請回到 App 重新發起連線，並依系統提示檢查相關 VPN 設定。不要在提示視窗中反覆取消，再只憑開關位置判斷是否成功。完成授權後返回 Home，觀察連線狀態是否維持；若剛開啟就恢復未連線，請先停下來排查，不必繼續新增規則嘗試修復。若已建立連線，請進入下一步，以實際請求驗證轉送結果。

請特別區分兩件事：系統接受 VPN 設定，代表裝置允許客戶端處理相應流量；遠端伺服器能否成功連線，還取決於地址、連接埠、憑證、協定參數與目前網路。即使開關維持開啟，也可能只有直連請求正常，代理請求仍然失敗。因此，不應將系統顯示 VPN 標誌等同於所有目標都能依預期存取。

首次操作期間，先維持 On Demand 等自動連線條件不變，手動完成一次連線與中斷的完整流程。也應避免其他 VPN 設定同時爭用連線狀態。需要中斷時，返回 Home 關閉頂端開關，再確認狀態已改變。如此可確認目前是哪份設定在處理請求，也為下一步連線前後的比較建立清楚起點。

本步完成條件
Home 中已選定伺服器，Global Routing 符合預期，系統授權已完成，且連線狀態能維持。接著驗證請求，不要把「開關已開啟」當作最終結論。

Shadowrocket 的 Home 頁面，頂端為 Not Connected 開關，下方顯示 Global Routing 的 Config、Connectivity Test、SERVER 分組與 Add Server — Home：在同一頁核對伺服器、Global Routing 與連線狀態，再前往 Connectivity Test。

04 / CHECK

使用 Connectivity Test 進行驗證

連線維持後，在 Home 使用 Connectivity Test。測試前確認目前選取的仍是剛才使用的伺服器，並留意 Settings 中的 Test Method：不同測試方法觀察的層面不同。某項測試有結果，最多只能證明該項測試在當時條件下收到回應，不代表所有網站、協定或規則都正常；某項測試失敗，也不能直接推論所有實際請求都會失敗。

接著開啟瀏覽器，造訪一個預期會經由代理連線的目標，再造訪一個預期直連的目標。兩次都應發出新的請求，不要只查看已開啟的頁面，因為快取內容可能掩蓋目前連線的變化。若使用設定檔 (Config)，請檢查目標的實際請求是否符合預期規則，以及最終策略是否為 PROXY 或 DIRECT；若暫時使用代理 (Proxy)，則先確認經由所選代理策略的請求能否完成。

以下三項可作為最基本的驗收記錄。只要記下本次實際觀察到的結果，不必填入完整憑證，也不必收集一長串測試數值。三項結果彼此補充，不能以其中一項取代其他兩項。

檢查項目	操作	確認內容
連線狀態	返回 Home 查看開關與狀態	完成系統授權後，連線能維持
實際請求	造訪預期經由代理連線的目標	新請求可正常完成，而非只顯示快取內容
規則結果	查看相應的請求記錄	匹配規則與最終策略符合預期

如果頁面能開啟但策略不正確，優先檢查 Global Routing 與 Rule 順序，不要立刻更換伺服器。例如，較前面的寬泛規則若已匹配，後面的精確規則就不會再決定該請求。反過來說，若策略已是 PROXY 但連線失敗，則應檢查該策略所用的伺服器與協定參數，避免把連線問題誤判為網域規則問題。

完成後先中斷再重新連線，並再次驗證同一個目標，確認結果不是偶然來自舊連線。切換網路環境時也應重新檢查，尤其在更新訂閱或變更伺服器參數後。若要檢查更複雜的網域解析、策略引用與規則優先順序，請繼續閱讀規則與設定參考；本入門教學只要求先建立一條可重現的驗證流程。

05 / REVIEW

常見問題與排查順序

發生問題時，先判斷失敗是在匯入、建立連線，還是送出實際請求的階段。開啟 Settings，可看到 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等相關入口。這些設定各有用途，並非一組需要同時開啟的「修復開關」。先保留原設定，每次只變更一項，重新測試同一個目標後，再決定是否保留變更。

訂閱失敗：先檢查網址與回傳內容

若更新失敗，或匯入後沒有伺服器，請先回到原始資料確認連結是否完整，以及是否混入換行、空格或聊天文字。連結中的查詢參數可能用於識別訂閱，任意刪除可能導致無法取得內容。接著確認目前網路能否存取該訂閱網址，以及回傳內容是否為客戶端支援的資料，而非登入頁面、錯誤說明或網頁正文。若混用了設定檔訂閱與伺服器訂閱入口，也可能出現「已儲存但清單沒有變化」的情況。

不要為了反覆測試而刪除仍可用的舊項目。先記下錯誤提示，再向你現有連線資料的提供者確認網址狀態、內容格式與使用條件。訂閱連結通常包含個人存取憑證，不應貼到公開討論區，也不要在故障截圖中顯示完整網址。處理好匯入問題後，返回第一步檢查儲存結果，不要直接跳去修改 DNS。

開關自動關閉或請求失敗：分別檢查系統與伺服器

連線開關無法維持時，請檢查 VPN 授權是否完成、是否有其他 VPN 設定影響目前連線，並查看 App 顯示的錯誤訊息。若開關能維持但請求失敗，再核對 Host、Port、Type 及相應憑證。部分協定還需要額外的傳輸或 TLS 參數，必須與既有資料一致；地址與連接埠相同，並不代表設定完整。請先在相同伺服器與網路下重試，避免同時更換網路和參數。

若只有某個網域無法連線，而其他目標正常，請檢查相應規則與解析結果。不要先用涵蓋範圍過大的規則掩蓋問題，也不要在無法說明原因時啟用 HTTPS Decryption。首次連線通常不需要解密加密流量；誤改相關設定會增加變數，讓原本單純的伺服器連線問題更難排查。

測試失敗但仍可存取：檢查 Test Method

Connectivity Test 與瀏覽器存取不一定使用完全相同的請求方式。若實際瀏覽正常但測試失敗，先檢查 Test Method 與測試條件，不要只憑單次測試結果刪除伺服器。若網頁正常但某類 App 請求失敗，則要進一步區分 TCP、UDP、網域解析與伺服器端能力；不能由一種請求成功就推論其他類型也都受支援。

需要進一步定位時，可使用 Diagnostics；分享前請移除伺服器地址、訂閱參數、帳戶資料等敏感內容。On Demand 用於依條件觸發連線，無法修復無效憑證；請先確認手動連線與驗證都正常，再依使用情境設定自動行為。若仍不清楚 Settings 中各入口的用途，可參閱功能與設定說明。

保存一次成功的結果
匯入、連線與驗證都通過後，請保留目前設定的備份，並記下 Global Routing 與所用伺服器。之後修改規則時，以這份可重現的狀態作為比較基準；規則結構與備份注意事項請參閱規則手冊。