Shadowrocket 官方手冊

Shadowrocket 常見問題

依購買、安裝、訂閱及連線問題查找處理步驟。先確認目前裝置與錯誤訊息,再逐項檢查;修改 Config 或刪除訂閱前,請先備份。

查看全平台下載與安裝方式

正版與購買

先區分 App 取得方式與設定還原,再確認商店商品頁及購買帳號。

電腦和 Android 裝置可以使用 Shadowrocket 嗎?

可以。Shadowrocket 提供 iPhone、iPad、Mac、Windows、Android 和 Linux 版本。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 分為 Apple 晶片版與 Intel 版;其他平台也請依作業系統和安裝檔格式選擇。請從下載頁前往對應平台:iPhone / iPad 前往 App Store,其他平台的安裝檔由本站 /dl/shadowrocket/ 提供。首次開啟若遇到系統攔截,請參閱下方安裝分類的處理方式。

iPad 可以安裝嗎?系統需求要去哪裡查看?

可以。iPhone 與 iPad 使用同一個 App Store 商品頁面,系統需求以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。已購買的使用者,請先使用原購買帳號查看已購項目,再於另一台相容裝置下載;不要因搜尋結果相似就改選其他 App。安裝後仍須匯入使用者已有的訂閱或伺服器資訊;裝置間還原設定與下載 App 是兩回事。

更換裝置或重新安裝後,需要再次購買嗎?

iPhone / iPad 使用者請先登入原購買時使用的 App Store 帳號,在帳號的已購項目或 App 列表中找到 Shadowrocket,再點選重新下載。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。同一購買帳號通常不必再次付費即可還原 App。若仍顯示購買按鈕,請先確認帳號與購買紀錄,不要急著重複付款。重新下載 App 不代表伺服器列表也會還原;更換裝置前請另外備份設定。電腦和 Android 裝置重新安裝時,從本站下載頁重新取得即可。

購買用戶端後,為什麼還需要訂閱或伺服器資訊?

用戶端負責讀取伺服器參數、建立連線及執行規則;線路服務則是另一項服務,因此用戶端一次買斷 ≠ 線路方案。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,這兩種價格都不包含線路服務。本站是 Shadowrocket 官網與官方手冊,不提供、不銷售也不推薦節點或訂閱。後續操作均以使用者已有自己的訂閱或伺服器資訊為前提;匯入前請先確認資訊仍有效。

安裝與首次開啟

先確認系統、晶片與下載來源。系統放行只應針對已確認的 App。

Mac 應選擇 Apple 晶片版還是 Intel 版?

點選 Mac 左上角的 Apple 選單,開啟「關於這台 Mac」。若顯示「晶片」並列出 Apple 晶片名稱,請選擇 Mac Apple 晶片版;若顯示「處理器」且名稱包含 Intel,請選擇 Mac Intel 版。兩種安裝檔都可在下載頁的 Mac 區找到,不必依電腦外觀、購買年份或瀏覽器判斷。下載 dmg 後,依指示將 Shadowrocket 移至 Applications。首次開啟若出現「無法驗證開發者」,請先確認下載來源,再依下一題的系統設定步驟處理。

Mac 顯示「無法驗證開發者」或「已損毀」,該如何處理?

請先確認安裝檔來自本站下載頁的 /dl/shadowrocket/ 路徑,且 App 已移至 Applications。若顯示「無法驗證開發者」,請先嘗試開啟一次,再前往「系統設定 → 隱私權與安全性」,在對應提示處選擇「仍要打開」,並完成系統確認。若顯示「已損毀」,確認來源與 App 位置後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再重新開啟。此命令僅適用於該 App,不要改成整個磁碟的路徑,也不要為了執行 App 而關閉整體系統安全防護。

Windows 出現 SmartScreen 風險提示,該如何允許執行?

請先確認 exe 是從本站下載頁取得,連結路徑為 /dl/shadowrocket/,並確認檔案對應 Shadowrocket。SmartScreen 顯示「Windows 已保護您的電腦」時,可點選「其他資訊」,再選擇「仍要執行」;接著依安裝程式提示完成操作。若畫面沒有此選項,或裝置受組織政策管理,請先確認 Windows 安全性與組織政策,不要反覆關閉安全功能。安裝完成後首次建立連線,仍須依系統實際提示確認相應的網路權限。

