官方手冊 · 依症狀查找

Shadowrocket 疑難排解

先確認適用平台,再依序檢查權限、設定與網路。以下問答以使用者已有自己的訂閱或伺服器資訊為前提;點選問題即可展開步驟。

每次只調整一個項目;刪除設定或重新安裝前請先備份。

取得管道 · 帳號記錄

正版核對與購買

先區分 App 取得方式與連線服務,再核對商店資料及購買記錄。

電腦和 Android 能用 Shadowrocket 嗎?下載方式和價格有什麼差別?

Shadowrocket 全平台皆可使用。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,分為 2 種取得方式。①先在取得應用程式頁面選擇裝置;②iPhone / iPad 會前往 App Store,其他平台請使用本站 /dl/ 下的安裝檔;③電腦與 Android 首次開啟若遇到系統攔截,請依本頁的安裝權限分類核對檔案來源後再允許執行。不同平台的安裝檔不可混用。

如何核對 App Store 上的 Shadowrocket?

iPhone / iPad 使用者請在 App Store 產品頁核對三項資料:①名稱為 Shadowrocket;②開發者為 Shadow Launch Technology Limited,App ID 為 932747118;③圖示與本站頁首的官方圖示相同。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。請勿只憑搜尋排序或相似名稱判斷;商店中標示免費的同名項目並非此處所指的 iPhone / iPad 版產品。

在 App Store 搜尋不到 Shadowrocket,該檢查哪些項目?

iPhone / iPad 的商店搜尋結果會依 Apple Account 所屬國家或地區而異;中國大陸 App Store 未上架此 App。①先確認「媒體與購買項目」所用帳號的地區,不要只看裝置語言;②從取得應用程式頁面開啟指定產品頁,確認是否可用;③如需更改地區,請在系統設定中依序前往 Apple Account、媒體與購買項目、檢視帳號、國家或地區,並依 Apple 提示處理餘額、訂閱與付款條件。請勿反覆更改裝置地區來取代商店帳號設定。

換 iPhone、重新安裝 App 或改用 iPad,需要再次購買嗎?

iPhone / iPad 可用原購買帳號查詢已購項目並還原。①在 App Store 確認登入的是原購買帳號;②前往帳號中的已購項目清單搜尋 Shadowrocket;③從購買記錄重新下載。若再次顯示價格,請先確認帳號與商店地區,不要直接重新付款。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。還原 App 不等於還原本機設定,換機前請另外備份設定資料。

購買 App 後,為什麼仍須輸入訂閱或伺服器資訊?

所有平台的 Shadowrocket 都需要使用者已有的訂閱或伺服器資訊。一次買斷 App ≠ 購買連線方案:iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。App 取得費用與連線服務是兩回事。①先備妥有效的現有資訊;②依 Subscribe 或 Add Server 的方式匯入;③核對伺服器參數後再連線。本站是 Shadowrocket 官網與官方手冊,不提供、不販售也不推薦伺服器節點或訂閱。

平台版本 · 系統權限

安裝與首次開啟

先選對架構,再處理目前檔案觸發的系統提示;不要以關閉整體防護取代問題排查。

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

Mac 使用者應依晶片類型選擇 Shadowrocket 安裝檔,不要依螢幕尺寸或購買年份判斷。①開啟 Apple 選單中的「關於這台 Mac」;②若顯示「晶片」及 Apple 晶片名稱,請選 Apple 晶片版;若顯示 Intel 處理器,請選 Intel 版;③前往取得應用程式頁面下載對應的 dmg 並完成安裝。首次開啟若出現無法驗證開發者的提示,請先確認檔案來自本站,再到系統設定的「隱私權與安全性」查看此次攔截記錄,選擇「仍要打開」並完成系統確認。

Windows SmartScreen 或 macOS 安全性提示該如何處理?

Windows 與 Mac 首次開啟安裝檔時,請先確認下載來源並閱讀系統提示。①確認檔案是從本站取得應用程式頁面下載,路徑位於 /dl/shadowrocket/;②Windows SmartScreen 可在「更多資訊」中選擇「仍要執行」;macOS 無法驗證開發者時,請到「隱私權與安全性」選擇「仍要打開」;③若 macOS 明確提示「已損壞」,請確認 App 已放入 Applications,再依安裝說明執行 xattr -cr /Applications/Shadowrocket.app。若安全軟體明確偵測到威脅,請先停止操作並確認狀況,不要關閉整套系統防護。

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

