v2rayN
優先推薦 7.24.1不必為了支援更多協定而同時安裝兩個版本。介面類型與核心設定是不同概念，實際功能請以目前客戶端的設定為準。
客戶端安裝包／作業系統與架構
V2Ray 客戶端下載
v2rayN 桌面版、v2rayNG Android 版。先選作業系統，再選對應的安裝包。
三款客戶端皆為免費開源軟體。下載後仍須匯入有效訂閱或伺服器設定；安裝包、訂閱網址與代理模式是三個不同步驟。
Windows 版 v2rayN
提供兩個 x64 下載項目，請依介面使用習慣選擇。安裝與匯入訂閱的基本步驟相同。
下載後依序操作
先前往「設定 → 系統 → 系統資訊」確認系統類型。這兩個下載項目皆適用於 x64 Windows，不能將 x64 安裝包當成 ARM 原生版。下載完成後，將 ZIP 檔完整解壓縮至一般使用者具備讀寫權限的資料夾，再執行其中的安裝程式；請勿直接從壓縮軟體的預覽視窗啟動。
安裝完成後，開啟「訂閱群組設定」，為訂閱來源命名並填入網址，儲存後執行更新訂閱。伺服器出現在清單後，選擇要使用的項目，再從底部的系統代理選單選取「自動設定系統代理」。若只有瀏覽器需要代理，可先用這種方式測試，不必一開始就啟用 TUN。
更新或切換 WPF 與桌面版前，請先備份訂閱、路由規則及自訂設定，並完全結束舊程序。不要讓兩個執行個體同時接管系統代理，或監聽相同連接埠。若啟動時提示缺少執行環境，請依錯誤訊息列出的環境名稱與架構處理；不要只憑客戶端名稱猜測需要安裝哪些元件。
查看 Windows 安裝流程與介面選擇 →系統與安裝需求
| 檢查項目 | 選擇依據 |
|---|---|
| 處理器 | x64；請在系統資訊中確認系統類型。 |
| 系統相容性 | 請以目前安裝程式的提示為準；不保證相容於舊版系統。 |
| 安裝資料夾 | 完整解壓縮並保留隨附檔案，確認設定資料夾可寫入。 |
| 執行環境 | 若提示缺少元件，請確認所需執行環境及位元數。 |
| 權限 | 一般代理與 TUN 所需權限不同；TUN 通常需要提升權限。 |
macOS 版 v2rayN
先開啟「關於這台 Mac」，依晶片資訊選擇 DMG。
v2rayN
7.24.1請依晶片型號判斷，不要以電腦外觀或購買年份推測。Apple Silicon 裝置建議優先使用對應的原生架構安裝包。
從磁碟映像檔安裝
下載 DMG 後按兩下掛載，將應用程式移至「應用程式」資料夾，再從該資料夾啟動。請勿長期直接從掛載的映像檔執行，否則退出映像檔或重新啟動後，可能找不到原本的啟動位置。若系統提示無法開啟應用程式，請先確認完整提示、下載來源與晶片架構，再到系統設定查看與此次啟動相關的安全性提示。
首次執行後，先建立訂閱群組並更新訂閱，確認伺服器清單不是空的。系統代理主要影響遵循系統代理設定的應用程式；有些程式自行設定網路，未必會隨系統代理變更。遇到這種情況，請先檢查應用程式本身的代理選項，再評估是否需要 TUN；不要反覆重新安裝來取代網路範圍的檢查。
啟用 TUN 時可能需要系統授權或輔助元件權限，依目前版本的提示完成設定即可。升級前請先結束正在執行的客戶端，避免舊程序在背景占用連接埠。覆蓋應用程式檔案不代表會清除使用者設定，但仍建議預先匯出重要設定，尤其是手動新增的路由規則與自訂 DNS 設定。
查看 macOS 安裝與權限說明 →系統與安裝需求
| 檢查項目 | 選擇依據 |
|---|---|
| 晶片類型 | Apple M 系列選 arm64；Intel 選 x64。 |
| 系統相容性 | 請以目前應用程式的系統需求及啟動提示為準。 |
| 安裝位置 | 將應用程式移至「應用程式」資料夾後再啟動。 |
| 首次授權 | 請閱讀系統安全性提示，確認應用程式來源及要求的權限。 |
| 網路模式 | 先測試系統代理；視需求授權 TUN，避免同時使用多個網路接管工具。 |
Android 客戶端
建議優先選擇 v2rayNG；若要沿用 V2Fly 設定，再考慮 v2flyNG。
v2rayNG
優先推薦 Xray 核心 2.2.6版本資訊與安裝包路徑分別更新；檔名中的數字可能暫時與版本資訊不同，請勿自行修改下載網址。
v2flyNG
替代選項 · V2Fly 核心 1.10.31安裝、訂閱與 VPN 授權
從瀏覽器或檔案管理員開啟 APK 時，Android 可能會要求允許該來源安裝應用程式。請只授權目前使用的來源，安裝完成後可在系統設定中撤銷此權限。若出現解析錯誤，請先檢查檔案是否下載完成，以及系統版本與架構是否相容；不要反覆安裝同一個未下載完整的檔案。
開啟 v2rayNG 後，進入「訂閱群組設定」，輸入有效網址並儲存，再返回主畫面更新訂閱。成功匯入不代表已連線，還須選擇伺服器並啟動服務。首次啟動時會出現 Android VPN 連線授權提示，確認後客戶端才能建立本機流量接管介面；這項授權本身不會建立伺服器或訂閱。
使用「依應用程式設定代理」前，請先確認目前設定是代理所選應用程式，還是略過所選應用程式，兩種方向不可混用。系統中的其他 VPN 工具也可能占用相同連線位置，排查時請先停止這些工具。若背景連線容易中斷，再檢查電池最佳化、背景執行限制與省電模式，不必一開始就更換安裝包。
v2rayNG 與 v2flyNG 是不同客戶端，不能假設所有協定與安全性參數都能互換。尤其使用 VLESS 或 REALITY 時，請先確認核心支援情況，再考慮移轉設定。切換前請保留原有訂閱與手動設定，分開測試，避免同時執行而難以判斷問題。
查看 v2rayNG 訂閱匯入步驟 →系統與安裝需求
| 檢查項目 | 選擇依據 |
|---|---|
| 應用程式架構 | 若支援 64 位元應用程式，優先選 arm64；不確定時可考慮通用版。 |
| 系統相容性 | 請以目前 APK 的最低系統需求與安裝提示為準。 |
| 安裝權限 | 視需要允許瀏覽器或檔案管理員安裝應用程式。 |
| 連線權限 | 啟動服務時，請確認已授予系統 VPN 權限。 |
| 覆蓋安裝 | 即使應用程式名稱相同，簽章仍須相容；解除安裝前請先備份設定。 |
Linux 版 v2rayN
先確認發行版採用的套件格式，再選擇 x64 或 arm64。
v2rayN
7.24.1amd64 與 x86_64 都是常見的 x64 標記；arm64 與 aarch64 則對應 ARM 64 位元。請勿只依副檔名判斷是否相容。
使用發行版安裝程式處理相依套件
請在系統的「關於」頁面查看發行版與處理器資訊。採用 deb 套件體系的系統請選 deb，採用 rpm 體系的系統請選 rpm；但套件格式相同，不代表所有發行版版本都能安裝。仍須符合目前套件對圖形元件、系統程式庫與桌面環境的需求，請以安裝程式提供的詳細資訊為準。
下載後，使用發行版的軟體安裝程式開啟檔案，讓套件管理員檢查相依套件。若提示缺少程式庫或版本衝突，請先記下完整訊息，再依發行版版本處理；不要更改副檔名，也不要強制略過相依性檢查。此處提供的是圖形介面客戶端，需要可用的桌面工作階段，並非供純命令列環境使用的伺服器程式。
首次啟動後，先匯入訂閱並測試一般代理。Linux 桌面環境支援系統代理的方式可能不同：有些應用程式會讀取自身設定，有些則讀取環境變數，不能只因某個程式可以連線，就判定所有流量都已接管。若需要 TUN，請依客戶端提示設定權限，避免為了方便而長期以管理員身分執行整個圖形介面。
升級時建議沿用原本的套件管理方式，先結束舊客戶端，再安裝新套件。解除安裝軟體與刪除使用者設定是兩回事，操作前請確認套件管理員與客戶端各自會保留哪些資料。若訂閱、路由或 DNS 有自訂內容，請先匯出或備份。
查看 Linux 安裝與權限說明 →系統與安裝需求
| 檢查項目 | 選擇依據 |
|---|---|
| 套件管理體系 | 依發行版選擇 deb 或 rpm，請勿透過更改副檔名轉換格式。 |
| 處理器架構 | x64 對應 amd64、x86_64；arm64 對應 aarch64。 |
| 桌面環境 | 需要圖形桌面工作階段及可用的相關系統元件。 |
| 相依性相容 | 由套件管理員檢查系統程式庫與版本需求。 |
| 網路權限 | 先測試一般代理；TUN 權限請依提示另行設定。 |
安裝後：訂閱與代理模式
安裝完成後只是備妥圖形介面客戶端。接著請匯入可信來源的訂閱網址，儲存群組並更新訂閱；若清單仍是空的，請先檢查網址是否完整、訂閱是否過期，以及群組篩選條件是否隱藏項目。請勿將訂閱網址貼到公開討論區，因為其中可能包含存取憑證。截圖求助時也請遮蔽訂閱、伺服器密碼與個人識別資訊。
清單出現內容後，選擇一筆設定再啟動連線。桌面版可先試用「自動設定系統代理」，Android 版則須先授予系統 VPN 權限。系統代理、TUN 與依應用程式設定代理，控制的是哪些流量會進入客戶端；路由規則則決定流量進入後如何分流，兩者不能互相取代。遇到連線問題時，依序檢查「訂閱是否更新 → 是否選取伺服器 → 服務是否啟動 → 應用程式是否使用代理」，通常比反覆重新安裝更容易找出原因。
若要手動填寫 VLESS、REALITY 或其他參數，請逐項核對伺服器端提供的設定，尤其是位址、連接埠、傳輸方式、SNI 與相關金鑰欄位。遇到憑證錯誤，請先檢查系統時間與網域，不要直接略過驗證。安裝與連線是兩個不同問題：客戶端能開啟卻無法連線時，可前往連線疑難排解；初次設定時，請依照訂閱匯入與首次連線教學逐步操作。
安裝包常見問題
Windows 桌面版和經典 WPF 版該怎麼選？
首次安裝可先選桌面版，採用新一代跨平台介面；習慣經典 Windows 操作方式的使用者可選 WPF 版。兩個下載項目皆為 x64 安裝包。切換介面前請先備份設定，也不要讓兩個客戶端同時接管系統代理。
Android 該選 arm64 還是通用版？
2015 年後推出的主流手機通常可優先選 arm64，但仍須確認系統支援 64 位元應用程式。若無法確認架構，或 arm64 安裝包因架構不符而無法安裝，可改試通用版。通用版包含多種架構，不代表支援所有舊版系統。
下載客戶端後就會自動取得伺服器嗎？
客戶端安裝包不含可直接使用的伺服器設定。安裝後須匯入自行準備的有效訂閱網址或單筆設定，再更新訂閱、選擇伺服器並啟用相應的代理模式。請妥善保管訂閱網址，避免外流。
升級安裝前需要先解除安裝舊版嗎？
請勿先解除安裝。先備份訂閱群組、路由規則及自訂設定，並完全結束舊客戶端，再依相同客戶端的安裝方式升級。若更換安裝來源、簽章或客戶端類型，不能假設可直接覆蓋安裝；確認設定可以還原後，再處理舊版。
安裝包無法開啟或顯示不相容時，該先檢查什麼？
先確認檔案已下載完成，再檢查作業系統、處理器架構與安裝包格式。Windows 的 ZIP 檔須先解壓縮；macOS 須區分 Apple Silicon 與 Intel；Linux 須區分 deb 與 rpm。請記下完整錯誤訊息，不要直接關閉系統防護，也不要執行來源不明的修復指令。
為什麼版本資訊和安裝包檔名中的數字不一樣？
客戶端版本資訊與各架構安裝包路徑是分別維護的欄位，更新時可能暫時不同步。選擇前請確認客戶端名稱、作業系統與架構；不要依顯示的數字自行改寫下載網址。若不確定升級相容性，請先保留現有設定備份。