Android apk 無法安裝,或在微信裡點下載沒有反應,該怎麼辦?

請先使用系統瀏覽器開啟本站下載頁並選擇 Android 版,避免在微信內建瀏覽器中反覆點選。下載完成後,若系統提示不允許安裝,請前往目前使用的瀏覽器或檔案管理員所對應的「安裝未知應用程式」設定,允許該來源完成這次安裝;安裝後可視需要撤銷權限。本站提供 arm64 apk;若仍顯示不相容,請確認裝置架構與系統提示,不要更改檔案副檔名。首次連線出現 VPN 授權視窗時,請確認 App 名稱後再允許,否則無法建立連線。

Linux 應選 deb、rpm 還是 AppImage?

建議優先依發行版的套件管理方式選擇:Debian、Ubuntu 等系統通常使用 deb;採用 RPM 套件管理的系統則選擇 rpm;需要獨立檔案格式時再考慮 AppImage。所有格式均可從本站下載頁的 Linux 區取得。安裝 deb 時,可在下載資料夾使用 sudo apt install ./,後接實際檔名;AppImage 則須先使用 chmod +x,後接實際檔名以授予執行權限,再執行該檔案。命令中的檔名應與本機下載的檔案一致;若出現權限或相依性錯誤,請先閱讀終端機提示,不要直接以高權限反覆啟動。

查看安裝放行表與完整命令說明 →

訂閱與伺服器匯入

以下說明以使用者已有自己的訂閱或伺服器資訊為前提。請先辨識內容類型,再選擇匯入入口。

已有的訂閱要從哪裡匯入?

在 Home 點選新增入口,進入 Add Server 後選擇 Subscribe,將使用者已有的完整訂閱連結填入 URL,並設定容易辨識的名稱後儲存。不同版本的入口位置可能略有差異,請以目前 App 的欄位名稱為準。儲存後更新一次,確認 Home 顯示該訂閱中的伺服器,再選擇一項進行測試。訂閱連結與單一伺服器分享連結是不同內容,不要把整份設定檔文字填入 URL;訂閱連結可能包含存取憑證,也不要貼到公開聊天或截圖中。

訂閱匯入失敗或更新後列表為空,應先檢查哪些項目?

先檢查連結是否完整,有沒有混入空格、換行、中文標點或額外說明文字;再確認它是 Subscribe 需要的訂閱網址,而非帳號網頁或單一伺服器連結。接著確認本機網路是否可用、原訂閱是否仍有效,以及是否傳回 Shadowrocket 能辨識的內容。若舊列表仍在,先不要刪除;請先備份並記錄錯誤提示。更新成功但列表為空,代表請求完成不一定表示傳回內容有效;請確認訂閱端實際傳回的結果,再決定是否重新匯入。

如何更新訂閱?手動修改的伺服器會被覆蓋嗎?

在 Home 找到對應的訂閱群組或編輯入口,使用該訂閱的更新功能;完成後確認伺服器名稱、數量變化與目前選取的項目。訂閱更新不等於更新 Config,兩者管理的內容不同。訂閱中的伺服器由遠端內容產生,手動修改名稱或參數可能在後續更新時被覆寫;需要長期保留的自訂項目,請先另行儲存並備份。更新失敗時,優先保留原有可用列表,記錄錯誤並檢查連結,不必反覆刪除及重建所有群組。

掃描 QR Code、使用剪貼簿或在 Add Server 手動輸入,該怎麼選?

已有 QR Code 時,使用 Scan QR Code 並依提示授予相機權限;已有伺服器分享連結時,可複製完整連結,再使用 App 提供的剪貼簿匯入入口,並確認系統允許讀取。只有零散參數時,再進入 Add Server,依原始資料選擇 Type,填入位址、連接埠、驗證與傳輸設定。無論採用哪種方式,儲存前都應確認解析結果,尤其是協定類型與連接埠。QR Code 無法辨識時,先確認內容是否為支援的伺服器資訊,而非登入頁面或付款頁面。

多個訂閱出現重複伺服器,該如何整理與備份?

