官方手冊 · 常見問題
Shadowrocket
安裝、訂閱與連線問答
適用於 iPhone、iPad、Mac、Windows、Android 與 Linux。先找出問題所在階段,再展開答案;匯入與連線說明皆以使用者已有自己的訂閱或伺服器資訊為前提。
先處理取得方式與系統權限,再確認匯入結果,最後檢查規則和連線。請勿同時修改多項設定,以免無法比較變更前後的結果。
查看客戶端下載正版查核與購買
依裝置確認取得方式;查核商店版本時,請以開發者、官方圖示及 App ID 為準。
電腦和 Android 能用嗎?分別要如何取得?
可以。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片版與 Intel 版,其他平台則依裝置與發行版選擇。前往客戶端下載頁,iPhone / iPad 會連至 App Store,其餘安裝檔由本站 /dl/ 路徑提供。首次開啟若遭系統阻擋,請先確認檔案來自本站,再依本頁安裝分類中的步驟設定系統允許執行。
如何確認 App Store 上的 Shadowrocket 是正版?
別只看搜尋結果中的名稱。開啟產品頁,確認名稱為 Shadowrocket、開發者為 Shadow Launch Technology Limited,並核對產品頁網址中的 App ID 932747118;圖示也應與本站頁首的官方圖示一致。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費,各商店的金額以當地頁面顯示為準。若名稱或圖示相似,但開發者或 App ID 不符,請勿依照本手冊繼續操作。
在 App Store 搜尋不到 Shadowrocket,先檢查哪些項目?
先從客戶端下載頁開啟 App Store 產品頁,確認是搜尋結果沒有顯示,還是商店提示目前所在地區無法使用。中國大陸 App Store 目前未上架此應用,請確認「媒體與購買項目」使用的 Apple 帳號國家或地區,而非只檢查裝置語言。也請檢查「螢幕使用時間」中的內容分級限制。若要變更地區,請依序前往「設定 → Apple 帳號 → 媒體與購買項目 → 檢視帳號 → 國家或地區」,並先了解餘額、訂閱與付款方式的相關要求。
iPad 可以安裝嗎?換機或重新安裝需要再買一次嗎?
iPad 可以安裝,系統需求請以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 一次性付費 $2.99;兩種裝置使用同一個購買帳號時,可從已購項目重新下載。Mac / Windows / Android / Linux 版免費。換機後先確認登入原購買帳號,再前往 App Store 帳號頁面尋找已購項目;項目名稱可能因系統版本而異。重新下載應用程式不會自動還原所有本機伺服器與設定,換機前請另外備份,並妥善保管備份中的憑證。
取得客戶端後,為什麼還需要準備訂閱或伺服器資訊?
客戶端一次性買斷 ≠ 線路方案。Shadowrocket 負責讀取設定、比對規則並建立連線;購買應用程式不會提供伺服器位址、驗證資訊或 Subscribe 連結。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。這兩種取得方式都不包含線路服務。本站不提供、銷售或推薦節點或訂閱。以下操作均以使用者已有自己的訂閱或伺服器資訊為前提,匯入前請確認資料完整且仍有效。
安裝與首次開啟
先確認檔案來源與裝置架構。系統允許執行僅適用於已查核的應用程式;受管理的裝置應遵循管理員政策。
Mac 要選 Apple 晶片版還是 Intel 版?
在 Mac 的 Apple 選單中開啟「關於這台 Mac」,查看「晶片」或「處理器」欄位。若顯示 Apple 晶片,請選 Mac Apple 晶片版;若顯示 Intel,請選 Mac Intel 版,勿依電腦外觀或購買年份猜測。兩種安裝檔都可在客戶端下載頁的 Mac 區域取得。下載後開啟磁碟映像檔,將 Shadowrocket 拖曳至 Applications。首次開啟若出現無法驗證開發者的提示,確認來源後前往「系統設定 → 隱私權與安全性」處理,不必反覆更換晶片版本。
Windows 出現 SmartScreen 風險提示,要如何檢查並繼續安裝?
先確認下載是從本站客戶端下載頁開始,安裝檔由本站 /dl/ 路徑提供,並確認準備執行的是剛下載的檔案。出現 SmartScreen 提示時,可展開「更多資訊」,核對檔案後選擇「仍要執行」,再閱讀系統權限確認畫面。若沒有此選項,或裝置由公司管理,請勿嘗試繞過組織政策,應聯絡裝置管理員。系統允許執行只代表程式可以啟動,不表示伺服器資訊已設定完成;首次開啟後仍須匯入使用者已有的資訊。
Mac 提示無法驗證開發者或應用程式已損毀,該如何處理?
先確認安裝檔來自本站,且已將 Shadowrocket 放入 Applications。若提示無法驗證開發者,先嘗試開啟一次,再前往「系統設定 → 隱私權與安全性」,找到相關提示並選擇「仍要打開」,依系統指示確認。若提示應用程式已損毀,請先重新下載並安裝;若來源確認無誤但仍出現提示,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app 後再次開啟。此命令只適用於該應用程式,勿擴大至整個目錄;受管理的裝置請先詢問管理員。
Android 安裝遭到阻擋,需要開啟哪項權限?
從客戶端下載頁取得適用於裝置的 Android 安裝檔後,系統可能會要求為目前使用的瀏覽器或檔案管理員開啟「允許安裝未知應用程式」。只授權實際用來開啟安裝檔的應用程式,安裝完成後即可關閉權限。若出現無法解析套件的提示,先確認下載是否完整、裝置架構是否相符,再重新下載;勿連續重複安裝同一個失敗檔案。在微信中無法開始下載時,請依頁面提示改用系統瀏覽器。首次連線出現 VPN 設定確認時,請先閱讀應用程式名稱與權限說明,再決定是否允許。
Linux 要選 deb、rpm 還是 AppImage?
依發行版的套件系統選擇:Debian、Ubuntu 等通常使用 deb;採用 RPM 套件系統的發行版則選擇 rpm。AppImage 適合以獨立檔案啟動的情況,仍須符合執行所需的相依套件。從客戶端下載頁取得套件後,可在 deb 檔所在目錄執行 sudo apt install ./Shadowrocket.deb,其中本機檔名須替換成實際名稱。AppImage 須先授予執行權限,例如 chmod +x Shadowrocket.AppImage,再執行該檔案。若提示架構或相依套件不符,請先處理錯誤訊息,勿強制安裝。
訂閱與伺服器匯入
先確認連結或欄位內容,再儲存並測試。訂閱連結、設定備份與 QR Code 都可能包含驗證資訊。
已有 Subscribe 連結,要如何匯入並確認結果?
先確認手上的是自己已有的完整訂閱連結,而不是網頁說明網址。在 Home 開啟 Add Server,選擇 Subscribe,將連結貼到對應的 URL 欄位,並填入方便辨識的名稱,接著儲存並等待取得完成。返回清單後,確認群組名稱、伺服器項目與通訊協定都符合預期,別只因出現一個群組就判定匯入成功。訂閱連結通常含有驗證參數,屬於敏感資料,勿放入公開截圖或求助訊息。欄位與操作入口的詳細說明,請參閱訂閱手冊。
訂閱匯入失敗或清單空白,應依什麼順序排查?
先檢查連結前後是否有空格、換行、截斷或多餘標點,再確認連結是否仍有效。接著依錯誤類型排查:逾時通常先確認目前網路能否連上訂閱網址;驗證失敗則核對連結參數;若取得成功但沒有項目,請確認回傳內容是否為支援的訂閱格式,而非登入頁或錯誤頁面。勿將完整連結交給他人代測。若另一個既有訂閱能正常更新,問題較可能出在目前的連結或回傳內容;請保留錯誤訊息,再向原資訊提供者確認。
只有伺服器參數時,Add Server 要如何填寫?
在 Home 開啟 Add Server,先依既有資料選擇通訊協定,再填寫 Address、Port 與相應的驗證欄位。Shadowsocks 的加密方式、VMess 或 VLESS 的識別欄位,以及 Trojan 的驗證資訊等不能互相替代;TLS、SNI 與傳輸參數也應依原始資料逐項填寫。伺服器位址通常不應包含網頁路徑,連接埠須填入提供者給的數字。儲存後先核對欄位,再選擇該伺服器進行測試。勿為排除錯誤而任意關閉憑證驗證;需要修改時,先確認原設定的要求。
如何更新訂閱?更新會覆蓋手動整理的內容嗎?
在 Home 找到對應的 Subscribe 群組,使用該群組的更新功能,等待完成後再確認項目是否變更。操作位置可能因版本與平台而異,請以目前群組提供的選單為準。訂閱更新會依遠端回傳內容重建或調整所屬伺服器,不應視為手動修改的名稱、排序或欄位會永久保留。重要調整請先備份;需要長期保留的獨立伺服器可分開管理。更新失敗時先保留舊群組,勿立即刪除,以免一併失去排查依據。
多個訂閱出現重複伺服器,如何整理才不會誤刪?
先依來源與用途為既有訂閱群組命名,再確認是同一連結重複匯入,還是不同訂閱包含相同伺服器。勿只看顯示名稱判斷是否重複,應核對通訊協定、位址、連接埠及必要的傳輸參數;名稱相同也可能是不同連線。確認某個群組是重複匯入後,先備份再刪除整個群組,避免逐項刪除後下次更新又重新出現。刪除前檢查目前選取的伺服器是否屬於該群組。備份檔可能包含密碼與訂閱參數,請存放於受保護的位置。
規則分流與故障排查
「開關顯示已連線」、「伺服器可連線」與「目標請求成功」是不同結果。請依基礎網路、系統授權、伺服器、DNS、規則的順序逐步縮小範圍。
連線開關無法開啟,或開啟後立刻關閉,怎麼辦?
先確認已選取有效伺服器,並完成系統要求的 VPN 設定授權。若首次授權時取消,請返回應用程式重新嘗試並閱讀系統提示;仍無法連線,可在系統設定中確認是否已建立對應的 VPN 設定。接著檢查是否有其他 VPN 連線或裝置管理政策占用網路權限,避免同時啟用多個互相衝突的連線。若開關會隨網路變化自動切換,請檢查 On Demand 條件。最後記下錯誤提示與觸發步驟,再查看診斷資訊;一開始不要清除所有設定。
開關顯示已連線,但網頁無法開啟,如何找出問題?
先暫時關閉連線,確認目前的 Wi-Fi 或行動網路本身可正常使用;若網路需要網頁認證,請先完成登入。接著檢查伺服器驗證資訊、有效狀態與系統時間,並使用 Connectivity Test 協助判斷是否可連線;但測試成功不代表所有網頁請求都會成功。若所有目標都失敗,優先檢查伺服器與 DNS;若只有部分目標失敗,則查看請求記錄中的命中規則與策略。每次只修改一項設定,並記錄測試結果,才能判斷變化是由網路、伺服器還是規則造成。
Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?
Config 會依目前設定檔中的規則決定請求走向,適合日常使用已核對過的規則;Proxy 會將可代理的流量交由目前選取的代理策略處理,可用於對照測試;Direct 則讓請求直接送出,可用來檢查基礎網路。這三種模式不是三台伺服器,也不會自動修復失效的訂閱。測試前先記下原本的選項,使用同一個目標依序比較,完成後再恢復所需模式。Config 的實際結果也會受到規則順序、策略引用及最後的預設規則影響。
DOMAIN-SUFFIX 或 REJECT 沒有如預期生效,該先檢查什麼?
先確認 Global Routing 設為 Config,且目前使用的是剛修改的設定檔。規則通常依序比對,目標可能已先被較前面的 DOMAIN、IP-CIDR 或其他規則處理,因此不會執行新加入的規則。確認 DOMAIN-SUFFIX 填的是網域後綴,而非完整網頁網址,再從請求記錄查看實際連線的網域與命中的策略。REJECT 會依比對條件拒絕連線,無法辨識頁面內容;同一頁面可能會請求多個網域,因此不能只看頁面外觀判斷某條規則是否生效。
介面是英文,建議從哪些功能入口開始?
先依用途辨識幾個入口:Home 用來查看與選取伺服器,Add Server 用來新增既有資訊,Subscribe 用來管理訂閱,Config 用來管理設定檔,Global Routing 用來選擇連線模式,Settings 用來查看設定。官方手冊保留這些英文名稱,方便對照實際介面,不必先翻譯每個詞才能操作。若系統支援個別設定應用程式語言,可在裝置設定中查看 Shadowrocket 的語言選項;可選語言以實際介面為準。若不同平台的入口位置有差異,先確認功能名稱,再依相關章節操作。
使用時耗電增加,需要調整 On Demand 或診斷測試嗎?
先在系統電池用量統計中,區分應用程式前景使用時間、背景連線時間與裝置整體網路活動;勿只看單次百分比就判斷故障。持續下載、頻繁重新連線、訊號較弱、密集執行 Connectivity Test,以及持續記錄詳細日誌,都可能增加網路與處理負載。檢查 On Demand 是否在目前網路條件下反覆觸發,並減少不必要的重複測試。每次只調整一項,在相近的使用時間與網路環境下比較;排查完成後,恢復適當的日誌等級。勿為了降低耗電而任意修改不熟悉的驗證或規則欄位。