v2rayN
首選7.24.1
兩個下載項目都是 ZIP 壓縮檔。請先完整解壓縮，再執行其中的安裝程式；不要直接從壓縮檔預覽視窗啟動。
用戶端安裝檔與架構選擇
V2Ray 下載
v2rayN 與 Android 用戶端
先選擇作業系統，再選擇處理器架構。桌面系統使用 v2rayN；Android 優先選用 v2rayNG，需要 V2Fly 核心時則可選 v2flyNG。
三款用戶端皆為免費開源軟體。安裝檔用於安裝用戶端；訂閱與伺服器設定需另外匯入。
初次設定：查看訂閱匯入與連線教學 →依平台選擇
用戶端安裝檔
不確定架構時，請先查看系統「關於」或裝置資訊，再下載對應檔案。
Windows 安裝檔
Windows 系統需求與準備
| 檢查項目 | 選擇與準備 |
|---|---|
| 系統與架構 | 本頁提供 Windows x64 套件。請在「設定 → 系統 → 關於」查看系統類型；x64 套件並非其他架構的原生套件。 |
| 執行環境 | 實際系統版本與執行階段需求，請以目前安裝程式的提示為準。若提示缺少執行階段元件，請先記下元件名稱與架構再處理。 |
| 目錄與權限 | 請使用目前帳戶可寫入的解壓縮目錄，並預留安裝與設定所需空間。一般系統代理測試不必一開始就啟用 TUN。 |
桌面版與 WPF 版的主要差異在於介面技術與操作配置，不代表訂閱會自動分成兩套不同的伺服器。初次安裝建議先選一個版本，完成訂閱匯入並測試瀏覽器連線後，再決定是否更換。比較兩個版本時，請先結束目前執行個體，以免本機監聽連接埠衝突，也避免把另一個執行個體的系統匣狀態誤認為目前設定。
已有設定的使用者，請先備份訂閱群組、路由與 DNS 設定，再升級或切換介面版本。安裝程式完成後，請確認啟動路徑與實際讀取的設定位置；不要只複製單一程式檔覆蓋舊目錄。若啟動時發生錯誤，請保留完整錯誤訊息，分辨是缺少執行環境、目錄權限不足或連接埠遭占用，再依原因排查。
macOS 安裝檔
v2rayN
桌面用戶端7.24.1
開啟 DMG 後，依安裝視窗的指示放置應用程式。安裝完成後，請從「應用程式」資料夾啟動，避免一直從磁碟映像檔執行。
macOS 系統需求與準備
| 檢查項目 | 選擇與準備 |
|---|---|
| 晶片類型 | 在系統選單中開啟「關於本機」，依晶片或處理器欄位選擇 Apple Silicon 或 Intel 套件。 |
| 系統版本 | 應用程式的具體系統版本需求，請以目前發行套件的說明為準；架構正確不代表系統版本一定符合需求。 |
| 網路權限 | 首次設定代理或啟用虛擬網路介面時，請閱讀系統授權說明，只授予目前操作所需的權限。 |
先確認晶片類型，再開啟對應的磁碟映像檔。安裝完成後，請退出磁碟映像檔並從「應用程式」資料夾重新啟動用戶端，確認設定能正常儲存。若系統提示無法開啟應用程式，請先閱讀提示中的具體原因，釐清是來源驗證、系統版本還是應用程式架構問題；不要把所有提示都當成同一種故障，更不要直接關閉全系統安全防護。
首次連線可先從系統代理開始，先測試會遵循系統代理設定的瀏覽器，再測試其他應用程式。命令列程式不一定會讀取系統代理；若瀏覽器正常但終端機請求失敗，不能據此判定用戶端安裝有誤。若要讓更多應用程式使用代理，請先閱讀 TUN 模式說明，確認權限、DNS 與路由設定後再逐項啟用。
Android 安裝檔
v2rayNG
首選 · Xray 核心2.2.6
適用於 Android 上的訂閱匯入、伺服器選擇與路由設定。啟用連線時，請確認系統 VPN 授權。
v2flyNG
備選 · V2Fly 核心1.10.31
若有明確的核心需求，可將 v2flyNG 作為備選；初次使用者可先依照 v2rayNG 的流程完成設定。
Android 系統需求與準備
| 檢查項目 | 選擇與準備 |
|---|---|
| 應用程式架構 | 請優先確認裝置支援的應用程式架構。處理器支援 64 位元，不代表目前系統一定提供完整的 64 位元應用程式環境。 |
| 系統相容性 | 請以 APK 安裝程式顯示的系統需求為準。通用套件解決的是架構涵蓋問題，不會降低應用程式的系統需求。 |
| 安裝與連線授權 | 只為實際用來開啟 APK 的瀏覽器或檔案管理員授予所需的安裝權限；首次連線時，請確認系統 VPN 授權。 |
| 背景執行 | 若鎖定螢幕後連線中斷，請檢查電池最佳化與背景執行限制，並確認系統中是否有其他 VPN 應用程式占用連線。 |
下載 APK 後，請從下載紀錄或檔案管理員開啟並安裝。若安裝失敗，先查看錯誤內容：架構不符、系統版本過舊、儲存空間不足與簽章衝突是不同問題。沒有備份前不要直接解除安裝舊用戶端；若已有訂閱或自訂規則，請先使用匯出功能保存，再決定是否重新安裝。
v2rayNG 與 v2flyNG 都是圖形介面用戶端，但各自核心支援的設定項目可能不同。訂閱可以匯入，只代表用戶端能辨識相應格式，不代表其中每種連線參數都能正常運作。若服務提供者指定用戶端或核心需求，請優先確認是否符合；切換用戶端前記下原本的傳輸、安全與路由設定，避免把設定差異誤判為網路故障。
開啟連線按鈕後，系統通常會透過 VPN 介面接管符合設定的流量。這個介面是本機處理流量的機制，流量是否經由代理出口仍由路由規則決定。初次排查時建議只開啟一個代理用戶端，先測試一般網頁，再檢查需要特殊分流的應用程式；不要同時修改應用程式分流、DNS 與背景執行策略，否則難以判斷是哪項變更影響結果。
Linux 安裝檔
v2rayN
圖形介面用戶端7.24.1
先確認套件管理系統，再確認處理器架構。deb 與 rpm 代表不同套件格式，不是介面版本差異；不建議只改副檔名或強制轉換後安裝。
Linux 系統需求與準備
| 檢查項目 | 選擇與準備 |
|---|---|
| 桌面環境 | 本頁提供圖形介面用戶端，須具備可用的圖形桌面工作階段；僅有終端機的環境不適用此安裝流程。 |
| 套件管理系統 | 依發行版使用的套件管理工具選擇 deb 或 rpm。副檔名相符只是第一步，仍須符合系統程式庫相依性。 |
| 架構名稱 | amd64、x86_64 通常對應 x64；arm64、aarch64 則對應 ARM 64 位元。下載前請確認系統實際架構。 |
| 權限與網路模式 | 安裝套件與啟用虛擬網路介面可能需要不同權限。請先以一般使用者啟動介面，再依功能提示處理權限。 |
從系統設定查看發行版與處理器資訊，選好套件後使用系統的軟體安裝程式開啟。若套件管理工具回報相依性不符，請先確認缺少的程式庫與版本需求，不要略過相依性強制安裝。副檔名相同不代表不同發行版之間必然相容，架構正確也不能取代系統程式庫版本檢查。
啟動後先匯入一組訂閱，再於支援代理設定的應用程式中測試連線。Linux 桌面環境實作系統代理的方式可能不同，有些命令列程式也需要另外設定代理環境變數。TUN 涉及路由、介面權限與 DNS，建議基本連線正常後再啟用；測試結束後請確認系統路由已恢復，避免殘留設定影響後續判斷。
下載之後
安裝與初次連線
先完成最基本的可用設定，再逐項加入路由、DNS 與 TUN 設定。
先安裝，再匯入訂閱
安裝完成後，請準備有效的訂閱網址或分享連結。訂閱網址通常含有存取權限資訊，請妥善保管，勿將完整連結放進公開截圖、討論區或故障紀錄。新增訂閱群組後執行更新，確認伺服器清單已載入，再選擇一項測試連線。
若清單為空，請先檢查訂閱是否過期、群組是否已啟用，以及更新紀錄中的具體提示。反覆重新安裝用戶端通常無法解決訂閱網址失效的問題。手動匯入分享連結時，也請確認複製內容完整，避免混入空格、說明文字或不完整的參數。
查看訂閱匯入步驟 →先測試，再調整網路模式
桌面端可先使用系統代理測試瀏覽器；Android 則先確認 VPN 介面授權。網頁能正常開啟後，再驗證路由結果是否符合預期。系統代理只會影響遵循該設定的應用程式，不能根據單一程式的結果推論所有程式都採用相同的連線路徑。
路由規則、DNS 與 TUN 會影響不同環節。修改前先記下原值，每次只調整一個項目，並以相同目標重複測試。若發生問題，先還原最近修改的選項，再檢查紀錄中的出口與解析結果；比起同時切換多項功能，這樣更容易找出原因。
查看路由規則說明 →安裝檔與更新
下載常見問題
Windows 初次安裝，該選桌面版還是經典 WPF 版？
第一次使用可先選桌面版 Desktop，採用新一代跨平台介面；若習慣經典介面或需要沿用既有操作流程，則可選擇穩定的經典 WPF 版。兩者都是 v2rayN 用戶端。安裝前請先備份現有設定，測試時只執行一個執行個體。
Android 該選 arm64 還是通用版？
2015 年後推出的主流手機通常可優先選擇 arm64，但仍應以裝置支援的應用程式架構為準。若無法確認架構，或 arm64 套件提示不相容，可改試通用版。通用版不代表支援所有系統版本，也無法解決簽章衝突。
v2rayNG 和 v2flyNG 該怎麼選？
Android 建議優先使用採用 Xray 核心的 v2rayNG；若需要 V2Fly 核心的行為或已有相應設定，可選擇 v2flyNG。請先確認服務提供者要求的協定、傳輸方式與安全參數，再選擇用戶端；不要只憑訂閱連結的外觀判斷相容性。
下載後顯示無法安裝，應該先檢查什麼？
先確認作業系統、處理器架構與套件格式是否相符，再查看系統顯示的具體錯誤。Windows 壓縮檔應先完整解壓縮；Android 請檢查安裝來源權限與簽章衝突；Linux 請確認套件管理工具的相依性；macOS 則檢查晶片類型與系統安全性提示。請勿直接關閉全系統安全防護。
安裝用戶端後就能連線了嗎？
安裝只代表用戶端已準備就緒，還需要有效的訂閱網址、分享連結或設定檔。請先匯入訂閱並更新伺服器清單，再選擇伺服器，視需要啟用系統代理或 VPN 介面，最後確認目標應用程式的流量是否經由預期的出口。
升級前需要保留哪些設定？
請先使用用戶端提供的備份或匯出功能，保存訂閱群組、路由規則、DNS 設定與自訂出口，並記下原本的網路模式。備份可能包含訂閱網址及存取憑證，請存放在安全的位置。升級後先確認設定可正常讀取，再逐項測試連線與分流。