本文適用於準備在 Mac 或 Windows 安裝 Shadowrocket（小火箭）的使用者。請先確認裝置架構與本站下載來源，再分辨系統信譽提示、明確風險警告與連線權限要求；安裝完成後，使用既有設定檔檢查 Global Routing 和連線狀態。顯示「已安裝」不代表已能正常連線；首次開啟時也不應透過關閉系統安全功能來放行。
一、下載前確認平台、晶片與檔案來源
Shadowrocket Mac 版提供 Apple 晶片與 Intel 兩種版本。晶片類型決定應下載哪個安裝檔，不能只憑 Mac 外觀、購買年份或螢幕尺寸判斷。Windows 使用者則應先查看系統類型，再依下載頁當下列出的適用說明選擇；請勿在 Windows 使用 Mac 的 dmg 檔案。
- Mac：開啟 Apple 選單 →「關於這台 Mac」。若顯示「晶片」且名稱為 Apple 晶片，請選擇 Apple 晶片版；若顯示「處理器」且包含 Intel，請選擇 Intel 版。
- Windows：開啟「設定」→「系統」→「系統資訊」，查看「系統類型」。若裝置採用 ARM 架構，請勿預設所有桌面安裝檔都適用，應先確認下載頁的說明。
- 取得檔案：前往全平台下載頁，選擇對應平台。Mac 的兩個晶片版本按鈕分別對應不同安裝檔，下載後請保留原始檔名，以免改名後混淆。
- 確認來源：桌面版安裝檔由本站
/dl/shadowrocket/路徑提供。若檔案來自聊天附件、重新導向後的陌生網站，或來源不明的舊備份，請先停止開啟，並返回下載頁重新下載。
二、Mac 安裝：先複製到 Applications，再首次開啟
dmg 是磁碟映像，按兩下後會在 Finder 中掛載為一個磁碟區。成功掛載只代表可以檢視其中的檔案，不代表應用程式已複製到電腦。若一直直接從映像檔啟動，推出映像後可能會找不到原本的啟動位置。
- 在 Finder 的「下載項目」資料夾中找到剛下載的 dmg，按兩下掛載後，開啟其中的應用程式。
- 將 Shadowrocket 拖曳到「應用程式」（Applications）。若映像檔中有 Applications 捷徑，可拖曳至該捷徑；若沒有，請拖到 Finder 側邊欄的「應用程式」。
- 等待複製完成。若系統詢問是否取代同名應用程式，請先確認現有設定已備份，並結束正在執行的 Shadowrocket，再決定是否取代。
- 從「應用程式」開啟 Shadowrocket。確認複製完成後，可在 Finder 中退出安裝映像；之後請從「應用程式」資料夾啟動。
若首次啟動時出現無法驗證開發者或無法檢查是否含有惡意軟體的提示，請先讀完完整訊息。macOS 的提示文字會隨系統版本而異；單純無法驗證身分，與系統明確判定應用程式會損害電腦，並非同一種情況。
Mac 首次開啟：依提示類型分別處理
尚未確認身分或信譽
- 確認檔案確實來自本站，並確認晶片版本正確。
- 嘗試開啟一次後，前往「系統設定」→「隱私權與安全性」。
- 若頁面提供該應用程式的「仍要打開」選項，請確認應用程式名稱後點選，依系統要求驗證身分並確認開啟。
- 部分系統可在 Finder 中按住 Control 鍵並按一下應用程式，再選擇「打開」；若沒有相應選項，請依系統實際提供的操作辦理。
明確風險警告或檔案異常
- 若出現「會損害你的電腦」等風險判定，請停止操作，不要強行啟動。
- 若提示應用程式已損壞、映像檔無法掛載或複製中斷，請先刪除異常下載檔案，再從本站重新下載。
- 重新下載後仍出現風險提示，請保留提示原文，並透過網站說明頁查看回報方式。
- 若受組織管理的 Mac 禁止放行，請交由管理員確認，不要變更管理政策。
只針對已確認來源的單一應用程式進行處理；不要關閉 Gatekeeper，也不要執行大量移除隔離屬性的指令。
三、Windows 安裝：分辨 SmartScreen 與惡意軟體警告
Windows SmartScreen 會根據下載檔案的信譽資訊顯示提示。「Windows 已保護您的電腦」不代表應用程式已被判定為惡意軟體，但也不能只憑這句話就直接放行。請先確認下載來源，再查看提示中的應用程式名稱與發行者資訊。
- 從本站下載頁取得適用於目前系統的 Windows 安裝檔。請等瀏覽器顯示下載完成後再開啟，不要執行尚未下載完整的檔案。
- 啟動安裝程式。若出現使用者帳戶控制提示，請查看程式名稱與發行者，確認這是剛才由你主動開啟的安裝程式，再決定是否允許變更裝置。
- 若 SmartScreen 顯示「Windows 已保護您的電腦」，請點選「更多資訊」並檢查顯示內容。確認來源與檔案相符，且沒有明確的惡意軟體警告後，才使用系統提供的「仍要執行」。
- 依照安裝精靈完成安裝，再從「開始」功能表或已建立的應用程式捷徑啟動。不要反覆執行安裝程式來取代啟動應用程式。
若沒有「仍要執行」選項，可能是受到組織政策限制，也可能是其他類型的封鎖。請記錄完整提示並交由管理員確認。若 Windows 安全性明確回報威脅，請勿關閉即時保護、將整個下載資料夾加入排除項目，或反覆還原已隔離的檔案。
- 看到 SmartScreen 信譽提示：先查看「更多資訊」，判斷是否可以繼續處理單一檔案。
- 看到 Windows 安全性威脅警告：停止啟動，並保留偵測名稱與檔案來源資訊。
- 看到「此應用程式無法在您的電腦上執行」：返回「系統資訊」確認系統類型與下載頁的適用條件，不要繼續尋找放行按鈕。
四、首次啟動後：先確認設定，再決定 Global Routing
應用程式能開啟，只代表安裝與啟動階段已完成。要連線，還需要使用者已有的服務商與訂閱，或自行管理的伺服器參數。本站不提供、不販售、不推薦節點或訂閱。首次匯入前，請備份現有設定；訂閱連結中的權杖也不應出現在截圖或公開回報中。
- 先確認目前一般網路可正常使用，再進入 Home 新增既有連線資訊；已有訂閱的使用者，請透過介面提供的入口匯入，並確認伺服器位址、連接埠及協定欄位。
- 在 Config 中確認目前設定是否為準備使用的那一份，尤其留意規則引用的策略是否存在。協定、驗證資訊、TLS 與傳輸參數應與既有伺服器端設定一致。
- 查看 Global Routing 目前的選項。排查問題時一次只修改一個變數，不要同時更換訂閱、協定、DNS 與路由模式。
- 首次啟用連線時，若系統要求新增 VPN 設定或其他網路權限，請確認要求來自目前使用的應用程式後再授權。權限要求與安裝時的安全性放行是不同步驟。
Config：依目前規則處理
建議根據目前設定中的規則與策略決定連線去向。符合規則後會採用相應動作；未符合時則由後續規則或 FINAL 決定，不能簡單理解為「其他流量一定直連」。
適用情況：已有確認過的設定，需要依網域或目標位址分流。
Proxy：暫時檢查代理路徑
讓應用程式處理的連線採用代理模式，方便與 Config 的結果比較。但這不保證電腦上所有程式的各類流量都會自動由它接管。
適用情況：已有可用代理，想暫時判斷故障是否與分流規則有關。
Direct：檢查直連結果
讓應用程式處理的連線採用直連路徑。切換至 Direct 後能夠存取，只能表示該目標在當時的網路環境下可直連，不能證明代理參數正確。
適用情況：建立直連對照，以區分本機網路問題與代理路徑問題。
結論：能啟動但無法連線時，不要反覆安裝
若視窗能正常開啟且沒有系統封鎖，請保留安裝結果，改為檢查既有連線的位址、連接埠、驗證資訊與 Global Routing。若 Proxy 可用但 Config 無法使用，下一步應檢查規則是否命中及策略引用，而不是再次放行安裝檔。
五、常見提示與安裝後檢查
回報問題時，至少記錄平台、晶片或系統類型、問題發生於安裝或連線階段，以及完整提示文字。只說「打不開」無法分辨檔案架構不符、系統阻止啟動、權限未授予或連線逾時。以下處理順序有助減少不必要的變更。
Mac 明明已下載完成，為什麼沒有出現「仍要打開」？
先從「應用程式」實際嘗試啟動一次，再查看「系統設定」→「隱私權與安全性」。若仍沒有選項，請確認提示是否屬於應用程式損壞或明確風險警告；受管理裝置也需檢查組織限制。不要透過關閉系統安全檢查來讓按鈕出現。
Windows 開啟後提示不相容，需要以系統管理員身分重試嗎？
先開啟「設定」→「系統」→「系統資訊」確認系統類型，再返回下載頁查看適用說明。系統管理員權限無法讓架構錯誤的程式變成相容程式。只有在安裝精靈或系統明確要求必要權限時，才依提示處理。
已經看到 Home，為什麼還是連線失敗？
先確認選取的連線及其位址、連接埠、驗證與協定參數，再檢查 Global Routing。若用戶端提供連線測試，請搭配測試結果與記錄判斷故障階段；延遲測試有回應，不代表目標網頁、DNS 與所有協定流量都已正常。
關閉連線後又自動連上，是安裝尚未完成嗎？
這較可能與自動連線設定有關，而非安裝殘留。若目前平台提供 Settings → On Demand，請先查看並暫時停用相應觸發規則，再重新測試。桌面版若未顯示此選項，請依目前介面檢查自動連線設定與系統 VPN 政策，不要套用其他平台的選單路徑。
六、確認安裝完成的檢查清單
驗收安裝時，請分開記錄「應用程式啟動」與「網路連線」。前者確認系統能否正常載入應用程式；後者確認使用者既有設定能否如預期運作。重新安裝前，先判斷問題是否確實發生於啟動階段，避免覆蓋現有設定卻仍留下原本的連線問題。
- 檔案位置：Mac 請從「應用程式」啟動，不依賴仍掛載的 dmg；Windows 請從安裝後的應用程式捷徑啟動，不要反覆執行下載資料夾中的安裝程式。
- 系統狀態：沒有尚未處理的明確風險警告，也沒有為了執行應用程式而關閉整台裝置的安全防護。
- 設定狀態：已選取正確的既有連線，Config 使用預期設定，訂閱更新也沒有覆蓋尚未備份的手動修改。
- 連線狀態：先測試一個已知目標，再恢復日常使用的 Global Routing 設定；記錄 Direct、Proxy 與 Config 的差異，方便後續排查。
- 復原準備：保留必要的設定備份；回報問題時遮蔽密碼、私鑰與訂閱權杖，只提供排查所需資訊。