Windows
選擇 v2rayN。桌面版提供跨平台介面，經典 WPF 版則保留熟悉的桌面操作方式，依使用習慣選擇即可。安裝後先匯入訂閱，再設定系統代理，方便區分安裝問題與連線問題。
前往下載CLIENT / 依作業系統選擇
V2Ray 用戶端下載
桌面平台使用 v2rayN，Android 則依核心需求選擇用戶端。
先確認作業系統與處理器架構，再前往對應平台下載。用戶端負責管理設定並啟動核心；實際連線還需要可用的伺服器參數或訂閱網址。即使已有訂閱，也別跳過架構選擇：安裝套件能否執行，與訂閱能否連線是兩回事。
macOS
使用 v2rayN，依 Apple Silicon 或 Intel 晶片選擇安裝套件。可在「關於這台 Mac」查看晶片資訊。首次啟動若出現系統安全提示，請先確認檔案來源，再依系統設定中的指示處理。
前往下載Android
優先選擇以 Xray 為核心的 v2rayNG；需要 V2Fly 核心時，再考慮 v2flyNG。多數手機選 arm64 即可；不確定架構時，請參閱通用版說明。首次連線須確認系統 VPN 授權；若在背景中斷線，再檢查電池限制。
前往下載Linux
使用 v2rayN 的 deb 或 rpm 安裝套件，依 Linux 發行版與處理器架構選擇。桌面環境的代理設定不一定會套用到終端機程式；請先用瀏覽器測試，再另外檢查命令列工具的代理環境變數。
前往下載更換平台不代表更換協定。能否使用仍取決於用戶端核心、伺服器設定與傳輸參數是否相符。
查看所有用戶端 →CONFIGURATION / 設定關係
訂閱、路由與代理模式
先釐清各項設定控制的層面，再修改參數。以下是局部設定範例，並非可直接連線的完整檔案。
匯入設定不等於啟用代理
在訂閱管理中新增可信來源的網址，儲存後更新，再從清單選擇伺服器。訂閱只用來批次提供設定，不能取代系統代理或 VPN 授權。相較於逐一貼上分享連結，訂閱更適合集中更新，但也可能覆寫來源管理的項目。初次使用時先保留預設群組，確認更新成功後再整理名稱；請勿在公開截圖中放入含有存取憑證的訂閱網址。右側是本機入站設定片段，用來說明匯入設定後仍需要流量入口，並非訂閱檔案格式。
操作順序：新增訂閱 → 更新 → 選擇伺服器 → 啟用代理。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"udp": true
}
}
]
}規則依序決定流量出口
先使用用戶端提供的路由預設，確認連線正常後，再依區域網路、指定網域或應用程式需求新增規則。路由通常由上往下比對，條件較明確的規則應排在較寬泛的規則之前。相較於只切換全域模式，分流能保留本機資源的直接存取，但須確認出口標籤確實存在。右側片段會將私有 IP 位址交給名為 direct 的出口；實際設定還需定義該出口並準備對應的規則資源。新增規則後重新載入核心，並以明確的目標測試結果。
先測試單一規則，再擴大比對範圍。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}依應用程式行為選擇接管方式
瀏覽器等遵循系統代理設定的應用程式，可先使用自動設定系統代理；不讀取此設定的程式，則須另外指定代理或使用 TUN。TUN 透過虛擬網卡接管流量，涉及權限、路由與 DNS，並非提升速度的開關。相較於只修改系統代理，TUN 的涵蓋範圍更廣，也更須避免與其他網路工具衝突。初次設定時，請勿同時啟用多種流量接管方案。右側是本機 HTTP 代理入口範例，連接埠必須與應用程式填入的數值一致，實際數值以用戶端設定為準。
先用系統代理確認連線，再依需求啟用 TUN。
{
"inbounds": [
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}依協定支援度選擇核心
先確認伺服器要求的協定、傳輸方式與安全參數，再判斷核心是否支援。v2rayN 可管理不同核心的設定；Android 則可依需求在 v2rayNG 與 v2flyNG 之間選擇。比起只看用戶端名稱，確認實際執行的核心更能釐清相容性問題。切換前先儲存可用設定，切換後查看啟動記錄，確認欄位已正確辨識。兩種核心有共通語法，但擴充功能不一定相容。右側的 freedom 出口僅為基本範例，不代表所有設定都能原封不動地移轉。
協定相容性優先於介面習慣，別依名稱判斷效能。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}解析路徑須配合路由設定
先確認網域解析是由系統、瀏覽器還是核心處理，再決定是否修改 DNS。瀏覽器的獨立加密解析可能會略過系統設定；使用 TUN 時也可能走另一條解析路徑。與其只替換 DNS 伺服器位址，檢查解析要求如何送達上游，更有助於找出問題。右側展示核心 DNS 的 servers 陣列；使用遠端解析服務時，也要確認連線路徑可達。若直接連線正常、網域連線失敗，應優先檢查解析結果與記錄，不要同時修改路由和傳輸參數。
一次調整一條解析路徑，並保留可還原的設定。
{
"dns": {
"servers": [
"https://1.1.1.1/dns-query",
"localhost"
],
"queryStrategy": "UseIP"
}
}安裝後的操作順序
v2rayN 快速上手：三步確認連線
先完成最基本的設定，再新增分流、TUN 與個人化規則。
不同用戶端的選單名稱可能略有差異，但設定邏輯一致：先讓用戶端取得伺服器參數，再讓應用程式將要求交給用戶端，最後確認要求確實經過預期的出口。將這三個層面分開，遇到問題時就能判斷該檢查訂閱、系統設定還是路由，而不必反覆重裝軟體。
匯入訂閱，選擇一台伺服器
準備可信來源的訂閱網址，在 v2rayN 的訂閱管理中新增群組並儲存，再執行更新。Android 使用者可在 v2rayNG 的訂閱群組設定中進行相同操作。更新後應會看到設定項目；若清單是空的，先確認網址是否完整、訂閱是否有效，以及更新記錄是否顯示格式或網路錯誤。
選取一個項目作為作用中的伺服器，別只停留在「已匯入」狀態。協定、傳輸方式、連接埠及安全參數都必須與伺服器相符，不能只憑名稱自行替換。訂閱更新可能變更現有項目，建議先記下目前使用的群組，方便之後排查時確認所用設定。
啟用代理，保留預設路由設定
桌面端先啟動核心，再選擇自動設定系統代理，並用瀏覽器進行首次測試。若已安裝代理擴充功能，請確認它是否接管瀏覽器設定；同時執行其他代理程式，也可能讓系統代理指向錯誤的連接埠。Android 首次連線須同意系統 VPN 授權，這與訂閱是否匯入成功沒有直接關係。
初次使用時，先選擇符合目前需求的路由預設，避免同時修改 DNS、出口規則與 TUN。若需要接管不遵循系統代理設定的應用程式，再閱讀該平台的 TUN 設定說明。離開用戶端前，請清除不再使用的系統代理，避免應用程式繼續將要求送往已關閉的本機連接埠。
先測試網頁，再檢查特定應用程式
開啟預期會透過代理連線的網頁，並查看用戶端記錄中的連線與出口資訊。能開啟某個網頁，只代表該次要求成功，不能證明所有應用程式都在使用代理。終端機工具、瀏覽器和桌面應用程式可能各有獨立設定，請依實際需求逐一測試。
若顯示已連線卻無法存取，請依序檢查伺服器狀態、裝置時間、DNS 解析、路由比對結果與本機連接埠。先記下錯誤訊息，再一次修改一個變數，測試後決定保留或還原。連線狀態通常只代表核心或網路接管已啟動，不表示遠端服務一定可用。
用戶端、核心與開源授權
Project V、V2Fly 與 Xray 的關係
介面負責管理，核心負責處理連線，協定則定義通訊方式。
V2Ray 源自 Project V 的模組化代理工具架構。設定中常見的入站、出站、路由與 DNS，分別負責流量入口、連線出口、規則選擇與網域解析。日常所說的「V2Ray 用戶端」常是泛稱，可能指核心，也可能指具備圖形介面的管理程式。下載前先釐清兩者，才能理解為何同一份訂閱可以由不同用戶端讀取，卻不一定能在所有核心上呈現完全相同的行為。
核心系列：共同基礎與各自發展
V2Fly 社群延續 V2Ray 核心的開發與維護，Xray 則在相關技術基礎上獨立發展。兩者都採用以設定檔驅動的代理架構，但功能擴充、欄位支援與更新時程並不完全相同。VMess、VLESS、Trojan 和 Shadowsocks 是協定名稱；TLS、傳輸層與路由策略則屬於不同層面。看到熟悉的協定名稱，不代表可以略過傳輸方式與安全參數的檢查，更不能把所有以 V2Ray 命名的程式都視為同一套軟體。
選擇核心時，先依伺服器提供的完整參數確認相容性，再考慮用戶端是否方便管理。若匯入後出現「不支援的協定」或設定欄位錯誤，應先查看實際執行的核心與功能說明，而不是反覆切換系統代理模式。系統代理決定要求如何進入用戶端；核心相容性則決定進入後能否正確連上遠端伺服器，這兩類問題應分開處理。
三款用戶端：桌面管理與行動裝置的取捨
v2rayN 適用於桌面平台，提供訂閱群組、伺服器選擇、路由管理與核心設定等圖形化操作，適合需要在多種桌面環境維持相近操作方式的使用者。v2rayNG 適用於 Android，以 Xray 核心管理行動代理；v2flyNG 同樣適用於 Android，是採用 V2Fly 核心的另一選擇。桌面端與行動裝置的網路權限機制不同，教學中的設定目標雖可對照，按鈕位置與授權流程卻不能照搬。
三款用戶端皆以開源方式提供程式碼，但用戶端介面與採用的核心仍是不同專案。更換用戶端不會自動修復訂閱中失效的伺服器，也不會自動取得另一核心的所有擴充功能。若已有可用設定，優先選擇能正確解析它的用戶端；需要移轉時，先匯出或記錄自訂規則，再確認訂閱、代理模式與 DNS 是否都已還原。
開源授權：區分介面與相依元件
v2rayN 與 v2rayNG 採用 GPL 系列開源授權，v2flyNG 採用 GPL 授權；V2Fly 核心採用 MIT 授權，Xray 核心則採用 MPL 2.0 授權。軟體也可能包含其他採用獨立授權的相依元件，實際權利與義務應以取得的發行套件所附授權文字為準。開源表示可依相應授權檢視、使用與再散布程式碼，不代表用戶端專案也提供所有網路服務、伺服器資源或第三方訂閱。
一般使用者更應留意設定的界線：用戶端可能儲存伺服器憑證與訂閱存取網址，分享截圖或記錄前應先移除這些敏感資訊。通常只需提供記錄，就足以判斷握手、解析或連接埠錯誤，不必公開整份訂閱。需要了解 UUID、出口標籤、網域策略等術語時，可先查閱術語手冊，再決定是否調整相關欄位。
更新機制：分別檢查程式、核心與規則
用戶端更新、核心更新、訂閱更新與規則資源更新，解決的是不同問題。用戶端更新可能變更介面或設定產生方式；核心更新會影響協定與執行能力；訂閱更新用來同步伺服器參數；規則資源更新則會變更網域與位址集合。遇到問題時，先確認變動發生在哪一層，再選擇處理方式；別把「更新訂閱」當成所有故障的通用解法。
更新前先備份自訂路由與重要設定，更新後確認作用中的伺服器、代理模式和本機連接埠。若要判斷新設定是否可靠，請在相同網路、相同應用程式與相同目標下重新測試，減少環境變化造成的干擾。本網站提供用戶端選擇與設定說明，實際功能仍以目前安裝的程式為準；需要各平台的操作細節，請繼續閱讀多平台安裝與設定文件。
依問題繼續閱讀
不確定用戶端差異時，先看比較；已安裝但連線失敗，直接查看設定文件。將術語、操作步驟與故障現象對照，通常比反覆嘗試不同開關更有效。
用戶端選擇與疑難排解
V2Ray 設定專題文章
基本設定完成後，再依實際問題閱讀專題。瀏覽器與終端機的代理行為、Android 的背景限制，以及用戶端與核心的差異，各有對應的排查方向；不必為了單一故障重新學習整套設定。
v2rayN 系統代理未生效：分別排查瀏覽器與命令列終端機
瀏覽器未使用代理時，檢查擴充功能與代理模式；終端機未使用代理時，檢查環境變數與連接埠設定，並說明何時應改用 TUN 模式統一接管流量。
v2rayNG Android 設定要點：VPN 授權、省電白名單與依應用程式分流
說明 v2rayNG 如何透過 VpnService 運作，示範如何加入省電白名單避免背景斷線，以及如何設定依應用程式分流，只讓指定應用程式使用代理。
v2rayN、v2rayNG、v2flyNG 怎麼選：三款 V2Ray 用戶端的核心與平台差異
比較三款用戶端適用的平台、內建核心、訂閱與路由功能及介面操作，說明桌面端為何優先推薦 v2rayN，以及 Android 兩款用戶端的選擇考量。