用戶端安裝檔／平台與架構
桌面端選 v2rayN，Android 優先選 v2rayNG。先選作業系統，再確認晶片架構；安裝完成後，還需要匯入有效的訂閱或伺服器設定。
選擇作業系統
比起檔案大小，應先確認檔名中的架構。
Windows 桌面用戶端 · x64
兩個版本擇一即可，不必同時安裝。Desktop 採用新一代跨平台介面，適合希望在不同桌面系統間維持相近操作體驗的使用者；WPF 是 Windows 上的經典介面分支，適合熟悉原有選單與設定流程的人。兩個版本的設定入口、介面配置及執行環境需求可能不同，不應只憑壓縮檔大小判斷哪個版本較適合。
下載後，請將整個壓縮檔解壓縮至有寫入權限的固定目錄，再從解壓縮後的目錄啟動程式。請勿直接在壓縮軟體的預覽視窗中執行，也不要只取出單一執行檔。若系統提示缺少執行環境，請依提示確認元件名稱、位元數與對應版本，安裝所需元件後再啟動；重複下載相同壓縮檔通常無法解決執行環境缺漏。
準備從 WPF 切換到 Desktop 時，先在舊用戶端匯出設定，並另行保存自訂路由。將新程式放在不同目錄，完成匯入及連線測試後，再處理舊目錄。移轉時請特別檢查本機監聽連接埠、訂閱分組及路由模式，不要假設所有介面選項都能一一對應。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 系統與架構 | 本頁提供 Windows x64 安裝檔；請在「設定 → 系統 → 系統資訊」確認系統類型。其他架構的裝置需先確認相容的執行條件。 |
| 執行環境 | 系統最低需求與所需執行階段程式庫會隨發行版本變動，請以安裝檔隨附說明及啟動提示為準；Desktop 與 WPF 的執行環境需求應分開確認。 |
| 目錄與權限 | 請完整解壓縮至可寫入的目錄。一般匯入設定與使用系統代理通常不必長期以管理員身分執行；TUN 等功能則依權限提示處理。 |
啟動後先匯入訂閱、選擇伺服器，再設定系統代理並用瀏覽器測試。能開啟主視窗只代表程式已啟動，不代表所有應用程式都已使用代理。瀏覽器與終端機使用的代理路徑不同，命令列程式可能還需要另外設定環境變數。詳細操作請參閱快速入門教學。
macOS 桌面用戶端 · DMG
先確認晶片名稱，再下載相符的安裝檔。開啟系統的「關於這台 Mac」，若顯示 Apple M 系列晶片，請選 arm64；若顯示 Intel 處理器，請選 x64。不要只依購買年份推斷架構，同一年份也可能有不同晶片的機型。選擇原生架構可減少額外的相容處理，兩個 DMG 不是可以任意互換的同一個檔案。
開啟 DMG 後，依視窗中的指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。請避免長期直接從已掛載的磁碟映像執行，以免卸載映像後找不到程式。若遇到系統安全性提示，請先閱讀提示內容，確認應用程式來源與檔案類型，再依系統提供的安全性設定流程處理；不建議為了單次安裝而全面關閉系統保護。
初次使用時，先測試一般系統代理，再視需要設定 TUN。兩種流量接管方式涉及不同的權限與網路路徑，建議瀏覽器連線正常後再擴大接管範圍，較容易找出問題。若已安裝其他網路代理或流量過濾工具，請先確認它們是否也會修改系統代理，避免關閉其中一個程式後，其他程式仍留下舊的代理連接埠。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 晶片架構 | Apple M 系列選 arm64，Intel 處理器選 x64；請以「關於這台 Mac」顯示的晶片資訊為準。 |
| 系統相容性 | 最低系統需求請以目前發行版本的說明為準。舊版系統無法啟動時，先確認系統相容範圍，而不是改用另一種晶片架構。 |
| 安裝與權限 | 將應用程式複製到「應用程式」資料夾後再啟動；使用系統代理或接管網路時，依實際出現的系統權限提示操作。 |
從其他桌面系統移轉設定時，建議優先使用用戶端提供的匯入與匯出功能。若設定包含本機檔案路徑、外部規則位置或自訂指令碼，需重新確認對應檔案是否存在。訂閱匯入成功，不代表與系統相關的路徑也已一併移轉。
Android 用戶端 · Xray 核心
初次安裝 Android 用戶端可先選 v2rayNG。此版本使用 Xray 核心，實際支援的通訊協定、傳輸方式與參數，取決於所用的用戶端及核心版本。若訂閱包含 REALITY 或特定 flow 欄位，請先確認用戶端能否辨識相關參數；安裝成功不等於設定相容，不能只看訂閱是否出現在清單中。
下載 APK 後，從瀏覽器下載紀錄或檔案管理員開啟。若系統要求允許從目前來源安裝應用程式，請只授權正在使用的瀏覽器或檔案管理員；安裝完成後可撤銷權限。初次連線通常會出現系統 VPN 授權對話框，確認應用程式名稱後再授權；若同時執行其他 VPN 應用程式，可能發生接管衝突。
Android 備選用戶端 · v2fly 核心
v2flyNG 適合需要 v2fly 核心設定的使用者，不能視為 v2rayNG 的完全替代品。兩者的操作介面有相似之處，但核心功能範圍不同。移轉前先確認節點使用的通訊協定、傳輸方式及安全性參數；若原設定仰賴另一個核心的專屬功能，切換用戶端不會自動轉換這些欄位。
測試備選用戶端時，先停止原用戶端的連線，再於新用戶端匯入設定。如此可分辨節點本身的問題與 VPN 接管衝突。訂閱連結應透過可信任的管道傳送，請勿將完整連結、QR Code 或匯出的連線參數貼到公開討論區。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 處理器與系統 | 主流裝置通常選 arm64；部分裝置使用 32 位元系統，即使晶片為 64 位元，也應確認應用程式架構支援情況。若架構不明，可嘗試通用版。 |
| 安裝條件 | 請預留足夠的儲存空間，並依系統提示授予目前來源的安裝權限；最低 Android 版本需求以目前應用程式的發行說明及安裝程式提示為準。 |
| 連線與背景執行 | 連線需要系統 VPN 授權。若鎖定螢幕後連線中斷，請檢查電池最佳化及背景執行限制，不要直接判定為節點失效。 |
覆蓋升級時若提示無法安裝，請先判斷是系統版本、架構還是簽章來源造成的問題。不同簽章的安裝檔無法直接覆蓋同一應用程式，貿然解除安裝可能會刪除現有設定。請先在舊版應用程式中匯出必要資料，再決定移轉方式。安裝程式提示不相容時，也不要反覆修改副檔名嘗試安裝。
Linux 圖形化用戶端 · deb / rpm
Linux 安裝時需同時確認套件格式與處理器架構。Debian、Ubuntu 系通常使用 deb，Fedora、RHEL 系通常使用 rpm，但套件格式相同不代表所有發行版版本都相容。請先確認系統資訊中的發行版與架構，再用系統的軟體安裝程式開啟下載檔案，閱讀相依套件與相容性提示後再安裝。
x64 也常標示為 amd64 或 x86_64，arm64 也常標示為 aarch64。兩者屬於不同的處理器架構，不能只靠修改檔名互相轉換。若軟體安裝程式提示相依套件版本不足，請確認目前的發行版是否符合安裝檔需求；不要為了安裝圖形化用戶端而強制覆寫系統基礎元件。
安裝完成後，從桌面應用程式選單啟動 v2rayN。系統代理是否會被應用程式採用，取決於桌面環境與應用程式本身；瀏覽器、終端機及背景服務可能使用不同的代理設定來源。先用明確支援代理的應用程式測試，再排查其他程式。若需要 TUN，也要確認權限、路由與既有網路管理工具之間的設定。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 套件管理系統 | 依發行版選擇 deb 或 rpm；套件管理員能辨識檔案，不代表相依套件一定符合需求，仍須閱讀安裝提示。 |
| 裝置架構 | 一般桌上型電腦選 x64；arm64 裝置請選擇對應的小字入口，勿混用不同架構的安裝檔。 |
| 桌面環境與權限 | 需要可用的圖形化桌面及相應執行相依套件；一般使用與接管網路所需的權限應分開處理。 |
移轉既有設定時，請特別檢查路徑的大小寫及檔案存取權限。其他系統的目錄路徑不能直接沿用為 Linux 路徑。修改路由或 DNS 後，應讓用戶端重新載入設定，再觀察實際連線狀況；只儲存文字檔不一定會讓執行中的核心立即套用新設定。
下載與安裝問答
還需要有效的伺服器設定或訂閱連結。用戶端負責匯入設定、啟動核心及設定本機代理，不會自動提供伺服器帳號。匯入後選擇伺服器，再視需要啟用系統代理或 Android VPN 連線；初次使用建議先閱讀快速入門指南。
初次安裝可先選桌面版 Desktop，採用新一代跨平台介面；熟悉經典 Windows 介面的使用者則可選 WPF 版。兩者介面與執行環境需求不同，不建議共用程式目錄。切換前先匯出設定，並在獨立目錄完成匯入與連線測試。
2015 年後的主流手機通常可優先選 arm64，但仍應以裝置實際支援的應用程式架構為準。若系統較舊、架構不明或提示安裝檔不相容，可改選通用版。通用版包含多種架構，檔案通常較大，但不代表功能更多。
先在原用戶端匯出設定並保存自訂路由，再關閉程式後升級。桌面版先不要刪除原資料目錄；Android 同一款應用程式通常可直接覆蓋安裝，但簽章來源不同可能導致安裝失敗。不要直接解除安裝後重裝，應先確認備份可正常使用。
先查看瀏覽器的下載紀錄，確認是否正在詢問儲存位置、權限或可用空間。下載中斷時，可重新點選對應的安裝檔入口，必要時改用穩定的網路。頁面入口已包含檔案網址，即使版本資訊尚未更新，仍可嘗試下載。
無法啟動時，先檢查安裝檔的系統與架構是否符合需求、是否完整解壓縮，以及執行環境提示；若能啟動但無法連線，再檢查訂閱是否有效、本機時間、連接埠占用情況及核心記錄。兩類問題應分開排查，不要只因連線失敗就反覆更換安裝檔。