官方手冊 · 問題索引

Shadowrocket 常見問題

依購買、安裝、匯入、連線的順序逐步排查。先確認目前狀態,每次只調整一項設定。

以下操作皆以使用者已有自己的訂閱或伺服器資訊為前提。需要依序操作時,請查看使用教學 →

取得方式與帳號

正版與購買

先確認平台與購買帳號。從商店還原 App、還原設定與取得線路服務,需要分別處理。

查看下載與正版確認 →
Shadowrocket 如何收費?購買客戶端有包含線路嗎?

iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。其他商店依當地幣別標價,請以商店頁面為準。一次買斷客戶端不等於購買線路方案,取得客戶端與線路服務是兩回事。使用前請備妥自己的訂閱或伺服器資訊,訂閱請向服務商取得。本網站為官網與官方手冊,不提供、銷售或推薦節點及訂閱。

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

可以。Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 與 Linux。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。電腦與 Android 裝置請至本站全平台下載頁選擇安裝檔,檔案由本站 /dl/shadowrocket/ 路徑提供。首次開啟時可能遇到系統封鎖,請先確認來源,再依本頁安裝分類或下載頁的允許安裝說明操作。

iPad 可以安裝嗎?和 iPhone 需要分開購買嗎?

iPad 可以安裝 Shadowrocket。iPhone / iPad 版在 App Store 一次性付費 $2.99,兩種裝置共用;Mac / Windows / Android / Linux 版免費。在 iPad 的 App Store 使用原購買帳號查看已購項目,找到 Shadowrocket 後重新下載。系統需求請以 App Store 頁面標示為準;若按鈕仍顯示價格,請先確認購買紀錄及「媒體與購買項目」帳號,勿急著重複付款。

更換裝置或重新安裝後,如何還原已購項目?

在新裝置的 App Store 登入購買時用於「媒體與購買項目」的原帳號,進入帳號中的已購 App 清單,搜尋 Shadowrocket 並重新下載;清單名稱可能因系統版本而異。iPhone / iPad 版在 App Store 一次性付費 $2.99,同一購買帳號可還原已購 App;Mac / Windows / Android / Linux 版免費。還原 App 不代表所有設定也會一併還原,訂閱與設定檔仍須從自己的備份或服務商資料中找回。

如何確認 App Store 上的 Shadowrocket?

從本站下載頁前往 App Store 產品頁,核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、App ID 932747118,並比對本站頁首使用的官方圖示。App ID 可在產品頁網址中確認,勿只憑搜尋結果中的名稱判斷。電腦與 Android 等平台則請從本站下載頁選擇相應安裝檔。若遇到名稱相近但開發者或 App ID 不符的項目,請停止操作並重新確認產品頁。

架構與系統權限

安裝與首次開啟

先確認檔案來源與裝置架構,再處理系統提示。只對已確認的 App 操作,不要全域關閉系統防護。

查看安裝允許方式 →
Mac 應選 Apple 晶片版還是 Intel 版?

開啟蘋果選單中的「關於這台 Mac」:若顯示「晶片」且名稱為 Apple M 系列,請選 Apple 晶片版;若顯示 Intel 處理器,請選 Intel 版。下載頁為兩種架構分別提供 dmg,請勿依機身外觀或購買年份猜測。將 App 移至 Applications 後再開啟;若系統提示無法驗證開發者,請確認安裝檔來自本站,再前往「系統設定 → 隱私權與安全性」查看該 App 的「仍要打開」選項。

Windows 出現 SmartScreen 風險提示,該如何處理?

先確認檔案是從本站下載頁取得,下載路徑屬於本站 /dl/shadowrocket/,並確認裝置為所需的 Windows 64 位元環境。若出現 SmartScreen「Windows 已保護您的電腦」提示,確認來源後可點選「其他資訊 → 仍要執行」。這只是允許系統執行,不代表已完成安全檢測。若提示來自組織政策、檔案遭安全軟體偵測,或無法確認來源,請停止執行並保留提示內容,先查明原因;不要全域關閉安全防護。

Mac 顯示「無法驗證開發者」或「已損壞」怎麼辦?

先確認 App 來自本站,且已放入 /Applications。若顯示「無法驗證開發者」,嘗試開啟後前往「系統設定 → 隱私權與安全性」,找到該 App 的「仍要打開」,再依系統提示確認。若顯示「已損壞」,請先重新下載並取代原檔;確認來源與路徑無誤後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。此命令會清除該 App 的擴充屬性,不應批次用於其他未知檔案;受管理裝置請遵循管理員政策。

Android 安裝時顯示不允許安裝,如何允許?

