全平台用戶端 · 官方手冊
依裝置取得全平台用戶端，匯入既有訂閱並設定規則分流；iPhone / iPad 在 App Store 一次性 $2.99，Mac、Windows、Android、Linux 版免費。
目前版本 v2.2.92 · iPhone / iPad 在 App Store 一次性 $2.99；Mac、Windows、Android、Linux 版免費
先區分伺服器資料、設定檔與路由模式，再檢查連線。以下依功能說明入口與操作順序，實際位置以裝置上的介面為準。
規則依設定中的順序檢查，符合條件後採用該列指定的策略。進入 Config 查看 Rule，先確認網域或網段是否正確，再確認 PROXY 等策略名稱確實存在。具體條件應放在較寬泛的條件之前，FINAL 用來處理前面未符合的請求。若要讓規則參與處理，Global Routing 應選擇設定模式 Config；暫時改為 Proxy 或 Direct 後，就不能再用同一組規則結果判斷連線去向。修改前請保留原設定，方便逐項比對。
DOMAIN-SUFFIX,example.com,PROXYOn Demand 用於依網路條件觸發連線，無法修正錯誤的伺服器參數。在 Settings 找到對應設定後，先閱讀現有條件，再依自己的網路環境調整。建議先關閉自動觸發，手動選擇伺服器並完成一次連線測試，確認設定有效後再啟用。切換 Wi-Fi 與行動網路時，觀察條件是否符合預期；若關閉連線後又被觸發，應回到這裡檢查，而非反覆修改密碼。觸發條件與連線中的 Rule 分工不同：前者決定何時連線，後者決定如何處理請求。
IP-CIDR,192.168.0.0/16,DIRECT訂閱可集中管理一組伺服器資料，前提是已經持有有效的訂閱連結。在 Home 透過新增入口選擇 Subscribe，貼上完整網址並儲存，更新後檢查清單是否出現預期項目。連結中的查詢參數也屬於網址，複製時不要漏掉尾端字元。更新失敗時，先釐清是網址無法存取、回傳內容格式不符，還是訂閱狀態變更，再考慮刪除重建。訂閱更新主要變更伺服器資料，不等於自動取代所有 Rule；排查前應分別記錄目前的伺服器與設定，避免混淆兩種來源。
FINAL,PROXYConfig 儲存規則及相關設定，選取設定檔後還要核對 Global Routing。設定模式 Config 依規則處理，代理模式 Proxy 依目前的代理選擇處理請求，直連模式 Direct 則直接連線；切換模式不會更新訂閱。編輯檔案時先備份，再檢查規則引用與預設策略。使用 iCloud 同步時，應核對目前裝置的同步開關、登入的帳戶與實際同步項目，不要把同步完成理解為所有裝置都已選取相同設定。伺服器權限與系統連線授權仍須在各裝置分別確認。
DOMAIN,example.com,DIRECTShadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 的參數結構各不相同。在 Add Server 中先讓 Type 與伺服器資料一致，再逐項填寫 Host、Port 及該類型要求的驗證欄位。TLS、傳輸方式、路徑與憑證相關設定也必須相符，不能只憑連接埠判斷類型。協定名稱本身無法保證速度或耗電表現，結果也會受伺服器、網路與裝置狀態影響。若已有完整連結，優先依資料匯入，再比對原始參數；需要了解欄位取捨時，請參閱技術參考。
DOMAIN-SUFFIX,example.com,PROXY連線開關開啟只代表系統連線狀態，不能取代實際存取驗證。先用 Connectivity Test 檢查連線能力，再到 Diagnostics 尋找與失敗時間相符的記錄，最後搭配 Data 查看流量變化。測試成功不代表每個目標都能存取，流量增加也不能單獨證明某條 Rule 確實符合。若只有一個網域失敗，請檢查 DNS 與符合的策略；若所有請求都失敗，先核對目前的伺服器、網路與授權。分享排查資料前，請遮蔽訂閱網址、密碼與金鑰，只保留錯誤類型及必要的設定名稱。
FINAL,DIRECTiPhone / iPad 在 App Store 一次性 $2.99；Mac、Windows、Android、Linux 版免費。以下入口皆連至下載頁，安裝包由本站 /dl/shadowrocket/ 路徑提供。
App Store 售價 $2.99，一次性付費；其他平台免費。兩種裝置可共用購買，系統需求以 App Store 頁面標示為準。先確認用於購買的 Apple 帳號，再前往產品頁確認 App 名稱、開發者與圖示；裝置上若已安裝同名 App，也應核對 App ID，不要只憑中文別稱判斷。
首次開啟連線時，依系統提示允許新增 VPN 設定。此授權用於建立連線，不會自動填入伺服器資料；完成後仍須匯入自己的訂閱，或在 Add Server 中填寫既有參數。
先開啟「關於這台 Mac」，查看顯示的是 Apple 晶片還是 Intel 處理器，再選擇對應的 dmg。兩種安裝包分別提供，請勿依瀏覽器名稱猜測晶片，也不要將 App Store 行動版購買當成 Mac 安裝步驟。
首次開啟時若出現「無法驗證開發者」提示，確認檔案來自本站後，前往系統設定的「隱私權與安全性」查看「仍要打開」。若提示「已損毀」，請先閱讀下載頁的對應處理方式，不要直接降低整個系統的安全設定。
下載頁提供 Windows 64 位元安裝程式。儲存檔案後先確認來源與檔案類型，再執行安裝；完成安裝不代表連線設定也已完成，仍須匯入既有資料並檢查目前的路由選擇。
SmartScreen 出現封鎖提示時，確認來源後可透過「更多資訊 → 仍要執行」繼續。若裝置由單位管理、沒有允許選項或帳戶權限不足，請遵循裝置管理規範，不要反覆嘗試繞過系統限制。
使用下載頁提供的 arm64 安裝包，並確認裝置架構。若安裝時系統要求授權，請在目前瀏覽器或檔案管理器對應的「允許安裝未知應用程式」設定中操作；安裝完成後，可依個人管理習慣撤回該權限。
應用程式內建瀏覽器限制下載時，可改用系統瀏覽器開啟本站下載頁。首次建立連線也需要系統 VPN 授權；若有其他 VPN 應用程式占用連線，請先確認系統目前使用的連線設定。
Debian / Ubuntu 優先選擇 deb，Fedora 系列選擇 rpm，其他發行版可查看 AppImage 的執行條件。套件格式與處理器架構都必須相符，不能只依發行版名稱下載後直接執行。
deb 與 rpm 由對應的套件管理器處理相依性；AppImage 執行前須授予執行權限。若桌面環境阻止執行、掛載目錄不允許執行或缺少執行相依項目，請先找出具體錯誤，再依下載頁的安裝說明處理。
跨裝置使用時，請分開處理「安裝用戶端」與「移轉設定」。不同系統的權限提示、檔案入口與背景行為不盡相同；匯入既有資料後，應在每台裝置分別確認伺服器、Config 與連線結果。
查看全部平台 →Shadowrocket 是閉源商業應用程式。本站是官方網站與官方手冊，說明取得方式與操作方法；用戶端、伺服器資料和網路連線是三個需要分別核對的部分。
在 iPhone / iPad 上搜尋 Shadowrocket 後，進入產品詳細頁，逐項核對開發者 Shadow Launch Technology Limited、官方圖示與 App ID 932747118。搜尋結果的排列位置、名稱相似程度與別稱都不能作為核對依據。遇到同名但開發者不同的項目，不應視為同一產品；已安裝的應用程式也可以從商店記錄返回對應產品頁確認。桌機與 Android 版本則從本站下載頁取得，實際安裝包路徑位於本站 /dl/shadowrocket/ 下。
App Store 內容由目前用於商店購買的帳號地區決定，不只取決於手機所在位置或系統語言。中國大陸商店未提供此應用程式；搜尋不到時，先確認帳號的商店地區、「螢幕使用時間」中的年齡分級限制，以及帳號是否能正常購買。需要調整地區時，應透過 Apple 帳號的正式設定流程操作，並先了解餘額、訂閱與付款方式等條件。不要為了搜尋結果反覆切換系統語言或重置裝置，這些操作無法取代商店地區核對。
iPhone / iPad 版在 App Store 一次性 $2.99，美國商店以該價格顯示，其他商店的顯示貨幣與實際金額以商店頁面為準；Mac、Windows、Android、Linux 版免費。iPhone 與 iPad 可在用於購買的同一個 Apple 帳號下共用購買項目。換機或重新安裝時，先檢查 App Store 的已購項目，再確認登入的是當初完成購買的帳號；若看到重新標價，請勿急著重複付款，應先核對購買記錄、帳號及產品頁。系統需求一律以 App Store 頁面標示為準。
已有訂閱連結時，請保留完整網址，包括問號之後的參數；已有單一伺服器時，請備妥協定類型、位址、連接埠與相應驗證欄位。掃描 QR Code 可使用 Scan QR Code，手動新增則使用 Add Server，兩種方式最終都必須與原始資料相符。教學中的 example.com 僅用於展示格式，並非可連線的伺服器。訂閱網址可能包含存取憑證，複製到裝置時請留意剪貼簿與螢幕截圖範圍，向他人說明錯誤時不要直接公開完整連結。
設定模式 Config、代理模式 Proxy、直連模式 Direct 是 Global Routing 的三種模式，連線開關則控制是否建立系統連線。若要依 Rule 分流，應先選擇正確的 Config 檔案，再讓 Global Routing 使用 Config。暫時切換到 Proxy 有助於區分規則與伺服器問題，但不能用來修復所有請求；切換到 Direct 也不代表伺服器參數已恢復。每次只修改一個因素，記錄修改前後的模式與結果，才能判斷是哪項設定造成變化。
iPhone / iPad 用戶端更新透過 App Store 管理；Mac、Windows、Android 與 Linux 版本請回到本站下載頁取得新版安裝包。用戶端更新、Subscribe 更新與 Config 檔案修改是三件不同的事：前者變更程式，訂閱更新變更既有伺服器清單，設定修改則會影響規則與相關行為。更新前請保留必要的設定副本，更新後核對目前選取的項目。使用 iCloud 同步時，也要檢查裝置上實際出現的內容，不能只因帳號相同就假設所有狀態都已同步。
排查時先記下問題發生在哪個網路、哪個目標、哪種模式，以及是否只有某一台伺服器受到影響。能連線但部分內容無法開啟，可能與 DNS、Rule 或目標本身有關；完全無法建立連線，則優先檢查系統授權、伺服器資料與基本網路。Connectivity Test 的結果只代表特定測試條件下的連線能力，不能取代實際存取。若記錄中出現明確錯誤，請保留錯誤名稱與發生時間，再依相關章節逐項核對，不要同時更換協定、規則和網路。
先確認發行版與處理器架構。Debian / Ubuntu 選擇 deb，Fedora 系列選擇 rpm；AppImage 適用於可自行檢查執行條件、相依項目與執行權限的情況。三者是不同的發行格式，不代表不同的訂閱類型。查看安裝與權限說明 →
匯入成功只表示用戶端已接收資料。還要確認伺服器是否可用、目前選取的項目是否正確、Global Routing 是否符合預期，以及系統是否允許建立連線。保留原始設定，依序檢查網路、伺服器與規則。依首次連線步驟核對 →
不要只因大小寫相似就混為一談。規則中的 PROXY 是策略引用，必須在目前設定中有效；Global Routing 的 Proxy 則是路由模式。前者寫在規則列中，後者會改變整體處理模式。查看規則與故障排查問答 →
依問題查找文章。安裝篇處理系統與晶片差異，商店篇核對帳號條件，規則篇說明比對界線；閱讀前先確認問題屬於哪個層面。
如何對應 Mac 的 Apple 晶片與 Intel 安裝包，首次開啟時出現無法驗證開發者的提示要到哪裡檢查；Windows 遇到 SmartScreen 時，先確認來源，再依系統提供的選項繼續。將安裝封鎖與應用程式內連線失敗分開判斷，避免在錯誤的環節修改設定。
閱讀安裝說明 →依序檢查商店地區、「螢幕使用時間」限制與帳號購買狀態，再透過 App ID 932747118 確認產品頁。搜尋不到與已購項目還原失敗可能是不同問題；先判斷是在尋找應用程式、還原購買，還是處理付款提示，再選擇相應步驟。
閱讀商店排查 →了解 REJECT 與 DOMAIN-SUFFIX 的組合，以及規則順序如何影響比對。網域規則針對的是請求目標，無法自然區分同一網域下的不同內容；修改前應了解連帶影響，遇到誤封時應回到符合的規則定位問題，而非繼續疊加寬泛條件。
閱讀規則說明 →