官方手冊 · FAQ

Shadowrocket 常見問題

先確認問題發生在哪個步驟,再展開相應解答。購買記錄、App 安裝、訂閱清單與實際連線是不同環節,逐項核對比一次修改多項設定更容易找出原因。

正版確認與購買

先確認商店產品與購買帳號,再處理裝置下載及已購項目還原。

在 App Store 搜尋不到 Shadowrocket,該先檢查什麼?

先從下載指南開啟 Shadowrocket 的 App Store 產品頁,別只憑搜尋結果判斷。若頁面顯示目前所在商店地區無法使用,請檢查 App Store 登入中的 Apple 帳號及其國家或地區;裝置的語言與地區設定不等於商店帳號地區。確實需要變更時,請在系統 Settings 中依序前往 Apple 帳號 → Media & Purchases → View Account → Country/Region,並依 Apple 提示確認餘額、訂閱與付款條件。商店供應狀況以目前頁面顯示為準,請勿反覆更改地區來取代問題排查。

如何確認是正版 App?購買後是否包含連線服務?

請在 App Store 產品頁核對三項資訊:名稱 Shadowrocket、與本站頁首相同的官方圖示,以及開發者 Shadow Launch Technology Limited;再確認產品連結中的 App ID 為 932747118。Shadowrocket 是付費用戶端,購買用戶端不等於購買線路方案;使用前須備妥自己已有的訂閱或伺服器資訊。美國商店價格約為 2.99 美元,實際價格、當地貨幣與付款結果以 App Store 頁面為準。購買 App 與確認設定是否有效是兩回事,請分別確認。

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

先使用原購買時的 Apple 帳號登入 App Store,再到個人帳號中的 Apps 或已購項目尋找 Shadowrocket;項目名稱可能因系統語言與介面而異。找到 App 後,依商店頁面提示重新下載,先不要重複付款。若仍顯示價格,請核對購買記錄、商店帳號與目前產品頁是否一致。還原下載記錄不代表訂閱、伺服器和 Config 也會自動還原;更換裝置前,請另外備份現有設定並妥善保管登入憑證。家人共享及跨裝置購買的適用範圍,以 App Store 頁面標示為準。

iPad 可以安裝 Shadowrocket 嗎?如何使用已購項目?

先在 iPad 的 App Store 開啟同一個產品頁,查看相容性並確認是否可下載。使用購買時的 Apple 帳號查看已購項目;系統需求與是否支援通用購買,均以 App Store 頁面標示為準。iPad 的橫向顯示、分割畫面與視窗寬度會影響清單及詳細資訊的排列;操作時可依 Home、Config、Settings 等名稱尋找功能,不必照著 iPhone 的按鈕位置操作。App 可下載不代表伺服器設定已同步;首次使用時仍須確認現有訂閱、目前選取的伺服器及 VPN 設定授權。

相關步驟:正版確認 · 已購項目還原 · iPad 使用說明

安裝與首次啟用

先區分系統授權、App 功能入口與連線結果,避免將授權成功誤當成網路已連通。

首次開啟時,如何確認系統需求並授權 VPN 設定?

安裝前請在 App Store 的相容性欄確認裝置與系統需求,並以 App Store 頁面標示為準。首次開啟後,先確認現有伺服器或訂閱已正確匯入;啟用連線時,系統可能會要求新增 VPN 設定,並以裝置密碼或系統驗證確認。這項授權是允許用戶端建立系統 VPN 設定,不代表伺服器已連線。若先前取消授權,可返回 Shadowrocket 再試一次;若裝置受管理政策限制,請先確認相關管理設定。授權完成後仍須實際測試連線,不能只憑授權成功判定連線正常。

連線開關無法啟用,或一開就關,該先檢查哪些項目?

先確認 Home 中有可用設定且已選取伺服器,再查看系統是否正在等待 VPN 設定授權。開啟系統 Settings,確認 VPN 設定是否存在、是否與其他連線衝突,以及裝置是否受管理政策限制;記下目前狀況後,可暫時停用其他 VPN 連線進行比對。若開關立即關閉,請查看 Shadowrocket 相關記錄,留意欄位缺漏、設定解析失敗與權限提示。不要直接重設所有設定或刪除所有伺服器。刪除並重建 VPN 設定前,請先備份 App 內的設定,並確認原有連線可以還原。

介面是英文,如何對照官方手冊找到功能入口?

本手冊保留介面英文名稱,方便直接對照:Home 用來查看伺服器與連線狀態,Add Server 用來輸入單一伺服器資訊,Config 是設定檔,Settings 是設定。Global Routing 中的 Config、Proxy、Direct 分別代表設定、代理與直連模式。若要變更 App 顯示語言,可在系統 Settings 的 App 設定中查看是否有 Language 選項;可選語言以裝置實際顯示為準。介面語言不會自動修正訂閱網址或伺服器欄位;找不到功能時,請先確認頁面名稱,再核對目前介面配置。

如何更新 Shadowrocket?更新前要先保存什麼?

App 更新透過 App Store 完成,可在商店帳號頁面查看可用更新,或依系統設定使用自動更新。更新前建議保存目前使用的 Config、手動新增的伺服器及訂閱群組資訊,並確認現有訂閱網址仍可使用。App 更新與訂閱更新彼此獨立:前者更新用戶端,後者重新整理現有伺服器清單,兩者不能互相取代。若遇到異常,先閱讀商店中的更新說明,再記錄重現問題的條件;不要為了嘗試修復而立刻刪除 App,因為重新下載不保證能還原儲存在本機的設定。

依序操作:查看首次連線教學。

訂閱與伺服器匯入

