先選作業系統，再選架構。桌面平台使用 v2rayN，Android 優先選 v2rayNG，v2flyNG 則作為核心備選。
以下兩個安裝入口皆適用於 x64 系統。首次安裝建議選桌面版；想保留經典操作習慣則可選 WPF 版。
採用新一代跨平台介面，適合初次使用，或希望在不同桌面系統間維持相近操作方式的使用者。
經典穩定版本，沿用 WPF 介面，適合熟悉傳統伺服器清單與設定版面的使用者。
下載內容為 ZIP 壓縮檔。請先完整解壓縮，再依檔案內的結構執行安裝程式；不要直接在壓縮檔預覽視窗中啟動。
| 確認項目 | 選擇依據 | 操作說明 |
|---|---|---|
| 系統架構 | x64 Windows | 在「設定 → 系統 → 系統資訊」查看系統類型；不要只依電腦品牌判斷。 |
| 系統相容性 | 目前版本支援的 Windows | 系統版本與執行環境需求請以安裝程式及版本說明為準；較舊的系統應先確認相容性。 |
| 安裝環境 | 可寫入的目錄與足夠的儲存空間 | 請完整解壓縮，並依提示安裝所需執行環境；避免將兩種介面的程式檔案覆寫到同一個目錄。 |
| 權限範圍 | 一般使用與 TUN 分別處理 | 一般設定不必預先提高權限；啟用虛擬網卡功能時，再依用戶端提示授予所需權限。 |
桌面版與 WPF 版的主要差異在介面框架，不代表其中一種協定一定較快。實際支援的協定仍取決於所選核心及其版本。若要遷移現有設定，請先使用匯出或備份功能保留伺服器、訂閱群組與路由規則，再匯入新介面；不要把「複製程式檔案」當成完整的資料遷移。
安裝完成後，先確認用戶端能正常開啟，再匯入設定。若要讓瀏覽器使用代理，請檢查系統代理狀態；若要接管不遵循系統代理設定的應用程式，再評估 TUN 模式。兩者的接管範圍不同，安裝成功不代表所有應用程式的流量都已變更。
在「關於這台 Mac」確認處理器。Apple Silicon 與 Intel 使用不同架構的安裝檔，建議優先選擇符合硬體的版本。
適用於 Apple M 系列晶片。可在「關於這台 Mac」的「晶片」欄位確認機型。
適用於 Intel 處理器機型。若裝置資訊顯示為 Intel，請選擇此安裝檔。
開啟 DMG 後，依視窗提示安裝至「應用程式」。首次啟動時，請逐項確認權限與網路存取提示。
| 確認項目 | 選擇依據 | 操作說明 |
|---|---|---|
| Apple Silicon | ARM64 DMG | 裝置資訊顯示 Apple M 系列晶片時，請選擇原生架構安裝檔。 |
| Intel 處理器 | x64 DMG | 裝置資訊顯示 Intel 時，請選擇對應安裝檔，不要以機身外觀判斷架構。 |
| 系統版本 | 符合目前版本的需求 | 若系統提示版本過舊，請先查看相容性需求；重複下載相同安裝檔不會解除系統限制。 |
| 功能權限 | 依實際功能授權 | 啟用 TUN 時可能需要額外授權；安裝應用程式與啟用虛擬網卡是兩個步驟。 |
同為 Mac 電腦不代表能使用相同的二進位程式。原生架構安裝檔通常是最直接的選擇，不要為了沿用舊的安裝習慣而優先選用其他架構。安裝完成後，請從「應用程式」啟動，確認程式可正常執行，再匯入訂閱並設定路由，方便分開排查安裝與連線問題。
若系統阻止開啟應用程式，請先閱讀提示原因，確認是來源限制、相容性還是權限問題，再透過系統提供的應用程式層級入口處理。不要直接關閉整台裝置的安全功能。更換不同晶片架構的電腦時，可透過支援的匯出方式遷移設定資料，但程式本身仍需重新下載對應的安裝檔。
建議優先使用 v2rayNG；需要 V2Fly 核心時，再選擇 v2flyNG。使用前請分別確認兩款應用程式與協定及訂閱的相容性。
2015 年後的主流手機通常可優先選用，但仍需確認系統支援 64 位元 ARM 應用程式。
支援較多處理器架構，適合架構不明或需相容多種裝置的情況。
透過 Android VPN 介面接管流量，首次連線時需確認系統授權。
適用於支援 64 位元 ARM 應用程式的裝置，供需要相容 V2Fly 核心的設定使用。
無法確認處理器架構時可考慮此版本；能否安裝仍取決於系統版本等條件。
不要將 Xray 專屬功能直接視為 V2Fly 的通用功能；匯入前請確認設定所需的功能。
| 確認項目 | 選擇依據 | 操作說明 |
|---|---|---|
| 處理器與系統 | arm64 或通用版 | 手機處理器支援 64 位元，不代表系統必然支援 64 位元應用程式；請以裝置的系統能力為準。 |
| 安裝權限 | 授予來源應用程式權限 | 只需授予用來開啟 APK 的瀏覽器或檔案管理員必要權限，安裝完成後可撤銷。 |
| 系統相容性 | 符合應用程式目前需求 | 若無法剖析套件，請檢查系統版本、架構、剩餘空間及下載是否完成。 |
| 網路接管 | Android VPN 授權 | 通常一次只能啟用一個使用 VPN 介面的應用程式，請留意其他網路工具是否正在使用。 |
APK 是應用程式安裝檔，安裝後仍需匯入訂閱或伺服器參數。首次啟動連線時，系統會提示建立 VPN 連線；這項授權只會讓應用程式接管本機流量，不代表已連上可用伺服器。請先確認目前選用的設定，再查看通知列與用戶端記錄，避免把完成授權誤認為連線已驗證。
arm64 安裝檔通常比包含多種架構的通用版精簡，但不能以檔案大小判斷功能是否完整。若安裝時提示與現有應用程式衝突，請先確認是否為同一個應用程式及簽章來源，並備份設定後再處理。不要在不清楚原因時直接解除安裝，因為解除安裝可能一併刪除本機儲存的訂閱、伺服器與路由設定。
行動裝置的背景執行限制可能影響連線維持。只有在實際遇到螢幕關閉後斷線、背景程序遭結束等問題時，再檢查電池最佳化與背景執行權限；安裝時不必一次開放所有權限。v2rayNG 與 v2flyNG 可分別用於相容性測試，但不要同時啟用兩者的網路接管功能，以免混淆目前生效的設定。
先依發行版使用的套件系統選擇 deb 或 rpm，再確認處理器架構是 x64 或 ARM64。發行版名稱與處理器架構是兩個獨立條件。
適用於使用 deb 套件系統的相容發行版，例如 Debian、Ubuntu 系列。
適用於符合此 rpm 套件相依性需求的發行版；安裝前請確認系統相容性。
使用系統的軟體安裝程式開啟對應套件。副檔名相同不代表所有發行版都符合其相依性與執行環境需求。
| 確認項目 | 選擇依據 | 操作說明 |
|---|---|---|
| 圖形桌面環境 | 可執行桌面應用程式的系統 | 本頁提供圖形化用戶端，適合在本機桌面使用；不要將它當成伺服器服務套件安裝。 |
| 套件管理系統 | deb 或 rpm | 請依發行版採用的原生套件系統選擇，優先使用系統安裝程式檢查相依性，避免手動混裝。 |
| 處理器架構 | x64 或 ARM64 | x64 也常標示為 amd64、x86_64；ARM64 也常標示為 arm64、aarch64。 |
| 執行相依套件 | 符合套件宣告的需求 | 若無法滿足相依性，請先確認發行版版本與套件的適用範圍，不要強行略過相依性檢查。 |
deb 與 rpm 描述的是軟體套件的封裝系統，不會直接決定代理協定能力。即使兩個發行版都使用 rpm，也可能因基礎程式庫與相依套件版本不同而無法安裝同一個套件。安裝程式若顯示相依性錯誤，請先保留具體提示並核對系統版本與架構；不要透過變更副檔名或重新命名檔案嘗試解決。
安裝完成後，從桌面應用程式選單啟動 v2rayN，先以一般使用者身分匯入設定。系統代理能否套用至特定應用程式，取決於桌面環境與應用程式本身的代理支援；TUN 則涉及額外的網路權限與路由設定。建議先測試一般代理，再視需要啟用 TUN，逐步縮小問題範圍，避免同時變更 DNS、路由與權限而難以找出異常原因。
分別確認程式安裝、匯入設定及流量接管是否正常，每一步完成後再進行下一步。
用戶端不提供連線目標。取得有權使用的訂閱後，請在訂閱群組中新增網址並更新；若只有單一分享連結，請使用用戶端提供的剪貼簿匯入功能。訂閱連結可能包含帳戶識別資訊，請視為敏感資料，勿貼到公開討論區或截圖中。
匯入成功後，請檢查協定類型、傳輸方式與安全層是否都已正確識別。VLESS、VMess 與 Trojan 是不同的設定類型，不能只修改名稱就互相轉換。若遇到不熟悉的欄位，請先參考設定提供者的說明及所選核心的支援能力，不要只因名稱相似就自行填入參數。
查看協定與核心技術參考 →在清單中選定使用中的伺服器後，再啟用系統代理或行動裝置連線。系統代理主要供遵循系統代理設定的應用程式使用；TUN 則透過虛擬網路介面擴大接管範圍，並非單純的速度檔位。請先採用符合需求的最小接管範圍，再依應用程式的實際行為調整。
測試時除了確認目標網站是否正常，也要查看用戶端記錄與路由命中狀況。清單中的延遲測試不能取代完整的連線測試，單次失敗也不能直接歸咎於安裝檔。依序檢查設定、伺服器、DNS、路由及應用程式的代理設定，比反覆重新安裝更容易找出原因。
依步驟完成首次連線 →更新程式不等於遷移資料。更換介面、裝置或核心前，請先確認設定的儲存方式。
先使用用戶端支援的匯出或備份功能，保留訂閱群組、手動新增的伺服器及自訂路由。訂閱可以重新取得，不代表手動修改的欄位也能自動還原。另請記下目前使用的核心、DNS 策略、系統代理模式與 TUN 設定，方便更新後逐項核對。
執行更新安裝前請先退出用戶端，避免檔案仍被占用。不同安裝方式可能會將使用者資料存放在不同位置，因此不能假設「解除安裝程式」一定會保留設定，也不能認定「複製程式資料夾」就是完整備份。遷移至新裝置時，請只透過可信任的方式傳送設定檔，並妥善保管其中的敏感資訊。
首次開啟更新後的用戶端，先確認訂閱群組與伺服器清單仍在，再檢查目前使用的伺服器、預設路由及系統代理狀態。核心升級可能改變欄位或行為；設定成功匯入不代表所有功能都已維持原狀，請搭配記錄與實際連線確認。
若只有某一類應用程式異常，請先檢查該應用程式是否遵循系統代理設定，不要立即更換安裝檔。若同一份訂閱匯入不同用戶端後表現不一，請核對核心支援與訂閱解析方式。確認設定已完整還原且連線正常後，再清除舊安裝檔與暫存的敏感匯出資料。
整理安裝檔選擇、系統權限及更新備份等常見疑問。
用戶端負責管理設定與轉送流量，安裝檔不含可用伺服器。請自行準備有權使用的伺服器設定或訂閱，匯入後選擇伺服器，再設定系統代理或 TUN 模式。訂閱網址屬於敏感資訊，請勿公開分享。
首次安裝可先選桌面版，採用新一代跨平台介面；若熟悉經典版面並希望沿用原有操作習慣，則可選 WPF 版。兩種介面的選單位置與設定儲存方式可能不同，遷移前請先匯出設定，勿直接混用程式目錄。
arm64 安裝檔適用於支援 64 位元 ARM 應用程式的裝置，2015 年後的主流手機通常可優先選用。通用版支援較多處理器架構，但檔案通常較大。裝置年份不能完全取代架構判斷；若 arm64 無法安裝，請先確認系統是否支援 64 位元應用程式，再考慮通用版。
先確認系統類型、處理器架構、可用儲存空間及系統相容性，再查看警告的具體原因。Android 僅需授予實際用來開啟安裝檔的應用程式安裝權限；桌面系統則依應用程式層級的提示處理。請勿為了完成安裝而關閉整台裝置的安全防護，也不要在原因不明時反覆強制安裝。
先透過用戶端匯出或備份設定，記下目前使用的核心、路由方案及 DNS 設定，再退出用戶端並進行更新。不要假設程式目錄包含所有使用者資料。更新後請檢查訂閱群組、目前使用的伺服器、系統代理及 TUN 狀態，確認連線正常後再清除舊檔案。
頁面版本文字與下載網址分別讀取版本清單中的不同欄位，清單更新期間可能暫時不一致。檔名僅供辨識安裝檔類型，不應單獨用來判斷已安裝的版本；安裝後可在用戶端的「關於」頁面確認實際版本。如有差異，請先核對應用程式名稱、平台與架構。