官方手冊 / 常見問題
Shadowrocket
常見問題
依取得方式、安裝、匯入及連線狀態找出問題。先核對目前使用的裝置與畫面提示,再逐項檢查;每次只變更一項設定,方便確認原因。
- 四類問題
- 介面用語保留英文
- 點選問題展開處理步驟
正版與購買
區分用戶端取得方式與伺服器使用權,再核對商店項目及購買紀錄。
電腦和 Android 可以使用 Shadowrocket 嗎?如何取得?
可以。iPhone / iPad 版可從 App Store 取得,價格為 $2.99,一次付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。請從本站下載頁選擇裝置,電腦與 Android 安裝檔由本站 /dl/shadowrocket/ 路徑提供。iPhone / iPad 的系統需求以 App Store 頁面標示為準;其他平台請確認下載頁上的架構與安裝說明。首次開啟若遇到系統攔截,請參考下方安裝問答。
iPad 可以安裝嗎?換機或重新安裝需要再買一次嗎?
iPad 可以安裝。iPhone / iPad 版在 App Store 售價 $2.99,一次付費,兩種裝置皆可使用;Mac、Windows、Android、Linux 版免費。換機或重新安裝時,請使用原購買時的 Apple ID,在 App Store 的已購項目或 App 清單中找到 Shadowrocket 並重新下載。如果仍顯示價格,請先確認登入帳號、購買紀錄及商店地區,不要急著重複付款;系統需求以 App Store 頁面標示為準。
在 App Store 搜尋不到 Shadowrocket,該先檢查什麼?
先確認搜尋字詞是 Shadowrocket,再檢查 Apple ID 的國家或地區。中國大陸的 App Store 未提供此 App;裝置系統語言與商店地區是不同的設定。可開啟本頁提供的 App Store 產品頁確認是否適用;如需更改地區,請在系統設定的 Apple 帳號中依序前往「媒體與購買項目」、「檢視帳號」及「國家或地區」,並閱讀官方更改地區的條件。帳戶餘額、訂閱及家庭共享狀態可能影響更改地區,單靠更改裝置語言無法解決。
如何確認 App Store 上的是正版項目?
請核對三項資訊:App 名稱 Shadowrocket、開發者 Shadow Launch Technology Limited,以及產品頁網址中的 App ID 932747118,並將圖示與本站頁首的官方圖示比對。iPhone / iPad 版在 App Store 售價 $2.99,一次付費;Mac、Windows、Android、Linux 版免費。其他平台的取得方式不適用於商店中名稱相同的項目。電腦與 Android 使用者請從本站下載頁前往本站安裝檔路徑,不要根據搜尋結果中的同名檔案判斷來源。
購買用戶端後,就有可用的伺服器嗎?
用戶端一次買斷 ≠ 連線方案。iPhone / iPad 版在 App Store 售價 $2.99,一次付費;Mac、Windows、Android、Linux 版免費。這些取得方式僅適用於用戶端本身,不包含伺服器使用權。連線前請準備自己已有的訂閱或伺服器資訊,並確認仍然有效。本站是 Shadowrocket 官網與官方手冊,不提供、不販售、不推薦節點或訂閱;手冊僅說明如何匯入、設定及排除既有資訊的問題。
安裝與首次開啟
先確認裝置架構與檔案來源,再依系統提示處理安裝及 VPN 權限。
Mac 應該選 Apple 晶片版還是 Intel 版?
開啟 Mac 左上角 Apple 選單中的「關於這台 Mac」:顯示晶片且標示 Apple 晶片的裝置請選 Apple 晶片版;顯示 Intel 處理器的裝置請選 Intel 版。下載頁提供兩種版本,請勿依購買年份或機身外觀猜測。下載對應的 dmg 後開啟,將 Shadowrocket 移至 Applications 再啟動。如果系統提示無法驗證開發者,確認檔案來自本站後,前往系統設定的「隱私權與安全性」選擇「仍要打開」。
Windows 或 Mac 顯示風險提示,該如何處理?
先確認安裝檔來自本站下載頁,並核對檔案類型與裝置架構。Windows 顯示 SmartScreen 提示時,選擇「更多資訊」,確認來源後再選「仍要執行」;受組織管理的裝置請遵守管理員政策。Mac 提示無法驗證開發者時,前往系統設定的「隱私權與安全性」選擇「仍要打開」。若提示檔案已損毀,確認來源後可執行 xattr -cr /Applications/Shadowrocket.app 再試。請勿為了啟動 App 而全面關閉系統安全防護。
Android 和 Linux 下載後,安裝前還要做什麼?
Android 請選擇下載頁提供的 arm64 安裝檔;若系統阻止安裝,只允許實際開啟安裝檔的瀏覽器或檔案管理員安裝未知的 App,安裝完成後可撤銷此權限。Linux 請依發行版選擇 deb、rpm 或 AppImage:前兩者使用相應的套件管理員安裝;AppImage 則先在檔案屬性中允許以程式執行,再啟動。如果出現架構不符、缺少相依套件或權限提示,請先處理相應問題,不要反覆執行不相符的檔案。
連線開關無法開啟,或開啟後立刻關閉,該怎麼辦?
在 iPhone / iPad 上,先選取一筆自己已有且有效的伺服器,再開啟連線開關;首次出現新增 VPN 設定提示時,請允許並完成系統驗證。如果先前曾拒絕,請重新發起連線以觸發授權,並檢查系統設定中是否已有 VPN 設定。暫時中斷其他正在使用的 VPN,避免爭用同一個連線位置。若開關仍立即關閉,請記下當次錯誤提示,再檢查設定欄位;不要一開始就刪除所有伺服器或反覆重設系統網路。
介面顯示英文,教學中的名稱該如何對照?
本手冊保留介面的英文原文,方便逐項核對:Home 用來查看伺服器與連線狀態;Add Server 用來手動新增;Subscribe 用來管理訂閱;Config 用來管理設定檔;Settings 用來調整設定。Global Routing 是流量處理模式的入口;設定、代理、直連分別對應 Config、Proxy、Direct。如果系統支援個別 App 語言,可在系統的 App 設定中查看語言選項。是否顯示此選項取決於系統及 App 提供的語言,不影響依照英文名稱操作。
訂閱與節點匯入
以下操作皆以使用者已有自己的訂閱或伺服器資訊為前提。
匯入既有訂閱失敗,應依什麼順序檢查?
先確認貼上的是自己已有的完整訂閱網址,而不是帳戶管理網頁或單一伺服器分享網址。檢查開頭和結尾是否有空格、換行或缺少參數,以及網址是否已過期,再到 Subscribe 儲存並嘗試更新。若出現網路錯誤,先確認目前網路能否連上訂閱網址;若回傳內容格式錯誤,請確認該網址輸出的資料是否受用戶端支援。請勿將含有個人存取參數的訂閱網址貼到公開留言或截圖中,也不要用瀏覽器顯示的登入頁面內容代替訂閱。
如何更新訂閱?更新後為什麼沒有新增伺服器?
前往該既有訂閱的管理入口,執行更新並查看結果,再回到伺服器清單檢查該訂閱群組。更新成功表示已取得並解析目前回傳的內容,不代表伺服器數量一定會改變;如果訂閱內容沒有變動,清單也可能維持原樣。若更新失敗,先檢查網址是否有效及目前網路狀態,再核對錯誤提示。更新前記下正在使用的伺服器及手動修改內容,更新後重新檢查選取項目,因為原有項目可能被訂閱內容取代或移除。
Scan QR Code 和從剪貼簿匯入適用於哪些內容?
兩種方式都能匯入自己已有的資訊,但 QR Code 或剪貼簿內容必須是用戶端可辨識的網址或資料。單一分享網址通常只包含一台伺服器;訂閱網址則用於取得並更新一組伺服器,匯入前請先確認類型。使用 Scan QR Code 時請允許相機權限,並確保 QR Code 完整清晰;從剪貼簿匯入前,請確認已複製完整內容。匯入後核對協定、位址與連接埠,不能只因清單出現新項目,就認定連線資訊正確。
使用 Add Server 手動填寫時,哪些欄位最容易出錯?
先選擇與既有伺服器相同的協定,再填寫位址、連接埠及相應的驗證資訊。Shadowsocks 的加密方式、VMess 或 VLESS 的識別欄位、Trojan 的密碼,以及 TLS 與傳輸相關欄位各有用途,不能互相替代。尤其注意位址欄不要混入網頁路徑或多餘空格,連接埠必須與原始資訊一致;啟用 TLS 時也要核對相關主機名稱。儲存後先測試單一項目,若失敗就逐項比對原始資料,不要同時修改多個欄位來猜測正確組合。
如何整理多個訂閱?刪除前需要備份哪些內容?
為每個既有訂閱取容易辨識的名稱,並將手動新增的伺服器與訂閱產生的項目區分開。清理重複項目前,先核對所屬群組、位址與協定,不要只憑相似的備註就批次刪除。刪除訂閱或重新匯入前,請保存原始訂閱網址、手動填寫的欄位,以及目前使用的 Config;若使用 App 提供的匯出功能,請妥善保管匯出檔案,並視為敏感資料。訂閱備份與規則設定備份並非同一件事,還原後需要分別核對。
規則與故障排除
固定測試目標,依序檢查伺服器、Global Routing、DNS 與規則。
Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?
Config 會依目前設定檔中的規則決定流量走向;Proxy 會讓用戶端處理範圍內的流量使用所選代理;Direct 則直接連線。日常需要依規則分流時,先確認已選取 Config 且規則完整;可用 Proxy 對照,判斷問題是否來自規則;用 Direct 確認直接連線的狀況。如果介面還顯示 Scene,應將其視為場景設定,而不是另一台伺服器。切換模式後,請以相同目標重新測試,避免同時更換伺服器。
顯示已連線卻無法上網,該先排查哪些項目?
先中斷連線,確認目前 Wi-Fi 或行動網路本身可正常使用;重新連線後檢查所選伺服器是否有效,並執行 Connectivity Test 查看是否逾時。接著核對 Global Routing,暫時使用 Proxy 對照 Config 的結果;如果只有 Config 失敗,請優先檢查規則匹配結果及 FINAL 的流量去向。若多個測試目標都失敗,再檢查 DNS、驗證欄位與伺服器狀態。每次只變更一項,並重試相同目標。連線開關保持開啟,不代表遠端伺服器或所有網站都能存取。
懷疑 DNS 錯誤或規則走錯時,如何縮小排查範圍?
先記下失敗目標的網域名稱與發生時間,再查看目前的 Config 和連線記錄,判斷請求是否送往預期的策略。DOMAIN-SUFFIX 用於匹配網域後綴,IP-CIDR 用於匹配 IP 網段,FINAL 則處理先前未匹配的流量;規則順序改變可能影響結果。若出現網域解析錯誤,請核對目前的 DNS 設定與所用網路,不要一次更換所有 DNS 和規則。修改後重新發出請求,避免把舊連線或快取結果誤認為新設定的效果;記錄中涉及個人資訊的部分應先遮蔽。
開啟後耗電增加,需要檢查 On Demand 嗎?
可以檢查,但請先查看系統電池用量統計,確認耗電增加的實際時段,也留意影片播放、下載等持續流量是否增加。On Demand 會在設定的網路條件下自動連線,不等於固定的省電開關;若設定造成網路切換時反覆連線,請分別核對 Wi-Fi 與行動網路條件。伺服器不穩定、頻繁重試、持續測試或長時間保留詳細記錄,也可能增加耗電。每次調整一項,並在相近的使用時段觀察一段時間,不要只憑單次電量變化判斷原因。
Connectivity Test 的結果能代表實際網速嗎?
不能直接畫上等號。Connectivity Test 用於輔助判斷特定測試條件下的連通性,結果會受測試目標、目前網路及伺服器回應影響。測試有回應,不代表所有網站或協定都正常;逾時也需要配合測試方式及實際瀏覽結果判斷。排查時固定使用相同網路、伺服器及目標,再分別比較連線前後與不同 Global Routing 模式。若要進一步定位,請記下錯誤時間、協定、模式及已遮蔽個人資訊的記錄,不要公開密碼、識別欄位或完整訂閱網址。