客戶端安裝包 / 平台與架構
桌面版選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器，再選擇安裝包。
三款客戶端皆為免費開源軟體。安裝包用於安裝圖形客戶端，連線前仍需準備有效訂閱或伺服器參數。已有設定的使用者，升級前請先備份設定。
第一次安裝？查看圖形客戶端設定教學 →同一款客戶端，提供兩種介面分支。以下安裝包適用於 x64 系統。
桌面版 Desktop採用新一代跨平台 UI，適合初次安裝，或希望在不同桌面系統上使用相近操作方式的使用者。經典 WPF 版是保留 Windows 經典介面的穩定分支，適合熟悉原有選單與設定位置的使用者。介面分支不同，不代表節點品質或協定速度有別。
上述下載檔案為 ZIP 壓縮包。下載完成後請先完整解壓縮，再開啟其中的安裝程式；不要直接從壓縮軟體的預覽視窗執行。若安裝時提示缺少執行元件，請先查看提示中的元件名稱、架構與所需版本，再依系統說明補齊；不要反覆更換訂閱來處理安裝錯誤。
準備切換介面分支時，請先匯出訂閱與自訂路由，關閉正在執行的舊客戶端，再開啟新版本檢查設定。若兩個執行個體使用相同的本機連接埠，後啟動的執行個體可能會發生監聽失敗。安裝完成後，再依教學啟用系統代理，並選擇符合目前使用情境的路由模式。
先查看「關於這台 Mac」中的晶片或處理器資訊，再選擇 DMG 安裝包。
Apple Silicon 請選 arm64，Intel 處理器請選 x64。開啟 Apple 選單中的「關於這台 Mac」；若顯示 Apple M 系列晶片，請選第一個下載項目；若處理器欄標示 Intel，請選第二個。系統版本與晶片架構是兩回事，更新系統不會讓 Intel 裝置變成 arm64 裝置。
下載 DMG 後開啟磁碟映像，依照其中的安裝指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。首次執行若出現系統安全提示，請先確認檔案來源與提示內容，再透過系統提供的安全性設定處理。不要只為略過單一提示，就關閉整套系統安全機制。
從其他桌面系統移轉時，可優先轉移訂閱網址，再逐項還原路由與 DNS 設定。檔案路徑、權限與系統代理介面並不完全相同，不建議直接覆寫整個舊設定目錄。連線前請確認客戶端已啟動核心，再於客戶端啟用所需的系統代理方式；測試結束後，也請留意結束程式時是否正確還原代理設定。
優先選擇 v2rayNG。需要相容 v2fly 核心環境時，再考慮 v2flyNG。
v2rayNG 是採用 Xray 核心的 Android 圖形客戶端。2015 年後的主流手機通常可先選 arm64，但實際仍須視處理器與系統提供的應用程式執行架構而定；部分入門裝置即使處理器支援 64 位元，系統也可能只提供 32 位元應用程式環境。無法確認時可選通用版，支援的架構較多，檔案通常也較大。
開啟 APK 後，系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝應用程式。請只依目前的安裝流程授予權限，不要任意放寬其他來源的權限。首次建立連線時，Android 會顯示 VPN 連線授權提示；這是客戶端透過本機 VPN 介面處理流量所需的系統步驟，請閱讀後再確認。
安裝完成後，請匯入訂閱、更新設定並選擇一台伺服器，再啟動連線。手機狀態列出現 VPN 圖示，只能表示本機介面已建立，仍須開啟目標應用程式確認是否能實際連線。若連線一段時間後中斷，可檢查電池最佳化與背景執行限制，不要先刪除所有設定。
v2flyNG 採用 v2fly 核心，適合做為現有 V2Fly 設定環境的替代選項。它與 v2rayNG 名稱相近，但並不是同一款應用程式的兩種外觀主題。核心支援的協定、傳輸方式與設定欄位可能不同，尤其不能將為 Xray 擴充功能設計的設定直接視為通用設定。
若訂閱服務提供者明確要求特定核心功能，請先確認協定需求，再選擇客戶端。更換應用程式時，建議重新匯入訂閱，不要直接複製另一款應用程式的所有內部資料。比較兩款客戶端時，請先停止其中一款的 VPN 連線，避免系統切換連線而影響排查結果。
先依發行版選擇 deb 或 rpm，再確認 x64 或 arm64。
Debian、Ubuntu 系列發行版通常選擇 deb；採用 RPM 套件管理系統的發行版則選擇 rpm，但套件格式相符不代表所有發行版都相容。系統仍須符合目前套件的系統程式庫與相依性需求。尤其是 RPM 套件，安裝前請查看軟體安裝程式提供的發行環境與相依性提示，不建議強制忽略相依性。
常見的 Intel、AMD 桌上型電腦通常選擇 x64，對應套件名稱中的 amd64 或 x86_64；ARM 64 位元桌面裝置則選擇 arm64，對應套件名稱中的 arm64 或 aarch64。amd64 是架構名稱，不代表只能在 AMD 品牌處理器上執行。可在系統的「關於」或硬體資訊中確認，不要只憑發行版名稱猜測處理器類型。
下載後使用系統的圖形軟體安裝程式開啟套件，查看相依性資訊並完成安裝。這些下載項目適用於具有圖形桌面環境的裝置，不應將桌面應用程式套件當作路由器或純命令列伺服器的部署方案。首次啟動後先匯入設定，確認本機監聽正常，再設定系統或應用程式代理。
不同桌面環境對系統代理的支援並不完全相同。若瀏覽器連線正常，但另一款應用程式仍直接連線，請檢查該應用程式是否讀取桌面代理設定。需要個別指定本機代理位址時，請依客戶端目前顯示的監聽位址、連接埠與協定填寫；不要將 SOCKS 連接埠當成 HTTP 連接埠使用。
準備完整的訂閱網址，在客戶端新增訂閱群組並執行更新。如果取得的是單一連線分享網址，請使用對應的匯入功能，不要填入訂閱更新網址欄位。匯入後先確認是否顯示伺服器設定，再選擇其中一項啟動。訂閱網址通常包含存取憑證，排查問題時只提供錯誤訊息，不要公開完整網址。
客戶端主視窗開啟，只能表示圖形介面正在執行。接著確認核心已啟動且本機監聽正常，再檢查系統代理或 Android VPN 是否啟用，最後確認路由模式。每次只調整一項設定，調整後立即驗證。同時變更核心、DNS 與路由，會讓問題來源難以判斷。
已在使用客戶端的使用者，請先記錄目前的分支、訂閱群組與自訂規則，再使用應用程式提供的匯出功能儲存設定。跨客戶端移轉時，訂閱網址通常比完整內部設定更容易轉移，但仍須確認目標核心支援相關協定。設定中的本機路徑、監聽連接埠與權限，須依新系統重新檢查。
選單操作詳見客戶端安裝與設定教學；若不熟悉協定或核心名稱，可先查看術語手冊，再透過協定與核心技術參考確認相容性。安裝階段與連線階段的錯誤應分別記錄。
你需要有效的訂閱網址或伺服器連線參數。客戶端負責匯入設定、選擇路由並建立連線，安裝包本身不附可用節點。請先確認訂閱來源與使用權限，再依教學匯入；不要將訂閱網址貼到公開頁面。
首次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。習慣 Windows 原有介面與操作方式的使用者，可選經典 WPF 穩定版。兩者是不同介面分支，並非連線速度等級；切換前請先匯出設定，避免同時啟動而搶用本機監聽連接埠。
2015 年後的主流手機通常可先選 arm64，但較舊裝置或僅提供 32 位元應用程式環境的系統可能不相容。可先查看裝置處理器與系統架構；無法確認或出現架構不相容提示時，再選通用版。通用版支援更多架構，安裝包通常也較大。
卡片上的版本資訊取自清單的 latest 欄位，下載按鈕則使用各平台對應的檔案網址，兩者是獨立欄位，更新時間可能不同。檔名不作為統一改寫版本的依據。安裝或升級時，請以實際安裝畫面及客戶端「關於」頁面顯示的資訊確認已安裝版本。
同一客戶端、同一分支的覆蓋更新通常會沿用原有使用者資料，但跨分支、跨核心或更換設定目錄時，不應直接假設相容。更新前請透過客戶端匯出設定或備份使用者資料，並先結束舊程序再安裝；首次啟動後檢查訂閱群組、路由模式與本機連接埠。
先確認檔案已下載完成、處理器架構相符，且系統符合該發行套件的執行需求。Windows 的 ZIP 檔請先完整解壓縮；macOS 請檢查晶片類型與系統安全提示；Android 請查看安裝權限及現有應用程式的簽章提示；Linux 請檢查套件格式與相依性錯誤。保留系統錯誤訊息原文，再依教學排查。