適合首次在 Mac 或 Windows 安裝 Shadowrocket 的使用者。先確認晶片與安裝檔來源，再辨別系統信譽提示和明確的安全封鎖，最後完成首次啟動與連線檢查。安裝提示不代表連線故障，無須為了開啟應用程式而關閉系統整體防護。
安裝前：確認裝置與下載來源
Shadowrocket（小火箭）的 Mac 版分為 Apple 晶片與 Intel 兩種，Windows 版則使用對應的 Windows 安裝入口。先前往全平台下載指南選擇裝置，不要只憑檔名中的「Mac」判斷是否適用，也不要將搜尋結果中的轉載附件當成本站安裝檔。
取得方式分為兩種：iPhone / iPad 於 App Store 一次性購買，價格為 $2.99；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。iPhone / iPad 版的開發者為 Shadow Launch Technology Limited，系統需求請以 App Store 頁面標示為準。用戶端費用與服務供應商的線路費用是兩回事，買斷用戶端不等於購買線路方案。
桌面版安裝檔可透過本站下載指南取得，檔案位於本站 /dl/shadowrocket/ 路徑。若瀏覽器顯示下載尚未完成，請先等待下載完成再開啟；重複點擊未下載完成的檔案無法解除系統封鎖。安裝前請先儲存正在編輯的設定，更新既有安裝時尤其需要留意。
Mac 安裝檔：Apple 晶片或 Intel
點選螢幕左上角的 Apple 選單 → About This Mac（關於這台 Mac）。其中的 Chip 或 Processor 欄位比購買年份更可靠：同一產品系列可能採用不同晶片平台。請勿依筆電外觀、記憶體容量或是否安裝過其他軟體來判斷。
依 About This Mac 顯示的欄位選擇
Apple 晶片
- Chip 欄位會顯示 Apple 晶片型號。
- 在下載指南選擇 Mac Apple 晶片版。
- 優先選用符合晶片架構的安裝檔，不要預設以相容性轉換作為安裝步驟。
Intel
- Processor 欄位會顯示 Intel 處理器名稱。
- 在下載指南選擇 Mac Intel 版。
- 若提示架構不適用，請重新確認下載按鈕與這台 Mac 的處理器。
請以這台 Mac 顯示的欄位為準；兩種 Mac 都有對應的下載入口，無須依年份猜測。
下載後依檔案內的安裝說明完成安裝。若開啟的是包含應用程式的磁碟映像，請將應用程式拖入 Applications，再從 Applications 啟動；若出現安裝輔助程式，請依指示安裝至指定位置。尚未複製完成前，請勿反覆啟動，也不要將磁碟映像視窗與已安裝的應用程式混淆。
macOS「無法驗證開發者」：個別允許開啟
「無法驗證開發者」是 macOS 對應用程式來源與簽章驗證的提示，不能直接據此判定安裝檔已損毀，也不代表檔案一定安全。請先確認檔案確實來自本站下載指南，且已選擇正確的晶片版本，再使用系統提供的單一應用程式放行選項。不同 macOS 版本的提示文字和按鈕位置可能略有差異。
-
嘗試啟動
從 Applications 開啟 Shadowrocket，閱讀系統提示視窗。若出現「無法驗證開發者」提示，請先關閉視窗，記下其中顯示的應用程式名稱。
-
開啟設定
前往 System Settings → Privacy & Security（系統設定 → 隱私權與安全性），向下找到 Security 區域。較舊版本可在 System Preferences → Security & Privacy → General 中查看。
-
確認項目
確認遭封鎖的應用程式確實是剛才啟動的 Shadowrocket，再點選 Open Anyway（仍要打開）。若名稱不符或來源不明，請勿執行此操作。
-
確認開啟
依系統要求使用這台 Mac 的帳號進行認證，並在後續確認視窗選擇 Open。等待應用程式視窗出現，確認畫面不是仍停留在安裝檔視窗。
Open Anyway 通常會在最近一次啟動遭封鎖後顯示。若找不到選項，請先確認是否曾嘗試開啟已安裝的應用程式，再返回安全性設定查看。公司或學校管理的 Mac 可能限制此權限，請交由裝置管理員處理，不要變更組織政策。
Windows SmartScreen：查看資訊後再決定
SmartScreen 顯示的「Windows 已保護您的電腦」提示可能與檔案信譽有關，這與 Microsoft Defender 明確通報威脅並不相同。只有確認下載來源、檔案用途及提示詳細資訊後，才考慮對目前檔案執行一次。若安裝程式需要管理員權限，系統也可能另外顯示 UAC 確認視窗。
-
完成下載
從本站下載指南取得 Windows 版，並等待瀏覽器完成下載。在 File Explorer 的 Downloads 中找到檔案，避免誤開同名的舊檔。
-
查看詳細資訊
開啟檔案後，若出現 SmartScreen 提示，請點選 More info（更多資訊），查看應用程式名稱與發行者資訊。若名稱不符或無法確認來源，請選擇不執行。
-
單次執行
確認檔案來源，且沒有明確的惡意軟體警告後，若畫面提供 Run anyway（仍要執行），即可選擇該按鈕。此操作只適用於目前檔案，無須關閉 SmartScreen。
-
完成安裝
依照安裝輔助程式的指示操作；若出現 UAC，請先確認其中的程式資訊再核准。安裝完成後，從 Start 選單或安裝位置啟動 Shadowrocket。
若沒有 More info 或 Run anyway，可能是封鎖類型不同，或裝置受到組織政策管理。請勿反覆更改副檔名、關閉即時防護，或以管理員身分強行嘗試。先記下完整提示；若 Windows Security → Virus & threat protection → Protection history 中有明確威脅紀錄，請停止執行並進一步確認，不要將該紀錄當成一般信譽提示而忽略。
首次開啟：分辨權限、設定與連線
應用程式視窗正常顯示，代表安裝與首次啟動已進入下一階段，但不代表伺服器或規則已設定完成。若已有自己的服務供應商與訂閱，請向服務供應商取得訂閱連結。本站不提供、不銷售也不推薦節點、訂閱或相關服務。
啟動與系統權限
- 應用程式視窗
- 先確認 Home、Config、Settings 等主要入口都能正常顯示。
- 觸發權限提示
- 首次啟用連線時，請依實際顯示的視窗確認網路元件或 VPN 設定要求。
- 處理原則
- 只核准由目前 Shadowrocket 操作觸發且用途明確的系統要求。
- 完成標準
- 關閉後仍能正常重新啟動，不會再次進入安裝或安全封鎖流程。
不同系統使用的網路連線機制可能不同，請以目前用戶端與系統提示為準。
設定與連線檢查
- Home
- 確認既有伺服器項目；手動輸入時使用 Add Server。
- Config
- 檢查目前使用的設定檔；新增訂閱時，依 Subscribe 入口填入服務供應商提供的連結。
- Global Routing
- 檢查目前選取的項目；Direct 會直接連線，Config 則依目前設定規則處理。
- Settings
- 先保留已知設定，確認基本連線正常後，再評估 On Demand 等自動連線選項。
先測試手動連線，再加入自動連線條件，較容易分辨安裝問題與設定問題。
需要手動輸入伺服器資料時，協定、主機、連接埠與驗證資訊都必須與服務供應商提供的內容一致。連接埠由服務供應商指定，不能因為使用 Trojan 就一律填 443，也不能把訂閱網址當成伺服器主機填入。若應用程式能開啟但無法瀏覽網頁，應檢查伺服器是否可用、訂閱更新結果及 Global Routing，而不是重複安裝。
安裝與放行常見問題
Mac 提示架構不適用，點選「仍要打開」有用嗎？
沒有用。安全放行無法將錯誤的架構轉換成正確架構。重新開啟 Apple 選單 → About This Mac，確認 Chip 或 Processor 欄位，再到下載指南選擇對應的 Apple 晶片版或 Intel 版。
Windows 沒有「仍要執行」，要在哪裡開啟？
先查看完整提示，確認是否確實為 SmartScreen，以及裝置是否由組織管理。沒有按鈕時，不應為了安裝而關閉系統防護；明確威脅警告與組織限制應分別處理，不能套用單次放行步驟。
應用程式能開啟，但連線失敗，需要重新安裝嗎？
先在 Home 確認伺服器，再檢查 Config 中的設定與訂閱更新結果，並確認 Global Routing 是否符合預期。安裝問題通常發生在應用程式無法啟動或元件無法載入時；服務供應商的憑證錯誤不會因重新安裝而自動修復。
更新後再次出現安全提示，可以沿用上次的判斷嗎？
不可以只因上次成功就直接允許。先儲存目前設定，從下載指南重新確認更新檔的來源與架構，再依這次的提示類型處理。新檔案可能再次觸發信譽檢查，但若遭明確安全封鎖，仍應停止執行並確認原因。
排查時記下三項資訊，就能提供有效線索：系統顯示的完整提示、下載時選擇的平台與晶片，以及問題發生在安裝前還是連線後。請勿在紀錄中附上完整訂閱連結、密碼或驗證權杖。這樣既能定位問題階段，也能避免透過截圖或日誌散播憑證。