官方手冊 · 常見問答

Shadowrocket 常見問題

依裝置、匯入方式和連線狀況查找說明。先確認目前設定,每次只調整一項,並保留原始設定以便比對。

正版與購買

依平台確認取得方式,並區分應用程式購買紀錄、設定備份與現有連線資料。

電腦和 Android 能使用 Shadowrocket 嗎?各平台如何取得?

可以。Shadowrocket 提供 iPhone、iPad、Mac、Windows、Android 和 Linux 版。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片與 Intel 兩種安裝檔;Windows、Android 和 Linux 也應依裝置選擇相應格式。電腦和 Android 版請從本站全平台下載頁取得,安裝檔透過本站 /dl/shadowrocket/ 路徑提供;首次開啟時的系統允許步驟請參閱下方安裝分類。

iPad 可以安裝嗎?如何確認商店中的應用程式?

可以,iPhone 和 iPad 共用同一筆應用程式購買紀錄,系統需求請以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。請在商店產品頁一併確認名稱 Shadowrocket、官方圖示、開發者 Shadow Launch Technology Limited 和應用程式 ID 932747118,不要只憑中文別稱或搜尋結果中的相似圖示判斷。安裝時請使用持有該應用程式購買紀錄的 Apple 帳號。

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

先開啟本頁提供的 App Store 產品頁,確認是搜尋不到,還是目前商店無法提供此應用程式。中國大陸商店未上架此應用程式;請在裝置設定中前往 Apple 帳號的 Media & Purchases,查看帳號與 Country/Region,並確認 Screen Time 的內容分級限制。若確實需要變更地區,請依 Apple 帳號設定中的官方流程處理餘額、現有訂閱和付款資料要求,不要只變更裝置語言。商店是否可用,請以目前帳號實際開啟的產品頁為準。

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

iPhone / iPad 換機或重新安裝時,請先使用原購買帳號進入 App Store 的已購項目清單,再搜尋 Shadowrocket 並重新下載;若使用不同帳號,商店可能不會顯示原購買紀錄。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,這四種平台重新從本站下載即可。應用程式購買紀錄不等於設定備份,移除舊裝置上的應用程式前,請另外保存現有伺服器資訊與 Config,並妥善保管其中的認證資料。

購買用戶端後,還需要準備自己的連線資料嗎?

需要。用戶端一次買斷 ≠ 連線服務方案。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,這些價格說明的是用戶端的取得方式。使用前請準備自己已有的訂閱或伺服器資訊,包括協定類型、伺服器位址、連接埠和認證欄位。本站是 Shadowrocket 官方網站與官方手冊,不提供、不販售也不推薦節點或訂閱;匯入與排解說明皆以使用者已有合法使用權的連線資料為前提。

安裝與首次開啟

先確認裝置架構和檔案來源,再處理系統權限。由組織管理的裝置請遵循管理員要求。

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

在 Mac 的 Apple 選單開啟「關於這台 Mac」,查看顯示的是「晶片」還是「處理器」。若顯示 Apple 晶片,請選擇下載頁的 Mac Apple 晶片版 dmg;若顯示 Intel 處理器,請選擇 Mac Intel 版 dmg,不要依電腦外觀或購買年份猜測。開啟 dmg 後,將 Shadowrocket 移至 Applications 再啟動。若出現無法驗證開發者的提示,請先確認安裝檔來自本站,再依本分類的 macOS 允許步驟處理;不要反覆更換不相容的晶片版本。

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

先確認檔案確實來自本站下載頁,且下載後的檔名與所選 Windows 安裝檔相符。Windows SmartScreen 顯示「Windows 已保護您的電腦」時,可展開「其他資訊」,確認來源後選擇「仍要執行」。若安裝需要系統管理員權限,請先檢查使用者帳戶控制提示中的程式和路徑,再確認是否繼續。若安全軟體明確通報威脅,或無法確認檔案來源,請停止執行並查明原因;不要為了安裝而長期關閉整個系統的防護。由組織管理的裝置請先聯絡管理員。

Mac 顯示無法驗證開發者或應用程式已損壞,如何首次開啟?