Android 使用者請使用取得應用程式頁面提供的 arm64 apk,並透過系統瀏覽器下載。①若無法在微信中下載,請使用選單中的「在瀏覽器中開啟」功能重新造訪本站;②安裝時依系統提示,允許實際執行安裝的瀏覽器或檔案管理員「安裝未知的應用程式」;③返回原檔案繼續安裝,完成後可關閉該來源的安裝權限。若系統提示架構不相容或解析失敗,請先確認裝置架構、下載是否完成及檔案來源,不要反覆更改與安裝無關的系統權限。

iPad 可以安裝嗎?首次新增 VPN 設定代表什麼?

iPad 可使用 Shadowrocket,系統需求請以 App Store 產品頁標示為準;iPhone 的需求也請在同一產品頁確認。①安裝後備妥現有的伺服器或訂閱資訊;②首次連線時閱讀系統新增 VPN 設定的提示;③確認提示是由目前操作觸發後再允許,並依系統要求驗證身分。此權限用於建立系統網路通道,不代表伺服器參數已通過驗證。App 下載、設定匯入與實際連線是三個不同步驟,請分別確認結果。

介面是英文,該從哪些入口開始?Linux 安裝檔又該怎麼選?

各平台請依實際介面尋找功能,英文名稱保留原樣即可對照手冊。①Home 查看連線狀態及 SERVER;②Config 管理設定,Settings 檢查設定,Add Server 用來輸入伺服器資訊,Subscribe 用來處理現有訂閱。請勿為了配合教學而任意更改協定參數。Linux 使用者請先依發行版選擇套件:Debian 系使用 deb,Fedora 系使用 rpm;AppImage 須先授予執行權限再執行。詳細安裝指令與權限設定請參閱取得應用程式頁面,不要直接套用其他系統的安裝步驟。

Subscribe · Add Server

訂閱與伺服器匯入

僅處理使用者現有的資訊;先確認輸入類型,再區分取得失敗、解析失敗與連線失敗。

現有訂閱連結應放在 Subscribe,還是 Add Server?

訂閱與單一伺服器資訊應使用相對應的入口,不要只看連結外觀。①服務商明確提供訂閱網址時,請使用 Subscribe 對應的訂閱匯入功能;②只有伺服器位址、連接埠、協定和驗證參數時,請使用 Add Server 逐項填寫;③匯入後回到 SERVER,確認是否出現預期項目,再選取項目連線。訂閱通常用於批次管理伺服器資訊;設定檔也可能包含規則與 DNS 設定,兩者用途不同。匯入成功不代表目前已啟用正確的設定。

訂閱匯入失敗或清單空白,應按什麼順序檢查?

各平台匯入訂閱失敗時,請先分辨是下載失敗還是內容解析失敗。①重新複製使用者現有的完整訂閱網址,檢查前後空格、換行及遭截斷的參數;②確認目前網路能否連上訂閱網址,以及服務是否仍有效;③若已取得內容但清單空白,請確認服務商提供的是 App 支援的訂閱格式,而非登入頁、錯誤頁或網頁分享網址。不要連續覆寫原本可用的訂閱;先保留舊記錄,再單獨測試新網址,並避免將含有驗證參數的連結張貼到公開頁面。

Scan QR Code 或從剪貼簿匯入時沒有辨識結果,該怎麼辦?

在支援掃描 QR Code 或從剪貼簿匯入的介面中,辨識失敗時通常應先檢查內容本身。①使用 Scan QR Code 時,請確保 QR Code 清晰完整,並在系統提示時確認相機權限;②從剪貼簿只複製實際連線內容,不要一併帶入說明文字、引號或換行;③確認 QR Code 中包含的是支援的伺服器連結或訂閱網址,而不是一般網頁。若內容只有參數說明,請改用 Add Server 手動填寫。掃描辨識只完成資訊輸入,後續仍須核對協定、連接埠與驗證欄位。

更新訂閱後,原本選取的伺服器不見了,該怎麼辦?

