官方手冊 · 問題索引
Shadowrocket 疑難排解
依取得、安裝、匯入、連線的順序檢查。先確認問題發生在哪個步驟,再展開對應解答;涉及訂閱時,前提是使用者已有自己的訂閱或伺服器資訊。
取得方式 / 商店 / 購買記錄
正版與購買
先確認裝置的取得方式,再核對商店資訊與自己的購買記錄。
電腦和 Android 可以使用 Shadowrocket 嗎?各平台如何收費?
可以。Shadowrocket 提供 iPhone、iPad、Mac、Windows、Android 與 Linux 版本,分為 2 種取得方式:iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。電腦和 Android 請至本站下載頁選擇適用裝置的安裝檔,檔案由本站 /dl/shadowrocket/ 路徑提供。首次開啟若出現系統風險提示,請先確認檔案來源,再依下方安裝分類的對應步驟操作;勿直接將系統提示視為安裝成功或失敗的判定。
App Store 搜尋不到 Shadowrocket,該先檢查什麼?
先確認 App Store 使用的 Apple 帳號所屬商店,不要只看裝置語言、所在地或系統地區。中國大陸商店目前沒有此 App;可在 Settings 中前往 Apple 帳號的 Media & Purchases,選擇 View Account,再查看 Country/Region。如需變更,請依 Apple 帳號設定流程處理餘額、現有訂閱及付款資料,並確認符合該地區規定。產品頁無法顯示也可能與商店上架狀態有關,反覆更換搜尋關鍵字通常無法解決帳號地區問題。
如何確認 App Store 上的正版 Shadowrocket?
請一併核對 App 名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、官方圖示,以及產品頁網址中的 App ID 932747118;不要只憑「小火箭」別稱或相似圖案判斷。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。其他平台的免費取得方式,不能用來判斷 App Store 上同名項目的真偽。遇到名稱相近的搜尋結果,請返回本站下載頁核對產品頁,付款前再次確認開發者與 App ID。
更換 iPhone、重新安裝或改用 iPad,需要再次購買嗎?
iPhone 與 iPad 可使用同一筆購買記錄。在新裝置的 App Store 登入當初購買所用的 Apple 帳號,從 Apps 或 Purchased 的已購項目清單找到 Shadowrocket 並重新下載;實際入口名稱會因系統版本而異。若畫面顯示購買按鈕,請先確認帳號、商店地區及購買記錄,不要立刻再次付款。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。還原 App 下載與還原本機設定是兩回事,既有設定仍須事先備份。
購買 App 是否包含連線服務?如何確認家人共享?
App 一次性買斷 ≠ 連線服務方案。iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。這些價格僅代表 App 的取得方式,不包含網路連線服務。使用前應備妥自己的訂閱或伺服器資訊;本站不提供、不販售也不推薦節點或訂閱。家人共享是否適用,請查看目前 App Store 產品頁的 Family Sharing 標示,並確認家庭群組的購買共享設定、帳號地區及成員資格;同一帳號還原已購項目不等於家人共享。
平台選擇 / 系統提示 / VPN 授權
安裝與首次開啟
允許系統執行前,必須先確認檔案來源。受管理裝置的限制應由裝置管理員處理。
Mac 應選 Apple 晶片版還是 Intel 版?
開啟 Apple 選單中的「關於這台 Mac」:若顯示 Chip 及 Apple 晶片名稱,請選 Apple 晶片版;若顯示 Processor 且為 Intel,請選 Intel 版。不要只依電腦購買年份或外觀判斷。前往本站下載頁取得對應的 dmg,將 Shadowrocket 移至 Applications 後再開啟。若系統提示無法驗證開發者,請先確認檔案來自本站 /dl/,再前往 System Settings 的 Privacy & Security,查看這次遭封鎖的 App,並依提示選擇 Open Anyway;不要靠試裝來判斷晶片版本。
Windows SmartScreen 提示有風險,該如何處理?
先確認安裝檔來自本站下載頁,且下載網址屬於本站 /dl/shadowrocket/。這些安裝檔沒有程式碼簽章,首次執行時可能出現 SmartScreen 提示。確認來源後,在提示中選擇「更多資訊」,核對顯示的檔案,再選擇「仍要執行」。若裝置由公司或學校管理,按鈕可能受管理政策限制,請聯絡裝置管理員;不要修改組織政策或關閉整套系統防護。若無法確認檔案來源、名稱異常或下載未完成,請停止執行並從下載頁重新取得。
Mac 提示無法驗證開發者或 App 已損壞,該怎麼辦?
先將本站下載的 dmg 中的 App 複製到 Applications,再嘗試開啟。若出現無法驗證開發者的提示,可前往 System Settings → Privacy & Security 查看遭封鎖的記錄;確認是 Shadowrocket 後,選擇 Open Anyway 並完成系統驗證。若仍提示 App 已損壞,請先重新下載並確認晶片版本;僅在確認來源且 App 位於指定目錄時,於 Terminal 執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。此命令會清除指定 App 的延伸屬性,不應改寫成針對整個磁碟的命令。
iPad、Android 與 Linux 首次安裝時各要注意什麼?
iPad 可以安裝 Shadowrocket,系統需求以 App Store 頁面標示為準,並使用自己的 Apple 帳號取得。Android 請從本站下載頁下載 apk;系統詢問時,只為目前用來開啟檔案的瀏覽器或檔案管理員啟用「允許安裝未知應用」,安裝完成後可關閉此權限。Linux 請依發行版選擇 deb、rpm 或 AppImage;AppImage 需在檔案屬性中允許執行,或對實際檔案執行 chmod +x 後開啟。電腦和 Android 若出現首次執行的風險提示,請先確認檔案來自本站,再依系統提示處理。
介面是英文、連線開關無法開啟或一開就關,該先做什麼?
手冊保留介面原文:Home 用來查看伺服器與連線,Config 用來管理設定檔,Settings 用來調整設定。連線前請確認已有可用的伺服器並已選取;首次開啟連線開關時,依系統提示允許新增 VPN 設定並完成裝置驗證。若先前拒絕過授權,可再次嘗試連線並檢查系統 VPN 設定。若開關一開就關,請先中斷其他正在執行的 VPN,檢查裝置管理限制,再重新啟動 App 試一次。不要一開始就刪除 App,以免遺失尚未備份的伺服器資訊和設定。
Subscribe / Add Server / Config
訂閱與節點匯入
先區分訂閱網址、單一伺服器參數與設定檔,再判斷錯誤發生在下載內容或建立連線的階段。
已有訂閱連結,如何匯入 Shadowrocket?
先從自己的服務商資料中複製完整訂閱網址,注意不要包含空格、換行或聊天訊息中的說明文字。在 Home 中進入 Add Server,選擇 Subscribe,將網址填入 URL 後儲存;實際位置請以目前 App 介面為準。匯入後應能看到訂閱群組及其中的伺服器項目,選取其中一項進行 Connectivity Test。若 App 自動辨識剪貼簿內容,也應先核對網址再確認。訂閱網址可能包含存取憑證,請勿將完整網址貼到公開截圖、留言或排查記錄中。
訂閱匯入失敗、內容空白或格式錯誤,如何區分?
先確認複製的是服務商提供的訂閱網址,而不是帳號登入頁、公告頁或一般網頁連結。請求失敗通常要檢查目前網路、網址是否完整及服務是否有效;回傳內容空白時,確認服務狀態及該訂閱是否確實包含伺服器。若格式錯誤,則檢查連結類型與目前版本的支援範圍。每次只修改一項,再重試並記下錯誤訊息。不要將訂閱網址當成單一伺服器網址填入,也不要把完整網址傳給他人;必要時向自己的服務商確認回傳內容。
如何更新 Subscribe?更新後項目為什麼改變?
在 Home 找到對應的訂閱群組,使用該群組提供的更新功能;完成後查看項目是否變動,以及是否出現錯誤提示。訂閱由服務商維護,伺服器名稱、數量或參數可能因回傳內容而改變;更新不代表原先選取的項目仍然有效。更新前可記下目前的群組與選取項目,但不要長期手動修改訂閱產生的項目,因為下次更新可能會覆蓋修改。更新失敗時先檢查網路與訂閱狀態,不要連續刪除重建;重要的本機設定應先備份。
手動輸入伺服器或掃描 QR Code 後,為什麼還是無法連線?
匯入成功只代表資料已寫入,不代表參數正確或伺服器可用。請對照自己已有的伺服器資訊,逐項檢查協定、位址、連接埠與驗證欄位;若涉及 TLS,還要核對 Server Name、傳輸方式、路徑等伺服器端要求。WireGuard 的私鑰、公鑰與 Endpoint 也不能互相替代。掃描 QR Code 後仍須檢查辨識出的協定與欄位,不要只因名稱相似就沿用其他伺服器的設定。先執行 Connectivity Test,再根據錯誤判斷是驗證、解析或傳輸問題。
Subscribe 和 Config 有什麼不同?設定如何備份?
Subscribe 主要提供伺服器項目及其連線參數;Config 則包含規則、DNS 等請求處理設定。已有訂閱不代表已選好合適的規則設定,匯入設定也不一定會自動補上自己的伺服器。修改前先在 Config 確認目前使用的檔案,並透過 App 提供的分享或匯出功能儲存副本;伺服器資料與訂閱網址也應分別記錄。備份可能含有驗證資訊,請存放在自己掌控的位置。更換裝置後先還原資料,再核對目前設定、伺服器選取項目與 Global Routing,逐項驗證。
Global Routing / DNS / On Demand
規則與故障排除
分辨基礎網路、伺服器連線、網域解析與規則命中狀況。顯示已連線不代表每項請求都已完成。
Global Routing 的 Config、Proxy、Direct 三種模式該如何選?
Config(設定)依目前設定檔中的規則決定請求策略,適合需要分流且已檢查規則的情況;Proxy(代理)會將請求交由代理策略處理,適合暫時確認代理路徑是否可用;Direct(直連)讓請求直接連線,不能取代伺服器連線測試。日常需要規則分流時,先選 Config 並確認啟用的是預期檔案。排查時可在相同網路與相同目標下比較三種模式的結果,但應記下原始設定並在測試後還原,不要把暫時切換當成規則已修復。
顯示已連線但無法上網,應依什麼順序排查?
先中斷連線,確認目前的 Wi-Fi 或行動網路本身能正常瀏覽原本可連線的網站。接著連線至 Shadowrocket,確認所選伺服器屬於目前有效的訂閱,並執行 Connectivity Test。然後核對 Global Routing、目前的 Config 與請求記錄,查看目標網域實際採用的策略。若在多種網路下都失敗,檢查伺服器狀態與驗證參數;若只有特定 Wi-Fi 失敗,檢查該網路的登入頁面與限制。每次只變更一個項目並記錄現象,避免同時更換伺服器、DNS 與規則而無法判斷原因。
Connectivity Test 正常,但網頁無法開啟,是 DNS 問題嗎?
可能與 DNS 有關,但測試正常不代表網頁所需的所有請求都正常。Connectivity Test 只反映相應測試條件下的連線結果;網頁還需要網域解析、TLS、規則選擇及多個資源網址都正常。先核對請求記錄中的網域與命中策略,再確認 DNS 設定是否來自目前可用的設定;只修改自己清楚用途的項目。可在相同伺服器下比較不同網路,並以另一個原本可瀏覽的網站作為對照。不要同時堆疊多個陌生 DNS 位址,也不要只憑一次測試結果判斷所有目標都能連線。
規則沒有生效,該如何檢查 DOMAIN-SUFFIX 與 FINAL?
先確認 Global Routing 設為 Config,且目前啟用的是剛修改的設定檔。規則通常由上而下比對,命中後便執行對應策略;範圍較廣的規則若排得太前面,後續的特定規則便可能沒有機會命中。DOMAIN-SUFFIX 用於比對網域後綴,不能直接填入含路徑的完整網頁網址;IP-CIDR 用於 IP 網段。FINAL 應放在最後,為未符合前述條件的請求指定策略。請搭配請求記錄核對實際命中項目,再調整順序;不要只憑網頁能否開啟判斷規則是否執行。
連線後耗電增加,或切換網路時反覆重新連線,該怎麼檢查?
先查看系統電池用量統計,並比較相同使用時段,分辨大量資料傳輸、訊號較弱、頻繁重新連線與持續記錄日誌各自的影響;不要只比較某一瞬間的電量。檢查是否在 Wi-Fi 與行動網路間反覆切換,以及 On Demand 條件是否符合預期;若要暫時比較,先記下原設定,再關閉按需連線進行測試。診斷結束後停止不再需要的詳細日誌,並依各平台的更新方式保持 App 為最新版本。若只有特定網路或伺服器會觸發重新連線,優先排查該條件,而非清除所有設定。