官方手冊 / 問題索引
常見 Shadowrocket 問題
依照取得、安裝、匯入、連線的順序查找解答。先確認問題出在哪個步驟，再只調整相關設定，避免同時更動伺服器、模式與規則。
若已有完整錯誤訊息，請先保留原文；分享截圖前，先遮住訂閱網址與驗證資訊。
正版核對與價格
先確認平台與購買帳號，再區分 App 取得、設定還原及伺服器連線。
Shadowrocket 各平台價格多少？電腦和 Android 可以使用嗎？
如何在 App Store 核對正版項目？
開啟 Shadowrocket 產品頁，核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。圖示應與本站頁首的官方圖示相同，產品頁網址中的數字也應一致，請勿只憑搜尋結果中的名稱判斷。iPhone / iPad 版售價 $2.99，一次性付款；Mac、Windows、Android、Linux 版免費。商店中標示免費的同名項目，不是這個付費版本。
在 App Store 找不到 Shadowrocket，該怎麼辦？
先確認「媒體與購買項目」使用的 Apple 帳號所屬地區，不要只看裝置的語言與地區。中國大陸 App Store 未提供此 App，可先開啟本站提供的產品頁確認是否適用。如需變更地區，請在系統 Settings 中前往 Apple 帳號 → 媒體與購買項目 → 檢視帳號 → 國家或地區，依 Apple 提示確認餘額、現有訂閱及付款條件。請勿反覆更改裝置地區來取代帳號地區設定。
更換 iPhone 或改用 iPad，需要重新購買嗎？
使用曾購買此 App 的 Apple 帳號登入「媒體與購買項目」，在 App Store 的已購項目列表中找到 Shadowrocket 並重新下載；同一購買帳號可在相容的 iPhone 和 iPad 上還原下載。iPhone / iPad 版售價 $2.99，一次性付款；Mac、Windows、Android、Linux 版免費。若仍顯示價格，請先核對購買紀錄與目前使用的帳號，不要直接再次付款。重新下載 App 不會自動還原未備份的本機設定。
取得用戶端後，就能直接建立代理連線嗎？
一次性購買用戶端 ≠ 購買線路方案。Shadowrocket 負責讀取設定、比對規則，並連線至使用者已有的伺服器；買斷用戶端不等於購買線路方案，安裝完成也不代表已有可用的伺服器資訊。請先準備自己已有的訂閱或伺服器參數，再匯入並連線。本站不提供、不販售、不推薦節點或訂閱；本手冊僅說明既有資訊的輸入、設定與排查方式。
App 與伺服器列表要如何分別更新？
App 更新與訂閱更新是兩回事。iPhone / iPad 可在 App Store 的 App 更新列表中查看 Shadowrocket；Mac、Windows、Android、Linux 請從本站下載頁取得新版安裝檔。訂閱更新則是在用戶端重新讀取已有的訂閱內容，不會更新 App 本身。更新 App 前請先備份本機設定；更新訂閱前記下目前選用的伺服器，完成後確認該項目是否仍存在、是否仍為選取狀態。
各平台安裝與首次開啟
先確認安裝檔來源，再處理系統提示。受管理的裝置應遵循組織的安裝政策。
Mac 應選 Apple 晶片版還是 Intel 版？
在 Apple 選單中開啟「關於這台 Mac」：若顯示「晶片」及 Apple 晶片名稱，請選擇 Apple 晶片版；若顯示 Intel 處理器，請選擇 Intel 版。兩種安裝檔都可在本站下載頁的 Mac 區取得，不能只憑電腦外觀或購買年份判斷。安裝後若系統阻止開啟，請先確認檔案來自本站，再前往系統設定 → 隱私權與安全性，查看此 App 的提示並選擇「仍要打開」。
Windows 出現 SmartScreen 風險提示，該如何處理？
先確認安裝檔來自本站下載頁，並確認正在執行的是剛下載的 Shadowrocket 安裝程式。SmartScreen 顯示「Windows 已保護您的電腦」時，按一下「其他資訊」，確認程式後選擇「仍要執行」；若出現使用者帳戶控制提示，再依安裝需求確認。請勿為了安裝而長期關閉系統防護。公司或組織管理的裝置可能禁止手動允許，遇到這種情況請交由裝置管理員處理。
Mac 顯示無法驗證開發者或 App 已損壞，該怎麼辦？
確認安裝檔來自本站，且已將 App 移至 Applications。「無法驗證開發者」時，可前往系統設定 → 隱私權與安全性，選擇「仍要打開」。若顯示「已損壞」，請先重新下載並取代原檔；確認來源無誤後，可在 Terminal 執行 xattr -cr /Applications/Shadowrocket.app，再嘗試開啟。此命令只會作用於該 App 路徑，請勿擴大至整個磁碟；受管理的裝置應遵循管理員的安全政策。
下載 Android 版後無法安裝，在微信裡按下載也沒反應？
在微信中無法下載時，請改用系統瀏覽器開啟本站下載頁，取得 Android 版安裝檔。若系統阻止安裝，請前往設定中的「允許安裝未知應用」，只授權這次使用的瀏覽器或檔案管理工具，安裝完成後可關閉此權限。本站提供 arm64 安裝檔；若顯示不相容，請核對裝置架構及系統提示。安裝失敗也可能是檔案未完整下載或儲存空間不足所致，請勿連續重複按下安裝。
Linux 應選 deb、rpm 還是 AppImage？
先依 Linux 發行版選擇：Debian、Ubuntu 等通常使用 deb，Fedora 等通常使用 rpm；需要直接執行時可選擇 AppImage。安裝檔均可從本站下載頁取得。deb 可使用 sudo apt install 加上下載檔案的本機路徑；rpm 可使用 sudo dnf install 加上本機路徑。首次執行 AppImage 前，使用 chmod +x 加上檔案路徑以授予執行權限。若遭系統攔截，請依本機政策確認是否允許；不要以 root 身分直接執行圖形用戶端。
iPad 可以安裝嗎？首次開啟時需要允許哪些權限？
相容的 iPad 可以安裝，系統需求請以 App Store 頁面標示為準。iPhone / iPad 版在 App Store 售價 $2.99，一次性付款；Mac、Windows、Android、Linux 版免費。首次開啟後，先匯入自己已有的設定再嘗試連線；系統詢問是否加入 VPN 設定時，確認要求來自 Shadowrocket 後再允許。此授權用於建立本機網路接管入口，不代表已有可連線的伺服器。
訂閱與伺服器匯入
以下操作以你已擁有自己的訂閱或伺服器資訊為前提。匯入成功與連線成功需要分別確認。
訂閱連結匯入失敗，應先檢查什麼？
先確認複製的是自己已有的完整訂閱連結，而不是服務商的登入頁或說明頁；檢查連結前後是否有空格、換行或遭截斷的參數。接著確認目前網路可以連上訂閱網址，並判斷錯誤是逾時、驗證失敗還是格式解析失敗。驗證失敗時，請確認連結是否仍有效；解析失敗時，請核對輸出格式。訂閱連結可能包含存取憑證，請勿將完整連結貼在公開截圖或排查紀錄中。
如何手動更新訂閱？自動更新又有什麼不同？
在 Home 找到對應的訂閱群組，使用更新功能，完成後確認項目是否有變化。若 Settings 提供啟動時更新的選項，可依需求啟用；不同版本的選項位置請以實際介面為準。自動更新只是免去手動觸發，無法修復失效連結或網路故障。更新後若原有伺服器已被移除，請重新選擇可用項目；更新成功不代表每台伺服器都能連線。
Scan QR Code 掃描失敗，可以改為手動新增嗎？
可以。先確認 QR Code 來自自己已有的伺服器資訊，畫面完整清晰，且已允許使用相機；網頁網址或登入確認碼不一定是可匯入的伺服器 QR Code。仍無法辨識時，前往 Add Server，依原始資料選擇協定，填入伺服器、連接埠及驗證欄位。手動輸入時不可省略協定要求的參數；儲存後再次核對大小寫、空格及連接埠，再執行連線測試。
Subscribe 和 Config 是同一種檔案嗎？
不是。Subscribe 通常用於讀取及更新一組伺服器項目；Config 用於管理規則、DNS 等設定內容，兩者的用途和操作位置不同。將訂閱網址當成設定檔匯入，可能會造成解析失敗；只更新訂閱也不會自動取代目前的規則。匯入前先確認手上的資料用途；變更設定前備份目前檔案，套用後核對 Global Routing 與選用的伺服器，避免同時更改多處而難以判斷原因。
手動新增伺服器時，如何核對協定與參數？
Add Server 中選用的協定必須與原始伺服器資料完全一致，例如 Shadowsocks、VMess、VLESS 或 Trojan；不能只填入位址和連接埠後隨意選擇協定。接著逐項核對驗證資訊、加密方式、傳輸方式及 TLS 相關欄位，伺服器端未要求的項目不要自行猜測填入。儲存成功只代表資訊已輸入，不代表遠端驗證通過。若無法連線，請先逐項比對原始資料，再測試網路連通性。
更換裝置前如何保留設定？截圖可以當備份嗎？
截圖適合記錄開關狀態，無法取代完整的設定備份。更換裝置前，請保存自己已有的訂閱網址，並使用 App 提供的匯出或備份功能保留本機設定，確認檔案可以正常讀取。備份可能包含伺服器憑證，請存放在自己能妥善控管的位置。新裝置還原後，重新核對目前設定、選用的伺服器及系統 VPN 授權；還原本機規則與重新下載 App 是兩個獨立步驟。
規則分流與連線排查
依序檢查基礎網路、伺服器、模式、DNS 與規則，逐步縮小範圍，並記錄每次測試的條件與結果。
Global Routing 中的 Config、Proxy、Direct 要如何選擇？
三種常用模式為設定（Config）、代理（Proxy）及直連（Direct）。Config 依目前設定中的規則決定請求的路徑；Proxy 將符合條件的請求交由選用的代理伺服器處理；Direct 則直接連線。日常依規則分流通常先使用 Config。排查時可暫時切換至 Proxy 或 Direct，比較同一個目標的結果，但每次只變更一個條件，測試後再切回原模式；切換模式無法修正錯誤的伺服器參數。
連線開關無法開啟，或一開啟就自動關閉，該怎麼辦？
先確認是否已選擇伺服器，以及首次連線時是否允許加入 VPN 設定。若先前拒絕授權或刪除了系統 VPN 項目，請返回 Shadowrocket 再次發起連線，並依提示重新授權。接著檢查是否有其他 VPN 連線或裝置管理政策占用相關功能；必要時先停止衝突的連線再試。若仍立即關閉，請記下系統提示並保留用戶端記錄；不要反覆刪除所有設定，應先備份再重建。
顯示已連線卻無法上網，應依什麼順序檢查？
先中斷連線，確認目前的 Wi-Fi 或行動網路本身可正常使用；再核對選用的伺服器及 Connectivity Test 結果。接著檢查 Global Routing、DNS 及實際命中的規則，尤其確認 FINAL 的策略是否符合預期。若只有部分網站無法連線，記下目標網域並查看相關記錄，不要立刻更改所有設定。每次只調整一項，並以相同目標重新測試；系統顯示 VPN 已連線，只代表通道已建立，不保證每個請求都能成功。
DNS 與規則發生衝突時，如何找出原因？
先判斷是網域無法解析，還是解析完成後才連線失敗。檢查目前 Config 中的 DNS 設定，再查看請求符合哪一條 Rule。DOMAIN-SUFFIX 可比對網域及其子網域，IP-CIDR 可比對 IP 位址網段；符合條件且排序較前的規則可能先決定處理方式，FINAL 應作為最後的預設規則。不要堆疊多條相似規則來試錯；先保留必要的最少規則，記錄命中結果，再逐條還原並重新測試。
介面顯示英文，要如何對照手冊？
本手冊保留介面原文，可直接對照 Home、Add Server、Config、Settings、Global Routing 和 On Demand，尋找操作入口。系統語言、App 語言設定及 App 版本都可能影響實際顯示；若系統提供個別 App 的語言選項，可在該 App 的系統設定中查看。不要只憑圖示位置判斷功能，請優先核對英文名稱。若找不到入口，可先參閱入門指南中的操作順序，再確認目前所在頁面。
使用後耗電增加，需要關閉 On Demand 嗎？
先比較系統電池用量統計中相近時段的使用情況，並檢查是否有持續下載、頻繁重新連線或大量診斷記錄。On Demand 會依設定條件觸發連線；若條件設得太寬，可能在不需要時仍保持連線。可暫時停用並觀察，但不應認定它是所有耗電問題的原因。減少重複測試及過於頻繁的訂閱更新，並確認網路是否穩定。比較時盡量維持相近的使用習慣，避免只憑一次電量下降就判定用戶端異常。