本文適合準備在 Mac 或 Windows 安裝 Shadowrocket（小火箭）的使用者。先確認裝置與安裝檔，再分別處理 Gatekeeper 或 SmartScreen 的首次啟動提示，最後確認應用程式能否正常開啟。系統的來源確認提示、惡意軟體警告及組織管理限制，必須分別處理，不能用同一種允許方式解決。
一、下載前先確認平台與晶片
Shadowrocket 提供兩種取得方式：iPhone / iPad 版在 App Store 售價 $2.99，一次性購買；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。本文的電腦安裝入口統一使用本站下載指南，在頁面選擇相應平台。請勿從聊天附件或來源不明的轉載檔案開始安裝。
Mac 版本應依處理器架構選擇，而非外觀、購買年份或螢幕尺寸。打開螢幕左上角的 Apple 選單 →「關於這台 Mac」：若顯示「晶片」及 Apple 晶片名稱，請選擇 Apple 晶片版；若「處理器」欄位顯示 Intel，請選擇 Intel 版。兩種 Mac 安裝檔適用不同架構，不要反覆開啟錯誤的安裝檔來嘗試。
Windows 使用者可前往「設定」→「系統」→「系統資訊」查看「系統類型」，並與下載指南的安裝說明核對。請勿將 Mac 的 Apple 晶片版或 Intel 版選擇方式套用到 Windows。下載尚未完成時，請勿開啟暫存檔；瀏覽器顯示下載完成後，再從下載記錄前往檔案所在位置。
二、Mac 安裝：先複製應用程式，再從「應用程式」開啟
下載 dmg 後，先將應用程式複製完成，再處理首次啟動確認。長期直接從已掛載的磁碟映像執行，容易造成後續尋找應用程式、退出映像及更新安裝位置時的混亂。以下步驟適用於本站下載指南提供的 Mac 安裝流程。
-
確認晶片
Apple 選單 →「關於這台 Mac」，查看「晶片」或「處理器」欄位，再到下載指南選擇相應的 Apple 晶片版或 Intel 版。
-
開啟映像檔
等待 dmg 下載完成後，按兩下開啟。若系統顯示無法讀取映像檔，請先停止安裝並重新下載，不要將檔案損毀當成權限問題處理。
-
複製應用程式
將 Shadowrocket 拖曳至「應用程式」。等待複製完成；若需要取代已有的應用程式，請先結束正在執行的 Shadowrocket，再處理取代提示。
-
首次啟動
在 Finder →「應用程式」中開啟 Shadowrocket。若出現阻止啟動的提示，請記下完整訊息，再依照下一節的對應情況處理。
-
退出映像檔
確認應用程式已複製到「應用程式」後，從 Finder 側邊欄退出安裝映像。之後請從「應用程式」啟動，不再依賴下載資料夾中的 dmg。
若系統提示目前的應用程式不適用於這部 Mac，請先返回「關於這台 Mac」確認架構，再核對下載說明中的系統需求。應用程式不相容與 Gatekeeper 的來源檢查是不同問題；安全性設定中的允許按鈕不會變更程式架構，也無法補足未達到的系統需求。
三、Gatekeeper 提示：僅允許已確認的應用程式開啟
Gatekeeper 是 macOS 的應用程式安全檢查機制。首次開啟下載的應用程式時，系統可能要求確認來源，也可能阻止尚未通過相關驗證的應用程式執行。提示文字會依系統版本和檔案狀態而異，因此請先閱讀警告內容，不要一看到「無法開啟」就直接變更安全性設定。
依提示文字選擇處理方式
| 提示內容 | 建議操作 | 停止條件 |
|---|---|---|
| macOS 無法驗證開發者，或無法確認是否包含惡意軟體 | 確認檔案來自本站下載後，前往「系統設定」→「隱私權與安全性」，找到剛被阻止的 Shadowrocket，選擇「仍要打開」，並完成身分驗證及再次確認。 | 若頁面未顯示相應應用程式，或無法確認檔案來源，請勿繼續允許開啟。 |
| macOS 提示應用程式已損毀 | 停止安裝並刪除此次下載的檔案，返回下載指南重新取得適用於正確架構的安裝檔，再嘗試複製。 | 重新下載後仍持續出現錯誤時，請記錄系統版本、晶片類型及完整提示，不要使用通用解除指令強行執行。 |
| 系統明確指出含有惡意軟體或會損害電腦 | 請停止開啟，保留提示文字，並使用系統安全性功能處理檔案。 | 這類警告不適用一般來源確認的允許開啟步驟。 |
| Windows 顯示「Windows 已保護您的電腦」 | 確認檔案來源後，點選「更多資訊」查看應用程式及發行者資訊；若有「仍要執行」選項，且確認要繼續，再單獨允許此次執行。 | 若偵測到明確威脅、組織原則限制，或應用程式資訊異常，請停止操作。 |
Mac 的操作順序是先嘗試開啟一次，再前往 Apple 選單 →「系統設定」→「隱私權與安全性」查看安全性區域。若出現「仍要打開」，請確認對應的應用程式確實是 Shadowrocket，點選後依系統要求輸入密碼或使用 Touch ID，並在後續確認視窗中選擇開啟。較舊系統的路徑可能是「系統偏好設定」→「安全性與隱私權」→「一般」。
四、Windows 安裝：區分 SmartScreen 與威脅偵測
SmartScreen 的信譽檢查提示不代表程式已被判定為惡意軟體，但也不等於安全保證。「仍要執行」僅適用於使用者已確認來源、了解提示內容並決定繼續的情況。看到任何安全性視窗時，請勿一律照做並尋找這個按鈕。
- 從本站下載指南選擇 Windows 版，等待下載完成，再從瀏覽器下載記錄開啟檔案所在位置，確認準備執行的是剛下載的安裝檔。
- 按兩下檔案。若出現「Windows 已保護您的電腦」，點選「更多資訊」展開應用程式名稱及發行者資訊；資訊不明或與預期不符時，請先取消。
- 確認來源及應用程式資訊後，若視窗提供「仍要執行」，即可選擇繼續。若沒有這個選項，請勿透過關閉防護或變更組織原則強行啟動。
- 若接著出現 User Account Control，請確認要求啟動的程式及檔案位置。只有確認是此次安裝操作時才允許，並依照安裝精靈完成後續步驟。
- 安裝完成後，從開始功能表或實際安裝位置啟動 Shadowrocket，確認應用程式視窗能正常開啟，再進行連線設定。
SmartScreen、User Account Control 和 Windows 安全性中心的威脅偵測負責不同環節：前者涉及應用程式信譽檢查，第二項涉及權限提升，第三項則可能提供具體威脅處置結果。若系統明確偵測到威脅，請停止安裝並查看「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」，不要將還原隔離檔案當成一般安裝步驟。
五、分別確認安裝完成與連線成功
能開啟 Shadowrocket，只代表安裝及啟動流程已完成。連線還需要使用者已有的伺服器設定、網路環境、路由設定及系統授權。Shadowrocket 是閉源商業應用程式，客戶端本身不等於線路方案；本站不提供、不銷售、不推薦節點或訂閱。
依故障階段分別檢查
應用程式尚未開啟
- Mac：確認選用 Apple 晶片或 Intel 安裝檔。
- 確認下載已完成，且應用程式已複製到「應用程式」。
- 依據 Gatekeeper 或 SmartScreen 的實際提示處理。
- 記錄錯誤原文，不要透過修改訂閱或路由設定來解決啟動問題。
應用程式已能開啟
- 若有自備設定，先確認 Home 中選取的伺服器。
- 確認目前的 Global Routing 選項是否符合測試目的。
- 發起連線時閱讀系統授權內容，再確認是否允許。
- 執行 Connectivity Test，分開記錄連線問題與安裝問題。
先解決啟動問題，再確認設定；應用程式已能開啟時，不要反覆安裝來取代連線問題排查。
在 Global Routing 中，Config 會依目前的設定規則處理請求，Proxy 與 Direct 分別代表代理與直連模式；若介面提供 Scene，則須配合已設定的場景理解實際行為。切換模式無法修正安裝檔架構錯誤，也不能取代系統啟動許可。若要查看首次設定的詳細步驟，請繼續閱讀使用說明。
六、常見安裝問題與記錄方式
不知道 Mac 該下載哪個版本，可以依型號選嗎？
請勿只依型號或年份判斷。開啟 Apple 選單 →「關於這台 Mac」；「晶片」顯示 Apple 晶片時，請選擇相應版本；「處理器」顯示 Intel 時，請選擇 Intel 版。記錄這個欄位，比憑裝置外觀判斷更準確。
「隱私權與安全性」中沒有「仍要打開」怎麼辦？
先確認剛才確實是從「應用程式」嘗試開啟 Shadowrocket，再查看安全性區域中的具體提示。若屬於相容性錯誤、明確的惡意軟體警告或管理原則限制，就不應期待出現一般的允許開啟按鈕；請保留提示原文並依相應類別處理。
Windows 只有返回按鈕，沒有「仍要執行」怎麼辦？
確認是否已點選「更多資訊」。若仍沒有繼續選項，可能受到系統模式或組織安全性原則限制，請停止此次操作。公司或學校電腦應交由管理員確認，不要以關閉 SmartScreen 或即時防護作為替代方案。
應用程式能開啟但連線失敗，需要重新安裝嗎？
先不要重新安裝。在 Home 確認選取的伺服器，執行 Connectivity Test，並記錄連線時的提示。若只有連線失敗，而視窗正常、設定也能儲存，應優先檢查現有設定及網路，不要再次進行 Gatekeeper 或 SmartScreen 的允許操作。
若需要進一步說明問題，請準備四項資訊：作業系統名稱與版本、Mac 晶片或 Windows 系統類型、在下載指南中選擇的平台項目，以及完整錯誤訊息和出現步驟。可記錄「按兩下 dmg 時」、「首次從應用程式開啟時」或「點選連線後」等明確階段。請勿在公開截圖中放入密碼、完整訂閱網址或存取權杖。
- 下載失敗：記錄瀏覽器提示及下載是否完成，先不要調整應用程式的連線設定。
- 啟動失敗：記錄安全性視窗或相容性提示，並確認安裝來源與架構。
- 連線失敗：記錄 Connectivity Test 結果與目前的 Global Routing 模式，不要公開服務憑證。