桌面端選 v2rayN，Android 優先選 v2rayNG。確認作業系統與處理器後，再下載對應的安裝檔。
優先選桌面版；需要經典介面時，再選 WPF 版。
兩個下載連結都是 ZIP 壓縮檔。下載完成後請先解壓縮，再依套件中的安裝程式及指示繼續操作；請勿直接在壓縮檔預覽視窗中執行。
Desktop 是新一代跨平台 UI。首次安裝可從這個版本開始，透過圖形介面管理訂閱群組、選擇伺服器及調整設定。WPF 是經典穩定版。若已熟悉傳統版面，或希望沿用原有操作方式，可選擇 WPF。兩者不是不同的訂閱服務；同一份有效訂閱能否使用，取決於協定及目前核心的支援情況。
下載前請開啟「設定 → 系統 → 系統資訊」，查看系統類型。本頁的兩個 Windows 下載項目都是 x64 套件，請勿只憑電腦外觀判斷架構。安裝後先更新訂閱，再選擇伺服器及路由模式，最後啟用系統代理。請勿同時執行兩個版本並修改系統代理，否則其中一個版本結束時，另一個版本的代理設定也可能受到影響。
| 檢查項目 | 選擇與準備 |
|---|---|
| 處理器 | 需要 x64 系統與處理器；請在系統資訊中確認，勿將 x64 套件當作其他架構的原生安裝檔。 |
| 系統環境 | 確認目前發布版本支援所使用的 Windows 版本；執行階段元件請依安裝程式提示準備。 |
| 資料夾權限 | 解壓縮至可正常讀寫的位置，並保留設定檔所需的權限；升級前請先結束正在執行的客戶端。 |
| 代理權限 | 一般系統代理與 TUN 的權限需求不同；啟用 TUN 前，請依客戶端提示授予所需權限。 |
先在「關於這台 Mac」查看晶片，再選擇對應的 DMG。
M 系列晶片選 Apple Silicon；顯示 Intel 處理器時選 x64。請勿依購買年份推測晶片類型。
點選系統選單中的「關於這台 Mac」。若晶片欄位顯示 M 系列名稱，請下載 arm64 套件；若顯示 Intel 處理器，請下載 x64 套件。選擇原生架構可減少相容層帶來的額外變數。這兩個安裝檔是同一客戶端的不同架構版本，同一台電腦不需要同時安裝兩個。
開啟 DMG 後，依視窗指示將應用程式拖曳至「應用程式」，再從該處啟動。首次開啟若出現系統安全提示，請先確認應用程式來源及下載過程，再到系統設定查看該應用程式的處理選項。請勿為了啟動單一應用程式而關閉整台電腦的安全機制。啟動後匯入訂閱，確認更新成功，再設定代理。
macOS 系統代理通常依網路服務生效。切換 Wi-Fi、有線連線或其他網路環境後，若瀏覽器未使用預期的代理設定，請檢查目前網路服務的代理設定。結束客戶端前，先清除由客戶端設定的系統代理，避免本機代理連接埠停止監聽後，應用程式仍嘗試連線至舊連接埠。若要接管更多應用程式，再參閱 TUN 的權限與路由說明。
| 檢查項目 | 選擇與準備 |
|---|---|
| 處理器 | Apple Silicon 使用 arm64；Intel 使用 x64，請以「關於這台 Mac」顯示的資訊為準。 |
| 系統相容性 | 安裝前請確認目前版本對 macOS 的系統需求；舊版系統無法只靠更換晶片架構套件解決相容性問題。 |
| 應用程式位置 | 請將應用程式移至「應用程式」後再啟動，避免長期從已掛載的磁碟映像檔執行。 |
| 網路設定 | 允許所需的網路設定變更；請先了解流量接管範圍，再啟用 TUN。 |
優先選擇 v2rayNG；已有 V2Fly 設定時，可依實際需求選用 v2flyNG。
採用 Xray 核心。2015 年後推出的主流手機通常可先選 arm64；仍須確認系統支援 64 位元應用程式，不確定時請選通用版。
v2rayNG 將訂閱更新、設定選擇及連線開關整合在 Android 圖形介面中。首次安裝請先完成 APK 安裝，再開啟訂閱設定，填寫備註並貼上完整訂閱網址。儲存後執行更新訂閱，再回到設定清單選取要使用的伺服器。只貼上網址但未更新，不會自動產生可連線的設定。
首次連線時會出現系統 VPN 授權對話框，確認後才能建立本機流量接管通道。這是 Android 客戶端的運作方式，不代表訂閱已可使用。若裝置也在執行其他 VPN 類應用程式，請先停止其中一個再測試。若背景執行容易中斷，請檢查系統對 v2rayNG 的電池最佳化及背景執行限制，只調整與持續連線相關的設定。
採用 v2fly 核心。請先確認訂閱中的協定與傳輸設定，再決定是否使用此替代客戶端。
v2flyNG 適合需要 V2Fly 核心環境的使用情境。客戶端名稱相似，不代表核心功能完全相同；若訂閱使用較新的協定、傳輸方式或特定擴充功能，請依實際核心支援情況判斷。請勿把更換客戶端當成解決所有連線問題的通用方法；先查看更新結果及連線記錄會更有效。
從其他客戶端移轉時，建議重新新增既有訂閱連結，再檢查路由與 DNS 設定。兩個應用程式的資料目錄彼此獨立，安裝 v2flyNG 不會自動匯入其他應用程式的所有設定。若要進行對照測試，請先中斷原應用程式，再啟動新連線，以免兩個 VPN 工作階段互相取代，誤判為節點故障。
| 檢查項目 | 選擇與準備 |
|---|---|
| 應用程式架構 | 系統支援 64 位元應用程式時優先選 arm64；架構不明時選通用版，勿只依處理器名稱判斷。 |
| 系統相容性 | Android 版本須符合對應發布版本的安裝需求；通用版主要用於解決架構選擇問題，不保證相容所有舊版系統。 |
| 安裝權限 | 依系統提示允許目前使用的瀏覽器或檔案管理員安裝應用程式；安裝完成後可關閉該來源的安裝權限。 |
| 連線授權 | 首次啟動連線時，請確認系統 VPN 授權；若需要持續執行，請檢查背景執行與電池管理設定。 |
依發行版選擇 deb 或 rpm，再確認 x64 或 arm64 架構。
deb 常見於 Debian、Ubuntu 系列；rpm 常見於 Fedora、RHEL 系列。套件格式相符只是第一步，還要確認發行版版本及相依性是否相容。
先在系統資訊中查看發行版名稱及處理器架構。常見的 amd64、x86_64 對應本頁的 x64；aarch64 通常對應 arm64。請勿只憑裝置是桌上型電腦或開發板來判斷架構。下載後使用發行版的軟體安裝程式開啟套件，讓系統處理相依性；若提示函式庫版本不符合，請先確認此版本支援哪些發行版，勿強行略過相依性檢查。
Linux 桌面環境套用系統代理的範圍不盡相同。設定代理後，瀏覽器可能會使用桌面代理，但部分終端機工具或獨立應用程式仍使用自己的網路設定。因此，安裝成功、介面正常開啟，以及所有應用程式都經過代理，是三個需要分別確認的環節。請先用一個遵循系統代理設定的應用程式測試，再決定是否需要額外設定。
若需要使用 TUN，請依文件檢查虛擬網卡權限、路由及 DNS。請勿一開始就同時修改桌面代理、網路管理服務及防火牆規則；先保留可還原的基準設定，再逐項啟用功能。升級前請結束舊程序並備份設定，避免套件管理員完成更新後，仍由舊程序占用本機連接埠。
| 檢查項目 | 選擇與準備 |
|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm；請勿只修改副檔名來轉換套件格式。 |
| 處理器架構 | x64 請使用 amd64 或 x86_64 版本；arm64 請使用 arm64 或 aarch64 版本。 |
| 桌面環境與相依套件 | 需要可用的圖形桌面及目前版本所需的相依套件；缺少的項目會由系統安裝程式提示。 |
| 網路權限 | 一般桌面代理與 TUN 請分開設定；TUN 所需權限依客戶端及發行版需求處理。 |
安裝客戶端後，還需要設定訂閱、選擇伺服器及調整代理。依序完成，較容易找出問題發生在哪個步驟。
準備升級時，先記下目前客戶端使用的訂閱群組、路由模式及本機監聽連接埠。自訂路由、手動新增的伺服器及介面偏好設定，不一定包含在訂閱連結中；只保存訂閱網址不能取代完整的設定備份。請使用客戶端提供的匯出功能，或依文件備份設定資料夾，並將備份存放在只有自己能存取的位置。完成後結束舊客戶端，再安裝或啟動新版。
初次使用不需要為了完成安裝而調整大量進階選項。先保留預設的本機監聽設定，避免與其他正在執行的網路工具爭用連接埠。若提示連接埠已被占用，請檢查是否有舊程序仍留在系統匣或背景執行；勿連續啟動多個副本來嘗試解決。若安裝方式變動較大，請保留舊設定備份，等新版能正常啟動後再清理舊資料夾。
開啟訂閱群組設定，填寫方便辨識的備註，並貼上完整網址。注意移除複製時混入的空格及換行，請勿刪除網址中的參數。儲存只會登記更新來源，還要執行更新訂閱才能取得伺服器設定。若更新失敗，請先查看客戶端提示，分辨是網址無法存取、內容格式不符，還是帳戶狀態問題；不要反覆重裝與問題無關的客戶端。
訂閱網址通常包含存取憑證，請妥善保管，如同帳戶資料。向他人詢問問題時，請隱藏網址參數、帳戶識別資訊及其他敏感資料，只保留錯誤類型與必要的環境說明。客戶端免費使用與訂閱服務費用是兩回事；安裝軟體本身不會建立服務帳戶，也不會自動提供可用伺服器。
選取伺服器後，再啟用系統代理或 Android 連線。桌面端的系統代理只會影響採用該設定的應用程式，不代表裝置上的所有流量都已接管。路由模式則會決定進入客戶端的請求要直連、走代理或封鎖連線。若部分網站可用、部分應用程式無法使用，請先確認請求是否進入客戶端，再檢查規則的比對結果；不要直接把所有問題歸因於訂閱。
若需要使用 TUN，請先閱讀權限及 DNS 說明。TUN 可擴大流量接管範圍，但無法讓失效的訂閱恢復，也不能取代正確的路由規則。測試時一次只修改一項設定，並記錄修改前後的結果；若問題出現，先還原剛才的變更，通常比連續更換客戶端更容易找到原因。
第一次使用建議選 Desktop 桌面版，採用新一代跨平台介面。WPF 是經典穩定版，適合習慣傳統操作方式的使用者。兩者都屬於 v2rayN，請勿同時執行並控制同一組系統代理；切換前先備份設定。
2015 年後推出的主流手機通常可先選 arm64，但仍要確認系統能執行 64 位元應用程式。若無法確認架構，或安裝 arm64 時顯示不相容，請改選通用版。通用版包含多種架構元件，檔案通常較大，但不代表連線速度更快。
客戶端是用來管理設定及建立連線的工具，安裝檔不等於訂閱服務。請準備自己有權使用的訂閱連結，在訂閱群組中新增網址，再執行更新訂閱。訂閱網址可能包含存取憑證，請勿公開分享。
先結束舊版程式，並備份訂閱群組、路由規則及其他設定。能否直接覆蓋安裝，取決於安裝方式、原版本及新版的移轉需求，請勿假設所有版本都能直接覆蓋。若要更換安裝方式或介面分支，建議使用獨立資料夾，並依新版提示匯入設定。
頁面版本文字與安裝檔路徑是版本清單中的不同欄位，可能暫時未同步。請勿自行修改下載網址中的版本號。安裝後可在客戶端的「關於」頁面確認實際版本，再依功能需求判斷是否更新。
先確認訂閱已更新，且已選取可用伺服器，再檢查系統代理或 Android VPN 連線是否已啟用。桌面端若只設定系統代理，部分應用程式不會採用該設定；若要進一步接管流量，請參閱 TUN 文件。排查時只保留一個代理客戶端執行，並搭配記錄逐項檢查。