官方手冊 / FAQ

Shadowrocket 常見問題

依取得、安裝、匯入、連線四個階段查找。先確認問題發生在哪一步,再調整相關設定,避免同時變更伺服器參數與規則。

取得方式說明

正版查驗與價格

先核對平台、商店帳戶與購買紀錄,再判斷是否需要重新取得。

Shadowrocket 電腦和 Android 版能用嗎?各平台如何收費?

可以。iPhone / iPad 版在 App Store 售價 $2.99,採一次性付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。電腦與 Android 版的安裝檔可從本站的應用程式頁面取得,並透過本站 /dl/shadowrocket/ 路徑下載。首次安裝若遭系統阻擋,請先確認檔案來源與裝置架構,再依本頁安裝分類的步驟允許安裝,請勿直接關閉整體系統防護。

如何核對 App Store 上的 Shadowrocket?

開啟產品頁,核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、App ID 932747118,並比對本站頁首的官方圖示。iPhone / iPad 版在 App Store 售價 $2.99,採一次性付費;Mac、Windows、Android、Linux 版免費。請勿只憑搜尋結果中的名稱或相似圖示判斷;商店顯示的當地貨幣價格與系統需求,請以 App Store 頁面標示為準。

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

請先使用本站提供的 App Store 產品頁連結,確認是搜尋結果未顯示,還是目前所在商店地區無法下載。中國大陸商店沒有此 App;可在系統 Settings 的 Apple Account 中前往 Media & Purchases,查看帳戶的 Country/Region。若確實需要更改,請依帳戶設定中的官方地區變更流程操作,並先了解餘額、現有訂閱及付款方式的相關要求。裝置語言與裝置地區不等於商店帳戶地區,反覆切換系統語言通常無法解決問題。

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

iPhone / iPad 使用原購買帳戶時,請先在 App Store 的已購項目中尋找並重新下載;兩種裝置可共用同一帳戶的購買紀錄。iPhone / iPad 版在 App Store 售價 $2.99,採一次性付費;Mac、Windows、Android、Linux 版免費。若商店仍顯示購買按鈕,請先核對購買紀錄、登入帳戶與商店地區,不必急著重複付款。重新安裝 App 不會一併還原原有設定,換機前請另外備份自己的設定資料。

iPad 可以安裝嗎?在哪裡確認系統需求?

可以。iPhone / iPad 版透過 App Store 取得,售價 $2.99,採一次性付費;Mac、Windows、Android、Linux 版免費。iPhone 與 iPad 的系統需求請以 App Store 頁面標示為準,直接在裝置上查看產品頁的相容性資訊最為方便。若按鈕無法使用,請分別檢查系統相容性、帳戶地區、裝置儲存空間,以及「螢幕使用時間」中的安裝限制;這些因素與規則檔案是否正確並無直接關係。

取得用戶端後,是否已包含可用的連線節點?

一次買斷用戶端 ≠ 購買連線方案。Shadowrocket 負責讀取設定、執行規則並建立連線;使用前,使用者必須已有自己的訂閱或伺服器資訊。iPhone / iPad 版在 App Store 售價 $2.99,採一次性付費;Mac、Windows、Android、Linux 版免費。本站提供用戶端與官方手冊,不提供、不銷售也不推薦節點或訂閱。App 安裝成功、設定匯入成功,以及伺服器能否連線,是三個需要分別確認的環節。

裝置與權限

下載安裝與系統允許

選擇適用於裝置的檔案;確認來源為本站後,再處理對應的系統提示。

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

開啟 Apple 選單中的「關於這台 Mac」。若顯示 Apple 晶片名稱,請選 Apple 晶片版;若顯示 Intel 處理器,請選 Intel 版,不要只根據電腦購買年份判斷。兩個版本都可在本站的應用程式頁面取得。首次開啟若提示無法驗證開發者,確認檔案來自本站後,前往系統設定的「隱私權與安全性」,查看相應的阻擋紀錄並選擇「仍要打開」。若架構不符,請改選正確的安裝檔;反覆允許開啟無法修正架構錯誤。

Mac 提示無法驗證開發者或 App 已損毀,該如何處理?

請先確認安裝檔來自本站,並將 App 移至 Applications。若提示無法驗證開發者,先嘗試開啟一次,再前往系統設定的「隱私權與安全性」,選擇該 App 的「仍要打開」。若提示 App 已損毀,請先重新下載並確認晶片版本;確認來源後,可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再重新開啟。此命令會移除 App 的延伸屬性,只應用於已確認來源的這個 App,請勿擴大處理範圍。

Windows SmartScreen 提示有風險,可以如何允許執行?

