用戶端／安裝檔與架構
桌面版請選擇 v2rayN，Android 請選擇 v2rayNG。
先選擇作業系統，再確認處理器架構與安裝檔格式。下方提供桌面介面版本、晶片類型及通用版的個別下載入口，下載後依照相應系統完成安裝。
v2rayN · x64 · Desktop / WPF
兩種版本的主要差異在介面技術與操作布局，不代表 Desktop 和 WPF 使用不同的代理通訊協定。訂閱能否使用，仍取決於節點參數、選用的核心及傳輸設定是否相符。初次使用時先完成匯入並測試基本連線，再調整路由、DNS 與快速鍵。
下載完成後，先使用系統解壓縮功能，將 ZIP 內容完整解壓至可寫入的資料夾，再開啟解壓後的安裝程式，依畫面指示完成安裝。請勿直接在壓縮檔預覽視窗中執行程式。若出現缺少執行環境的提示，請依提示中的元件名稱處理；安裝路徑、所需環境及支援的系統版本，請以安裝程式實際說明為準。
從舊版移轉時，請先備份設定並結束原用戶端。新版介面不一定沿用舊版設定項目的位置，匯入後請重新確認伺服器選擇、監聽連接埠與系統代理狀態。測試期間只執行一個會接管系統代理的用戶端，避免舊程序占用連接埠或覆寫代理設定。
| 檢查項目 | 目前提供的版本 | 操作位置或說明 |
|---|---|---|
| 作業系統 | Windows 桌面環境 | 開啟「設定 → 系統 → 關於」，確認系統版本。 |
| 處理器架構 | x64 | 查看「系統類型」；本頁提供的兩種 Windows 安裝檔皆為 x64。 |
| 安裝格式 | ZIP 壓縮檔內含安裝程式 | 請完整解壓縮後再執行，勿只取出單一相依檔案。 |
| 執行條件 | 可寫入的資料夾與所需執行環境 | 依安裝程式提示處理相依套件；一般系統代理與 TUN 的權限需求不同。 |
v2rayN · Apple Silicon / Intel · DMG
請以系統資訊顯示的晶片類型為準，不要根據機型名稱或購買年份推斷。開啟左上角蘋果選單，選擇「關於這台 Mac」：若顯示「晶片」及 Apple M 系列名稱，請選擇 arm64；若顯示「處理器」及 Intel 名稱，請選擇 x64。使用符合架構的安裝檔，可減少額外相容層造成的差異。
開啟下載的 DMG，將 App 拖移至「應用程式」資料夾，再從該資料夾啟動。請勿長期從已掛載的磁碟映像檔執行，否則更新路徑與 App 位置可能不如預期。複製完成後可退出磁碟映像檔；更新既有 App 前，請先結束正在執行的程式並保留設定備份。
首次開啟時若出現系統提示，請先確認檔案來源與提示的具體原因，再前往「系統設定 → 隱私權與安全性」查看系統提供的處理選項。請勿為單一 App 全面關閉系統保護。允許啟動後，先使用一般系統代理測試匯入的設定，再依實際需求設定其他代理模式。
| 檢查項目 | 選擇依據 | 安裝注意事項 |
|---|---|---|
| 晶片類型 | Apple Silicon / Intel | 蘋果選單 → 關於這台 Mac，依顯示的晶片或處理器選擇。 |
| 安裝格式 | DMG | 掛載磁碟映像檔後，將 App 複製到「應用程式」資料夾，再從本機資料夾啟動。 |
| 系統相容性 | 請以目前 App 的需求為準 | 確認這台 Mac 的 macOS 版本；若無法啟動，請先查看系統提示。 |
| 權限條件 | App 啟動與代理設定權限 | 依系統提示授權；額外的網路接管模式可能需要較高權限。 |
建議先選擇 v2rayNG，再依設定需求考慮 v2flyNG。
v2rayNG 是採用 Xray 核心的 Android 圖形化用戶端，適合在手機上管理訂閱、匯入設定及切換伺服器。設定能否使用，仍取決於具體通訊協定與傳輸參數；成功匯入只代表用戶端能讀取設定項目，不表示一定能連上遠端伺服器。若遇到通訊協定相容性問題，請先參照設定來源的說明。
下載 APK 後，從瀏覽器的下載紀錄或檔案管理員開啟。若系統要求允許安裝此來源的 App，請只為目前使用的瀏覽器或檔案管理員開啟相應權限，安裝完成後可視需要關閉。啟動用戶端並首次連線時，系統會顯示 VPN 連線要求；確認 App 名稱後再授權。
v2flyNG 採用 V2Fly 核心，可作為設定明確針對該核心時的替代選項。它與 v2rayNG 並非只改了名稱的同一款 App，支援的功能與參數可能不同。尤其設定涉及特定核心擴充功能時，請勿假設同一個分享連結在兩款用戶端中會有相同結果。
兩款 App 可分別保留設定，但連線前應先停止另一款 App 的 VPN 工作階段。Android 同一時間的活動 VPN 通道會影響網路接管結果，頻繁切換啟動可能增加排查難度。若背景連線容易中斷，請先檢查系統電池管理對目前用戶端的限制，再確認是否有其他 VPN 類 App 接管連線。
| 檢查項目 | 選擇依據 | 操作說明 |
|---|---|---|
| 應用程式架構 | arm64 或通用版 | 處理器支援 64 位元，不代表系統一定允許安裝所有 64 位元 App。 |
| 安裝格式 | APK | 允許目前來源安裝；請確認系統安裝程式顯示的提示。 |
| 系統版本 | 請以目前 APK 的需求為準 | 開啟「設定 → 關於手機」查看 Android 版本。 |
| 網路權限 | Android VPN 授權 | 首次連線時確認系統要求；同一時間只保留需要使用的 VPN 連線。 |
| 更新條件 | 套件名稱、簽章與版本須相符 | 若提示無法覆蓋安裝，請先備份，避免直接解除安裝造成設定遺失。 |
v2rayN · deb / rpm · 主要提供 x64 版本
Linux 安裝時須同時確認處理器架構與套件管理系統。常見的 Intel、AMD 64 位元桌上型處理器通常選擇 x64，檔名可能標示 amd64 或 x86_64；64 位元 ARM 環境則選擇 arm64，部分檔名會標示 aarch64。名稱不同不代表 App 功能不同，而是安裝檔適用的處理器平台不同。
deb 與 rpm 格式取決於發行版的套件管理系統，不能只改副檔名轉換。下載後以系統套件安裝程式開啟，先查看架構、相依套件與衝突提示，再確認安裝。目前 rpm 檔名含有 el10 標記，不代表所有使用 rpm 的發行版都能直接安裝；若基礎函式庫版本不符，請停止安裝並確認系統環境。
此處提供的是圖形桌面用戶端，並非純終端機伺服器使用的部署套件。安裝完成後從應用程式選單啟動，先匯入設定並確認本機監聽，再設定桌面環境的代理。不同桌面環境與 App 讀取代理設定的方式可能不同；若瀏覽器可用、其他程式無法使用，請分別確認各程式是否遵循系統代理設定。
| 檢查項目 | 目前提供的版本 | 安裝前確認 |
|---|---|---|
| 執行環境 | Linux 圖形桌面環境 | 需要可啟動桌面 App 的工作階段與相應執行相依套件。 |
| 處理器架構 | x64 / arm64 | 在系統「關於」或硬體資訊中確認處理器架構。 |
| 套件管理系統 | deb / rpm | 依發行版選擇，不可只修改副檔名。 |
| 相依套件 | 以套件安裝程式的結果為準 | rpm 檔名帶有 el10 標記；請確認發行版與基礎函式庫的相容性。 |
| 安裝權限 | 系統套件安裝權限 | 安裝程式可能要求驗證；日常執行時，依所選代理模式授予所需權限。 |
安裝完成後
安裝檔負責安裝 App，訂閱與節點參數則決定連線目標。請依序檢查，避免同時修改多項設定。
01 / 設定來源
用戶端本身不提供伺服器帳號。請先準備有權使用的訂閱連結、分享連結或完整連線參數，再透過用戶端的訂閱管理、剪貼簿匯入等功能新增。訂閱網址可能包含帳號識別資訊或存取憑證，複製時請勿連同說明文字一起貼上，也不要將完整網址貼到公開討論區。
匯入後先確認群組是否顯示、項目數量是否符合預期，再選擇要使用的伺服器。訂閱更新失敗與伺服器連線失敗屬於不同環節：前者先檢查連結、網路與格式，後者再確認通訊協定、時間及傳輸設定。請勿反覆覆蓋安裝來處理訂閱格式問題。
02 / 連線入口
在桌面用戶端中，系統代理決定 App 是否將要求送至本機監聽連接埠；路由模式則決定進入用戶端的要求要使用哪個出站連線。這是兩個不同的設定層級。請先確認用戶端正在執行，再選擇自動設定系統代理；如果只匯入設定而未設定連線入口，瀏覽器不一定會使用代理。
Android 首次啟動連線時，必須授予系統 VPN 權限。若已有其他 VPN App 正在執行，請先決定要保留哪個連線。暫時不要同時加入複雜的 DNS、App 分流與自訂規則；先用基本設定建立可確認的連線，再逐項新增所需功能。
03 / 確認結果
開啟常用網頁，確認頁面載入與網域名稱解析是否正常，再查看用戶端記錄中的具體錯誤。若特定 App 無法連線，請先確認它是否使用系統代理，不要立刻更換安裝檔。若所有 App 都無法連線，請依序檢查伺服器選擇、本機連接埠占用、裝置時間與訂閱參數。
準備停止使用時，桌面版請先關閉系統代理再結束用戶端，避免 App 繼續連線至已關閉的本機連接埠。更新或移轉後也請重新確認代理狀態。詳細操作步驟請參閱使用指南；如需了解 inbounds、routing 與 dns 欄位之間的關係，可繼續閱讀JSON 設定手冊。
下載與安裝常見問題
第一次安裝建議選擇 Desktop 桌面版，採用新一代跨平台介面。若熟悉傳統桌面操作方式並希望延續原有使用習慣，可選擇 WPF 經典穩定版。兩種版本都是 x64 安裝檔；切換介面版本前請先備份設定，且勿同時執行兩個會接管系統代理的程式。
開啟蘋果選單中的「關於這台 Mac」。「晶片」若顯示 Apple M 系列，請選擇 Apple Silicon（arm64）；「處理器」若顯示 Intel，請選擇 Intel（x64）。依實際晶片選擇，不要只憑電腦購買年份判斷。
arm64 安裝檔適用於 64 位元 ARM 裝置，2015 年後的主流手機通常可優先選用。通用版支援多種架構，適合架構不明或專用版不相容的裝置。較新的處理器也可能搭配不同位元數的系統，仍應以裝置實際支援的應用程式架構為準。
用戶端提供設定管理與連線功能，但安裝檔不含可用的伺服器設定。請自行準備有權使用的訂閱連結或節點參數，匯入後選擇伺服器，再設定系統代理或授予 Android VPN 權限。訂閱連結可能包含存取憑證，請勿公開分享。
先記下目前用戶端名稱與設定檔位置，再使用用戶端提供的備份或匯出功能，保存設定、訂閱群組和自訂路由。更新前先關閉正在執行的用戶端，完成後檢查訂閱、監聽連接埠與代理模式。一般更新問題不必先刪除原有設定。
先確認發行版支援的套件格式與處理器架構，再查看系統套件安裝程式列出的相依套件名稱。deb 與 rpm 不能只靠更改副檔名互換；即使同為 rpm 的發行版，相依套件版本也可能不同。目前提供的 rpm 檔名帶有 el10 標記，安裝前請確認發行版環境符合套件需求。