從本站下載頁取得適用於 arm64 的安裝檔後,系統可能要求為目前使用的瀏覽器或檔案管理員開啟「允許安裝未知應用程式」。只暫時授權實際用來開啟安裝檔的 App,安裝完成後可關閉授權。若仍顯示解析失敗,請檢查下載是否完成、裝置架構是否相符,以及是否有舊檔;不要反覆開啟同一個未下載完整的檔案。若微信內下載受限,可透過選單在系統瀏覽器中開啟本站下載頁。

Linux 的 deb、rpm 和 AppImage 該怎麼選?

依 Linux 發行版的套件格式選擇:Debian、Ubuntu 系統通常使用 deb,Fedora 等系統通常使用 rpm;若希望直接執行,可確認 AppImage 是否適用於目前環境。下載後在檔案所在目錄操作,deb 可使用 sudo apt install ./,後接實際檔名;rpm 可使用 sudo dnf install ./,後接實際檔名。AppImage 請先對實際檔案執行 chmod +x,再執行檔案。先確認來源與架構;若缺少執行相依套件,請依錯誤訊息補齊,不要反覆混裝不同格式的套件。

首次連線時開關無法啟用,應該先檢查哪裡?

以 iPhone / iPad 為例,首次啟用時會要求新增 VPN 設定檔,請依系統提示允許並完成裝置驗證。若不小心點選取消,請回到 Shadowrocket 再次啟用,並檢查系統 Settings 中是否已有 VPN 設定檔。也請確認已選取可用伺服器,暫時中斷其他正在使用 VPN 通道的 App,並檢查裝置是否受描述檔或組織政策限制。若開關立即跳回關閉,請記下具體錯誤訊息;不要先刪除所有設定,也不要將新增設定檔的系統確認視為連線成功。

既有資料的匯入與管理

訂閱與節點匯入

訂閱請向服務商取得。匯入失敗、更新失敗與伺服器連線失敗發生在不同階段,請分別確認。

依教學檢查匯入步驟 →
Subscribe 匯入失敗,如何判斷是連結還是客戶端問題?

先確認複製的是向服務商取得的完整訂閱連結,而不是網頁標題、說明文字或登入頁網址。檢查連結首尾是否有空格、換行或遭截斷的查詢參數,再確認 Add Server 中的 Type 是否選為 Subscribe。請保留具體錯誤訊息:逾時時先確認目前網路能否連上訂閱網址;若回傳格式不支援或沒有伺服器,請向服務商確認內容格式與訂閱狀態。勿將包含存取憑證的完整連結放在公開截圖或討論中。

Shadowrocket 訂閱更新後,為什麼伺服器仍和原來一樣?

先確認更新的是目前使用中的 Subscribe 群組,而不是另一個同名群組,再確認更新是否確實成功。更新成功只表示重新取得服務商回傳的內容;若服務商未變更清單,伺服器名稱可能完全相同。若有異常,請先備份目前資料,確認訂閱狀態與有效期限,並向服務商確認回傳內容;不要為了更新清單而連續刪除重建。更新後也要確認目前選取的伺服器仍在清單中,且原有設定引用仍有效。

Scan QR Code 掃描後沒有匯入,可能是什麼原因?

先檢查相機權限、QR Code 是否完整清晰,以及其中承載的是伺服器分享資訊、訂閱網址還是一般網頁。QR Code 能被辨識,不代表其中的資料一定能匯入為伺服器。若辨識出訂閱網址,請用 Subscribe 方式新增;若是伺服器資訊,則檢查協定類型與必要欄位。可向服務商索取原始文字資訊核對,避免反覆掃描模糊截圖。QR Code 也可能包含密碼或訂閱憑證,分享前請先遮蔽。

使用 Add Server 手動輸入時,哪些欄位不能混用?

先依服務商提供的資訊選擇 Type,再填寫對應欄位。Address 填伺服器位址,Port 填連接埠;密碼、UUID、金鑰等驗證資訊應填入各協定對應欄位,不能互相替代。使用 TLS 時,也要確認 Server Name、憑證相關選項,以及服務商要求的傳輸參數。伺服器位址與 TLS 名稱可能不同,不要為了看起來一致而自行修改。不確定欄位用途時,先查閱協定參考資料,再向服務商確認;不要藉由關閉憑證驗證來掩蓋參數錯誤。

更新後手動修改的伺服器參數不見了,如何避免?

