SHADOWROCKET / 官方手冊
Shadowrocket 常見問題
安裝、訂閱與規則疑難排解
先依症狀找出問題,再查看檢查步驟。連線設定以使用者已有的訂閱或伺服器資訊為前提;操作前請保存目前可用的設定,每次只調整一項。
電腦和 Android 可以使用 Shadowrocket 嗎?價格怎麼區分?
可以。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費。前往全平台下載頁,依裝置選擇版本;電腦、Android 和 Linux 的安裝檔由本站 /dl/shadowrocket/ 路徑提供。iPhone / iPad 的系統需求以 App Store 頁面標示為準;其他平台首次安裝時的系統允許方式,請參閱本頁「下載安裝」分類。
如何在 App Store 核對 Shadowrocket?
開啟產品頁後,請一併核對名稱 Shadowrocket、白底藍紫描邊的官方火箭圖示、開發者 Shadow Launch Technology Limited,以及產品連結中的應用程式 ID 932747118。不要只依搜尋結果中的名稱判斷。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。電腦、Android 和 Linux 的安裝檔請從本站全平台下載頁前往。
在 App Store 搜尋不到 Shadowrocket,該先檢查什麼?
先確認目前用於 App Store 的 Apple ID 所屬國家或地區;中國大陸商店未提供此 App。可開啟本頁提供的產品頁確認是否可用,但產品頁連結不會自動變更帳號地區。如需調整,請在系統 Settings 中依序前往 Apple ID → Media & Purchases → View Account → Country/Region,並依 Apple 提示處理餘額、訂閱及付款資料等要求。不要將裝置語言設定誤當成商店地區。
更換 iPhone、重新安裝或改用 iPad,需要再次購買嗎?
iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。iPhone 與 iPad 使用購買時的同一個 Apple ID,即可在 App Store 的已購項目中尋找並重新下載;裝置仍須符合產品頁列出的系統需求。如果再次顯示購買價格,請先核對商店帳號與購買紀錄,不要急著重複付款。重新下載 App 不等於還原設定,原有訂閱、規則與伺服器資料應另外保存。
購買用戶端後,是否已包含可用的連線節點?
不包含。用戶端一次買斷 ≠ 連線方案;Shadowrocket 用來匯入及管理使用者已有的訂閱或伺服器資訊。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,這兩種取得方式都不代表包含連線服務。本網站不提供、販售或推薦節點或訂閱。開始設定前,請準備自己的有效連線資料,並確認使用期限與參數。
Mac 應選擇 Apple 晶片版還是 Intel 版?
在 Apple 選單中開啟「關於這台 Mac」,查看顯示的是「晶片」還是「處理器」:Apple 晶片裝置選擇 Apple 晶片版,Intel 處理器裝置選擇 Intel 版。下載頁提供對應的兩個 dmg 按鈕,不必憑外觀判斷。首次開啟若出現無法驗證開發者的提示,確認安裝檔來自本站後,前往系統設定的「隱私權與安全性」選擇「仍要打開」;公司管理的裝置也可能需要管理員授權。
Windows 顯示 SmartScreen 風險提示,如何繼續安裝?
先確認安裝程式來自本站下載頁,且符合裝置架構;Windows 提供 64 位元安裝程式。安裝檔未經程式碼簽署,首次執行時可能觸發 SmartScreen。確認來源並決定繼續後,按一下「其他資訊」,再選擇「仍要執行」。不要為了執行單一程式而長期關閉系統防護。若沒有繼續按鈕,或裝置受組織政策管理,請聯絡裝置管理員;若明確偵測到惡意軟體,請先停止執行並查證。
Mac 顯示無法驗證開發者或 App 已損毀,該怎麼辦?
先確認下載來源與晶片版本,將 App 移至 Applications 後再開啟。若出現無法驗證開發者的提示,前往系統設定 → 隱私權與安全性,找到相關記錄並選擇「仍要打開」。若提示「已損毀」,確認 App 完整且來自本站後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再試一次。此命令會清除指定 App 的延伸屬性,不應用於來源不明的程式,也不應對其他目錄批次執行。
Android 安裝遭到封鎖,應修改哪項權限?
從本站下載頁取得適用於 arm64 裝置的安裝檔後,若系統提示不允許從此來源安裝,請前往系統設定中的「安裝未知應用程式」,只授權目前用來開啟安裝檔的瀏覽器或檔案管理員,再返回繼續安裝。完成後可撤銷該來源的權限。不同裝置的設定名稱可能略有差異;若出現剖析失敗,請檢查檔案是否下載完整、裝置架構是否相符,以及是否受到工作資料或家長監護政策限制。
Linux 的 deb、rpm、AppImage 該如何選擇?
Debian、Ubuntu 等通常選擇 deb,Fedora 等通常選擇 rpm;若要直接執行檔案,可考慮 AppImage。先從本站下載頁選擇符合系統架構的檔案,再使用發行版的套件管理員安裝。AppImage 需要先授予執行權限,可對實際下載的檔案執行 chmod +x 後再執行;部分發行版也需要相應的 FUSE 執行支援。安裝前請查看套件管理員顯示的相依性提示,不要只憑副檔名就認定所有發行版都相容。
iPhone / iPad 首次開啟時,VPN 權限該如何處理?
準備好自己的訂閱或伺服器資訊後,依照教學完成匯入,再啟動連線。系統要求加入 VPN 設定時,請確認要求來自 Shadowrocket,並依提示允許及完成裝置驗證。若先前曾拒絕,可重新發起連線,並查看系統的 VPN 管理設定。受管理的裝置可能禁止加入個人 VPN;此時請聯絡管理員,不要刪除組織設定。允許 VPN 設定只會建立本機連線權限,仍須有有效伺服器及正確參數才能存取網路。
已有訂閱連結,如何匯入 Shadowrocket?
先從自己的服務商資料複製完整訂閱連結,開啟 Home,進入 Add Server,將 Type 設為 Subscribe,在 URL 貼上連結並儲存;也可填寫方便辨識的名稱。返回清單後等待內容載入,再選擇其中一台伺服器測試。貼上前後請確認沒有多出空格、換行或遺漏查詢參數。訂閱連結通常包含存取憑證,請勿放進公開截圖、聊天紀錄或回報內容;具體操作位置可參考訂閱匯入教學。
訂閱匯入失敗,如何分辨是連結問題還是網路問題?
先檢查 URL 是否完整、訂閱是否到期,以及連結回傳的是否為用戶端可辨識的訂閱內容,而非登入頁面或錯誤頁面。接著分別透過 Wi-Fi 與行動網路嘗試一次,觀察錯誤是否隨網路改變。若出現 HTTP 錯誤,記下狀態碼;若逾時,檢查目前網路與訂閱網址是否可連線。不要反覆刪除原本可用的項目,也不要公開完整連結。仍無法確認時,只將去識別化的錯誤資訊和操作步驟提供給自己的服務商。
如何更新訂閱?更新後伺服器為什麼變了?
在 Home 找到相應的訂閱群組,使用該群組的更新功能,等請求完成後再查看清單。更新會依訂閱網址回傳的內容刷新項目;伺服器端移除或調整伺服器時,本機名稱與可選項目也可能改變。更新前先記下目前使用的項目與自訂設定,手動新增的伺服器則另行保存。若清單變空或出現錯誤,先檢查連結是否有效,不要連續重複發出請求;更新訂閱也不會自動取代 Config 中另外管理的規則檔。
VLESS 等通訊協定該如何填寫?為什麼匯入後仍無法連線?
依照自己的伺服器提供的通訊協定資料選擇 Type,不要混用 VLESS、VMess、Trojan 或 Shadowsocks 的欄位。匯入只能減少手動輸入,不能證明所有參數都正確;仍須逐項檢查位址、連接埠、驗證資訊、TLS、傳輸方式及相關主機名稱。連線失敗時,先逐項比對原始資料,再測試單一項目。不要為了消除錯誤而任意關閉憑證驗證,也不要在公開回報中貼上含驗證資訊的完整連線連結。
訂閱、伺服器與 Config 設定檔各自管理哪些內容?
伺服器項目儲存具體連線參數;訂閱網址用來取得及更新一組伺服器;Config 中的設定檔則用於管理規則、策略及相關網路設定。三者會搭配使用,但不應視為同一份備份。修改前記下目前啟用的 Config,並另外保存手動新增的伺服器與已有訂閱資料。匯入新的規則檔後,請確認其策略名稱能對應到實際可用的選項;只更新訂閱,不能據此判定本機規則也已同步更新。
掃描 QR Code 或手動新增後,應檢查哪些內容?
使用 Scan QR Code 或 Add Server 後,先核對 Type、伺服器位址、連接埠及驗證欄位,再檢查 TLS 與傳輸參數是否符合自己的原始資料。QR Code 也可能只包含部分資訊,掃描成功不代表伺服器可用。儲存後先選取單一項目執行 Connectivity Test,再嘗試連線並存取目標網站。需要回報時,請遮住 QR Code、驗證欄位及訂閱 URL,只保留錯誤提示與不含憑證的設定項目名稱。
Global Routing 的 Config、Proxy、Direct 該如何選擇?
Config(設定)依目前設定檔中的規則決定連線去向,適合檢查規則分流;Proxy(代理)用來檢查流量經所選代理處理時的狀況;Direct(直連)則用來比對本機網路。排查時一次只切換一種模式,記錄存取同一目標的結果。Proxy 無法讓無效的伺服器恢復正常,Direct 也不能證明代理連線正常。完成比對後,請恢復所需模式,並檢查目前選取的 Config 是否正確、策略是否引用有效伺服器。
Home 開關無法開啟,或一開啟就中斷,該怎麼辦?
先確認已選取有效伺服器,再查看系統是否正等待加入 VPN 設定或進行裝置驗證。若開關立即關閉,請檢查系統 VPN 設定中是否有衝突的連線,以及裝置是否受組織政策限制;需要切換時,先正常停止其他連線。保留錯誤提示後重新啟動 App 再試,不要一開始就刪除所有設定。若始終無法建立連線,請依問題診斷頁記錄系統版本、觸發步驟及去識別化記錄,以區分權限問題與伺服器連線問題。
顯示已連線卻無法上網,應依什麼順序排查?
先中斷連線,確認本機網路可以存取平常使用的網站;再重新連線,對目前的伺服器執行 Connectivity Test。接著暫時以 Proxy 和 Config 比對同一個目標:若 Proxy 可用但 Config 異常,優先檢查規則、策略與 DNS;若兩者都失敗,檢查伺服器狀態、驗證參數及網路連線狀況。顯示已連線只代表本機連線已建立,不表示所有目標都能存取。每次只修改一項,並保留原設定以便還原。
Connectivity Test 逾時,但有時仍能瀏覽網站,該如何判斷?
Connectivity Test 的結果會受到測試目標、測試方式及當下網路影響,不能單獨代表所有 App 的存取狀況。先確認選取的伺服器,再測試實際需要存取的網站,並換另一種網路重試一次。若只有測試失敗但實際使用正常,請檢查測試目標是否可連線;若實際存取也持續失敗,再檢查伺服器、連接埠與 DNS。不要把單次測試結果當成長期速度結論,也不要為了改善單一測試結果而同時更改多項設定。
只有部分網域無法開啟,需要修改 DNS 嗎?
先比對網域的規則命中結果與目前策略,確認是否有 DOMAIN-SUFFIX 或 GEOIP 規則將連線導向不合適的去處。接著查看相關請求是否發生解析失敗,並與另一種網路的結果比對。修改 DNS 前先保存目前的 Config,逐項調整並重新測試同一網域;不要同時更換伺服器和所有解析設定。若網域可以解析,但連線建立失敗,應繼續檢查 TLS、伺服器連線狀況及目標網站本身,而不是只反覆修改 DNS。
背景耗電增加,On Demand 應該開啟還是關閉?
先在系統電池用量統計中確認耗電時段、背景活動與實際流量,再查看記錄是否頻繁重新連線。On Demand 會依條件觸發連線,是否適合開啟取決於使用情境;若網路頻繁切換或規則反覆符合,應先檢查觸發條件。可在相近的使用情境下暫時關閉 On Demand 進行比較,並記錄是否改善。持續大量傳輸及其他 App 的活動也會影響耗電,不要只因 VPN 圖示一直顯示就判定原因。
介面是英文,或更新後設定位置改變,該怎麼辦?
本手冊保留 Home、Config、Settings、Global Routing、Add Server 等英文介面名稱,可直接依名稱尋找,不必猜測中文近義詞。不同平台及 App 更新後的版面可能不同,請先依操作目的尋找相應設定,再對照教學步驟。更新前先保存目前可用的設定;更新後若有異常,先確認所選伺服器、Global Routing 和 Config 是否維持原設定,再逐項重新測試。不要只因設定位置改變就清除所有資料。
繼續查看相關步驟
需要從頭開始操作時,請閱讀教學;已有明確症狀時,請前往問題診斷。記錄問題時,請寫明裝置系統、操作步驟、錯誤原文,以及更換網路後的比對結果;回報前請移除訂閱連結與驗證資訊。