官方手冊 · 依概念查閱

Shadowrocket 術語表

辨別介面入口、連線協定與規則動作。每個詞條都有獨立錨點,可對照設定或記錄排查位置;需要操作步驟時,再前往教學或伺服器管理章節。

01 · 設定層級

介面與開關

先確認全域模式,再檢查單一規則;開關、解析與改寫分別處理不同問題。

Global Routing

決定整體流量處理方式的入口,常見模式有設定檔 Config、代理 Proxy、直連 Direct,另有依場景設定運作的 Scene。模式會影響目前設定檔中的規則是否參與判斷,因此排查分流前應先確認這裡的選項。此處不會新增伺服器,也不代表連線開關已開啟。

Config / Proxy / Direct / Scene

Config

在 Global Routing 中,表示依目前設定檔規則處理流量,而非讓所有請求都走同一條路徑。在設定管理情境中,則可指設定檔入口或相關內容。看到「切換 Config」的說明時,請依所在頁面判斷是切換模式,還是選擇另一個設定檔。

模式名稱 ≠ 設定檔本身

Proxy

在 Global Routing 中,表示透過代理路徑處理相關流量;實際連線仍取決於所選伺服器及其參數。可暫時切換至此模式縮小排查範圍,確認問題是否與規則選擇有關。切換至 Proxy 無法修復失效的伺服器、錯誤密碼或無法建立的傳輸連線。

先確認伺服器,再判斷路由

Direct

在 Global Routing 中,表示直接連線,不會將相關請求交由遠端代理伺服器處理。可用來比較原始網路與代理路徑的狀況,但不等於關閉應用程式或移除系統 VPN 設定。若要結束連線,應檢查連線開關及 On Demand,不要只憑模式名稱判斷。

注意 Direct 與規則動作 DIRECT 的大小寫

Scene

依已設定的場景條件選擇相應處理方式,例如在不同網路環境採用不同安排。此功能處理的是場景層級,與 DOMAIN 這類針對單一請求的比對規則不同。使用前請先確認現有場景的條件與結果,避免將切換場景誤認為伺服器已自動修復。

場景條件 → 相應處理方式

On Demand

運用系統的隨選機制,依網路條件啟動或維持連線,可分別設定 Wi-Fi 與行動網路。此功能控制何時連線,不決定各網域應直連或使用代理。手動關閉後又重新連線時,請先檢查此項及系統相關設定,不必反覆刪除伺服器記錄。

連線時機 ≠ 請求分流

DNS

負責將網域名稱解析為 IP 位址,是建立連線前常見的環節。解析成功不代表伺服器驗證成功;解析異常也無法只靠更換規則動作解決。排查時請記錄查詢的網域、使用的解析設定及回傳結果,再搭配連線記錄判斷問題所在層級。

網域名稱 → IP 位址

URL Rewrite

依比對運算式改寫請求 URL 或執行其他指定處理,與決定連線路徑的規則分流不同。修改時需了解比對範圍與目標網址;範圍過廣的運算式可能影響原本正常的請求。HTTPS 請求可處理的範圍也受加密可見性及相關設定限制,並非新增運算式就一定生效。

先確認比對條件,再確認處理限制

各項設定的關係請見功能介紹;首次連線步驟請見教學。

02 · 連線方式

協定

協定名稱決定欄位的意義。名稱相似或連接埠相同,都不代表參數可以互換。

Shadowsocks

透過伺服器位址、連接埠、加密方式及密碼等參數建立連線的代理協定。加密方式必須與伺服器端一致,即使位址和密碼正確,連線仍可能失敗。匯入以 ss:// 開頭的分享文字後,也應檢查欄位,不能把連結前綴當成可用證明。

位址 / 連接埠 / 加密方式 / 密碼

VMess

使用使用者識別碼等參數驗證身分的代理協定,常見記錄還包含傳輸方式與 TLS 設定。匯入後也要檢查主機名稱、路徑等傳輸相關欄位。系統時間明顯不準也可能影響驗證,因此排查時不能只注意伺服器連接埠。

