桌面平台建議選 v2rayN，Android 建議優先選 v2rayNG。
先確認作業系統與處理器架構，再挑選安裝檔。
同一款 v2rayN，提供兩種介面。初次安裝建議選 Desktop；想沿用經典操作方式則選 WPF。
請將壓縮檔完整解壓縮至可寫入的本機資料夾，再查看其中的安裝或啟動程式。請勿直接從壓縮軟體的預覽視窗執行，也不要只解出單一程式檔；同一資料夾中的相依檔案可能是啟動所必需的。若安裝時提示缺少執行環境，請先確認提示中的名稱與架構，再依需求安裝。
Desktop 與 WPF 是介面選擇，與訂閱類型無關。將現有設定移轉至另一種介面前，請先匯出備份。測試新介面時先退出舊程式，避免兩個客戶端同時修改系統代理。結束連線後，請透過客戶端清除系統代理再關閉程式，以免下次啟動瀏覽器時因殘留代理設定而無法上網。
| 項目 | 安裝前確認事項 |
|---|---|
| 處理器架構 | 本頁提供的兩個下載入口皆為 x64。請在系統「關於」頁面查看系統類型，勿將 x64 安裝檔當成其他架構的原生安裝檔。 |
| 系統與執行環境 | 請使用受支援且已更新的 Windows；最低系統版本與執行環境需求，請以安裝檔的提示為準。 |
| 資料夾與權限 | 解壓縮資料夾必須可寫入。系統代理與網路權限可能受裝置政策限制；一般啟動不必預設授予管理員權限。 |
若視窗一閃即逝，請先確認檔案是否完整解壓縮、執行環境是否相符，再查看記錄。若是連接埠遭其他程式占用，反覆重新下載通常無法解決。
開啟系統選單中的「關於這台 Mac」，依「晶片」或「處理器」資訊選擇對應架構。
適用於「關於這台 Mac」顯示 Apple M 系列晶片的裝置，請選擇 ARM64 原生安裝檔。
下載v2rayN · Apple SiliconDMG 磁碟映像檔 · ARM64
開啟磁碟映像檔後，依視窗中的指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。請勿長期直接從掛載的映像檔執行，以免卸載後無法使用。首次啟動若出現系統安全提示，請先確認檔案來源與提示內容，再到系統設定查看原因；不要直接停用系統安全機制。
若啟用連線後只有部分應用程式能上網，請先確認這些程式是否遵循系統代理。一般系統代理與接管裝置流量的模式並不相同，後者可能需要額外權限。建議先使用一般代理確認基本連線正常，再依需求處理進階網路權限，減少初次安裝時需要排查的因素。
| 項目 | 安裝前確認事項 |
|---|---|
| 晶片架構 | Apple M 系列請選 ARM64，Intel 處理器請選 x64。建議使用符合裝置架構的原生安裝檔。 |
| 系統相容性 | 最低系統版本會依應用程式及其執行環境而異。若系統提示不相容，請先確認需求，不要反覆更換下載方式。 |
| 網路設定 | 請確認目前的網路服務允許修改代理設定。公司或學校管理的裝置可能需要管理員核准。 |
從舊裝置複製設定後，請重新確認本機路徑、代理連接埠與權限。可匯入設定檔，不代表平台相關設定會自動調整。
建議先選 v2rayNG。若需要搭配 V2Fly 核心，再評估 v2flyNG；兩款客戶端的設定各自獨立管理。
下載完成後，從瀏覽器下載紀錄或檔案管理員開啟 APK。若系統要求允許安裝未知來源的應用程式，請只授權目前用來開啟檔案的應用程式，安裝完成後即可撤銷。首次連線時會出現系統 VPN 授權對話框，確認客戶端名稱後再允許；取得授權不代表訂閱中的設定一定有效。
請先匯入設定並選取其中一項，再啟動連線。Android 通常一次只能執行一個使用者層級的 VPN 服務，其他同類連線可能會被取代或遭到阻止。若切回桌面後連線中斷，請再檢查電池最佳化、背景執行及廠商的省電政策；一開始不必調整大量網路參數。
v2flyNG 不是 v2rayNG 的附加元件。切換時需重新匯入訂閱或設定，兩款客戶端的自訂設定不一定通用。核心支援的功能也可能不同；若遇到不支援的欄位，請先確認設定需求，不要直接將訂閱失敗歸咎於安裝檔。
| 項目 | 安裝前確認事項 |
|---|---|
| 應用程式架構 | 建議優先選 arm64；處理器支援 64 位元，不代表裝置系統也支援 64 位元應用程式。不確定時可試用通用版。 |
| 系統版本 | 最低版本需求依目前的 APK 而定；通用版只提供不同架構的資源，不會降低應用程式的系統版本需求。 |
| 覆蓋安裝 | 同一應用程式透過不同管道發佈時，簽章可能不同。遇到簽章衝突時，請先備份設定，不要立即解除安裝舊版應用程式。 |
| 連線權限 | 首次連線時需確認系統 VPN 授權；若要持續在背景執行，可能需要調整該應用程式的電池最佳化設定。 |
先依 Linux 發行版選擇 deb 或 rpm，再確認 x64 或 ARM64。本頁提供的是桌面圖形介面客戶端。
請使用發行版的軟體安裝程式開啟下載的套件，確認相依套件檢查結果後再繼續。x64 在檔名中也可能標示為 amd64 或 x86_64；ARM64 則可能標示為 arm64 或 aarch64。請勿透過變更副檔名轉換套件格式，也不要忽略相依套件強行安裝。
此處 rpm 檔名包含目標發行環境標示，不代表所有 rpm 系統都能直接執行。若軟體安裝程式指出系統程式庫版本不足，請先確認發行版相容性。安裝完成後，請在目前使用者的桌面工作階段中啟動，並先以一般權限確認連線。圖形桌面的系統代理、應用程式自身代理與終端機環境變數屬於不同設定，請分別確認。
| 項目 | 安裝前確認事項 |
|---|---|
| 套件管理格式 | 依發行版選擇 deb 或 rpm；實際支援範圍取決於套件中繼資料與系統相依套件。 |
| CPU 架構 | x64 對應 amd64 或 x86_64；ARM64 對應 arm64 或 aarch64。原生安裝檔不可跨架構安裝。 |
| 圖形環境 | 需要可用的桌面工作階段及應用程式所需的圖形函式庫；僅有命令列的伺服器不適用本頁的安裝步驟。 |
| 代理適用範圍 | 系統代理是否生效，取決於桌面環境與目標應用程式；終端機工具可能需要另外設定。 |
安裝成功但視窗無法顯示時，請優先檢查桌面工作階段與圖形相依套件。若視窗正常但無法連線，再檢查設定、連接埠、DNS 與路由。
完成安裝只是第一步。分開處理匯入設定、確認連線與調整分流，遇到問題時更容易找出原因。
客戶端不會附帶可用節點。請先確認設定來源與有效期限，再透過訂閱管理、剪貼簿或 QR Code 匯入。訂閱網址用於取得一組可更新的設定；單一節點分享連結通常只會匯入一個項目，兩者不可任意互換。
訂閱網址可能包含存取憑證。請勿將原始網址、QR Code 或完整設定截圖公開發布。
更新完成後，請選取一項設定，確認本機連接埠未被占用，再啟用所需的代理模式。桌面應用程式是否遵循系統代理各有不同；行動裝置則須確認已取得系統連線授權。先用一個明確的目標應用程式測試，避免將局部問題誤判為所有連線都失效。
初次測試時，請勿同時啟用多個代理客戶端，也不要同時修改 DNS、路由與核心設定。
基本連線正常後，再依使用需求設定直連與代理規則。規則順序會影響實際比對結果，變更 DNS 解析方式也可能影響 IP 規則。每次只調整一組設定，並記錄變更前後的狀況；確認穩定後匯出備份，方便升級或移轉時還原。
在不同裝置間使用設定時，需手動匯入，並重新確認路徑、本機連接埠與平台權限。
請先區分安裝問題與連線問題。能開啟客戶端，不代表設定已準備就緒。
初次使用建議選擇 Desktop 桌面版，採用新一代跨平台介面。經典 WPF 版適合熟悉舊版 Windows 介面與操作流程的使用者。無須同時安裝兩者；切換前請先匯出設定，並避免同時啟用系統代理或占用相同的本機連接埠。
2015 年後推出的主流手機通常建議優先選擇 arm64，但仍應以裝置支援的應用程式架構為準。部分裝置的系統可能僅支援其他架構。不確定架構或遇到架構不相容提示時，可改試通用版；但通用版無法略過系統版本需求或安裝簽章衝突。
客戶端負責管理設定與建立連線，安裝檔不包含可用的訂閱或帳號。請從可信來源取得設定，匯入訂閱或分享連結，更新並選取設定，再選擇代理模式。先確認連線正常，再依需求調整分流與 DNS。
升級前請使用客戶端的匯出或備份功能，保留訂閱群組、自訂路由、DNS 設定及本機連接埠紀錄。先退出舊版客戶端再安裝。跨客戶端移轉時，請勿直接覆寫整個資料目錄；應重新匯入設定並確認平台差異。備份可能含有存取憑證，請妥善保管。
下載中斷時，先檢查網路、磁碟空間與瀏覽器下載紀錄，再重新下載對應安裝檔。系統阻止安裝時，請先閱讀提示內容，確認是架構不符、權限不足、簽章衝突或安全政策限制。請勿直接關閉系統防護；受管理的裝置應先洽詢管理員。
版本資訊與下載檔案入口取自清單中的不同欄位，更新時間可能不一致。請勿只憑檔名判斷已安裝的版本。安裝後，請在客戶端的「關於」頁面確認實際版本；若與預期不符，先保留現有設定，等待清單更新或重新確認下載入口。