CLIENT PACKAGES
依作業系統、處理器架構與介面類型選擇安裝包。桌面平台使用 v2rayN，Android 可依核心需求在 v2rayNG 與 v2flyNG 之間選擇。
PLATFORM SELECTOR
先切換平台，再對照裝置架構與安裝包格式。頁面會保留平台錨點，重新整理或分享連結後仍可返回對應標籤。
v2rayN 提供桌面版與經典 WPF 版。兩者皆為 x64 架構，主要差異在於介面技術與操作配置。
桌面版 Desktop：採用新一代跨平台介面，頁面結構、設定入口與其他桌面系統更加一致，適合首次使用 v2rayN 或希望使用目前桌面介面方向的使用者。
經典 WPF 版：延續傳統 Windows 用戶端配置，伺服器清單、訂閱群組、系統代理與路由設定的入口更接近舊版操作習慣，適合已熟悉經典介面的使用者。
兩個入口皆適用於 64 位元 Windows。若裝置能正常執行目前的 Windows 桌面應用程式，通常優先選擇桌面版；若現有教學、設定流程或使用習慣以 WPF 介面為基礎，選擇經典 WPF 版會更容易對應選單位置。
| 檢查項目 | 適用說明 | 建議選擇 |
|---|---|---|
| 處理器架構 | 頁面提供的兩個安裝包皆適用於 64 位元 x86 處理器。 | x64 |
| 介面類型 | 桌面版使用跨平台介面；WPF 版使用經典 Windows 介面。 | 新使用者優先選擇桌面版 |
| 安裝方式 | 下載 ZIP 檔案後，先完整解壓縮，再從解壓縮目錄執行安裝程式。 | 請勿直接在壓縮檔內啟動 |
| 執行權限 | 一般系統代理通常以一般使用者權限執行；涉及系統層級網路設定時，系統可能會要求管理員確認。 | 依功能提示授權 |
先在「關於這台 Mac」中查看晶片名稱。Apple M 系列選擇 arm64，Intel 處理器選擇 x64。
Apple Silicon 版：適用於搭載 Apple M 系列晶片的裝置，安裝包架構標記為 arm64。這是目前多數新款 Mac 對應的原生架構。
Intel 版：適用於「關於這台 Mac」中顯示 Intel 處理器的裝置，安裝包架構標記為 x64。
下載 DMG 後開啟磁碟映像，依照系統介面完成應用程式安裝。首次執行時，系統可能顯示網路下載應用程式的確認訊息；確認檔案來源與用戶端名稱後，依系統提示繼續。匯入訂閱、選擇伺服器與設定系統代理皆在用戶端內完成。
| 「關於這台 Mac」顯示內容 | 安裝包架構 | 下載入口 |
|---|---|---|
| Apple M 系列晶片 | arm64 |
Apple Silicon 版 |
| Intel 處理器 | x64 |
Intel 版 |
| 安裝包格式 | DMG |
開啟磁碟映像後安裝 |
| 網路設定 | 系統代理或 TUN 模式可能觸發系統權限確認。 | 依實際使用模式授權 |
優先選擇 v2rayNG。已有 V2Fly 設定或需要相應核心行為時，可選擇 v2flyNG。
v2rayNG 使用 Xray 核心，可在介面中管理訂閱群組、單筆分享連結、路由規則與本機代理設定。對 VLESS、VMess、Trojan、Shadowsocks、REALITY 等常見設定的支援相當完整，適合作為 Android 的一般選擇。
arm64-v8a：適用於 2015 年後的主流 Android 手機，安裝包只包含相應處理器架構的元件，通常應優先選擇。
universal：通用版涵蓋更廣泛的架構相容性，檔案通常較大。裝置架構無法確認、arm64 安裝時顯示不相容，或需要在不同架構裝置間保留同一安裝檔案時，可改用通用版。
v2flyNG 使用 V2Fly 核心，適合需要延續 V2Fly 設定語意、已有相應訂閱內容，或希望參照 V2Fly 文件設定路由與傳輸參數的使用者。它與 v2rayNG 的主要選擇差異在於核心家族，而非安裝步驟。
處理器架構的判斷方式與 v2rayNG 相同：主流裝置先選擇 arm64-v8a；無法確定架構或安裝時出現架構不相容，再使用 universal 通用版。
同一台裝置通常只需選擇一個主要用戶端。頻繁在兩個用戶端之間匯入相同訂閱，容易使系統連線權限、背景執行策略與目前啟用的設定變得難以判斷。需要比較核心行為時，再分別記錄所使用的用戶端與設定條件。
| 檢查項目 | 優先選擇 | 補充說明 |
|---|---|---|
| 2015 年後的主流手機 | arm64-v8a |
對應多數 64 位元 ARM 處理器裝置。 |
| 無法確認架構 | universal |
通用版涵蓋更多處理器架構。 |
| 用戶端核心 | v2rayNG 使用 Xray | v2flyNG 使用 V2Fly，可依設定需求選擇。 |
| 安裝包格式 | APK |
開啟檔案後，依 Android 系統的安裝流程操作。 |
| 首次連線 | 確認系統連線要求 | 用於建立本機網路介面，由系統統一管理授權狀態。 |
先依發行版的套件管理體系選擇 deb 或 rpm，再依處理器選擇 amd64 或 arm64。
deb：適用於 Debian、Ubuntu 以及採用 Debian 套件管理體系的發行版。常見的 64 位元桌上型電腦選擇 amd64，ARM 裝置選擇 arm64。
rpm：適用於 Fedora、RHEL、Rocky Linux、AlmaLinux 等採用 RPM 套件管理體系的發行版。常見的 64 位元桌上型電腦對應 x86_64，ARM 裝置對應 aarch64。
安裝前可執行 uname -m 查看架構：輸出 x86_64 時選擇 amd64 deb 或 x86_64 rpm；輸出 aarch64 時選擇 arm64 deb 或 aarch64 rpm。套件格式必須與發行版的套件管理體系相符，不能只依檔名中的架構判斷。
| 系統或命令結果 | 套件格式 | 架構選項 |
|---|---|---|
| Debian、Ubuntu 及其衍生版 | deb |
amd64 或 arm64 |
| Fedora、RHEL 系列發行版 | rpm |
x86_64 或 aarch64 |
uname -m 輸出 x86_64 |
依發行版選擇 | amd64 deb / x86_64 rpm |
uname -m 輸出 aarch64 |
依發行版選擇 | arm64 deb / aarch64 rpm |
| 桌面工作階段 | 需要可用的圖形環境 | 透過應用程式選單啟動 v2rayN |
PACKAGE DECISIONS
安裝失敗時通常先從平台、處理器架構與檔案格式三項排查。它們分別回答「在哪個系統執行」、「處理器指令集為何」以及「由哪種安裝工具處理」。
這三個名稱在本頁都對應常見的 64 位元 x86 桌面處理器環境。Windows 按鈕使用 x64；Debian 系軟體套件通常寫作 amd64；RPM 軟體套件通常寫作 x86_64。名稱來自不同平台與套件管理體系，不代表三個彼此不相容的處理器家族。
這些名稱都與 64 位元 ARM 架構相關，但使用情境不同。macOS 和 deb 套件常寫作 arm64，RPM 套件常寫作 aarch64，Android APK 常寫作 arm64-v8a。應從目前平台對應的下載入口選擇，不能將其他平台相同架構的檔案交叉安裝。
DMG 是 macOS 磁碟映像，APK 由 Android 安裝流程處理，deb 與 rpm 則分別服務於不同的 Linux 套件管理體系。檔案副檔名決定系統採用的安裝方式，架構名稱則決定其中的程式能否在處理器上執行，兩者都必須相符。
Android 的 arm64 安裝包只包含目標架構所需的程式元件，適合多數主流手機。通用版涵蓋更多架構，適合架構未知或需要在不同裝置間保留同一安裝檔案的情況。確認裝置為 64 位元 ARM 後，優先使用 arm64 版。
AFTER DOWNLOAD
完成安裝不代表已建立連線。用戶端還需要訂閱或分享連結、選擇伺服器，以及設定代理模式。
先核對下載檔案是否來自目前的平台標籤。Windows 選擇 x64 ZIP，macOS 依晶片選擇 DMG，Android 在 arm64 與通用 APK 之間選擇，Linux 則同時檢查發行版套件格式與處理器架構。若系統提示無法處理檔案類型，應先重新檢查平台或套件格式，而不是反覆執行同一個安裝檔。
Windows ZIP 需要先完整解壓縮；macOS 開啟 DMG 後依系統介面安裝；Android 開啟 APK 並依系統提示確認安裝來源；Linux 使用發行版對應的套件工具處理 deb 或 rpm。系統層級網路設定可能觸發權限確認，這是代理模式寫入網路設定時的正常系統流程。
啟動用戶端後，在訂閱群組中加入有效訂閱網址並執行更新，或從剪貼簿匯入 vmess://、vless:// 等單筆分享連結。訂閱用於維護一組可更新的伺服器項目，分享連結通常只描述一個項目。匯入後清單為空時，先手動更新訂閱，再檢查網址格式與網路存取狀態。
在伺服器清單中選擇目前的設定，再依需求啟用系統代理或 TUN 模式。系統代理主要影響遵循作業系統代理設定的應用程式；TUN 模式透過虛擬網路介面接管更廣泛的連線類型，通常需要額外的系統權限。首次使用建議先從系統代理開始，確認設定可正常載入後，再調整路由與 TUN。
DOWNLOAD FAQ
整理版本選擇、處理器架構、用戶端差異與首次啟動相關的簡要解答。
桌面版採用新一代跨平台介面，適合首次安裝及希望使用一致桌面體驗的使用者；WPF 版延續經典 Windows 介面與操作流程，適合熟悉舊版配置或需要經典工作流程的使用者。兩者皆使用 x64 安裝包，訂閱與伺服器設定的核心概念一致，但選單位置與介面編排有所不同。
開啟系統選單中的「關於這台 Mac」，查看晶片或處理器欄位。顯示 Apple M 系列晶片時選擇 Apple Silicon arm64 版本；顯示 Intel 處理器時選擇 Intel x64 版本。若選錯安裝包架構，常見情況是應用程式無法啟動或系統提示不相容。
2015 年後的主流 Android 手機通常優先選擇 arm64-v8a 安裝包，檔案更針對常見處理器架構。無法確認裝置架構、裝置較舊，或 arm64 包提示無法安裝時，再選擇 universal 通用版。通用版不是功能更多，而是涵蓋的處理器架構更廣。
v2rayNG 使用 Xray 核心，支援較廣泛的協定與傳輸選項，適合作為 Android 首選。v2flyNG 使用 V2Fly 核心，適合已有 V2Fly 設定或希望維持相應核心行為的使用者。選擇時應以訂閱參數、協定類型與所需傳輸功能為依據，不必在同一台裝置上長期同時執行兩個用戶端。
Debian、Ubuntu 及其衍生發行版選擇 deb；Fedora、RHEL、Rocky Linux、AlmaLinux 等採用 RPM 套件管理的發行版選擇 rpm。接著執行 uname -m 判斷架構：x86_64 對應 amd64 deb 或 x86_64 rpm，aarch64 對應 arm64 deb 或 aarch64 rpm。
用戶端安裝包只提供圖形介面與執行元件。首次啟動後仍需匯入有效訂閱或單筆分享連結、更新伺服器清單、選擇伺服器，並依需求啟用系統代理或 TUN 模式。若伺服器項目已匯入但仍未建立連線，應繼續檢查目前選取的項目、系統時間、代理模式與路由設定。