確認 dmg 來自本站,且應用程式已放入 Applications。遇到「無法驗證開發者」時,先嘗試開啟一次,再前往系統設定的「隱私權與安全性」,找到此次遭阻擋的紀錄並選擇「仍要打開」,接著依系統要求確認。若提示「已損壞」,請確認下載是否完整;確認來源後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再重新開啟。此命令會清除指定應用程式的延伸屬性,只能對已確認來源的這個路徑執行,請勿擴大至整個目錄或磁碟。

Android 和 Linux 首次安裝時各有哪些注意事項?

Android 請使用本站下載頁提供的 arm64 apk;若系統阻擋安裝,請為此次使用的瀏覽器或檔案管理員開啟「允許安裝未知的應用程式」,安裝完成後即可撤銷此權限。Linux 請依發行版選擇 deb、rpm 或 AppImage:Debian / Ubuntu 使用 apt 安裝本機 deb,Fedora 系發行版使用 dnf 安裝本機 rpm;AppImage 須先透過檔案屬性或 chmod +x 設定執行權限,再執行下載的檔案。命令中的路徑必須替換為實際檔案路徑;遇到相依套件或執行階段程式庫錯誤,請依發行版提示處理。

首次開啟後連線開關無法啟用,或立即自動關閉,該怎麼辦?

先確認 Home 中已有有效的伺服器項目,且已選取準備使用的項目。iPhone / iPad 首次連線時,須在系統提示中允許加入 VPN 設定檔,並依要求完成裝置認證;若取消授權,單獨點選開關通常無法建立連線。若先前拒絕授權,可重新發起連線並查看系統 VPN 設定。接著檢查是否仍有其他 VPN 連線在執行,以及 On Demand 是否正依條件接管連線。受管理裝置的設定限制應由管理員確認;若錯誤無法排除,請記下提示原文再進一步檢查。

訂閱與伺服器匯入

分別確認 Subscribe、Add Server 和 Config 的用途,並保留現有可用項目作為比對。

匯入現有訂閱失敗,應先檢查連結還是設定檔?

先檢查輸入內容,再檢查回傳內容。在 Add Server 中選擇 Subscribe,貼上自己已有的完整訂閱連結,確認開頭、路徑和查詢參數都沒有遺漏,並移除複製時帶入的空格或換行。連結可能包含認證資料,請勿貼到公開聊天或截圖中。若請求成功但匯入失敗,請確認回傳的是支援的訂閱內容,而不是登入頁面、到期提示或網頁正文;同時確認訂閱仍有效,且裝置日期正確。若現有項目仍可連線,請先保留,不要為了測試而刪除所有設定。

Scan QR Code 和 Add Server 手動輸入,該如何選擇?

若 QR Code 來自自己已有的連線資料,且格式受支援,可在 Home 使用 Scan QR Code 並允許存取相機;辨識後仍須檢查協定類型、位址和連接埠。QR Code 模糊或內容不受支援時,不必反覆掃描,可進入 Add Server 手動輸入。手動新增時先選對 Type,再依原始資料填寫密碼、UUID、TLS、SNI 或其他對應欄位;不同協定的欄位不能互相替代。不要將設定檔下載網址當成單一伺服器位址,也不要把訂閱 URL 填入密碼欄位。

更新 Subscribe 後項目有所變動,或更新失敗,該怎麼辦?

更新前先確認要重新整理的 Subscribe 群組,必要時記下目前使用項目的名稱和所引用的策略。更新會依訂閱回傳內容調整項目;名稱變更、項目移除或位址更新,不代表用戶端損壞。若重新整理失敗,請依序檢查目前網路、訂閱有效期限和回傳格式,並確認連結沒有被編輯截斷。更新後回到 Home 檢查所選伺服器,再確認 Config 引用的策略名稱是否仍存在;不要假設原本的選取狀態和規則引用一定會自動保留。

Subscribe 和 Config 有什麼差別?匯入其中一個就夠了嗎?

