CLIENT WORKBENCH / 安裝檔選擇
v2rayN 桌面用戶端 · v2rayNG 與 v2flyNG Android 用戶端
先選系統，再確認架構。桌面版使用 v2rayN，Android 優先選 v2rayNG。安裝檔用來安裝程式，訂閱與代理設定則是下一步。
可用方向鍵切換平台標籤。點擊連結中的平台錨點，可直接前往對應清單。
DESKTOP / x64
下載v2rayN 桌面版新一代跨平台 UI。初次安裝可從 Desktop 版開始，方便沿用不同桌面系統的操作習慣。此下載項目為 x64 安裝壓縮檔，下載後請先解壓縮，再執行其中的安裝程式。
CLASSIC WPF / x64
下載v2rayN 經典 WPF 版經典穩定版，採用 Windows WPF 介面。熟悉伺服器清單、系統匣選單與既有設定位置的使用者，可繼續使用此版本。這不是另一款代理軟體，主要差異在介面技術與操作配置。
兩個下載項目都是 v2rayN。請先選一個安裝；切換介面版本前，先備份訂閱分組與路由設定。
| 檢查項目 | 選擇與準備 |
|---|---|
| 系統與架構 | 建議使用仍有系統更新支援的 Windows 10 / 11；本頁提供的兩個套件皆為 x64。前往「設定 → 系統 → 關於」查看系統類型。 |
| 安裝檔格式 | ZIP 壓縮檔。解壓縮至可寫入的本機資料夾後再執行安裝程式，請勿直接從壓縮檔預覽視窗啟動。 |
| 執行環境 | 是否需要額外的 .NET 執行階段，請以目前發行套件和啟動提示為準；如有需要，請安裝符合架構與類型的執行階段。 |
| 代理權限 | 一般系統代理可使用一般權限執行；啟用 TUN 時可能需要管理員權限及虛擬網路介面支援。 |
檔名中即使有 Setup，外層仍可能是 ZIP。請先解壓縮，讓安裝程式與附帶檔案留在同一個資料夾，再依提示安裝。路徑盡量簡短，避免將工作目錄放在唯讀位置、遭同步磁碟占用的資料夾或需要額外權限的位置。啟動失敗時先查看錯誤訊息；執行階段、權限與設定損毀是不同問題，重新安裝前請先判斷原因。
開啟 v2rayN 後，在「訂閱分組設定」新增分組，輸入自己的訂閱網址並儲存，再選擇「更新訂閱」取得節點。選取要使用的伺服器，確認用戶端已啟動，最後在系統代理選單中選擇「自動設定系統代理」。系統代理負責應用程式的流量入口，路由則決定流量去向，兩者不是同一個開關。
若要從舊版移轉，請先關閉舊用戶端，避免兩套程式搶用同一組本機連接埠。訂閱網址通常可以重新更新；手動節點、自訂路由與 DNS 則需要另外保留。建議先完成一般系統代理連線，再嘗試 TUN；基本連線尚未打通就加入虛擬網卡，只會讓排查項目越來越多。
查看 Windows 完整安裝與設定章節 →
APPLE SILICON / arm64
下載 Apple Silicon 版使用 Apple Silicon 晶片的電腦請選此項。arm64 指的是晶片架構，不是系統版本編號。前往 Apple 選單中的「關於這台 Mac」查看「晶片」欄位；若顯示 Apple M 系列，請選擇此安裝檔。
INTEL / x64
下載 Intel 版使用 Intel 處理器的電腦請選 x64 套件。「關於這台 Mac」顯示 Intel 處理器時，請選擇此項。不要依電腦外觀或購買年份猜測架構；查看晶片名稱更可靠，也能避免白忙一場。
| 檢查項目 | 選擇與準備 |
|---|---|
| 處理器 | Apple Silicon 選 arm64，Intel 選 x64；請在「關於這台 Mac」確認。 |
| 系統相容性 | 請使用仍有系統更新支援的 macOS；最低版本依目前應用程式的發行需求與系統安裝提示為準。 |
| 安裝檔格式 | DMG 磁碟映像檔。開啟後將應用程式複製到「應用程式」資料夾，再從本機應用程式資料夾啟動。 |
| 網路權限 | 調整系統代理或啟用 TUN 時，請依明確的系統授權提示操作；一般啟動不代表網路已由用戶端接管。 |
下載 DMG 後，請等瀏覽器完成儲存，再開啟磁碟映像檔。將 v2rayN 複製到「應用程式」資料夾，避免長期直接從已掛載的映像檔執行。複製完成並確認本機應用程式可正常啟動後，即可退出映像檔。若系統顯示阻止開啟的提示，請先閱讀原因，再前往「系統設定 → 隱私權與安全性」查看相關記錄；不要以全域關閉安全檢查取代針對問題的處理。
初次啟動時先匯入訂閱、更新節點，再選取伺服器。啟用系統代理後，可前往「系統設定 → 網路」查看目前網路服務的代理設定，確認用戶端是否已完成入口設定。切換 Wi-Fi、有線網路或工作網路後，可能需要重新確認代理狀態。瀏覽器能連線，不代表所有終端機程式都會使用系統代理。
準備使用 TUN 時，請先儲存一份正常運作的基本設定，再依應用程式提示授權。連線異常時，先關閉新啟用的模式，還原基本設定；不要同時更換節點、DNS 和路由。退出用戶端前請關閉代理，尤其在安裝新版或更換用戶端時，避免系統仍指向已停止監聽的本機連接埠。
查看 macOS 完整安裝與設定章節 →
Xray 核心 · 訂閱分組 · VPN 模式
arm64-v8a / 常見架構
下載v2rayNG arm642015 年後推出的主流手機通常可先選 arm64。此安裝檔只包含對應架構的內容，適用於確認支援 64 位元應用程式的裝置。仍應以裝置實際執行環境為準；處理器支援 64 位元，不代表系統一定提供相同的應用程式支援。
UNIVERSAL / 多架構套件
下載v2rayNG 通用版無法確認應用程式架構時，可選通用版。此版本包含多種架構元件，檔案通常比單一架構版大。通用版只解決架構選擇問題，不代表能略過應用程式的最低系統版本需求。
v2fly 核心 · 依設定相容性選擇
arm64-v8a / 常見架構
下載v2flyNG arm64適合明確需要 v2fly 核心，且裝置支援 arm64 應用程式的使用者。若既有設定來自相同核心生態系，可將此用戶端作為備選。協定與傳輸選項仍需符合伺服器設定，不能只憑核心名稱取代設定檢查。
UNIVERSAL / 多架構套件
下載v2flyNG 通用版不確定架構時可選通用套件。v2flyNG 與 v2rayNG 是不同應用程式，設定與權限需分別處理。測試切換時，請先停止另一款用戶端的連線，同一時間只讓一款應用程式接管 VPN。
| 檢查項目 | 選擇與準備 |
|---|---|
| 應用程式架構 | 主流裝置優先選 arm64；無法確認時選通用版。安裝程式若顯示架構不相容，請重新確認系統實際支援的架構。 |
| 系統版本 | 最低系統需求會隨用戶端版本而變動，請以安裝程式提示為準；通用版不會降低最低系統需求。 |
| 安裝權限 | 安裝 APK 時，需允許目前使用的瀏覽器或檔案管理器「安裝未知應用程式」。安裝完成後可撤銷該來源的安裝權限。 |
| 連線權限 | 首次連線時需確認系統 VPN 授權；若要在背景持續執行，可能需要在電池設定中放寬該應用程式的限制。 |
開啟已下載的 APK 後，依系統提示授予目前來源安裝權限。這裡的「來源」是開啟檔案的應用程式，例如瀏覽器或檔案管理器，不是要全面更改手機的安全設定。安裝程式顯示「應用程式未安裝」時，請先記下完整原因，再檢查架構、儲存空間、系統版本及舊版簽章；不要把所有安裝失敗都歸咎於下載檔案。
在 v2rayNG 的「訂閱分組設定」儲存訂閱網址，返回主畫面後選擇「更新訂閱」。若取得的是單一分享連結，請使用「從剪貼簿匯入」，不要填入訂閱網址欄。匯入完成後選取節點，點擊連線按鈕並確認 VPN 授權。VPN 模式提供應用程式流量入口，實際直連或代理則由路由設定決定。
若背景連線中斷，先確認應用程式是否遭系統電池管理策略暫停，再檢查節點記錄。只需調整對應用戶端的背景權限，不必放寬所有應用程式的限制。v2rayNG 使用 Xray 核心，v2flyNG 使用 v2fly 核心；兩者支援的設定細節可能不同，尤其是特定協定與傳輸組合。若服務設定明確要求 Xray 功能，請優先使用 v2rayNG。
查看 v2rayNG 訂閱匯入與首次連線教學 →
DEB / x64
下載v2rayN deb 套件使用 DEB 套件管理系統的 Ubuntu、Debian 等 x64 桌面版，請選此項。檔名中的 amd64 與常見的 x86_64 指的是同類架構，不限處理器品牌。安裝時交由系統軟體安裝程式處理相依套件。
RPM / x64
下載v2rayN rpm 套件Fedora、openSUSE 等 RPM 系統的 x64 桌面版，請從此項開始。使用相同套件格式不代表發行版的相依套件完全相同；若安裝程式提示缺少程式庫或套件版本衝突，請依目前發行版的方式處理。
ARM64 桌面版請另選對應套件，勿安裝上方的 x64 檔案：
| 檢查項目 | 選擇與準備 |
|---|---|
| 桌面環境 | 需要可執行圖形應用程式的 Linux 桌面工作階段；本頁提供的是圖形介面用戶端，不是伺服器部署套件。 |
| 處理器架構 | x86_64 / amd64 選 x64；aarch64 / arm64 選 ARM64。請至系統「關於」或硬體資訊頁面確認。 |
| 套件管理系統 | Ubuntu、Debian 選 deb；Fedora、openSUSE 等 RPM 系統選 rpm，並確認與目前發行版的相依套件相容。 |
| 權限與相依套件 | 安裝軟體套件需要管理員權限；日常使用圖形介面時通常以一般使用者身分啟動，TUN 則依提示授權。 |
選擇 Linux 套件時要檢查兩件事：先確認套件管理系統，再確認處理器架構。DEB 和 RPM 是安裝格式，x64 和 ARM64 是執行架構，兩者不能互相替代。更改副檔名也無法轉換格式。請雙擊安裝套件，交由系統軟體安裝程式處理，確認相依套件提示後再安裝；若安裝程式明確指出與發行版不相容，請先停止，不要強行忽略相依問題。
安裝後從應用程式選單啟動 v2rayN，新增訂閱分組並更新節點。Linux 桌面系統代理能否生效，也取決於桌面環境與應用程式本身：瀏覽器可能會讀取桌面代理設定，命令列工具卻未必會。請先用明確支援系統代理的應用程式測試，再處理其他程式的代理入口。節點可用但應用程式未走代理，這兩種狀況應分開記錄。
若要登入後自動執行，可在桌面環境的「啟動應用程式」或類似設定中加入 v2rayN。登入時自動啟動與系統開機服務是兩回事：圖形介面用戶端應在使用者工作階段就緒後啟動。更新前請正常退出應用程式並保留個人設定；啟用 TUN 後若網路異常，先切回一般代理方式，再檢查權限、介面與路由。
查看 Linux 桌面安裝與登入自動啟動說明 →下載完成只是第一步。用戶端、訂閱、流量入口與路由各自負責不同環節，依序設定更容易找出問題。先確認最基本的連線正常，再加入分流、DNS 與 TUN；每次只調整一項設定，記錄才有參考依據。
01 / 設定來源
確認取得的是可更新的訂閱網址，還是以 vmess://、vless:// 等開頭的單一節點連結。訂閱網址請填入「訂閱分組設定」，分享連結則使用剪貼簿匯入。網頁網址、登入頁網址與訂閱網址不一定相同，匯入前請先確認服務提供的說明。
02 / 代理入口
桌面版請啟用系統代理，Android 請完成 VPN 授權。節點出現在清單中，只代表匯入成功；用戶端已啟動且應用程式流量進入用戶端，才算開始測試連線。請先停止其他代理程式，避免連接埠遭占用、系統代理設定互相覆蓋或 VPN 衝突。
03 / 確認結果
使用日常瀏覽器造訪要測試的網站，並查看用戶端記錄是否出現連線資訊。確認可連線後，再選擇合適的路由模式。系統代理與「繞過區域網路及中國大陸位址」等路由選項屬於不同層級；切換路由不會自動補上遺漏的系統代理設定。
下載清單更新時，版本號也會變動；桌面用戶端和 Android 用戶端各自維護，不必追求版本號一致。是否升級，應依目前功能需求與版本變更評估。既有設定運作正常時，請先備份再更新；遇到問題時，記錄升級前後的差異，比反覆重新安裝更有幫助。完整步驟請參閱使用教學，平台細節請參閱全平台安裝與設定文件。
先分辨是安裝問題還是連線問題，再調整設定。
初次安裝可先選 Desktop 版，採用新一代跨平台介面。若熟悉傳統 Windows 介面，想延續既有操作習慣，則選擇 WPF 版。兩者都是 v2rayN；下載前請確認套件名稱，切換前先備份設定，也不要讓兩套用戶端同時接管系統代理。
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置實際支援的應用程式架構為準。無法確認架構時，可選通用版。安裝失敗也可能是下載中斷、系統版本、簽章衝突或安裝權限所致，不能只憑購買年份判斷。
安裝檔只包含用戶端程式，不含可直接使用的訂閱。訂閱網址或分享連結由你使用的服務或自行架設的伺服器提供。v2rayN 可在「訂閱分組設定」中儲存網址，再更新訂閱；v2rayNG 也可在「訂閱分組設定」中儲存網址，再更新訂閱。網址可能包含存取憑證，請勿公開分享。
先備份訂閱分組、路由設定與必要設定，再關閉舊用戶端。同一款應用程式且簽章相容時，Android 通常可直接覆蓋安裝；桌面版則依安裝程式提示更新。若遇到簽章衝突、改用不同發行套件或切換介面版本，請勿直接刪除舊資料，先確認新用戶端能否匯入設定。
先確認瀏覽器已完成下載，且檔案副檔名符合所選平台。Windows 的 ZIP 檔需先解壓縮；Android 使用 APK；macOS 使用 DMG；Linux 則依發行版選擇 DEB 或 RPM。下載中斷時可重新下載；若系統阻止安裝，請查看明確的系統提示，不要直接關閉所有安全防護。
安裝、匯入與啟動代理是三個不同步驟。先選取節點並啟動用戶端，再確認桌面版是否啟用系統代理，或 Android 是否已完成 VPN 授權。瀏覽器代理設定、其他代理程式、路由規則和 DNS 都可能影響結果。依照記錄中的具體錯誤逐項排查，避免一次修改多項設定。