請先確認檔案是從本站應用程式頁面下載的 Shadowrocket 64 位元安裝檔,再檢查提示中的檔名與儲存位置。確認是正確檔案後,在 SmartScreen 提示中選擇「更多資訊」,再選擇「仍要執行」。若裝置由公司或機構管理、按鈕未顯示,或安全軟體明確回報異常,請暫停安裝並查明原因;不要關閉所有防護或規避管理政策。安裝完成後,請逐項確認連線所需的系統權限,不要將規則錯誤誤認為安裝遭阻擋。

Android 安裝遭阻擋,需要開啟哪些權限?

請從本站應用程式頁面下載 arm64 安裝檔。開啟檔案後,依系統提示前往目前使用的瀏覽器或檔案管理員設定,開啟「允許安裝未知應用」,只授權這次實際使用的來源。安裝完成後,可撤銷該來源的安裝權限。首次建立連線時,還需確認系統的 VPN 連線授權;安裝權限與 VPN 授權是兩回事。若裝置設有管理限制,請先確認管理規定,不要反覆點選安裝來忽略系統提示。

Linux 如何選擇檔案格式?AppImage 無法開啟怎麼辦?

請依 Linux 發行版的套件格式,選擇本站應用程式頁面提供的 deb 或 rpm。使用 AppImage 時,請先在檔案屬性中允許執行,或在 Terminal 輸入 chmod +x,後面接上實際檔名。請在下載目錄執行命令;若檔名含空格,請加上引號。若仍出現錯誤,請從 Terminal 啟動並記下具體訊息,以區分權限、架構與執行相依套件問題。請勿遞迴開放整個下載目錄的執行權限,也不要用管理員權限掩蓋相依套件缺漏。

更新用戶端前需要先解除安裝嗎?

請先備份目前使用的 Config、自行維護的伺服器資訊及必要設定,再依原平台更新。iPhone / iPad 請在 App Store 檢查更新;Mac、Windows、Android、Linux 請從本站應用程式頁面重新下載符合平台與架構的安裝檔。首次執行若遭阻擋,請依本分類的允許安裝步驟處理。不要優先採取解除安裝,因為解除安裝可能同時移除本機資料。用戶端更新與 Subscribe 內容更新彼此獨立,完成其中一項不代表另一項也已更新。

已有設定

訂閱與節點匯入

區分訂閱網址、單一伺服器與 Config 檔案,分別檢查儲存及更新結果。

如何匯入已有的訂閱連結?

在 iPhone / iPad 的 Home 中前往 Add Server,選擇 Subscribe,將自己已有的完整訂閱網址填入 URL,並使用容易辨識的名稱儲存。接著執行更新,確認清單出現預期項目,再選擇一台伺服器測試連線。不要將用於瀏覽器登入的帳戶頁面網址當成訂閱網址,也不要手動刪除連結後方的參數。訂閱網址可能包含存取憑證,排查時請勿公開原始連結或含有連結的完整截圖。

訂閱匯入失敗,應先檢查連結還是協定?

先檢查連結是否完整、有無前後空格或換行,以及複製時是否漏掉參數,再確認目前網路能否連線至該網址。若提示格式無法解析,請檢查回傳內容是否其實是登入頁面、錯誤訊息或不支援的格式,不要立刻修改伺服器協定。若先前能更新、現在突然失敗,請再確認連結是否失效,以及伺服器端是否有變更。一次只驗證一個因素;記錄錯誤訊息時,請遮蔽網址中的存取憑證,避免混淆網路故障與格式問題。

Subscribe 已匯入,但 Home 沒有伺服器,怎麼辦?

儲存 Subscribe 項目不代表內容已成功取得。先執行一次更新,確認是否出現錯誤;接著展開對應群組,檢查內容是否被收合,或是否啟用了篩選。若更新成功但清單仍是空的,請確認原訂閱是否真的包含伺服器項目,以及內容格式是否適用於目前的匯入方式。不要連續建立多個相同訂閱來測試,否則之後更難辨認要更新哪個項目。保留一個名稱清楚的項目,針對它檢查更新結果,更容易找出原因。

掃描 Scan QR Code 後參數不完整,可以直接連線嗎?

請先不要連線。Scan QR Code 只會讀取編碼內容,成功辨識不代表伺服器設定完整。請進入項目編輯頁,依照已有的伺服器資訊核對類型、位址、連接埠、驗證欄位,以及必要時的 TLS、Server Name 等參數。如果 QR Code 內含的是訂閱網址,應透過 Subscribe 管理,而不是當成單一伺服器。缺少的欄位不要參照其他項目猜填;確認資訊完整後再儲存,並先執行一次 Connectivity Test。

