桌面平台選擇 v2rayN，Android 優先選擇 v2rayNG。先確認處理器架構，再下載對應格式；安裝完成後前往訂閱群組，匯入既有訂閱。
選擇作業系統與安裝檔 ↓先選擇作業系統，再確認卡片上的架構與封裝格式。版本資訊會隨下載清單更新，安裝相容性仍須視裝置環境判斷。
在同一張用戶端卡片中選擇介面版本。Desktop 桌面版採用新一代跨平台 UI；傳統 WPF 版保留 Windows 經典介面，是經典穩定版。若已習慣 WPF，可繼續使用；首次安裝則可先從 Desktop 開始。
採用新一代跨平台 UI。下載 ZIP 後請先解壓縮，再執行其中的安裝程式；不要直接從壓縮檔預覽視窗啟動。
Windows 經典穩定版。切換介面版本前，請先保存訂閱網址與自訂路由，避免將介面差異誤認為訂閱遺失。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 作業系統與架構 | 適用於 Windows x64 環境；請在「設定 → 系統 → 系統資訊」查看系統類型。舊版系統請另外確認目前安裝檔是否相容。 |
| 安裝環境 | 請預留解壓縮與安裝所需空間；若安裝程式提示缺少執行元件，請依明確提示安裝對應元件。 |
| 執行權限 | 依需求使用一般系統代理；啟用 TUN 會涉及虛擬網路介面卡與路由設定，通常需要管理員權限。 |
先關閉正在執行的舊執行個體，再解壓縮並安裝。首次啟動後，請確認記錄中沒有核心啟動錯誤，再新增訂閱群組。若連接埠已被占用，請先找出其他代理程序；不要同時啟動兩個用戶端爭用相同的監聽連接埠。
系統代理只會影響遵循系統代理設定的應用程式。能開啟用戶端主視窗，不代表瀏覽器的請求已經透過代理。匯入訂閱並選擇節點後，請繼續查看系統代理設定，再實際測試連線。
在蘋果選單中開啟「關於這台 Mac」，先查看「晶片」或「處理器」欄位。M 系列晶片請選 Apple Silicon；顯示 Intel 處理器則選 Intel。不要只憑電腦外觀、購買年份或安裝檔大小判斷架構。
適用於 M 系列晶片。建議使用原生架構版本，降低執行環境不相容造成的啟動問題。
適用於 Intel 處理器。若系統提示應用程式無法執行，請先確認架構與系統相容性，再檢查安裝流程。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 處理器 | Apple Silicon 對應 arm64；Intel 對應 x64，請在「關於這台 Mac」確認。 |
| 系統相容性 | 目前的 DMG 仍受系統版本及執行元件限制；舊版系統安裝前請確認安裝檔需求。 |
| 網路權限 | 修改系統代理或啟用 TUN 時，請依系統提示授權；若需要管理員認證，請先確認目前執行的操作。 |
開啟 DMG，將應用程式複製到「應用程式」資料夾後再啟動。請勿長期從已掛載的磁碟映像檔執行，否則更新、權限與設定檔路徑可能較難判斷。首次開啟若遭系統阻擋，請先確認檔案來源與封裝類型，再透過系統提供的安全性設定處理；不要為了安裝用戶端而全面關閉安全機制。
訂閱更新成功後，請先選擇一個節點測試。切換 Wi-Fi、有線網路或其他網路服務後，請重新確認目前網路服務的代理狀態。關閉用戶端前，若曾啟用系統代理，請先還原相關設定，避免用戶端退出後仍指向已停止的本機連接埠。
Android 優先選擇 v2rayNG，採用 Xray 核心，適合需要相應協定與傳輸支援的設定。2015 年後的主流手機通常可優先選 arm64，但部分裝置系統仍有限制，請以系統實際支援的應用程式架構為準。
適用於支援 64 位元應用程式的常見 Android 裝置。安裝前請預留足夠空間，安裝完成後再授權首次連線所需的 VPN 權限。
適用於無法確認架構，或需要其他受支援架構的裝置。通用版無法解決系統版本過舊造成的相容性限制。
若有明確的 V2Fly 核心設定需求，可選擇 v2flyNG。它與 v2rayNG 支援的核心功能並不完全相同，不能只憑節點名稱判斷設定是否通用。若涉及特定協定或傳輸組合，請先確認設定需求再更換用戶端。
提供支援 arm64 應用程式的裝置使用。安裝後請另外匯入訂閱，不要假設其他用戶端的設定會自動轉移。
適用於其他受支援架構或尚未確認架構的裝置。更換用戶端前請保存訂閱網址，並記錄原有的個別應用程式代理設定。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 應用程式架構 | 若裝置支援 arm64 應用程式，優先選擇 arm64；無法確認時可試用通用版，並確認系統相容性。 |
| 安裝權限 | 依系統提示允許目前使用的瀏覽器或檔案管理器安裝應用程式；安裝完成後可關閉該來源的安裝權限。 |
| 連線環境 | 首次連線時需確認系統 VPN 授權；其他正在執行的 VPN 應用程式可能與目前連線衝突。 |
| 背景執行 | 依實際需求調整電池最佳化與背景執行限制；若鎖定螢幕後斷線，請先檢查系統的程序管理設定。 |
出現「應用程式未安裝」時，請勿立即刪除舊用戶端。先檢查儲存空間、安裝檔架構、既有應用程式版本與簽章是否相容；若需解除安裝後重裝，請先匯出設定或保存訂閱網址。直接解除安裝可能會清除應用程式內的資料。
兩個用戶端可以分別保留設定，但同一時間只能由一個用戶端建立 VPN 連線。匯入訂閱後，還需選擇節點並啟動連線，接著檢查通知列的連線狀態與實際請求結果。平台操作詳情請參閱Android 安裝與設定。
先確認發行版採用的套件格式，再選擇處理器架構。常見 Intel 與 AMD 桌面裝置通常使用 x64；ARM 桌面或開發裝置則需確認是否為 arm64。deb 與 rpm 不是依個人偏好選擇，而是由發行版的套件管理系統決定。
適用於採用 deb 格式的相關發行版。請使用系統套件安裝程式開啟，讓套件管理器檢查執行相依套件。
ARM 裝置：下載 arm64 deb →適用於採用 rpm 格式且相依套件相容的發行版。格式相同不代表所有系統版本都能直接安裝。
ARM 裝置：下載 arm64 rpm →| 檢查項目 | 需求與處理方式 |
|---|---|
| 套件管理系統 | Debian、Ubuntu 系列通常選 deb；Fedora、RHEL 系列通常選 rpm，仍須確認具體相依套件。 |
| 處理器架構 | amd64 與 x86_64 通常代表 x64；aarch64 通常對應 arm64，請勿跨架構安裝。 |
| 桌面環境 | 圖形用戶端需要可用的桌面工作階段及相應圖形執行相依套件；本指南不適用於純命令列伺服器安裝。 |
| 網路權限 | TUN 涉及虛擬網路介面卡與路由權限；應用程式能否讀取系統代理，也取決於桌面環境與應用程式本身。 |
安裝程式回報相依性不足時，請先記下完整提示，再確認發行版版本與套件架構。不要強行略過相依性檢查，也不要直接將其他發行版的軟體來源加入目前系統。安裝成功後，先在一般桌面工作階段中啟動，確認設定目錄可寫入，再逐一啟用網路功能。
若用戶端已連線，但某個應用程式仍直接連線，請先確認該應用程式是否讀取桌面系統代理。若要接管更多應用程式流量，再評估 TUN 模式，並檢查現有 VPN、容器網路與自訂路由，避免多種網路管理機制同時修改路由。
依序完成設定、測試與流量接管。將安裝問題與連線問題分開排查，避免一次變更多個條件。
開啟訂閱群組設定，填入容易辨識的別名與完整訂閱網址。網址可能包含專屬 token，複製時請避免混入換行、空格或通訊軟體自動附加的標點。教學中的 https://example.com/sub?token=xxxx 僅用於說明格式，無法用來取得節點。
儲存群組後執行更新訂閱，確認伺服器清單已顯示設定。更新失敗時，先檢查網址是否過期，再依目前網路狀況選擇透過代理或不透過代理更新。選擇節點並執行真實連線延遲測試；TCPing 結果僅供判斷連接埠是否連通，不能取代實際請求測試。
查看真實連線延遲測試說明 →桌面平台首次設定可先使用系統代理，確認哪些應用程式會讀取系統代理。若需接管更多流量，再了解 TUN 所需權限與路由變更。Android 請依系統提示確認 VPN 連線要求；連線後仍應透過實際存取情況與出口 IP 確認是否生效。
查看代理模式設定 →更新用戶端前請保存訂閱網址、自訂路由與連接埠設定。訂閱群組中可重新取得的節點，應與手動新增的設定分開管理。遇到問題時先記錄日誌中的關鍵錯誤，再判斷是安裝、核心啟動、訂閱更新或節點連線問題；不要以反覆重裝取代問題排查。
確認用戶端適用範圍 →先確認作業系統、架構與安裝方式。訂閱更新或連線問題，請參閱常見問題。
首次安裝可先選 Desktop 桌面版，採用新一代跨平台 UI。傳統 WPF 版是 Windows 經典穩定版，適合習慣舊介面的使用者。兩種版本皆為 x64 安裝檔；切換前請先備份訂閱網址與自訂設定，也不要同時執行兩個執行個體接管系統代理。
2015 年後的主流手機通常可優先選 arm64，但仍應以裝置實際支援的應用程式架構為準。舊裝置、僅支援 32 位元應用程式的系統，或無法確認架構時，可試用通用版。若出現不相容提示，請先檢查系統版本、剩餘空間及既有應用程式的簽章，避免反覆覆蓋安裝。
Apple Silicon 安裝檔適用於 M 系列晶片，Intel 安裝檔則適用於 Intel 處理器。請在蘋果選單的「關於這台 Mac」查看晶片或處理器資訊，再選擇對應的 DMG。封裝格式相同不代表處理器架構相同，建議使用符合裝置架構的原生版本。
Debian、Ubuntu 及其衍生發行版通常使用 deb；Fedora、RHEL 及相關發行版通常使用 rpm。也請確認 x64 或 arm64 架構，並使用系統套件安裝程式檢查相依套件。即使發行版採用相同封裝格式，相依套件版本仍可能不同，請勿略過相依性檢查。
用戶端負責管理設定，安裝檔不會附帶訂閱網址或節點。請準備有權使用的訂閱網址，在訂閱群組中儲存並更新訂閱，再選擇節點執行真實連線延遲測試。測試通過後設定系統代理，或視需要啟用 TUN，並確認出口 IP。
請先保存訂閱網址、訂閱群組別名、自訂路由與連接埠設定，並使用用戶端提供的匯出功能備份相關設定。關閉舊執行個體後再安裝新版。啟動後確認訂閱與路由設定，並重新執行真實連線延遲測試；請勿公開分享備份檔或包含 token 的螢幕截圖。