用戶端安裝檔 / 系統與架構
桌面平台選 v2rayN，Android 可先看 v2rayNG。
先確認作業系統，再選擇處理器架構與安裝格式。
下方按鈕可直接前往對應的安裝檔。免費圖形化用戶端用於管理設定與連線；安裝完成後，仍須匯入有權使用的訂閱或節點資訊。系統需求表可供選擇安裝檔時參考，實際執行條件會隨用戶端版本而異。
新一代跨平台 UI。初次安裝可優先選這個版本，桌面平台間的介面與操作方式較一致。
經典穩定版，採用 Windows WPF 介面。習慣原有選單配置或想沿用舊版操作流程時，可選這個版本。
兩個下載項目都是 v2rayN，並非兩種代理協定。選擇介面版本時，先考量使用習慣，再確認所需功能；系統代理、路由分流與訂閱管理的入口可能會隨介面更新而調整。請勿直接將既有設定覆蓋到另一版本的程式資料夾，先使用匯出或備份功能保存，再確認新版能否正確讀取。
前往「設定 → 系統 → 關於」查看系統類型，確認是否為 x64 環境。本頁提供的兩個 Windows 安裝檔皆為 x64，不能只憑電腦品牌判斷是否相容。系統位元數、處理器架構與應用程式執行環境是不同條件；舊版系統能執行某個舊版本，不代表也能執行目前的安裝檔。若安裝程式提示缺少執行元件，請依該版本的實際提示處理。
下載的檔案是 ZIP 壓縮檔。請先解壓縮至本機資料夾，再查看其中的安裝程式與說明，不要直接在壓縮軟體的預覽視窗中執行。升級前請結束系統匣中的舊用戶端；若舊執行個體仍在背景占用檔案，安裝可能無法完成。先保存原有設定再安裝，可避免誤把空白設定當成升級結果。
啟動後先匯入訂閱、更新清單並選取節點，再決定要啟用系統代理或 TUN 模式。一般啟動不代表所有程式都會經過用戶端；系統代理主要影響遵循系統代理設定的應用程式，TUN 則涉及虛擬網路介面與額外權限。初次測試時先採用一種接管方式，確認連線正常後再調整路由與 DNS，避免同時更動多項設定而難以找出問題。
| 檢查項目 | 本頁安裝檔 | 安裝前確認 |
|---|---|---|
| 處理器與系統 | x64 | 在系統類型中確認為 64 位元執行環境 |
| 檔案格式 | ZIP，內含安裝程式 | 下載完成後解壓縮，並依套件內說明安裝 |
| 系統與執行元件 | 依發行版本而定 | 依安裝程式提示確認相容性與相依項目 |
| 代理接管權限 | 系統代理 / TUN | 依提示授權 TUN，避免多個用戶端同時接管 |
適用於 Apple Silicon 晶片。若「關於這台 Mac」顯示 Apple M 系列晶片，請選這個項目。
適用於 Intel 處理器。「關於這台 Mac」的處理器資訊包含 Intel 時，請選這個項目。
兩種 DMG 的用途相同，差別在於程式適用的處理器架構。請勿依螢幕尺寸、購買年份或外觀選擇，也不必為了「通用」而優先執行另一種架構的安裝檔。使用原生架構最直接；若安裝後無法開啟或出現不相容提示，請先檢查晶片資訊與系統版本，而非反覆切換訂閱。
開啟系統選單中的「關於這台 Mac」，查看「晶片」或「處理器」欄位。顯示 Apple Silicon 的電腦選 arm64，顯示 Intel 的電腦選 x64。這會決定程式能否在本機執行，與訂閱使用 VMess、VLESS 或 Trojan 無關。用戶端的系統版本需求會隨版本更新，本頁不會將單一固定版本號視為後續所有安裝檔的相容保證。
開啟已下載的 DMG，依磁碟映像中的提示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。安裝完成後可退出磁碟映像，避免日後誤從映像中啟動舊副本。若系統顯示安全性提示，請在系統設定中確認原因與應用程式來源，再依系統提供的流程處理；不要為了開啟單一應用程式而全面關閉系統安全機制。
首次設定系統代理或 TUN 時，可能會出現相關權限要求。請先確認要求來自目前正在設定的用戶端，再依用途授權。若電腦上已有其他代理程式，請先暫停其接管功能。若瀏覽器可以連線、其他程式卻不行，通常需要檢查該應用程式是否遵循系統代理設定，換用另一種晶片架構的安裝檔並無法解決問題。
從 Windows 移轉時，可沿用相容的訂閱與節點資訊，但不應照搬本機路徑、開機啟動項目及網路介面設定。先還原節點清單，再檢查路由與 DNS；桌面系統專用的設定請逐項重新確認。完成連線測試後再啟用自動啟動，可避免未經驗證的設定在每次登入時執行。
| 檢查項目 | 對應選擇 | 確認方式 |
|---|---|---|
| Apple Silicon | arm64 DMG | 「關於這台 Mac」顯示 Apple M 系列晶片 |
| Intel | x64 DMG | 「關於這台 Mac」顯示 Intel 處理器 |
| 系統相容性 | 依發行版本確認 | 確認系統版本與應用程式啟動提示 |
| 安裝與授權 | 「應用程式」資料夾 | 依系統提示確認首次啟動與網路權限 |
2015 年後推出的主流手機通常可先選 arm64，但仍須確認系統具備相應的應用程式執行環境。
支援多種架構。若無法確認手機架構，或 arm64 安裝檔顯示不相容，可改試這個版本。
v2rayNG 是 Android 上用來管理節點、訂閱與路由設定的圖形化用戶端，採用 Xray 核心。若連線設定涉及 VLESS、REALITY 等功能，除了安裝用戶端，也須確認目前版本支援伺服器提供的具體組合。用戶端名稱、代理協定與傳輸安全層是不同概念，不要以為「安裝了 Xray 用戶端」就代表所有設定都能自動相容。
適用於需要 V2Fly 核心的設定與使用情境。架構選擇方式與上方用戶端相同。
不確定架構時可選的替代項目。通用套件不代表能支援另一種核心專屬的協定功能。
v2flyNG 採用 V2Fly 核心，適合確定需要此核心生態系的使用者。它與 v2rayNG 的介面操作可能相近，但不代表所有設定欄位都相同。移轉前請先確認協定、傳輸方式與安全設定；尤其不要直接匯入 Xray 專用功能的設定，然後將連線失敗歸咎於安裝檔架構。
下載 APK 後，系統可能會要求允許瀏覽器或檔案管理員安裝應用程式。只為目前使用的來源開啟此權限，安裝完成後可視需要關閉。若安裝程式顯示解析失敗，請先確認檔案已下載完成，再檢查系統版本與檔案是否適用於這台裝置。「儲存空間不足」、「與現有應用程式衝突」和「不支援此架構」是不同問題，請依提示分別處理。
同一用戶端從不同發布管道取得的安裝檔，可能使用不同簽章。若出現簽章衝突，請勿直接解除安裝舊應用程式：先匯出訂閱群組、手動新增的節點與個人設定，並確認找得到備份。解除安裝通常會移除應用程式資料；只記得訂閱網址，並不足以還原自訂路由、分應用程式清單等內容。
首次啟動連線時，Android 會顯示 VPN 授權畫面。VpnService 是系統提供的流量接管介面，不代表用戶端會自動產生伺服器資訊。授權後仍須具備有效節點與正確設定。系統通常只允許一個 VPN 服務處於啟用狀態；若其他應用程式已占用此介面，請先停止該服務，再測試目前的用戶端。
若鎖定螢幕後中斷連線，請先檢查電池最佳化、背景活動與自動啟動限制。可將目前使用的用戶端加入適當的背景執行允許清單，但不必替所有應用程式關閉省電策略。分應用程式代理也須另外確認：白名單通常代表只接管選取的應用程式，黑名單通常代表排除選取的應用程式，實際定義請以介面說明為準。清單方向選錯，會導致部分應用程式無法使用預期的出口。
| 檢查項目 | 建議選擇 | 注意事項 |
|---|---|---|
| 較新的主流手機 | 先選 arm64 | 晶片與系統都須支援相應的執行環境 |
| 不確定架構 | 通用版 | 仍受系統版本與應用程式相容性限制 |
| 核心需求 | v2rayNG / v2flyNG | 分別確認 Xray 與 V2Fly 的功能範圍 |
| 執行權限 | VPN 授權、背景活動 | 安裝授權與連線授權是兩個不同步驟 |
適用於使用 deb 套件管理方式的桌面發行版，例如 Debian、Ubuntu 系列。
適用於使用 rpm 套件管理方式的桌面發行版。也須確認發行版版本與相依項目是否相容。
Linux 選擇安裝檔時，套件格式與架構都必須正確。檔名中的 amd64、x86_64 通常對應 x64，arm64、aarch64 則對應 ARM64。deb 與 rpm 不是介面版本差異，也不能只改副檔名就互換使用。此處的 v2rayN 適用於桌面環境；伺服器或路由設備的部署方式，請參閱協定詳解與相關技術文章。
先在系統資訊中確認發行版與處理器架構，再查看系統使用的軟體安裝程式或套件管理工具。Debian、Ubuntu 系列通常選擇 deb；採用 rpm 管理的發行版則選 rpm，但即使同為 rpm 格式，也不保證能跨發行版相容。本頁 rpm 檔名包含目標發行版資訊，安裝前請特別留意系統函式庫與套件相依需求；套件格式相同不代表已確認相容。
可使用發行版提供的圖形化軟體安裝程式開啟下載的套件，並查看相依項目、安裝位置與錯誤訊息。若顯示缺少相依項目，請先確認套件是否適用於目前的系統版本，而非強制忽略所有相依需求。安裝成功後，從應用程式選單啟動 v2rayN；僅完成套件安裝，還無法確認系統代理與 TUN 是否正常運作。
不同桌面環境讀取系統代理設定的方式可能不同，有些應用程式只讀取自己的代理設定。若部分程式可以連線、部分卻不行，請先分辨是「用戶端連線失敗」還是「應用程式未被接管」。TUN 涉及網路介面、路由與權限，請依用戶端提示操作；不建議為了省略一次授權，就長期以高權限執行整個圖形化用戶端。
升級時先保存目前設定並結束舊程序，再使用相同的套件管理方式安裝新版。混用多種安裝來源，容易導致應用程式選單仍指向舊副本，或誤將不同設定資料夾視為同一份資料。升級完成後，先查看實際啟動的應用程式資訊並測試一個節點，再恢復開機啟動與其他自動化設定。
| 檢查項目 | 對應項目 | 安裝前確認 |
|---|---|---|
| x64 桌面 | amd64 deb / x86_64 rpm | 確認套件格式與發行版相依項目 |
| ARM64 桌面 | arm64 deb / aarch64 rpm | 確認執行的是 64 位元 ARM 系統 |
| 圖形環境 | 桌面工作階段 | 具備應用程式執行所需的圖形元件 |
| 代理與 TUN | 依用戶端設定啟用 | 確認應用程式接管方式與網路權限 |
安裝階段請檢查系統相容性、架構、相依項目與權限。若應用程式無法啟動，先處理這些基本條件；反覆更換節點無法解決程式執行問題。用戶端成功開啟後，再檢查匯入訂閱、選取節點與網路接管，分階段測試更容易找出原因。
訂閱網址與節點資訊可能包含個人憑證，請勿公開貼在截圖或問答中。匯入後確認協定、傳輸方式與安全設定，不要只憑節點名稱判斷是否相容。若連線發生錯誤，請記錄已去識別化的錯誤訊息，並查看常見問題中的相關說明。