訂閱項目通常由服務商回傳的資料維護,更新時可能重建或覆寫項目,因此不應將訂閱中的手動修改視為長期保存方式。若確實需要個別調整,請先備份原資料,再將必要資訊另存為獨立的手動項目,並以不同名稱和原訂閱群組區分。之後仍需自行確認服務商是否變更位址、連接埠或驗證資訊。伺服器項目更新與 Config 檔案更新是兩回事,請分別檢查其來源、內容與啟用狀態。

排查匯入問題時,可以提供哪些資訊?

可以提供裝置系統、所選 Type、問題發生於匯入或連線階段、完整錯誤訊息,以及已遮蔽敏感資訊的相關設定截圖。請遮蔽訂閱連結中的存取憑證、密碼、UUID、Private Key 和 QR Code 內容;保留欄位名稱有助於定位問題,但不必公開欄位值。若服務商需要確認訂閱狀態,請透過其既有的私人客服管道處理。本手冊只說明匯入與使用方式,不會要求提供訂閱連結、伺服器驗證資訊或帳號密碼。

從通道狀態到實際請求

規則分流與故障排除

連線開關、伺服器測試與目標請求並非同一件事。保持測試條件一致,才能判斷問題出在哪個環節。

查看協定欄位與選擇參考 →
Global Routing 中的 Config、Proxy、Direct 三種模式該怎麼選?

Config 會依目前啟用設定中的規則決定請求策略,日常需要規則分流時,請先檢查此模式。Proxy 會讓進入客戶端處理範圍的請求使用所選代理,適合短暫測試是否為規則比對問題。Direct 則讓相關請求直接連線,可用來確認本機網路基準狀態。切換模式不等於切換伺服器,也無法修正錯誤的驗證資訊。比較測試時,請保持網路、伺服器與目標一致,每次只變更一項條件,測試後再切回需要的模式。

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

先中斷連線,確認目前 Wi-Fi 或行動網路本身可正常使用,再重新連線並確認選取的伺服器正確。接著區分「所有目標都失敗」與「只有部分目標失敗」:前者先檢查伺服器驗證、連至伺服器的狀態及 DNS;後者優先檢查規則比對結果與目標服務狀態。可使用同一目標短暫比較 Proxy 與 Config;若只有 Config 失敗,請回頭檢查目前 Config 的 Rule 順序與策略引用。系統顯示 VPN 已建立,只代表本機通道狀態正常,不能證明遠端請求成功。

Connectivity Test 有結果,為什麼實際請求仍然失敗?

測試結果只適用於當時使用的測試方法與目標。連線至伺服器連接埠、完成協定交握、解析網域名稱,以及存取實際 App,屬於不同檢查層次,不能以單一結果概括判斷。先確認測試使用的伺服器與實際選取的項目一致,再查看目標請求的規則策略與 DNS 狀況。使用相同網路與目標少量重測並記錄錯誤類型,比只比較延遲數值更有參考價值;不要據此保證實際速度,也不要將單次逾時直接歸因於客戶端異常。

連線後覺得耗電,和 On Demand 有關嗎?

耗電會受到持續流量、無線訊號、協定處理、網路切換與背景請求等因素影響,不能只看 VPN 圖示是否顯示。請先在系統電池用量統計中比較相近的日常使用時段,再檢查是否長時間進行大量測試、開啟詳細記錄或頻繁更新訂閱。On Demand 會依條件觸發連線;若手動中斷後很快又連線,請檢查對應條件,測試時可暫時關閉。不要為了降低耗電而任意更改協定驗證或傳輸參數,先減少不必要的診斷活動並觀察差異。

介面是英文,該從哪些項目開始找?

本手冊保留介面英文原文,方便直接查找:Home 查看伺服器與連線,Add Server 新增資訊,Subscribe 表示訂閱類型,Config 管理設定檔,Global Routing 選擇處理模式,Settings 查看設定。若想調整顯示語言,可先確認系統是否提供該 App 的語言選項,並以 App 實際提供的選項為準。介面語言不會改變伺服器參數的意義;不確定開關用途時,先記下原設定並查閱教學,不要逐一嘗試所有設定。

修改 Rule 後沒有生效,如何確認目前設定與規則順序?

先在 Config 確認正在編輯的檔案就是目前啟用的檔案,再檢查 Global Routing 是否設為 Config;若處於 Proxy 或 Direct,不應以相同規則分流結果判斷。Rule 通常由上而下比對,較早符合的寬鬆規則可能讓後面的精確規則無法處理,FINAL 應作為最後的兜底規則。也要確認策略名稱存在且拼字一致,以及遠端設定更新是否覆寫本機修改。儲存後以相同目標重新發出請求,必要時查看記錄,確認實際命中的規則。