依裝置系統選擇 v2rayN、v2rayNG 或 v2flyNG。桌面平台使用 v2rayN，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。本頁也列出處理器架構、套件格式與安裝後的設定順序。
平台標籤會同步至頁面網址。複製帶有平台標記的網址後再次開啟，即可直接顯示對應系統的下載內容。
Windows 提供桌面版與經典 WPF 版兩個入口。桌面版採用新一代跨平台介面，介面結構與 macOS、Linux 版本更接近；經典 WPF 版延續長期使用的 Windows 操作方式，適合希望保留既有選單路徑與使用習慣的使用者。
首次使用且希望採用目前介面體系時，選擇桌面版。已熟悉經典選單、系統匣操作與 WPF 介面時，選擇經典 WPF 版。兩個安裝套件都面向 x64 Windows，無需同時安裝；若準備從一個版本切換至另一個版本，先記錄訂閱網址、路由規則與自訂設定，再完成遷移。
新一代跨平台 UI，適合首次安裝，以及希望桌面平台介面保持一致的使用者。
延續經典 Windows 介面與操作流程，適合想沿用既有使用習慣的使用者。
| 檢查項目 | 建議 | 原因 |
|---|---|---|
| 處理器架構 | x64 | 本頁兩個 Windows 安裝入口皆為 x64 架構版本。 |
| 安裝權限 | 使用具備安裝桌面程式權限的帳戶 | 安裝過程需要寫入應用程式檔案，並可能建立開始功能表或桌面捷徑。 |
| 首次啟動 | 允許用戶端進行必要的網路連線 | 用戶端需要更新訂閱、連線伺服器並回應系統代理設定。 |
| 版本選擇 | 桌面版或經典 WPF 版擇一 | 避免兩個版本同時執行並爭用本機代理連接埠或系統代理狀態。 |
macOS 安裝套件依處理器分為 Apple Silicon 與 Intel 兩種。架構必須與裝置處理器相符，否則可能無法啟動或需要額外的相容性轉譯。選擇前先開啟系統資訊，確認「晶片」或「處理器」欄位，再下載對應的 DMG 檔案。
「關於本機」中顯示 Apple 晶片型號的裝置選擇 Apple Silicon；顯示 Intel 處理器的裝置選擇 Intel。開啟 DMG 後，將應用程式拖曳至系統應用程式資料夾，再從應用程式資料夾啟動。系統首次攔截時，應透過隱私權與安全性設定確認允許應用程式執行，並依提示授予必要的網路連線權限。
適用於採用 Apple 晶片的裝置，處理器架構為 arm64。
適用於系統資訊中明確顯示 Intel 處理器的裝置。
| 檢查項目 | 選擇方法 | 安裝提示 |
|---|---|---|
| 晶片架構 | Apple 晶片選 arm64，Intel 處理器選 x64 | 不要只根據裝置外觀或購買年份判斷，應以系統資訊為準。 |
| 套件格式 | DMG | 開啟磁碟映像檔後，將應用程式移至系統應用程式資料夾。 |
| 系統允許執行 | 在隱私權與安全性設定中處理攔截提示 | 首次啟動出現開發者確認提示時，從系統設定完成確認。 |
| 網路權限 | 依系統提示授權 | 訂閱更新、節點連線與代理控制都需要正常的網路連線權限。 |
Android 請先依核心需求選擇用戶端，再依裝置架構選擇安裝套件。日常使用可優先選擇採用 Xray 核心的 v2rayNG；需要與既有 v2fly 設定及核心行為保持一致時，選擇 v2flyNG。2015 年後的主流手機通常可先嘗試 arm64 版本。
v2rayNG 是 Android 平台的主要選擇，採用 Xray 核心，適合匯入常見訂閱與分享連結。確認裝置為 64 位元 ARM 架構時選擇 arm64；無法確認架構、裝置較舊，或 arm64 套件無法安裝時選擇通用版。安裝完成後，首次建立 VPN 連線會出現系統授權提示，確認後才能接管所選流量。
面向主流 64 位元 ARM 手機，套件針對單一常用架構最佳化。
涵蓋更廣泛的裝置架構，適合架構不明時使用。
v2flyNG 採用 v2fly 核心，適合既有設定明確依賴該核心，或需要與其他 v2fly 環境保持設定行為一致的情境。架構選擇方法與 v2rayNG 相同：主流 64 位元 ARM 裝置優先選擇 arm64，裝置架構不明時選擇通用版。兩個 Android 用戶端通常無需同時執行，切換前應先停止目前的連線。
適合能確認處理器為 64 位元 ARM 架構的裝置。
適合無法確認裝置架構，或需要更廣泛相容範圍的情況。
| 檢查項目 | 建議 | 說明 |
|---|---|---|
| 用戶端 | 日常使用先選 v2rayNG | 需要維持 v2fly 核心行為時，再選擇 v2flyNG。 |
| 裝置架構 | 主流裝置先選 arm64 | 2015 年後的主流手機通常採用 64 位元 ARM 架構；不確定時選擇通用版。 |
| 安裝權限 | 允許瀏覽器或檔案管理器安裝下載的應用程式 | 系統會針對安裝來源顯示一次性授權入口，完成安裝後可視需要收回權限。 |
| 連線授權 | 確認系統 VPN 連線提示 | 用戶端需要透過系統網路介面接管選定流量。 |
Linux 安裝先判斷發行版的套件體系，再判斷處理器架構。Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux 等採用 RPM 套件管理體系的發行版通常使用 rpm。常見桌上型電腦選擇 x64，arm64 裝置則選擇對應架構入口。
x64 是常見 Intel 與 AMD 桌上型處理器使用的架構，主要下載入口提供 deb 與 rpm 兩種格式。arm64 常見於 ARM 桌上型裝置、開發板和部分輕量主機，需使用對應架構的套件。安裝前可透過發行版的套件管理工具確認格式，並以系統架構指令確認 x86_64 或 aarch64，避免只依檔案副檔名嘗試。
適用於 Debian、Ubuntu 以及採用 deb 套件管理體系的衍生發行版。
適用於 Fedora、Rocky Linux、AlmaLinux 等 RPM 體系發行版。
| 檢查項目 | 常見結果 | 對應安裝套件 |
|---|---|---|
| 發行版體系 | Debian、Ubuntu 及衍生版 | deb |
| 發行版體系 | Fedora、Rocky Linux、AlmaLinux 等 | rpm |
| 處理器架構 | x86_64 或 amd64 | x64 套件 |
| 處理器架構 | aarch64 或 arm64 | arm64 套件 |
| 桌面環境 | 能夠執行圖形桌面應用程式 | 安裝後從應用程式選單或桌面入口啟動 v2rayN。 |
安裝套件只完成用戶端部署。實際連線還需要有效的訂閱或分享連結，並應依固定順序設定，避免在節點、路由與網路模式之間反覆修改。
從服務提供者取得有效訂閱網址後，在用戶端中使用「從剪貼簿匯入」或訂閱管理入口新增。訂閱網址與單一分享連結用途不同：訂閱通常可批次更新伺服器清單，單一分享連結只會新增對應設定。匯入前先確認複製內容完整，避免將說明文字或多餘空格一併貼上。
新增訂閱後先執行更新，再從清單中選擇一個節點作為目前伺服器。清單中顯示的名稱主要用於辨識線路，不應只依名稱判斷實際可用性。首次連線時可直接選擇一項設定並執行實際連線測試；若失敗，再依節點狀態、網路環境、DNS 與本機代理設定逐層排查。
系統代理主要影響遵循作業系統代理設定的瀏覽器與應用程式，適合日常網頁瀏覽與一般桌面軟體。TUN 模式可接管更廣泛的應用程式流量，但通常需要額外的系統權限，也會讓 DNS 與路由設定更加重要。首次設定建議先使用系統代理確認節點能夠連線，再依應用程式涵蓋範圍決定是否啟用 TUN。
用戶端顯示正在執行，只能表示本機程序已啟動，不能取代實際連線結果。應開啟需要透過代理存取的網頁或應用程式，確認內容能正常載入；同時檢查系統代理狀態、目前節點與用戶端記錄。若一個應用程式可用而另一個不可用，優先判斷後者是否遵循系統代理，而不是立即更換全部訂閱。
V2Ray 是相關協定、設定結構與實作生態的統稱，日常使用通常透過圖形用戶端管理訂閱、節點、路由與系統代理。用戶端負責介面與操作流程，核心負責解析設定並處理網路連線，兩者分工不同。
v2rayN 涵蓋 Windows、macOS 與 Linux 桌面平台；v2rayNG 和 v2flyNG 面向 Android。v2rayNG 採用 Xray 核心，v2flyNG 採用 v2fly 核心。一般安裝情境只需下載對應的圖形用戶端，用戶端會依其發行方式管理所需的執行元件。
Windows、macOS、Linux 使用同一用戶端系列，訂閱管理、節點切換、路由設定與系統代理操作邏輯更容易保持一致。Windows 可在桌面版與經典 WPF 版之間選擇，macOS 依晶片架構選擇，Linux 依套件體系與處理器架構選擇。
v2rayNG 適合多數 Android 使用情境，支援常見訂閱匯入、節點管理與路由設定。裝置架構確定為 64 位元 ARM 時使用 arm64 安裝套件；裝置資訊不明時使用通用版，可減少因架構判斷錯誤導致的安裝失敗。
v2flyNG 是 Android 平台的備選用戶端。既有設定、路由行為或使用環境明確圍繞 v2fly 核心建立時，選擇 v2flyNG 更容易維持一致。若沒有明確的核心依賴，先使用 v2rayNG 可減少選擇步驟。
以下問題集中處理版本、架構、套件格式與首次設定。連線速度、路由規則、DNS 與 TUN 的深入設定，可繼續查閱進階手冊。