分別確認協定參數與傳輸參數

VLESS

使用使用者識別碼的代理協定,與 VMess 類型不同,不能只修改類型名稱就沿用所有參數。協定本身不負責傳輸加密,請確認伺服器實際要求的安全傳輸方式。既有分享連結中的傳輸方式、主機名稱及其他附加欄位也應完整保留。

使用者識別碼 / 傳輸 / 安全設定

Trojan

通常搭配 TLS 使用,並透過密碼驗證連線的代理協定。伺服器位址、憑證對應的主機名稱及密碼各有不同用途,不能互相取代。遇到憑證錯誤時,請先確認主機名稱、裝置時間與憑證狀態,不應將略過驗證當成一般修復方式。

分別確認驗證是否成功及憑證是否有效

Hysteria2

以 QUIC 為基礎的代理協定,連線需要網路具備相應的 UDP 連線條件。協定版本及驗證等參數必須與伺服器相符,不能因名稱相似就混用。網路限制 UDP、伺服器設定錯誤或憑證異常,都可能導致連線無法建立;不能只憑網頁無法開啟就判定原因。

QUIC / UDP

WireGuard

透過公私鑰配對及對端參數建立通道的協定,通常需要填寫金鑰、端點及通道位址等資訊。欄位結構與「位址加密碼」的記錄不同,應依既有設定逐項填寫。私鑰屬於敏感資料,整理設定、備份或提交問題記錄時都應避免公開。

Private Key 請妥善保密

HTTP / SOCKS5

這是兩種代理協定;HTTP 代理與 SOCKS5 使用不同的交握方式,不能只因連接埠相同就互換類型。是否需要使用者名稱、密碼及是否支援 UDP,應以既有伺服器的實際功能為準。代理協定名稱本身也不代表傳輸已加密,需另外確認安全傳輸條件。

協定類型 ≠ 連接埠編號
03 · 比對與動作

規則關鍵字

在 Config 模式下,規則通常由上而下檢查,第一條命中的規則會決定處理動作。以下 example.com 僅為語法範例。

DOMAIN

依完整網域名稱比對,適合只處理特定主機名稱的情況。請填入網域名稱本身,不要加上網址協定、路徑或查詢參數。比對 example.com 不代表同時比對所有子網域;若要涵蓋網域後綴範圍,請檢查 DOMAIN-SUFFIX。

DOMAIN,example.com,DIRECT

DOMAIN-SUFFIX

依網域名稱後綴比對,可涵蓋指定網域及其子網域,適合同一網域範圍採用一致處理方式。這不是在任意位置搜尋字串,也不會依網頁 URL 路徑比對。新增後請確認與前方較精確規則的順序,避免例外規則被較早的規則攔截。

DOMAIN-SUFFIX,example.com,PROXY

DOMAIN-KEYWORD

檢查網域名稱是否包含指定字串,比對範圍通常比完整網域及後綴規則更廣。較短的字串可能同時命中多個無關網域,請在記錄中確認實際命中的項目。若能精確描述目標範圍,優先使用更具體的比對方式,方便日後維護。

DOMAIN-KEYWORD,example,DIRECT

GEOIP

依目標 IP 在地理資料庫中的分類比對,而非依網頁語言、網域後綴或使用者所在地判斷。網域連線可能需要先取得解析結果,資料庫內容也可能與實際網路部署不同。使用這類規則時,請搭配目標 IP 與命中記錄核對,不要只憑網站名稱推測。

GEOIP,CN,DIRECT

IP-CIDR / IP-CIDR6

分別用於比對 IPv4 與 IPv6 網段,斜線後的數字表示網路前綴長度。這是位址範圍,不是連接埠,也不是網域後綴。只設定 IPv4 規則不會自動涵蓋相應服務的 IPv6 連線,因此排查雙堆疊網路時應同時檢查兩類目標位址。

IP-CIDR,192.0.2.0/24,DIRECT

FINAL

用來處理前面所有規則都未命中的連線,是規則清單的備援項目,通常放在末尾。其動作會決定未分類流量的去向,修改後影響範圍可能很大。若預期的精確規則未命中,請先確認網域、規則順序及目前模式,不要只修改 FINAL。