如何更新已有訂閱?更新失敗會造成什麼影響?

在 Home 找到對應的 Subscribe 項目,執行該項目的更新操作,完成後核對伺服器清單與目前選取的項目。若已啟用自動更新,也請查看最近一次的實際結果,而非只確認開關是否開啟。更新失敗時,先保留現有項目與設定,不要急著刪除重建;清單可能仍然保留,但伺服器能否連線仍取決於伺服器端狀態。訂閱更新主要是更新伺服器資訊,Config 中的規則檔案則須依其來源與更新方式另外管理。

手動修改的伺服器參數,為什麼更新後又還原了?

由 Subscribe 管理的伺服器資訊通常以訂閱回傳內容為準,手動修改可能會在下次更新時被覆蓋。若要暫時驗證參數,請先記下原值,並分別命名測試項目與訂閱管理的項目;不要將暫時修正當成永久同步方案。若伺服器端資訊確實有變更,請確認自己原有訂閱的回傳內容是否也已更新。排查完成後,移除不再使用的測試項目,並重新確認 Home 目前選取的伺服器,避免連到舊項目。

路由與診斷

規則分流與連線疑難排解

依序測試原始網路、伺服器、路由與 DNS。保留原始設定,每次只調整一項。

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

日常依規則分流時選擇 Config,並確認目前的 Config 檔案有效;若要暫時比較代理路徑,選擇 Proxy;若要確認原始網路是否能連線,選擇 Direct。Proxy 無法修正錯誤的伺服器參數,Direct 也不代表代理伺服器已恢復。排查時請使用相同的目標與網路,每次只切換一種模式並記錄結果,完成後恢復日常使用的 Config。三種模式用來決定路由方式,不能取代伺服器連線測試。

連線開關無法開啟,或剛開啟就關閉,怎麼辦?

先確認系統是否跳出 VPN 設定授權提示,並完成裝置驗證;若先前拒絕過授權,請到系統設定檢查相關設定狀態。接著確認 Home 已選取有效伺服器、目前的 Config 可正常讀取,並暫停其他正在使用 VPN 連線的服務。裝置管理政策也可能限制建立連線。若開關立即關閉,請記下當時的提示與日誌,不要先修改 DNS 或大量規則;等連線能維持開啟後,再進一步排查無法存取的問題。

顯示已連線,但網頁無法開啟,應依什麼順序排查?

先中斷連線,確認原始網路能否連線至正常可用的目標;接著重新連線,對目前的伺服器執行 Connectivity Test。測試失敗時,核對位址、連接埠、協定參數與系統時間;測試成功但目標仍無法連線時,檢查 Global Routing、目前 Config 的命中策略與 DNS 結果。使用同一個目標重複測試,每次只修改一項。顯示已連線只代表本機連線流程已建立,不代表所有遠端服務都能正常存取;分享日誌前,請遮蔽伺服器位址、驗證欄位與訂閱憑證。

規則看起來正確,為什麼沒有依預期分流?

先確認 Global Routing 設為 Config,並確認目前使用的確實是已修改的設定檔。Rule 會依序比對,前面的廣泛規則可能先命中,讓後面的 DOMAIN-SUFFIX 或 IP-CIDR 無法生效;FINAL 應作為未命中時的最後策略。接著檢查規則引用的策略是否存在,以及目標實際連線使用的是哪個網域或位址。儲存後以新的請求測試;必要時先結束原有連線,避免把舊連線沿用的路徑誤判為新規則失效。

介面顯示英文,應先認識哪些設定項目?

先依操作位置辨認:Home 查看伺服器與連線狀態,Add Server 新增已有的伺服器資訊,Subscribe 管理已有訂閱,Config 管理設定檔,Global Routing 決定路由模式,Settings 查看設定,Data 查看流量紀錄。手冊保留這些英文介面名稱,方便與 App 中的標籤逐項對照。尋找項目時,先確認所在頁面,不要因為文字相似就修改不相關的開關;協定名稱與規則關鍵字也應保留原文,不要把中文說明填入設定欄位。

連線後耗電增加,有哪些設定值得檢查?

先查看系統電池用量統計,區分螢幕、背景傳輸與網路環境的影響,再比較相同網路與相近使用時間下的耗電情形。持續傳輸、訊號微弱、頻繁重新連線、大量診斷日誌及過於頻繁的測試,都可能增加耗電。檢查 On Demand 是否反覆觸發;排查結束後,關閉不再需要的詳細日誌與連續測試,並確認規則沒有讓不必要的流量繞道。協定的表現也受伺服器與網路條件影響,不宜只因一次電量下降就更換所有設定。