用戶端安裝包／架構選擇
v2rayNG Android 版與 v2rayN 桌面版。先選擇作業系統，再選擇處理器架構。
三款用戶端皆為免費開源軟體。安裝完成後，請匯入有權使用的伺服器設定或訂閱網址。
查看安裝與匯入教學 →首次安裝建議選 Desktop；想沿用經典介面可選 WPF。以下兩個下載項目皆為 x64 壓縮包。
Desktop 是新一代跨平台介面。適合首次安裝，或希望在不同桌面系統上使用相近操作方式的使用者。WPF 是經典穩定版介面。已熟悉伺服器清單、訂閱分組和參數設定位置的使用者，可以繼續使用。兩者主要差異在介面實作與操作方式，不應把切換介面當成解決伺服器連線問題的通用方法。
下載 ZIP 後，請先解壓縮至獨立資料夾，再執行其中的安裝程式；不要直接從壓縮軟體的預覽視窗啟動。安裝路徑建議選擇目前帳戶可讀寫的位置。若執行時提示缺少元件，請依系統提示確認相依元件，避免反覆更換用戶端安裝包，卻忽略實際錯誤訊息。
| 檢查項目 | 本頁安裝包 | 確認方式 |
|---|---|---|
| 系統與架構 | Windows 64 位元、x64 | 前往「設定 → 系統 → 系統資訊」查看系統類型；這兩個套件並非原生 ARM 版本。 |
| 系統相容性 | 建議在仍受支援的 Windows 10／11 環境中使用 | 舊版系統請先確認具體版本需求與執行元件，不能只憑「64 位元」判斷是否相容。 |
| 檔案格式 | ZIP 壓縮包 | 完整解壓縮後再安裝，並保留原有設定備份。 |
| 連線接管 | 系統代理或用戶端支援的 TUN 模式 | 同一時間只讓一個用戶端接管代理；初次測試請先使用系統代理。 |
啟動後先匯入設定，再從伺服器清單選擇一項，最後設定系統代理。系統代理只會影響遵循此設定的應用程式；某個程式未經代理，不能直接代表安裝失敗。若需要接管更多流量，請再閱讀 TUN 與路由設定說明。
前往「關於這台 Mac」查看晶片名稱。Apple Silicon 請選 arm64，Intel 處理器請選 x64。
Apple Silicon 機型的晶片名稱通常以 M 開頭，請選擇 arm64 套件。若「關於這台 Mac」顯示 Intel，請選擇 x64 套件。不要依據外殼型號、購買年份或系統名稱猜測架構；同一系列電腦可能配備不同晶片。選擇原生架構有助於減少相容性轉譯帶來的額外變數。
開啟 DMG 後，請將應用程式複製到「應用程式」資料夾，再從該資料夾啟動。首次開啟時若出現系統安全性提示，請先確認下載來源，再前往「系統設定 → 隱私權與安全性」查看詳細訊息；不必為了執行用戶端而關閉整體系統安全機制。
| 檢查項目 | 選擇依據 | 注意事項 |
|---|---|---|
| 晶片 | Apple Silicon / Intel | 透過蘋果選單中的「關於這台 Mac」確認，不要依設備外觀判斷。 |
| 系統版本 | 須符合所選應用程式套件的最低需求 | 架構正確不代表舊版系統一定相容；請以安裝提示和應用程式需求為準。 |
| 安裝資料夾 | 應用程式 | 複製完成後再啟動，避免長期從掛載的磁碟映像執行。 |
| 網路權限 | 依啟用的功能授權 | 修改系統代理或啟用 TUN 時，請先閱讀權限說明再確認。 |
若應用程式可以開啟，但瀏覽器仍使用原本的網路，請先檢查系統代理開關、目前的網路服務，以及瀏覽器本身的代理設定。更新前請先結束舊程序，再替換應用程式；保留訂閱網址不代表所有本機規則都會保留，建議一併記錄路由設定和自訂 DNS 參數。
建議優先選擇 v2rayNG。2015 年後推出的主流手機通常可選 arm64，仍須以系統支援的架構為準。
v2rayNG 採用 Xray 核心，適合在 Android 上管理常見分享連結、訂閱設定、路由與分應用程式代理。需要使用 VLESS 或 REALITY 設定時，請優先依設定提供者的參數要求選擇並設定；不要只看協定名稱，就省略傳輸層、安全類型或伺服器名稱。
arm64 套件適用於系統支援 arm64-v8a 應用程式的裝置；通用版包含多種架構，適合無法確認架構時使用。部分裝置雖採用 64 位元處理器，系統卻可能只提供 32 位元應用程式環境，因此購買年份和處理器規格僅供參考，不能取代實際相容性判斷。
v2flyNG 採用 v2fly 核心，適合繼續使用已確認相容此核心的既有設定。這是獨立應用程式，不是 v2rayNG 的附加元件。兩款用戶端的功能範圍和參數支援可能不同，不應假設包含核心專屬欄位的同一份設定可以直接互換。
從其他用戶端移轉時，請先匯出需要的分享連結或訂閱資訊，再逐項檢查路由、DNS 與分應用程式代理。不要同時啟動兩個應用程式的 VPN 服務。若只有某筆設定無法連線，請先查看錯誤記錄和參數支援情形，不要頻繁更換安裝包。
| 檢查項目 | 需求或選項 | 操作說明 |
|---|---|---|
| 應用程式架構 | arm64／通用版 | 不確定系統架構時請選通用版；架構相符仍須符合應用程式的最低系統需求。 |
| 安裝權限 | 允許從目前來源安裝應用程式 | 僅授權本次使用的瀏覽器或檔案管理員，安裝完成後可關閉此權限。 |
| VPN 授權 | 首次連線時確認 | 系統會顯示連線要求；授權後，用戶端才能接管對應流量。 |
| 背景執行 | 依裝置的電池管理策略調整 | 只有鎖定螢幕後連線中斷時，才需要檢查背景執行限制，不必預先修改所有省電選項。 |
安裝時若出現「應用程式未安裝」，請依序確認系統版本、應用程式架構、可用空間及安裝簽章。通用版只能擴大架構涵蓋範圍，無法解決簽章衝突或系統版本過舊的問題。若目前版本文字與檔名暫時不同，請查看應用程式的「關於」頁面或系統應用程式資訊，確認實際安裝版本。
先確認發行版使用的套件管理格式，再區分 x64 與 arm64。主要下載項目為 x64 安裝包。
Debian、Ubuntu 及使用同類套件管理系統的發行版通常選擇 deb；採用 RPM 套件管理系統的發行版則選擇 rpm。套件格式正確只是第一步，發行版提供的系統函式庫、桌面環境和軟體相依項目也必須符合安裝需求。請勿將所有 RPM 系發行版視為完全相同的執行環境。
在圖形化檔案管理員中開啟安裝包，並由系統的軟體安裝程式處理相依項目。若安裝程式回報缺少函式庫或版本不符，請先查看詳細錯誤，不要強行忽略相依性問題。安裝後從應用程式選單啟動 v2rayN，再匯入設定；系統代理是否生效，也取決於桌面環境和目標應用程式是否讀取該設定。
| 檢查項目 | 對應選項 | 注意事項 |
|---|---|---|
| 處理器架構 | x64 / arm64 | amd64 與 x86_64 代表 x64；aarch64 通常對應 arm64。 |
| 套件管理格式 | deb / rpm | 依發行版選擇，不能只更改副檔名來轉換格式。 |
| 執行環境 | 圖形桌面與所需相依項目 | 本頁提供圖形化用戶端；安裝程式能開啟，不代表所有執行相依項目都已符合需求。 |
| 網路權限 | 系統代理／TUN | 先使用一般代理驗證設定；啟用 TUN 時，請依用戶端提示處理額外權限。 |
若軟體已在執行，卻只有部分應用程式經過代理，請先確認桌面代理設定和應用程式本身的網路選項。需要使用 TUN 時，請先排除其他 VPN、虛擬網卡和既有路由規則的影響。不要將長期以高權限執行圖形化用戶端，當作預設解決方式。
安裝完成後
安裝包負責讓「用戶端執行」，伺服器參數則用來「建立連線」。請依序驗證，避免同時變更多項設定而誤判問題。
單一節點分享連結和訂閱網址並非同一種內容。複製分享連結後，請使用剪貼簿匯入；取得訂閱網址則建立訂閱分組、填入網址並執行更新。不要把網頁介紹網址當成訂閱網址，也不要在匯入時刪除連結末尾的傳輸與安全參數。
匯入成功後，選擇一筆設定，先維持基本路由與 DNS 設定，再啟動系統代理或 VPN。開啟平常使用的測試網頁，搭配記錄判斷是否已建立連線。用戶端顯示執行中，只代表服務已啟動，不代表伺服器、名稱解析與目標網站的整條路徑都正常。
依步驟匯入並測試連線 →更新前請匯出設定，並另外保存訂閱分組、路由規則、DNS 和分應用程式代理設定。訂閱可重新取得伺服器參數，但通常無法還原所有本機偏好設定。備份檔案可能包含伺服器憑證，請存放在安全位置，勿公開傳送。
請先結束舊用戶端，再進行安裝，避免背景程序仍占用檔案。應用程式相同且簽章相容時，通常可以覆蓋更新；若遇到衝突，請先確認原因，不要直接解除安裝而遺失資料。完成後先測試原有設定，再逐項啟用新功能，方便判斷問題是否與升級有關。
查看訂閱、路由與 DNS 設定 →下載相關問題
首次安裝建議選 Desktop，使用新一代跨平台介面。若已習慣經典介面且使用正常，可繼續選擇 WPF 版。切換前請先備份設定，並避免兩個用戶端同時接管系統代理。
2015 年後推出的主流手機可優先確認並選擇 arm64；設備年份僅供參考，仍應以系統支援的應用程式架構為準。不確定架構，或 arm64 顯示不相容時，請選擇通用版。通用版無法解決系統版本或安裝簽章不相容的問題。
用戶端負責讀取設定並建立連線，安裝包不含可直接使用的伺服器設定。請匯入自行管理或有權使用的分享連結、QR Code 或訂閱網址，再選擇伺服器並啟動連線。
相同應用程式、安裝簽章相同，且系統允許升級時，通常可以直接覆蓋安裝。更新前請先匯出設定，並記下訂閱分組與路由設定。若系統提示簽章衝突，請勿直接解除安裝；先確認安裝包來源及備份是否可還原。
頁面版本文字和下載檔案路徑來自清單中的不同欄位，更新期間可能暫時不一致。確認實際安裝版本時，請查看用戶端的「關於」頁面或系統應用程式資訊，勿只依據頁面版本文字判斷安裝包版本。
請先確認伺服器設定有效、系統代理或 VPN 已啟用，並檢查記錄中的 DNS、連線逾時和憑證錯誤。通常應先排查設定與網路路徑；只有應用程式無法啟動、檔案損毀或套件架構不符時，才優先考慮重新下載。