CLIENT PACKAGES / 平台與架構
桌面平台選 v2rayN；Android 優先選 v2rayNG，使用 V2Fly 設定環境則可考慮 v2flyNG。先選作業系統，再確認處理器架構與安裝套件格式。
x64 安裝套件 · Desktop / WPF
新一代跨平台 UI。第一次安裝可從此版本開始，以一致的桌面介面管理訂閱、伺服器與路由設定。
ZIP / x64 / Windows
經典穩定版，採用 Windows WPF 介面。適合熟悉原有選單位置，或希望沿用既有桌面操作流程的使用者。
ZIP / x64 / Windows
兩種下載版本採用不同介面，不代表連線品質有高低之分。連線結果取決於伺服器參數、核心支援與網路路徑。切換版本前請先備份設定並結束舊版程序，避免重複占用相同的本機監聽連接埠。
| 檢查項目 | 選擇依據 |
|---|---|
| 作業系統 | 請使用仍在維護支援期間的 Windows 桌面系統；最低版本需求請以所選套件的安裝提示為準。 |
| 處理器架構 | 本頁提供的兩個下載版本皆為 x64。可在「設定 → 系統 → 系統資訊」查看系統類型。 |
| 套件與執行環境 | 下載檔案為 ZIP，請先解壓縮，再執行其中的安裝程式。若提示缺少執行環境，請依安裝指示處理，勿安裝其他架構的元件。 |
| 權限 | 一般啟動與系統代理設定請依客戶端提示操作；啟用 TUN 時可能需要管理員權限。 |
請將壓縮檔解壓縮至可寫入的獨立資料夾，不要直接在壓縮檔預覽視窗中啟動。安裝完成後，先匯入一組有效設定並確認連線正常，再設定開機啟動。若已有其他代理程式在執行，請先確認由哪個程式管理系統代理。
依「關於這台 Mac」中的晶片資訊選擇 DMG
適用於「晶片」欄顯示 Apple M 系列的裝置。建議優先使用符合處理器架構的原生版本，不必只因檔名不同就改選 Intel 版本。
DMG / arm64 / macOS
適用於「處理器」欄顯示 Intel 的裝置。外觀和購買年份不能取代晶片資訊，下載前請直接查看系統中的硬體資訊。
DMG / x64 / macOS
開啟 DMG 後，依安裝視窗指示將應用程式拖移至「應用程式」資料夾，再從該資料夾啟動。首次開啟若出現系統安全性提示，請先確認檔案來源與應用程式名稱，再依系統提供的單一應用程式授權流程操作。
| 檢查項目 | 選擇依據 |
|---|---|
| 晶片 | 在蘋果選單的「關於這台 Mac」查看裝置使用 Apple Silicon 或 Intel，分別對應 arm64 與 x64。 |
| 系統版本 | 所選應用程式套件必須支援目前的 macOS 版本；最低需求請以安裝時顯示的相容性提示為準。 |
| 安裝位置 | 請先將應用程式移至「應用程式」資料夾再啟動，避免長期從掛載的磁碟映像檔執行。 |
| 網路權限 | 系統代理或 TUN 可能會觸發授權要求。請確認操作來自目前使用的客戶端，再依提示授予必要權限。 |
安裝完成不代表流量已開始接管。請先確認伺服器設定，再選擇系統代理或符合需求的接管方式。若系統中有其他網路工具，請記下其代理與 DNS 設定，避免排查時同時修改多個程式。
優先選 v2rayNG · v2flyNG 為 V2Fly 核心替代選項
2015 年後的主流手機通常可優先選 arm64。也請確認系統支援 64 位元應用程式，不能只依處理器名稱判斷。
APK / arm64-v8a
不確定應用程式架構時可選用。通用套件包含多種架構元件，下載檔通常較大，且仍受最低系統需求限制。
APK / universal
v2rayNG 使用 Xray 核心。匯入連線後，請確認伺服器位址、連接埠、協定與傳輸選項。首次啟動連線時，Android 會要求授予 VPN 連線權限。此權限用於接管本機流量，不代表已自動取得伺服器連線參數。
適用於支援 arm64 應用程式，且需要使用 V2Fly 核心設定的裝置。安裝前請確認所需協定與傳輸方式受此客戶端支援。
APK / arm64-v8a
適用於尚未確認處理器架構的安裝情況。此版本與 arm64 套件屬於同一款客戶端，選擇依據是裝置相容性，而非節點速度。
APK / universal
v2flyNG 和 v2rayNG 使用不同核心，並非同一核心的兩種主題。若已有 V2Fly 設定，請先確認協定與欄位支援情況，再決定是否使用。移轉連線資訊後，請重新檢查 DNS、路由與接管設定，不要直接覆蓋另一個客戶端的所有設定檔。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統相容性 | 請以 APK 安裝程式提示的最低 Android 版本及應用程式架構支援為準。 |
| 架構 | 支援 64 位元應用程式的主流裝置可選 arm64；不確定時可嘗試通用版。 |
| 安裝權限 | 僅授予這次用來開啟安裝套件的瀏覽器或檔案管理器必要的安裝權限，完成後可撤銷。 |
| 流量接管 | 首次連線時需確認 VPN 權限；通常同一時間只能由一個 VPN 服務接管流量。 |
| 背景執行 | 若鎖定螢幕後連線中斷，請檢查電池最佳化與背景執行限制，再依裝置系統的設定項目調整。 |
若出現「未安裝應用程式」提示，請先查看完整錯誤說明。架構不符、系統版本過舊、儲存空間不足，或已安裝版本的簽章不同，都可能造成安裝失敗。請勿立刻解除安裝既有應用程式；先匯出設定，確認備份可用後再處理安裝衝突。
先依發行版選套件格式，再選 x64 / arm64
使用 DEB 套件管理系統的桌面發行版請選此格式。檔名中的 amd64 代表 x64 架構，也適用於相同架構的 Intel 處理器。
使用 RPM 套件管理系統的桌面發行版請選此格式。相依套件與發行版相容性仍須透過套件管理器確認，不能只看副檔名判斷是否適用。
請使用發行版提供的圖形化軟體安裝工具開啟安裝套件，先閱讀相依套件與變更提示，再確認安裝。軟體選單出現 v2rayN 後，即可從桌面啟動。若啟動失敗，請優先查看套件管理器提供的相容性資訊，不要反覆改用架構不符的套件。
| 檢查項目 | 選擇依據 |
|---|---|
| 桌面工作階段 | 需要能執行圖形應用程式的桌面環境。本頁提供桌面客戶端，不適用於沒有桌面環境的伺服器部署。 |
| 套件格式 | Debian、Ubuntu 系列通常選 DEB；Fedora 等 RPM 系列則選 RPM，並確認個別套件的相依性需求。 |
| 處理器架構 | x64 對應 amd64 或 x86_64；arm64 對應 arm64 或 aarch64。請以系統硬體資訊為準。 |
| 權限與相依套件 | 安裝由圖形化套件管理器處理；TUN 與系統網路設定可能需要另外授權。 |
安裝後請先確認圖形介面、設定匯入及本機監聽都正常，再新增桌面自動啟動項目。系統代理是否會被應用程式採用，取決於桌面環境與應用程式本身的行為；TUN 則需另行檢查權限、路由及與其他網路工具的衝突。
安裝套件只負責部署客戶端；連線設定、代理模式與連線測試是後續的獨立步驟。
完成以上步驟後，請使用實際需要連線的應用程式測試，並查看客戶端記錄中的錯誤類別。連線逾時、驗證失敗與網域名稱解析失敗的排查方向各不相同。不要只憑一次測試就解除安裝重裝，也不要同時調整協定、DNS、路由與代理模式，以免失去可供比對的基準。
分別檢查安裝更新、連線參數與核心相容性，避免將不同問題混為一談。
更新客戶端通常不必更換伺服器，但介面、預設選項與設定轉換方式可能有所變動。請先記下目前可用的伺服器、監聽連接埠、路由模式與 DNS 設定，結束執行中的客戶端後再安裝。更新完成後，確認訂閱仍在、目前伺服器正確，且系統代理符合預期。
需要回復舊版時，請優先使用更新前匯出的備份。舊版本未必能辨識新版寫入的所有設定，能開啟設定檔不代表完全相容。Desktop 與 WPF 之間移轉也應遵循相同原則。
Project V 生態系包含不同的核心實作。v2rayNG 採用 Xray，v2flyNG 使用 V2Fly；桌面版 v2rayN 實際採用的核心，請以客戶端介面與連線設定為準。即使協定名稱相同，也不代表各核心完全支援相同的擴充傳輸選項、TLS 參數與路由欄位。
請先依伺服器設定需求選擇客戶端，再確認協定與傳輸方式是否支援。不要將 Android 某個客戶端的所有設定直接覆蓋到另一個客戶端。欄位用途可參考設定欄位文件；名詞差異則可查看名詞解釋。
查看協定與核心名詞 →先確認套件格式、架構和系統提示，再檢查客戶端設定。
第一次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。習慣經典 Windows 介面或想沿用原有操作流程，可選擇穩定的經典 WPF 版。兩者都需匯入有效的連線設定；切換介面前請先備份訂閱、路由與設定，也不要同時啟動兩個客戶端，以免占用相同連接埠。
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置系統支援的應用程式架構為準。有些裝置雖採用 64 位元處理器，系統卻只支援 32 位元應用程式。若不確定架構，或 arm64 套件顯示不相容，可改試通用版；但通用版不保證相容所有舊系統。
客戶端安裝套件不含可直接使用的伺服器連線參數。請先準備有權使用的訂閱網址或單一連線設定，再匯入設定、選擇伺服器、設定代理模式並測試連線。訂閱網址可能包含存取憑證，請勿公開貼在截圖或討論區。
先使用目前客戶端的匯出或備份功能，保存訂閱、伺服器與自訂規則，並記下系統代理及 TUN 設定，再結束客戶端並進行更新。不同介面、客戶端或核心的設定目錄不一定能直接互通。更新後先檢查設定與監聽連接埠，再恢復代理接管。
先確認作業系統、處理器架構與套件格式，並確認下載已完成。Windows 套件為 ZIP 壓縮檔，須先解壓縮；macOS 請依晶片選擇對應的 DMG；Android 請檢查應用程式安裝權限與架構相容性；Linux 則可透過圖形化套件管理器查看相依性。請勿為了開啟安裝套件而停用整個系統的安全防護。
兩者分別採用 Xray 與 V2Fly 核心，對協定、傳輸方式和擴充欄位的支援可能不同。常見連線資訊可依客戶端支援的方式重新匯入，但不要假設所有設定或原始 JSON 都能原封不動地移轉。移轉前先備份，再逐項確認伺服器參數、TLS、傳輸方式、DNS 與路由規則。