先區分訂閱網址、單一分享連結與手動輸入欄位,再選擇相應的匯入方式。

匯入現有訂閱失敗,如何判斷是網址、網路還是格式問題?

先完整複製自己現有的訂閱網址,檢查前後空格、換行,以及查詢參數是否遭截斷;不要把帳號管理頁面的網址當成訂閱網址。接著依提示判斷問題:無法連線或逾時,先確認目前網路能否連上該網址;驗證失敗或連結失效,請確認原訂閱狀態;可以取得內容但無法識別,則確認回傳內容是否為用戶端支援的格式。訂閱網址通常包含憑證,排查時請勿公開貼出完整網址或 QR Code。保留原有群組與錯誤提示,確認原因後再重試,避免重複匯入造成混淆。

只有單一伺服器資訊時,該用 Add Server、掃描 QR Code 還是剪貼簿匯入?

若已有完整分享連結,可使用 App 提供的剪貼簿匯入功能;若已有 QR Code,請使用 Scan QR Code,並依系統提示允許相機存取。若只有欄位資訊,請前往 Add Server,先選擇與原設定相同的協定,再逐項輸入位址、連接埠及相關驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位不能混用;TLS、Server Name 與傳輸設定也應依原始設定填寫。儲存後重新開啟詳細資訊核對,再測試連線。不要只憑連結外觀猜測缺少的參數,也不要把訂閱網址填入單一伺服器位址欄。

如何更新訂閱?自動更新失敗時需要重新匯入嗎?

先在 Home 找到對應的 Subscribe 群組,使用群組的更新功能,並查看更新時間、伺服器清單與錯誤訊息;實際入口以目前 App 介面為準。若需要自動更新,可在 Settings 的訂閱相關設定中查看「開啟 App 時更新」等選項;這不代表 App 會一直在背景定時更新。更新失敗時,先確認網址有效、網路可連線及回傳格式,通常不必立刻刪除群組。重新匯入前請保存原網址與自訂備註,以免失去排查線索;更新成功後,也要再次確認目前選取的伺服器。

更新後伺服器減少、重複或排序改變,是匯入出錯嗎?

不一定。訂閱更新會依回傳內容重新整理伺服器清單,原有項目可能遭移除、更名或調整順序;手動新增的項目與不同訂閱群組也可能有相同名稱。請先依群組檢查項目的實際位址、連接埠與協定,不要只憑名稱判斷是否重複。確認更新成功後,再查看原先選取的伺服器是否仍在清單中。整理前請保存手動輸入的欄位與備註,避免誤刪後只能憑記憶重建。延遲排序只反映當次測試結果,不代表所有目標的連線速度;大量清理前,應先確認實際連線狀況及所屬群組。

欄位、群組與備份說明:訂閱與伺服器管理手冊。

規則分流與故障排查

使用相同網路與目標進行比對,分別確認基本網路、伺服器連線與規則選擇。

Global Routing 中的 Config、Proxy、Direct 該怎麼選?

需要依規則區分流量時選擇 Config,並確認目前啟用的設定檔與規則順序;需要將一般可代理的連線統一交由所選伺服器測試時,選擇 Proxy;需要測試直連時,選擇 Direct。設定、代理、直連對應的介面名稱分別是 Config、Proxy、Direct。Config 中的 DIRECT、PROXY 等策略由符合條件的規則決定,不能只看 Home 中選取了哪個伺服器。排查時保持相同網路與目標,每次只切換一種模式;若 Direct 可連線而 Proxy 失敗,應優先檢查伺服器連線,不要立刻重寫整份規則。

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

顯示已連線通常只代表系統 VPN 通道已建立,不保證目前伺服器、DNS 與目標位址都可正常使用。先暫停連線,確認基本網路可以正常連線;再重新連線並核對選取的伺服器,使用同一目標分別測試 Direct 與 Proxy。若 Proxy 也失敗,請檢查伺服器驗證資訊、位址、連接埠及網路連線;若 Proxy 正常而 Config 失敗,請檢查目前設定、規則比對結果與 DNS 設定。只有部分 App 連線失敗時,記錄目標網域及錯誤狀況。每次只修改一個項目並保留原值,避免同時更換伺服器、規則與 DNS,導致無法判斷原因。

背景耗電偏高,On Demand 該如何取捨?

先在系統 Settings 的電池頁面查看 Shadowrocket 的前景、背景活動及統計時段,再搭配裝置總耗電量判斷,不要只看耗電比例。持續傳輸、訊號不穩與頻繁重新連線都可能增加耗電。檢查 On Demand 是否因 Wi-Fi、行動網路或網域條件而反覆觸發;保留原設定後,可暫時關閉相關條件,並以相近的使用時間進行比較。按需連線不代表一定更省電,頻繁觸發也會增加連線活動。請依實際使用情境選擇常駐或按需連線,並分別記錄重新連線次數、網路環境與電池變化。

Connectivity Test 顯示正常,為何仍無法連線?該如何提供記錄?

Connectivity Test 成功只代表當下的測試目標符合測試條件,不能取代對所有網站、App 或協定的實際連線測試。先記錄測試方式、目前 Global Routing 模式、選取的伺服器及無法連線的目標;重現問題後再查看相關記錄,特別留意 DNS 解析、連線逾時、驗證失敗與規則策略。提供排查資料時,只保留必要的錯誤行與時間順序,並遮蔽訂閱網址、密碼、驗證識別資訊與 QR Code。記錄中的完整 URL 也可能含有憑證。不要只傳送一張測試成功的截圖,也要說明具體在哪個步驟失敗,以及已進行哪些比對。

需要從頭確認連線流程時,請返回使用教學,依照匯入、選擇模式、連線與驗證的順序重新檢查。