v2rayN 桌面版 · v2rayNG 與 v2flyNG Android 版
先選擇作業系統，再選擇處理器架構。下載入口依用戶端分類，版本資訊列於卡片中；安裝後的訂閱匯入與路由設定請參閱使用教學。
初次安裝可先選擇桌面版。桌面版採用 Avalonia 跨平台介面，適合需要在不同桌面系統間維持相同操作習慣的使用者；經典 WPF 版僅適用於 Windows，適合想沿用原有視窗配置與操作流程的人。兩者都是 v2rayN；介面版本與伺服器協定是不同概念，不應只看介面名稱就判斷某個分享連結能否匯入。
此處提供 x64 安裝檔，適用於相應的 64 位元系統。請開啟 Windows 設定中的「系統 → 系統資訊」，查看系統類型與處理器資訊，再決定是否使用本頁的下載入口。下載 ZIP 後，請先完整解壓縮至獨立資料夾，再執行其中的安裝程式。若直接在壓縮檔預覽中按兩下，可能導致隨附檔案未解壓縮，之後若無法啟動也較難查明原因。
安裝後先啟動用戶端並匯入設定，再啟用系統代理。系統代理主要影響遵循系統代理設定的應用程式，不等於接管所有網路流量。初次排查連線問題時，請先關閉 TUN，確認一般代理連線正常。有需要時再依教學啟用 TUN 並詳閱權限提示，避免把介面選擇、驅動程式權限與伺服器設定問題混為一談。
| 檢查項目 | 本頁安裝檔需求 | 確認方式 |
|---|---|---|
| 處理器架構 | x64；本頁兩個下載入口皆為 x64 套件 | 「系統資訊」中的系統類型 |
| 系統與執行環境 | 建議使用仍受支援的 Windows 10 / 11；實際最低需求請以所選發行版本的說明為準 | 安裝程式提示與用戶端發行說明 |
| 檔案與權限 | 完整解壓縮；安裝位置須可存取；啟用 TUN 時另行處理提升權限的要求 | 先以一般使用者身分啟動主介面 |
若安裝程式提示缺少執行環境，請先記下提示中的確切元件名稱與架構。不要把所有啟動異常都歸咎於伺服器，也不要隨意複製其他軟體資料夾中的檔案來修復。更換桌面版或 WPF 版之前，請先備份設定並結束原程式；確認新介面能讀取設定後，再決定是否保留舊版。
開啟系統選單中的「關於這台 Mac」查看晶片資訊。若顯示 Apple M 系列晶片，請選 Apple Silicon 版；若顯示 Intel 處理器，則選 Intel 版。兩種套件用途相同，主要差異在處理器架構。請勿依電腦外觀、購買年份或螢幕尺寸選擇；晶片的確切名稱才是較可靠的判斷依據。
下載完成後開啟 DMG，將 v2rayN 拖曳至「應用程式」資料夾，再從該資料夾啟動。磁碟映像檔是安裝媒介，不適合長期作為執行位置。複製 App 後即可退出磁碟映像檔；日後更新時，請先結束正在執行的用戶端再替換 App，避免系統提示檔案仍在使用，或舊程序繼續接管代理。
若系統阻止首次開啟，請先判斷提示原因是架構不符、系統版本不符合需求，還是安全機制要求確認。若是明確的安全確認，請閱讀「系統設定」中「隱私權與安全性」的相關資訊，再處理該 App。請勿為了啟動用戶端而關閉整體系統安全防護，也不要對來源與用途不明的指令批次授權。
| 檢查項目 | 選擇依據 | 安裝注意事項 |
|---|---|---|
| 晶片 | Apple Silicon 對應 arm64；Intel 對應 x64 | 在「關於這台 Mac」查看晶片或處理器名稱 |
| 系統環境 | 具備桌面圖形介面的 macOS；最低系統版本依發行版本而異 | 若出現系統版本提示，請參照發行說明確認 |
| 代理權限 | 系統代理與 TUN 的權限範圍不同 | 先匯入設定，再依需求啟用相應模式 |
安裝成功不代表系統代理已啟用。首次執行後，請選取已匯入的伺服器，再確認用戶端中的代理開關與系統網路設定是否一致。測試應用程式連線時，先確認該 App 是否遵循系統代理；若 App 自行指定代理位址，也要檢查位址與連接埠。不要只因瀏覽器能連線，就認定所有 App 都已接管。
v2rayNG 是 Android 圖形化用戶端，本頁以搭載 Xray 核心的版本作為 Android 首選。2015 年後的主流手機通常可先選 arm64，但部分裝置的處理器雖支援 64 位元，系統採用的應用程式執行環境卻可能不同。無法確認時請選通用版，並以系統安裝程式的相容性提示為準。通用版與 arm64 版的差異在架構，不是功能等級。
開啟下載的 APK 時，Android 可能會要求允許目前使用的瀏覽器或檔案管理器安裝 App。只需為正在使用的來源開啟安裝權限，安裝完成後即可在系統設定中重新關閉。首次啟動並開啟連線時，系統會要求 VPN 授權，這是用戶端接管流量所需的程序。授權前請確認要求來自剛安裝的用戶端；通常不需要取得裝置的特殊管理權限。
匯入訂閱後還需要執行更新，單純新增網址不一定會立即產生伺服器清單。連線成功後，如果鎖定螢幕或切換 App 導致服務停止，請再檢查電池最佳化、背景活動與廠商的自動啟動限制。只需針對目前使用的用戶端調整，不必將所有 App 設為常駐；是否維持連線也應依實際需求考量資源耗用。
v2flyNG 適合需要 V2Fly 核心行為或已有相關設定的使用者。選擇其他用戶端前，請先確認使用的協定與傳輸設定是否相容；切換用戶端並非所有連線錯誤的通用解法。V2Fly 與 Xray 屬於相關技術生態系，但各自的功能發展不同，實際支援的欄位與協定仍須依用戶端搭載的核心判斷。
從 v2rayNG 改用 v2flyNG 時，請先保留原有訂閱資訊與手動設定，再於新用戶端重新匯入。不要假設兩個 App 會自動共用私有資料。測試前先停止原用戶端的 VPN 服務，同一時間只讓一個用戶端接管連線，方便確認目前生效的設定，也能減少系統 VPN 授權反覆切換造成的混淆。
| 檢查項目 | 選擇依據 | 注意事項 |
|---|---|---|
| 應用程式架構 | arm64 或通用版 | 新款主流裝置優先選 arm64；不確定時選通用版 |
| 系統相容性 | Android 版本須符合目前 APK 的需求 | 最低版本以發行說明與安裝程式提示為準 |
| 必要授權 | 安裝來源權限與 VPN 服務授權 | 連線後再個別檢查背景執行限制 |
遇到「未安裝應用程式」時，請依序檢查剩餘儲存空間、架構相容性，以及是否已安裝簽章不同的版本。處理既有 App 前請先備份，不要卸載後才開始找原有設定。訂閱連結通常含有個人存取參數，分享螢幕截圖、回報問題或使用共用剪貼簿時，都應先隱藏這些資訊。
Linux 安裝檔須同時符合發行版的套件格式與處理器架構。Debian、Ubuntu 系統通常使用 deb；Fedora 等發行版則使用 rpm。一般 Intel 或 AMD 64 位元電腦請選 x64；採用 arm64 系統的裝置則選對應的 arm64 套件。格式相同不代表適用於所有版本的發行版，執行階段函式庫與套件相依性仍應交由本機套件管理器檢查。
下載後可用系統的圖形化軟體安裝程式開啟套件，閱讀相依性與安裝位置提示後再確認安裝。若管理器回報相依性不符，請先確認目前的發行版版本與軟體來源狀態，不要直接強制忽略相依性。安裝完成後，從應用程式選單啟動 v2rayN；這是桌面圖形化用戶端，應在可用的桌面工作階段中執行，不應將一般啟動流程視為背景服務部署。
Linux 桌面環境處理系統代理的方式不盡相同。啟用用戶端的系統代理後，仍須確認目標 App 是否採用桌面代理設定。瀏覽器、內建代理設定的 App 與命令列程式，可能使用不同來源的設定。初次連線時，先用明確遵循代理設定的 App 測試，再處理其他程式，能更快判斷問題出在訂閱、出口設定還是 App 本身。
| 檢查項目 | 安裝檔選擇 | 確認方式 |
|---|---|---|
| 套件管理系統 | deb 或 rpm | 發行版的軟體中心與套件管理器 |
| 處理器架構 | x64 或 arm64 | 系統資訊；amd64 / x86_64 對應 x64，aarch64 對應 arm64 |
| 執行環境 | 桌面圖形工作階段及套件所需的執行階段函式庫 | 安裝程式的相依性檢查；實際系統需求依發行版而異 |
| TUN 權限 | 依用戶端與系統需求個別授權 | 先確認一般代理正常，再設定 TUN 模式 |
若需要開機後自動啟動，請先區分「登入桌面後啟動」與「系統啟動時執行」。一般桌面使用情境應先設定前者，並確認啟動時能讀取設定檔路徑。請勿為了啟用 TUN 而讓整個圖形介面長期以提升權限執行。完整安裝與自動啟動設定請參閱Linux 安裝設定章節。
先確認目前裝置的作業系統，再確認處理器架構，最後選擇介面版本或套件格式。這三項各自解決不同問題：作業系統決定用戶端下載入口，架構決定程式能否執行，介面版本則影響操作方式。檔名中的 x64、amd64、arm64 不代表伺服器所在地，也不會決定可使用的協定。依此順序選擇，通常不必逐一嘗試所有安裝檔。
本頁的用戶端皆可免費使用，但用戶端本身與伺服器服務是兩回事。安裝檔包含執行用戶端所需的軟體，不包含個人訂閱或可直接使用的伺服器設定。請準備具有使用授權的分享連結或訂閱網址，確認有效期限與支援的協定，再開始連線。訂閱服務的可用性、費用與維護方式由各提供者決定，無法從用戶端版本號推斷。
下載入口會讀取同網域的版本清單，更新卡片中的版本資訊與對應檔案網址。頁面中的靜態入口可保留可點選的安裝檔路徑；即使瀏覽器指令碼無法使用，仍可透過這些入口下載。各用戶端的版本獨立發布，版本號大小不代表功能強弱，也不能直接跨用戶端比較。升級時應考量系統相容性、具體修正內容與既有設定需求。
安裝檔是程式的發行檔案；訂閱群組、伺服器項目與自訂路由則屬於個人設定。更新程式前，請先使用用戶端提供的匯出或備份功能，不要只保留下載資料夾中的 ZIP、DMG 或 APK。切換用戶端時，建議透過分享連結或重新新增訂閱來轉移，並逐項核對自訂欄位；不要直接將某個用戶端的整個設定資料夾交由另一個用戶端讀取。
備份檔可能包含伺服器密碼或訂閱存取參數，請存放在自己能存取的位置。回報問題時，提供錯誤類型、作業系統、應用程式架構與操作步驟即可；設定截圖中的網址、帳戶資訊與存取參數應先遮蔽。如此既能提供排查所需資訊，也能降低憑證透過截圖或記錄檔外流的風險。
單一分享連結用來新增一筆伺服器設定；訂閱網址則用來取得並更新一組設定。複製有效的分享連結後，在用戶端使用從剪貼簿匯入的功能；若使用訂閱，請先新增訂閱群組、輸入網址，再執行更新。不要把網頁介紹頁當成訂閱網址，也不要將訂閱網址貼入只接受單一分享連結的欄位。更新完成後，確認清單中已出現項目，再選擇要使用的設定。
桌面端先透過系統代理確認基本連線；Android 端則透過系統 VPN 授權啟動服務。路由預設值決定不同請求使用哪個出口；系統代理與 TUN 則決定哪些 App 流量會進入用戶端，兩者不能互相取代。尚未了解規則前，請先沿用一組明確的預設值，不要同時變更 DNS、路由、傳輸設定與核心選項，否則很難判斷哪項調整影響結果。
確認用戶端服務已啟動後，再使用實際需要連線的 App 測試。介面顯示已連線只代表本機服務狀態正常，不表示遠端請求一定成功。若某個 App 可用、另一個無法使用，請先檢查 App 的代理設定與路由規則是否命中，不必立刻重新下載。若所有 App 都無法連線，請依序確認訂閱是否過期、伺服器資訊是否完整、系統時間是否正確，再查看具體錯誤記錄。
結束用戶端前，請先停止連線或還原系統代理，尤其是在切換兩種桌面介面或測試多個 Android 用戶端時。殘留的代理位址可能使瀏覽器繼續向已結束的本機服務傳送請求，導致一般網頁也無法開啟。遇到這種情況，請先確認系統代理狀態，而不是反覆安裝。操作截圖與步驟說明請參閱v2rayN 與 v2rayNG 使用教學；權限、平台差異與路由細節請參閱全平台安裝設定指南。
不需要。初次使用可選擇 v2rayN 桌面版；習慣經典 Windows 介面的使用者則可選 WPF 版。兩種介面不應同時接管系統代理。切換前請先結束原用戶端，並備份訂閱群組與自訂路由設定。
2015 年後的主流手機通常可優先選 arm64，但處理器支援 64 位元，不代表系統一定提供 64 位元應用程式環境。無法確認架構時可選通用版；若安裝程式提示不相容，請檢查系統版本與應用程式架構，不要反覆安裝同一個檔案。
先確認 Apple Silicon 或 Intel 安裝檔是否選對，再將 App 從磁碟映像檔拖曳至「應用程式」資料夾。若系統阻止執行，請閱讀提示，並在「系統設定」的「隱私權與安全性」中確認是否要開啟該 App。請勿關閉整體系統安全防護。
用戶端本身不提供伺服器或訂閱服務。請準備具有使用授權的分享連結、訂閱網址或伺服器設定，匯入後選取可用設定，再啟用系統代理或 Android VPN 服務。訂閱網址可能含有存取憑證，請勿公開分享。
請保留訂閱群組、手動新增的伺服器、自訂路由規則，以及需要沿用的用戶端設定。使用用戶端提供的匯出或備份功能，並將備份存放在自己能存取的位置。升級前先結束用戶端；升級後確認設定仍在，並重新檢查代理模式與權限。