各平台更新訂閱後,清單會依本次取得的內容更新,伺服器名稱或項目可能有所變動。①更新前記下目前使用的訂閱名稱與伺服器;②更新後在相同的訂閱群組中重新尋找並選取可用項目;③若整個群組消失或變成空白,請先檢查訂閱是否有效及回傳格式,不要立即刪除其他設定。手動修改由訂閱產生的項目,後續更新時可能會被覆寫,因此需要長期保留的個人參數應另外記錄;也不要把伺服器清單更新當成規則檔更新。

Add Server 顯示儲存成功卻無法連線,哪些參數最容易漏掉?

所有平台手動新增伺服器後,都應逐項對照使用者現有的原始參數,不要依協定名稱自行填入數值。①核對伺服器位址、連接埠與協定;②檢查密碼或 UUID、加密方式及傳輸設定;③使用 TLS 時,核對 Server Name 等伺服器端要求;涉及路徑時,保留大小寫與斜線。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位不可互相套用。儲存只代表表單已記錄;Connectivity Test 與實際連線才能進一步判斷連線狀況。

Global Routing · Connectivity Test

規則分流與故障排解

依「基本網路 → 伺服器 → DNS → 規則」的順序縮小問題範圍,並保留每次測試的條件。

連線開關無法開啟,或開啟後立刻關閉,該怎麼辦?

iPhone / iPad 請先檢查 VPN 設定權限;其他平台則確認裝置的網路權限與 App 提示。①確認已選取參數完整的伺服器,並閱讀剛出現的系統授權提示;②檢查是否有其他 VPN 連線或受管理裝置的政策阻止建立通道;③中斷衝突連線後重新嘗試,必要時重新啟動裝置。若先前曾拒絕授權,請前往系統對應設定檢查,不要連續點擊開關。刪除系統設定或重新安裝 App 前,請先備份現有設定並記下錯誤訊息,避免權限問題導致資料遺失。

顯示已連線但網頁無法開啟,該先檢查伺服器還是 DNS?

各平台顯示已連線,只能說明通道狀態,不能單獨證明目標網站可正常存取。①先中斷連線,確認基本網路可用,並完成公共 Wi-Fi 登入;②重新連線後檢查所選伺服器,並使用 Connectivity Test 輔助判斷;③若連線測試正常但網域無法存取,再核對 DNS 與規則,確認是否只有特定網域受影響。每次只更改一項並記錄結果,也可分別透過 Wi-Fi 與行動網路重新測試。不要同時更換伺服器、DNS 和整份設定,否則難以判斷是哪項修改造成影響。

Global Routing 的 Config、Proxy、Direct 三種模式該如何選?

有 Global Routing 的介面中,三種模式分別是 Config、Proxy 和 Direct。①日常依規則使用時選擇 Config,並確認啟用的是預期設定檔;②暫時排查代理路徑時可切換至 Proxy,觀察問題是否仍存在;③需要檢查直連路徑時使用 Direct。切換模式只會改變路由判斷方式,不會修正錯誤的伺服器驗證參數,也不代表所有 App 流量都一定受控。測試完成後請恢復原本模式,避免長期保留診斷時使用的暫時設定。

Config 模式下規則未如預期生效,該檢查哪些項目?

使用 Config 模式時,請先確認目前啟用的設定檔,再檢查規則順序。①核對實際存取的網域或 IP,不要把網頁標題當成網域;②檢查 DOMAIN-SUFFIX、IP-CIDR 等目標規則之前,是否已有範圍更廣的規則符合條件;③確認 FINAL 位於預期的末尾備援位置,並核對 PROXY、DIRECT、REJECT 等策略的含義。規則通常由上而下比對,前面的規則符合後就不會繼續尋找更符合直覺的項目。需要重現問題時,只保留相關測試修改,並先儲存原設定。

連線後耗電或發熱增加,或更新後才出現異常,該如何排查?

各平台請先分辨背景使用、網路重試與更新後的設定變化,不要只憑 VPN 圖示判斷耗電來源。①在系統電池或活動記錄中比對 App 耗電情況與實際傳輸時段;②檢查是否頻繁切換網路、持續測試,或因伺服器連線失敗而反覆重新連線;③核對 On Demand 條件,減少不必要的連線嘗試。若異常是在更新後才出現,請先重新啟動裝置,確認目前的伺服器與設定未被切換,再用已知可用的設定重新測試。調整前請先備份並記錄觸發條件;更完整的症狀排查流程請參閱疑難手冊。

返回分類頁頂端 ↑