v2rayN
優先推薦 Windows · x64Desktop 是新一代跨平台介面，WPF 則是經典穩定版。初次安裝可先選 Desktop；想沿用經典介面與操作習慣，則可選 WPF。
客戶端安裝檔・平台與架構
V2Ray 客戶端下載
桌面版建議選 v2rayN，Android 優先選 v2rayNG。先確認作業系統與處理器，再下載對應的安裝檔。
VMess
VLESS
Trojan
Shadowsocks
客戶端永久免費且原始碼開放。連線所需的訂閱或節點設定須另行準備，協定支援情況則取決於所選核心與具體設定。
選擇作業系統
點選平台查看對應客戶端。安裝說明與系統需求會隨平台切換；也可以保留目前頁面網址，以便下次造訪。
Windows 系統與執行需求
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 系統與架構 | 目前下載入口為 Windows x64 版 | 請在系統設定的「關於」頁面確認系統類型；其他架構不可直接套用。 |
| 執行環境 | 依所選發行版本需求準備 .NET 等相依元件 | 缺少執行階段可能導致介面無法啟動，與訂閱是否有效是兩回事。 |
| 權限與網路 | 一般代理與 TUN 的權限需求不同 | 先完成基本連線；需要使用 TUN 時，再依提示授予相應權限。 |
先將安裝檔儲存至本機，再解壓縮到可正常讀寫的資料夾。請勿直接從壓縮軟體的預覽視窗執行程式，否則相依檔案可能不會一併解壓。安裝完成後正常啟動客戶端；若出現缺少執行環境的提示，請先安裝提示指出的相依元件，不要反覆匯入訂閱。
首次連線建議只啟用一種流量接入方式。先匯入設定並選取節點，再使用自動設定系統代理，確認瀏覽器是否遵循系統設定。此時不必同時啟用 TUN。有些應用程式會自行管理代理，不會隨系統代理設定變動；請先確認基本連線正常，再個別處理。
Desktop 與 WPF 的介面配置可能不同，請勿只依照舊截圖尋找選單位置。切換前先匯出需要保留的設定，並分別確認訂閱群組、路由與本機監聽連接埠。若保留兩個安裝目錄，平時只執行其中一個，避免連接埠與系統代理狀態互相覆蓋。
v2rayN
macOS · Desktop使用桌面圖形介面管理訂閱、節點與路由。先在「關於本機」查看晶片資訊：Apple Silicon 請選 arm64，Intel 處理器請選 x64。
macOS 系統與安裝需求
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 處理器 | Apple Silicon 對應 arm64；Intel 對應 x64 | 從系統選單開啟「關於本機」，查看晶片或處理器名稱。 |
| 系統版本 | 須符合目前 Desktop 發行版本的需求 | 較舊的系統請先查看應用程式相容性提示，不保證所有系統版本皆可執行。 |
| 應用程式與權限 | 從本機應用程式資料夾啟動，依功能授予權限 | 首次開啟若遭系統阻擋，請先確認來源與系統提示，再決定是否允許。 |
開啟 DMG 後，依安裝畫面指示將應用程式移至應用程式資料夾，再從該資料夾啟動。磁碟映像只是安裝媒介，不建議長期從映像中執行。應用程式啟動後，先匯入訂閱並確認清單中出現有效設定，再設定系統代理與路由預設值，逐步測試連線。
系統安全提示與網路連線失敗應分開處理。前者發生於應用程式啟動階段，請查看系統設定中的相關提示；後者發生於客戶端已執行後，請查看核心記錄與設定參數。不要為了略過一次確認而全面關閉系統安全機制，也不要把權限問題直接歸咎於訂閱失效。
若之前使用過其他代理工具，切換前請先關閉舊工具，並檢查是否有殘留的系統代理設定。客戶端關閉後仍無法直接連上網路時，優先檢查系統網路設定中的代理項目。恢復基本網路後，再逐項啟用新客戶端的功能，避免多個背景程序同時修改相同設定。
v2rayNG
優先推薦 Xray 核心Android 優先推薦。透過 Android VPN 介面接管流量，支援匯入訂閱與個別應用程式設定。2015 年後的主流手機通常可先選 arm64，但仍須確認系統支援 64 位元應用程式。
v2flyNG
替代選項 v2fly 核心需要使用 v2fly 核心生態系時，可選擇這款 Android 替代客戶端。下載前請確認現有訂閱的協定與傳輸參數可由相應核心辨識，不同核心的功能範圍並不完全相同。
Android 系統與授權需求
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 架構與系統 | arm64 安裝檔需要系統支援 64 位元應用程式 | 硬體支援不代表系統一定支援；不確定時請查看裝置資訊或選擇通用版。 |
| 安裝授權 | 安裝 APK 須允許目前來源安裝應用程式 | 只需依需求授權目前使用的瀏覽器或檔案管理員。 |
| VPN 介面 | 啟動代理時，確認系統 VPN 連線要求 | 避免同時執行其他占用 VPN 介面的應用程式。 |
| 背景執行 | 省電策略可能影響持續連線 | 視需要調整背景活動與電池最佳化設定，重新啟動後再次確認連線狀態。 |
下載完成後，從通知列或檔案管理員開啟 APK。若系統顯示無法安裝，請先確認是否為架構不符、系統版本過舊，或已安裝的應用程式與新安裝檔簽章不一致。請勿直接解除安裝唯一保存設定的應用程式；先匯出訂閱與自訂節點，再決定是否需要重新安裝。
首次啟動代理時，系統會顯示 VPN 連線要求。這是授權客戶端將選定應用程式的流量交由本機代理處理，不代表安裝後會自動取得遠端服務。請先匯入設定並選取節點，再允許連線。若同時啟用了其他 VPN 類應用程式，請先停止其中一個。
背景連線容易中斷時，先檢查系統是否限制客戶端的背景活動，以及螢幕關閉後是否暫停網路。也要確認個別應用程式代理的包含與排除範圍：修改應用程式範圍後，通常需要重新建立連線。測試時先維持預設範圍，再逐步加入自訂排除項目，較容易找出問題。
v2rayN
Linux · Desktop依發行版選擇 deb 或 rpm，再核對處理器架構。下方主要下載入口為 x64；使用 ARM 桌面環境時，請選擇對應的 arm64 安裝檔。
deb 安裝檔
Debian 系Debian、Ubuntu 等通常使用此格式。請以系統軟體安裝程式開啟，查看相依性提示後再確認安裝。
Linux 系統與相依套件需求
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 套件管理系統 | Debian 系通常使用 deb；RPM 系通常使用 rpm | 請依發行版名稱與軟體安裝程式提示判斷，勿混用套件格式。 |
| 處理器架構 | x64 對應 amd64 或 x86_64；arm64 對應 aarch64 | 請在系統資訊中確認架構，不要以發行版名稱代替架構判斷。 |
| 桌面環境與系統函式庫 | 須符合圖形介面與目前發行版本的相依需求 | 請由套件管理員檢查相依套件；系統函式庫過舊時，不建議強制忽略相依性。 |
| 代理與權限 | 應用程式是否遵循系統代理，取決於桌面環境與應用程式 | 先測試基本代理；TUN 權限與路由設定請另外處理。 |
先使用桌面環境提供的軟體安裝程式開啟安裝檔，查看套件管理員列出的相依關係。若系統函式庫版本不符，請先確認該發行版本是否適用於目前系統。安裝格式相同只代表套件管理方式相近，不保證能在不同發行版之間直接相容。
安裝後從應用程式選單啟動 v2rayN，匯入設定並查看啟動記錄。瀏覽器、桌面應用程式與終端機程式讀取代理設定的方式可能不同：桌面系統代理正常，不代表每個程式都會自動遵循。請先用一個確定會遵循系統代理的應用程式測試，再處理其他程式的連線方式。
需要使用 TUN 時，再檢查目前使用者權限、虛擬網卡與現有路由。不要只為了測試單一功能，就讓所有桌面程式長期以高權限執行。若連線後區域網路存取異常，先撤回剛新增的路由設定，確認預設網路恢復後，再細調略過規則。
下載後的設定步驟
安裝只是第一步。依序匯入設定、啟用代理並測試連線，較容易找出問題。
先準備設定，再啟用代理
客戶端是本機管理工具，訂閱網址則是取得一組連線設定的入口。複製完整網址後，在訂閱群組中新增來源並更新；若取得的是單一節點分享連結，請使用從剪貼簿匯入等對應功能。兩種內容看起來都像連結，但匯入位置不同，不能只靠網址長度判斷。
訂閱更新完成後，先確認清單中出現預期設定，再選取一個節點作為目前連線。暫時不要大量修改協定、傳輸方式或安全參數，這些設定必須與伺服器端一致。若更新後清單為空，請先檢查網址有效性、網路是否可連線及訂閱格式，不要盲目切換代理模式。
分清系統代理、路由與 TUN
系統代理決定遵循系統設定的應用程式如何將流量交給客戶端；路由決定客戶端收到流量後如何分流；TUN 則是另一種流量接入方式。三者各自負責不同環節。初次使用桌面客戶端時，建議先透過系統代理測試，確認基本連線正常後，再考慮接管更多流量。
Android 客戶端透過系統 VPN 介面接管指定範圍的流量，須確認授權與目前連線狀態。桌面版與 Android 版的選項名稱不一定完全相同，但檢查方式一致：設定有效、核心正常執行、應用程式流量進入客戶端，且路由符合預期。每次只修改一個環節，避免多個問題交錯。
需要查看具體選單操作，請接著閱讀 v2rayN 設定教學；想了解核心選擇、TUN 與日常維護，可參閱 從入門到進階手冊。設定異常時請保留必要的錯誤資訊；分享截圖前，務必遮蔽訂閱網址、節點憑證與個人網路資訊。
升級與設定遷移
升級前先匯出訂閱群組、自訂節點、路由規則及需要保留的設定。訂閱可以重新取得伺服器端設定，但不會自動還原所有本機偏好；僅在本機手動新增的內容，更需要另外保存。
先停止代理並關閉客戶端，再替換程式。跨介面或跨核心遷移時，優先使用應用程式提供的匯入與匯出功能，不要直接覆寫用途不明的設定檔。新版啟動後，先測試一個連線，再還原自訂分流及其他進階設定。
請保留舊設定備份，直到新環境運作正常。若遇到問題，先記錄錯誤訊息與最近修改項目，恢復到確定可用的狀態後再逐項重試。備份若含訂閱或連線憑證，請存放於受控位置，勿放入公開分享資料夾。
下載與安裝常見問題
優先確認安裝檔類型與執行環境，再檢查連線設定。
下載客戶端後，是否已內含可用的連線設定？
客戶端負責讀取設定、啟動核心及管理代理，安裝檔不會附帶連線服務。首次使用前，請準備可信來源的訂閱網址或節點分享連結，再匯入客戶端。訂閱網址可能包含存取憑證，請勿公開截圖或轉傳。
Windows 應該選 Desktop 還是 WPF 版？
Desktop 採用新一代跨平台介面，適合初次安裝或希望在不同桌面系統維持相近操作習慣的使用者；WPF 則是經典穩定版，適合熟悉傳統 Windows 介面的使用者。兩者都須依實際發行需求準備執行環境，切換前請先備份設定。
Android 要下載 arm64 還是通用版？
2015 年後的主流手機通常可優先選擇 arm64，但仍須確認系統支援 64 位元應用程式。若無法確認架構，或 arm64 安裝檔顯示不相容，可改試通用版。通用版支援較多架構，檔案通常較大；安裝檔較大不會提升連線品質。
升級前需要備份哪些資料？
先備份訂閱群組、自訂節點、路由規則及重要設定，再停止代理並關閉舊版客戶端。建議使用客戶端內建的匯出功能，並妥善保存備份檔。確認新版能匯入設定並成功連線後，再清理舊目錄；請勿直接刪除唯一一份本機設定。
安裝完成後網頁仍無法連線，該先檢查什麼？
先確認設定已成功匯入且已選取節點，再檢查核心是否啟動、系統代理或 VPN 是否開啟，以及本機連接埠是否被占用。接著核對系統時間、伺服器參數與路由規則。每次只修改一項設定，透過記錄檔找出錯誤，避免同時開啟多個代理客戶端。
Linux 應選 deb 還是 rpm 安裝檔？
依發行版使用的套件管理系統選擇：Debian、Ubuntu 等通常使用 deb；Fedora、RHEL 系發行版通常使用 rpm。也要核對 x64 或 arm64 架構，以及安裝檔要求的系統函式庫版本。同為 rpm 或 deb，不代表所有發行版版本都能直接安裝。