v2rayN 優先推薦
桌面版採用新一代跨平台 UI，適合初次安裝；經典 WPF 版保留熟悉的 Windows 操作介面，是延續經典工作流程的穩定選擇。
兩個下載入口都是 ZIP 壓縮檔
請先完整解壓縮至可寫入的資料夾，再執行壓縮檔內的安裝程式。不要直接在壓縮軟體的預覽視窗中啟動，也不要只解出其中一個程式檔。
用戶端安裝包依平台與架構選擇
V2Ray 用戶端下載
桌面端選擇 v2rayN，Android 端優先選擇 v2rayNG。先確認作業系統，再選擇處理器架構與安裝格式。
選擇下載平台
下載入口依系統分類；版本資訊列於各用戶端卡片中。
Windows 安裝需求
| 檢查項目 | 需求與確認方式 | 安裝後檢查 |
|---|---|---|
| 系統與架構 | 適用於 x64 Windows；最低系統版本依所選發行套件的說明為準。 | 確認主視窗可正常開啟，且記錄檔沒有執行環境錯誤。 |
| 資料夾與執行環境 | 請使用可寫入的資料夾；若安裝程式提示缺少執行元件，請依提示安裝相應元件。 | 確認設定可以儲存，且不要長期在暫存解壓縮資料夾中執行。 |
| 代理與權限 | 一般系統代理與 TUN 所需權限不同；啟用 TUN 前請確認具備管理員權限。 | 先用系統代理確認連線，再依應用程式需求考慮使用 TUN。 |
v2rayN
Apple 晶片請選擇 Apple Silicon 套件，Intel 處理器請選擇 Intel 套件。在 Apple 選單的「關於這台 Mac」查看「晶片」或「處理器」，不要只依電腦購買年份判斷。
從「應用程式」資料夾啟動
開啟 DMG 後，將應用程式移至「應用程式」資料夾，再從該處啟動。安裝完成後可退出磁碟映像，避免一直從掛載中的安裝映像執行。
macOS 安裝需求
| 檢查項目 | 需求與確認方式 | 安裝後檢查 |
|---|---|---|
| 晶片與系統 | Apple Silicon 使用 arm64，Intel 使用 x64；最低系統版本依發行套件說明為準。 | 在「關於這台 Mac」確認晶片，並確認應用程式可以啟動。 |
| 應用程式資料夾 | 將應用程式移至「應用程式」資料夾，並確認目前使用者可以儲存用戶端設定。 | 退出 DMG 後重新啟動應用程式，確認安裝位置正確。 |
| 網路權限 | 依系統提示授予必要權限；TUN 可能需要額外授權。 | 分別確認系統代理狀態、所選模式與連線記錄。 |
v2rayNG 優先推薦
Android 端優先選擇。支援匯入訂閱、分享設定與路由設定；首次建立連線時，需核准系統 VPN 連線要求。
主流手機優先選 arm64
2015 年後的主流手機通常採用 arm64；仍須以裝置支援的應用程式架構為準。無法確認架構或出現不相容提示時，再試用通用版。
v2flyNG 替代選項
適合明確需要 V2Fly 核心相容性的設定。選擇前請確認伺服器端的協定與傳輸選項，不同核心的功能支援範圍並不完全相同。
遷移前先確認設定相容性
匯入前請確認目標用戶端能辨識協定、傳輸方式與安全性設定。能辨識分享連結，不代表其中每個選項都能以原用戶端的方式運作。
Android 安裝需求
| 檢查項目 | 需求與確認方式 | 安裝後檢查 |
|---|---|---|
| 系統與架構 | 裝置必須符合所選用戶端目前發行套件的最低系統需求；請優先確認是否支援 arm64。 | 安裝不相容時，先檢查架構與系統版本，不要反覆覆蓋同一個套件。 |
| 安裝權限 | 視需要允許目前使用的瀏覽器或檔案管理員安裝應用程式，完成後可撤銷此權限。 | 首次啟動時確認應用程式名稱，再匯入現有設定。 |
| VPN 與背景執行 | 連線需要系統 VPN 授權；若要持續使用，請依裝置狀況調整電池與背景執行限制。 | 避免同時使用其他 VPN 服務，並查看連線中斷時的記錄。 |
安裝完成後，再處理連線與背景執行設定
APK 可以安裝，只代表系統接受了這個應用程式套件。實際連線前，還需匯入有效設定、選取要使用的項目並核准 VPN 要求。如果手機已在執行其他 VPN 應用程式，請先中斷原連線，再啟動目前的用戶端，避免把系統層級的連線互斥誤判為訂閱失效。
通用版通常包含多種架構元件，檔案可能較大，但不會因此增加協定支援能力。若應用程式在鎖定螢幕後停止連線，請再檢查電池最佳化、自動啟動與背景執行限制；基本連線尚未成功前，不要一次變更多項系統設定。
v2rayN
Debian、Ubuntu 及相容發行版請選 deb；Fedora、RHEL 系列及相容發行版請選 rpm。以下兩個主要下載入口適用於 x64 桌上型裝置。
套件格式正確，還需符合相依性
同屬 rpm 或 deb 系列，不代表所有發行版都符合相同的相依需求。請查看套件管理器列出的具體缺少項目，不要強行忽略相依性繼續安裝。
Linux 安裝需求
| 檢查項目 | 需求與確認方式 | 安裝後檢查 |
|---|---|---|
| 發行版與架構 | deb、rpm 格式依發行版選擇，x64、arm64 架構依 CPU 選擇；具體相容範圍以發行套件說明為準。 | 使用套件管理器確認安裝結果，不要混裝不同架構的套件。 |
| 桌面環境與相依套件 | 需具備可執行圖形應用程式的桌面環境，並符合發行套件所需的執行程式庫。 | 確認應用程式可以啟動，並能寫入目前使用者的設定資料夾。 |
| 網路與權限 | 系統代理取決於桌面環境與應用程式支援情況；TUN 需要相應的網路權限。 | 先從一般代理模式開始測試，確認路由正常後再調整接管範圍。 |
安裝前後檢查
分開檢查安裝包、設定與連線
套件能安裝、設定能匯入、連線能建立，是三個不同的檢查項目。依序確認，比反覆更換用戶端更容易找出問題。
安裝前：保留可還原的設定
若已使用其他用戶端，請先記下訂閱網址、群組、路由預設、DNS 與本機監聽連接埠。無法從訂閱還原的手動設定，應使用用戶端支援的方式另行匯出。備份檔案可能含有存取憑證，不宜張貼在公開討論區。
升級或切換介面版本前，請正常關閉原程式。保留一份可用的設定，有助於在新版本啟動異常時分辨是安裝問題還是設定問題；直接刪除資料目錄會失去排查依據。
安裝後：先完成訂閱匯入
用戶端本身不會提供伺服器連線設定。匯入有效的訂閱網址後，還要更新訂閱並確認項目已成功讀取，再選擇要使用的設定。如果只有群組名稱、沒有任何內容，請先檢查訂閱讀取結果。
不同用戶端可以共用相容的訂閱內容，但路由、DNS、介面設定與應用程式資料目錄不適合直接互相覆蓋。遷移時請先使用可辨識的分享格式，再逐項重建用戶端設定。
連線時：先確認代理範圍
桌面端啟用系統代理後，只會影響遵循該設定的應用程式；TUN 則透過虛擬網卡接管符合條件的流量，仍需搭配路由規則。兩者不是同一個開關，啟用 TUN 也不代表所有流量都會透過代理連線。
首次測試時先保留簡單的路由設定，確認基本連線正常後，再調整 DNS、分流與背景執行策略。Android 端先核准 VPN 要求；桌面端先檢查記錄與本機連接埠，避免同時執行的用戶端互相占用。
用戶端與核心
依設定相容性選擇用戶端
v2rayN、v2rayNG 與 v2flyNG 都是免費開源的圖形介面用戶端。用戶端提供設定管理、訂閱更新與連線控制介面；核心則負責處理代理協定、傳輸與路由。兩者彼此相關，但屬於不同的軟體層級。
Project V 是認識 V2Ray 生態系的起點，V2Fly 與 Xray 則是相關的核心專案。不同核心支援的協定、傳輸方式與安全性選項會隨版本演進，不能只因為都能匯入某種連結，就認定功能完全相同。
桌面端優先選 v2rayN；Android 端通常先選採用 Xray 的 v2rayNG，若有明確的 V2Fly 相容需求，再考慮 v2flyNG。最後仍應確認伺服器端需求與用戶端實際支援項目，不要依名稱長短或安裝包大小判斷連線表現。
更新前請先閱讀應用程式內的版本與變更資訊，再決定是否遷移日常設定。軟體更新不會自動修復無法使用的伺服器，也不會改變訂閱有效期限。想了解協定名稱時，可先查閱術語，再回到實際設定確認欄位。
查閱協定、核心與路由術語 →下載與安裝常見問題
從選擇安裝包、安裝權限到還原設定，先確認問題發生在哪個環節。
Windows 桌面版與經典 WPF 版該怎麼選？
初次安裝建議先用 Desktop 桌面版，採用新一代跨平台介面；若習慣經典介面、想沿用原本的操作方式，可選擇經典穩定的 WPF 版。兩者都需確認系統為 x64。切換版本前，請備份訂閱群組、路由規則及自訂設定，先關閉舊用戶端再啟動新版本，以免本機連接埠衝突。
Android 手機該選 arm64 還是通用版？
2015 年後的主流手機通常可先選 arm64，但仍應以裝置實際支援的應用程式架構為準。若出現裝置不相容的安裝提示，或無法確認架構，可改選通用版。通用版包含多種架構元件，通常檔案較大，但不代表連線能力較強；較舊的裝置也需確認目前用戶端的最低系統需求。
安裝用戶端後，可以直接連線嗎？
用戶端負責讀取設定並建立連線，本身不會提供可用的伺服器設定。安裝後需匯入有效的訂閱連結、分享連結或手動設定，更新訂閱並選取要使用的項目，再設定系統代理或核准 Android VPN 連線。先用預設路由確認基本連線，再逐項調整分流與 DNS，遇到問題時較容易找出變動原因。
升級用戶端前，哪些資料需要保留？
至少保留訂閱網址、群組資訊、自訂路由規則、DNS 設定及本機監聽連接埠紀錄；手動新增且無法透過訂閱還原的設定也要另外匯出。設定備份可能含有存取憑證，請存放在安全可控的位置。升級前先關閉用戶端，升級後確認匯入結果，再檢查代理模式與記錄檔；不要直接以不同用戶端的資料目錄互相覆蓋。
下載後安裝遭系統封鎖，該怎麼處理？
先確認安裝包符合系統與處理器架構，並查看系統提示的具體原因。Windows 請檢查安全性提示與安裝權限；macOS 可在「隱私權與安全性」查看此次應用程式遭封鎖的紀錄；Android 僅在需要時授權目前負責安裝檔案的應用程式；Linux 則透過套件管理器查看相依性錯誤。請勿為了安裝而全面關閉系統安全防護。
下載檔名與卡片上的發行版本資訊不同，該如何判斷？
下載清單中的發行版本文字與安裝包檔名是獨立欄位，更新時程可能不同。先確認選擇的平台、架構與套件格式，再於安裝後查看用戶端「關於」頁面的實際版本；不要依檔名自行修改下載網址。若下載中斷或連結暫時無法使用，可稍後重新開啟本頁，保留原本可用的安裝與設定，避免反覆覆蓋。