V2Ray 下載與
用戶端安裝檔

解壓縮 ZIP 後再執行安裝程式

將壓縮檔完整解壓縮至可寫入的資料夾，再開啟其中的安裝程式。請勿直接從壓縮軟體的暫存預覽視窗執行，以免後續檔案被解壓縮至暫存路徑。若系統提示缺少執行元件，請依安裝提示補齊對應架構的相依元件，再重新啟動用戶端。

切換 Desktop 與 WPF 前，請先匯出設定或備份原資料目錄。兩種介面可能使用不同的資料位置，不應透過覆蓋整個程式目錄來搬移資料。請保留舊設定副本，待新介面完成訂閱、路由與監聽連接埠檢查後，再清理舊目錄。

從「應用程式」資料夾啟動

打開 DMG，將 App 移至「應用程式」資料夾，複製完成後再啟動。請勿將掛載的磁碟映像當作長期執行位置，否則退出磁碟映像或清理下載資料夾時，可能影響 App 正常使用。

首次開啟時若出現系統安全性提示，請先確認所選用戶端與檔案來源，再依系統「隱私權與安全性」中的提示處理。請勿為了執行單一 App 而關閉整台裝置的安全機制。安裝成功後，先檢查訂閱群組、代理監聽連接埠與路由設定，再決定是否啟用系統代理。

處理器架構請以系統資訊為準，不要根據機身外觀或購買年份推測。更新 App 前請正常結束執行中的用戶端並備份設定，也請記錄原有路由設定，避免將安裝問題與設定遷移問題混在一起排查。

安裝權限與首次 VPN 請求

開啟 APK 時，系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝 App。請只授權實際用來開啟檔案的來源，安裝完成後可撤銷此權限。啟動連線時，Android 會顯示 VPN 連線要求，確認 App 名稱符合預期後再授權。

安裝失敗不一定是架構問題。系統版本過舊、可用空間不足、既有 App 簽章不同或嘗試降級，都可能導致安裝遭拒。請先閱讀系統提示，再決定是否更換安裝檔；不要反覆解除安裝，以免遺失現有訂閱與路由設定。

依核心功能遷移設定

v2rayNG 與 v2flyNG 是不同的 App，不能只因介面相似，就假設所有設定都能互換。切換時請重新檢查協定、傳輸方式與 TLS 參數，尤其不要將某個核心專用欄位直接複製到另一款用戶端。兩款 App 可以分別儲存設定，但使用 VPN 連線時，應先停止另一款 App 的連線。

先確認發行版，再檢查相依套件

使用系統內建的軟體安裝程式開啟套件，閱讀相依性與相容性提示後再安裝。deb 與 rpm 是不同的套件格式，不能只改副檔名來轉換；即使都使用 rpm 或 deb，也不代表不同版本的發行版一定相容。

本頁提供的下載入口適用於圖形桌面環境，不以伺服器終端機部署為目標。安裝完成後，請從應用程式選單啟動，並確認用戶端能寫入自己的設定目錄。桌面環境是否提供系統代理入口會影響設定方式；App 本身的代理設定也可能優先於桌面全域設定。

更新時請優先沿用相同的套件格式與處理器架構。執行套件升級前，先備份訂閱群組、路由規則與自訂設定；若遇到相依性衝突，請保留詳細提示，避免忽略相依性後繼續安裝。