先為每個訂閱設定不同名稱,依群組確認重複項目屬於哪個訂閱,再判斷是否確實重複。名稱相同不代表位址、連接埠與傳輸參數相同;延遲相近也不能作為刪除依據。若多個訂閱包含相同伺服器,直接刪除群組內的項目可能在更新後再次出現,建議從決定保留哪些訂閱著手整理。刪除前請匯出目前設定,並另外保存必要的訂閱資訊;備份檔可能包含驗證資訊,請存放在安全的位置。App 還原後,再逐一更新各群組並確認目前選取的項目,避免一次變更太多內容。

查看訂閱與伺服器管理手冊 →

規則與連線排查

釐清本機網路、伺服器連線及規則比對三個環節。測試時保留原設定,每次只變更一項。

Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?

Config 會依目前啟用設定中的規則,為請求選擇策略;Proxy 會讓通常交由代理處理的流量使用所選伺服器;Direct 則讓流量透過本機網路直接連線。日常需要依規則分流時,請先選擇 Config,並確認 Config 頁面啟用的是預期檔案。疑難排解時可短暫切換模式,比較同一目標的連線結果;但不要以為 Proxy 會忽略所有系統略過項目,也不要把 Direct 當成中斷 VPN。診斷結束後,請恢復原本需要的模式。

連線開關無法開啟,或剛開啟就自動關閉,該怎麼辦?

先確認已選取參數完整的伺服器,並留意首次連線時系統是否跳出 VPN 設定或連線授權提示。iPhone / iPad 可在系統 Settings 的「一般 → VPN 與裝置管理」中確認相關設定;Android 裝置則應檢查是否拒絕了 VPN 授權。接著確認是否有其他 VPN 連線占用、裝置管理限制或失效設定。不要一開始就刪除所有系統設定;請先關閉衝突連線、重新啟動 App,再記錄 App 顯示的錯誤。若已啟用 On Demand,也請確認觸發條件是否導致連線立即中斷。

顯示已連線卻無法上網,應依什麼順序排查?

先中斷連線,確認本機網路本身可以正常連線;使用公共 Wi-Fi 時,也應先完成網頁認證。接著確認目前伺服器及其驗證資訊,執行 Connectivity Test,並注意測試成功只代表部分連線條件成立,不表示所有目標都能連線。然後檢查 Global Routing、目前的 Config 與請求命中的策略,再確認 DNS 設定是否與目前網路衝突。每次只變更一個項目,並以相同目標重新測試;若 Direct 可用但 Proxy 不通,請優先檢查伺服器連線路徑,不要立刻重設整台裝置的網路。

On Demand 沒有自動連線,或不斷自動重新連線,該怎麼辦?

先確認 On Demand 已啟用,並檢查系統是否允許對應的 VPN 設定依需求連線。逐項確認 Wi-Fi SSID、Cellular、Domain 等條件;SSID 必須與目前網路名稱一致,多個條件也可能互相影響。排查時先記錄目前設定,暫時關閉 On Demand,手動連線至同一伺服器;手動連線正常後,再一次只恢復一項條件並觀察結果。若反覆中斷和重新連線,也請檢查 Wi-Fi 與行動網路是否頻繁切換;不要同時修改伺服器、規則及所有觸發條件。

介面是英文,Home、Config 和 Settings 分別用來做什麼?

本手冊保留 App 介面英文名稱,方便逐項對照。Home 主要用來查看和選擇伺服器、操作連線;Add Server 用來新增伺服器,Subscribe 用於訂閱類型;Config 用來管理及選擇設定檔;Settings 用來查看 App 設定;Global Routing 用來選擇整體路由模式。不要只因介面語言不同就重新匯入訂閱或重新安裝。若要調整顯示語言,可先查看系統為該 App 提供的語言選項;實際可用選項以目前安裝版本及系統介面為準。

連線後耗電增加,Data 流量統計該怎麼看?

先在系統電池設定中比較相近時段的使用情況,同時留意影片傳輸、背景同步、網路訊號及頻繁重新連線。VPN 運作時需要處理網路流量,不能只憑狀態列圖示判斷耗電變化。Data 可用來查看 App 記錄的流量,但統計範圍可能與系統或線路端的計算方式不同,不應將其視為帳單。排查時先停止反覆測速,檢查 On Demand 是否頻繁觸發,並比較網路穩定時的情況;若異常持續,請記錄重現條件與相關日誌,分享前遮蔽訂閱網址及驗證資訊。