FINAL,PROXY

PROXY / DIRECT / REJECT

這是規則命中後的處理方式,分別表示使用代理、直接連線及拒絕連線,不是三種比對條件。請將大寫關鍵字與介面中的 Proxy、Direct 模式名稱區分。記錄顯示 REJECT 時,連線失敗可能正是規則指定的結果,請先確認是否命中預期項目。

比對條件 → 處理方式

規則看似未生效時,請先查看規則與故障排除問答,再修改設定。

04 · 資料管理

訂閱與設定

訂閱用於維護遠端記錄,設定檔用於管理處理邏輯;兩者不是同一種檔案。

Subscribe

用來匯入及更新既有訂閱,內容由訂閱網址所連線的伺服器提供。更新成功只表示用戶端已取得並處理回應,不代表其中每筆伺服器記錄都能連線。訂閱連結可能包含帳號憑證,分享截圖、提交記錄或整理筆記時,請遮蔽完整網址。

匯入後確認筆數、名稱與連線結果

Add Server

手動新增伺服器記錄的入口,需依既有伺服器資訊選擇協定,再填寫對應欄位。不同類型的密碼、使用者識別碼、金鑰及傳輸設定不可混用。儲存只會將參數寫入本機清單;要確認是否可用,還需選取該記錄並進行連線測試。

先選擇協定,再填寫欄位

Connectivity Test 與延遲

用來檢查測試目標是否可連線,並依測試方式回報所需時間。耗時會受測試目標、網路路徑及測試方法影響,不等於頻寬,也不代表所有網站的連線體驗。比較記錄時應盡量使用相同條件;若逾時,則需進一步判斷是解析、交握還是目標回應出了問題。

測試耗時 ≠ 下載速度

設定檔

用來管理規則、DNS 及其他設定,作用不同於只包含伺服器記錄的訂閱。下載或編輯設定檔後,也要確認目前使用的是哪一份,以及 Global Routing 是否設為 Config。修改前建議保留可還原的副本,並分次調整,以免多項變更同時進行而難以找出原因。

編輯 → 選擇使用 → 確認命中

匯入、更新、整理與備份的完整步驟,請參閱伺服器管理手冊。

05 · 裝置與授權

安裝與系統權限

處理器架構、應用程式取得記錄與網路授權各自管理,不可互相取代。

VPN 設定

系統用來授權應用程式接管相關網路流量的設定記錄,並非遠端伺服器資料。首次連線出現新增提示時,請確認操作是由剛開啟的 Shadowrocket 發起,再依系統要求授權。刪除這筆記錄可能使下次連線時需要重新新增,但不會因此修復錯誤的伺服器密碼。

分別檢查系統授權與伺服器驗證

Apple 晶片 / Intel / arm64

這些名稱用來區分處理器架構,影響應選擇哪一種安裝檔,並非不同的代理模式。Mac 可在「關於這台 Mac」確認晶片或處理器資訊,再選擇 Apple 晶片版或 Intel 版;Android 安裝檔中的 arm64 也代表架構。各平台安裝後若出現首次執行提示,請依下載頁的允許執行說明處理。

已購項目

App Store 中與購買帳號連結的應用程式記錄;更換裝置或重新安裝時,可使用原購買帳號搜尋並重新下載。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac / Windows / Android / Linux 版免費,後者由本站提供。請確認商店頁面的開發者為 Shadow Launch Technology Limited,應用程式 ID 為 932747118;系統需求以 App Store 頁面標示為準。

系統允許執行

作業系統對應用程式首次執行或安裝來源的確認,與 VPN 設定授權是兩回事。確認來源為本站後,Windows 可在 SmartScreen 的「其他資訊」中查看「仍要執行」,macOS 可在「隱私權與安全性」查看「仍要打開」,Android 則可允許執行安裝程式的應用程式安裝未知應用程式。若系統沒有提供允許執行的選項,請保留提示並檢查裝置管理限制,不要關閉整體防護。