Subscribe 主要用於取得或更新現有伺服器項目;Config 用於管理規則、策略引用及相關設定,兩者用途不同。若只有伺服器清單,仍須檢查 Global Routing 和目前啟用的 Config;若只有設定檔,也應確認其中引用的伺服器或策略確實存在。匯入新的 Config 前,請先保留目前可用的設定,並檢查來源、規則順序及引用名稱。設定中出現的 PROXY 等策略識別字必須與實際定義相符,不能只因文字相似就認定已正確連結。

介面是英文,匯入和連線時應認哪些選項?

先依用途辨識介面項目:Home 查看伺服器和連線狀態,Add Server 新增已有伺服器,Subscribe 匯入訂閱,Scan QR Code 掃描已有資料,Config 管理設定,Global Routing 選擇連線處理方式,Settings 查看設定,Data 查看流量資訊。官方手冊保留這些英文原文,方便直接對照介面。不同平台的選項位置可能不同,請依名稱而非固定位置尋找;不要將 Proxy 這個模式名稱與設定中的 PROXY 策略識別字混淆。

規則進階與故障排解

區分本機網路、伺服器連線、DNS 和規則比對結果。測試結果只適用於相應條件,不能取代實際連線驗證。

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

日常依規則分流通常選擇設定(Config),連線會依目前 Config 中符合的規則處理;代理(Proxy)會透過目前的代理路徑處理連線,適合暫時進行對照測試;直連(Direct)則用於測試不經代理路徑的連線。切換模式無法修正錯誤的伺服器參數,也不能取代訂閱有效性檢查。排解時可固定同一個測試目標,分別比較 Direct 與 Proxy,再回到 Config 檢查規則,避免同時變更伺服器、DNS 和模式而無法判斷原因。

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

顯示已連線通常只代表裝置已建立本機 VPN 或代理處理通道,不表示遠端伺服器、DNS 和目標網站都可正常使用。先中斷 Shadowrocket,確認目前 Wi-Fi 或行動網路本身可以正常連線;再檢查 Home 中選取的伺服器和認證資訊。使用同一個目標比較 Direct、Proxy 和 Config 的結果,必要時執行 Connectivity Test。最後確認錯誤屬於連線逾時、認證失敗還是名稱解析失敗,再依錯誤類型處理;不要只因開關仍開啟就連續更換所有設定。

使用 Config 時只有部分網站異常,如何檢查規則和 DNS?

先記下異常網站的網域,並在連線紀錄中查看符合的規則和策略,確認是否被較早出現的 DOMAIN、DOMAIN-SUFFIX 或 IP-CIDR 規則攔截。規則通常依序比對,FINAL 應保留作為兜底規則;檢查符合規則後引用的 PROXY、DIRECT 或 REJECT 是否符合預期。若是解析錯誤,再確認 Config 中的 DNS 設定及實際網路連線狀況。每次只調整一處並重新測試,不要只因某個頁面無法開啟就大量刪除規則;同一個網站也可能連線至多個不同網域。

連線後耗電增加,On Demand 應如何設定?

耗電會受到實際流量、訊號強弱、重新連線頻率、協定實作及背景活動共同影響,不能只依協定名稱判斷。先查看系統電池用量統計中的相關時段,再觀察是否有持續下載、弱訊號下反覆連線或密集測試。On Demand 會依設定的網路條件觸發連線,設定前應先確認哪些 Wi-Fi 或行動網路情境需要啟用;條件互相衝突可能導致反覆切換。排解時可暫時關閉 On Demand,改為手動連線進行對照;確認穩定後再逐一恢復條件,不要頻繁執行整組測試。

Connectivity Test 能證明實際連線正常嗎?回報問題時應保留哪些資訊?

不能。Connectivity Test 的結果取決於測試方式和測試目標,某項測試成功不代表所有網站或應用程式都能使用,也不能直接用來判定實際傳輸速度。回報前請記錄裝置系統、使用的平台、目前的 Global Routing 模式、觸發問題的操作及錯誤原文,並說明 Direct 與 Proxy 的對照結果。分享日誌或截圖前,請移除訂閱 URL、密碼、金鑰、UUID、伺服器位址及其他帳號資料。請優先提供最精簡的重現步驟,不要直接公開完整 Config 或整份連線紀錄。