客戶端安裝檔先選作業系統，再選架構
依作業系統選擇安裝檔。桌面版使用 v2rayN，Android 版首選 v2rayNG，另提供 v2flyNG 作為替代選項。
安裝檔不含伺服器設定。安裝後需匯入有權使用的訂閱網址或設定連結。
安裝檔清單
只下載一種符合裝置的安裝檔。切換平台後，請查看卡片下方的安裝需求。
Windows x64 安裝檔分為桌面版與經典 WPF 版。初次使用可先選桌面版；習慣經典選單配置則選 WPF 版。
新一代跨平台 UI。適合初次安裝，或希望在不同桌面系統間維持相近操作方式的使用者。
經典穩定版，保留熟悉的 Windows 桌面介面。已有設定時，升級前請先記下目前使用的分支。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 作業系統與架構 | 適用於 Windows x64；建議使用仍受支援的 Windows 10 或 Windows 11 | 前往「設定 → 系統 → 系統資訊」查看系統類型 |
| 安裝檔格式 | ZIP 壓縮檔，內含對應分支的安裝程式 | 先完整解壓縮，再執行其中的安裝程式 |
| 執行環境 | 執行階段需求依所選分支與發行套件而異 | 若顯示缺少執行環境，請依提示安裝對應元件 |
下載後先開啟儲存資料夾，將 ZIP 完整解壓縮至可寫入的資料夾。請勿直接從壓縮檔預覽視窗啟動程式，否則相關檔案可能無法解壓縮至預期位置。先關閉正在執行的舊客戶端，再進行安裝；安裝路徑與設定位置不一定相同，複製程式資料夾不等於完整備份。
首次啟動時，伺服器清單為空是正常情況。開啟「訂閱群組 → 訂閱群組設定」，新增群組與訂閱網址，再更新訂閱。接著選取一台伺服器，確認底部的「系統代理」是否設為「自動設定系統代理」。初次測試請先使用系統代理，確認連線正常後再視需要調整 TUN 模式，避免一次變更多項設定而難以找出問題。
若要從 WPF 版切換至 Desktop，請先保留原有設定與程式，再確認新介面中的訂閱、路由及監聽連接埠。兩個執行個體同時啟動可能會搶用本機混合監聽連接埠。若發生連接埠占用，先結束另一個執行個體，不要反覆重新安裝。更多操作請參閱v2rayN 設定教學。
先在蘋果選單的「關於這台 Mac」查看晶片名稱。若顯示 Apple M 系列，請選 Apple Silicon；若顯示 Intel 處理器，請選 Intel。
適用於 Apple M 系列晶片。選擇原生架構，減少透過相容層執行所帶來的額外變數。
適用於搭載 Intel 晶片的 Mac。請勿只憑電腦外觀或購買年份判斷處理器架構。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 晶片架構 | Apple Silicon 對應 arm64；Intel 對應 x64 | 開啟蘋果選單 → 關於這台 Mac |
| 系統相容性 | 最低系統版本請以目前安裝檔的相容性提示為準 | 記下目前的 macOS 版本，晶片符合不代表系統版本也相容 |
| 套件格式與權限 | DMG 磁碟映像檔；應用程式資料夾需可寫入 | 安裝至「應用程式」，首次開啟時留意系統提示 |
開啟 DMG 後，依磁碟映像視窗中的指示將客戶端移至「應用程式」，再從「應用程式」啟動。請勿長期從掛載的磁碟映像檔執行。更新前先結束舊客戶端，確認選單列沒有仍在執行的執行個體，再取代應用程式；若顯示檔案正在使用，先檢查背景處理程序，不要強制覆寫。
首次啟動遭系統安全機制阻擋時，先確認下載來源與應用程式名稱，再前往「系統設定 → 隱私權與安全性」查看相關提示。不同系統版本的操作位置可能略有差異。不建議直接執行來源不明的終端機指令，也不要為了啟動單一應用程式而關閉整台電腦的安全防護。
匯入訂閱後，確認客戶端已選取伺服器，再啟用系統代理。網頁仍無法開啟時，請檢查瀏覽器是否安裝獨立代理擴充功能，以及其他網路工具是否覆寫系統代理。需要使用 TUN 時，再依客戶端提示完成權限設定。結束客戶端前清除系統代理，有助於避免程式已關閉、瀏覽器卻仍連線至本機連接埠的情況。
採用 Xray 核心的 Android 圖形客戶端。2015 年後的主流手機通常選 arm64；仍應以裝置系統實際支援的架構為準。
優先用於支援 arm64-v8a 的裝置，採單一架構封裝，通常比通用版小。
無法確認架構時的替代選項。內含多種架構，不必與 arm64 版同時安裝。
需要 V2Fly 核心環境時可使用的 Android 替代選項。選擇前請確認現有設定所需的協定與傳輸方式受此客戶端支援。
適用於支援 arm64-v8a 的裝置。若已安裝其他客戶端，請先停止其連線再進行測試。
不確定架構時可選用。切換客戶端前請保留訂閱網址，不要假設兩款應用程式共用設定資料夾。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 處理器與系統架構 | 主流裝置優先選 arm64；不確定時選通用版 | 查看裝置規格，部分裝置可能使用較舊的系統架構 |
| 系統版本 | 最低版本需求請以安裝程式對目前套件的提示為準 | 前往「設定 → 關於手機」查看 Android 版本 |
| 安裝與連線權限 | 允許目前使用的瀏覽器或檔案管理員安裝應用程式；連線時需要 VPN 授權 | 只為本次使用的來源開啟安裝權限，安裝後即可關閉 |
下載 APK 後，從瀏覽器下載清單或檔案管理員開啟檔案。若系統提示需允許安裝，請確認授權對象是剛才使用的瀏覽器或檔案管理員。若顯示「應用程式未安裝」，先確認是架構不相容、儲存空間不足，還是新舊版本的簽章不一致。通用版能解決部分架構選擇問題，但無法排除簽章衝突。
開啟 v2rayNG 後，在「訂閱群組設定」新增訂閱網址，儲存後執行「更新訂閱」。清單出現設定後，選取其中一項，再點選連線按鈕。首次連線時會跳出系統 VPN 授權提示，確認後才能建立裝置層級的連線。手機通常無法同時維持多個同類型 VPN 服務；測試前請暫停其他占用該通道的應用程式，避免授權在不同應用程式間切換。
鎖定螢幕後斷線時，先檢查應用程式的電池管理、背景執行限制與系統省電模式，而不是更換安裝檔。若只有行動網路異常，也應比較 Wi-Fi 下的狀況。若要測試 v2rayNG 與 v2flyNG，請分別匯入設定並查看記錄，不要因為一種核心能讀取設定，就認為另一種核心也支援所有參數。
適用於 Linux 桌面環境。先確認發行版使用 deb 或 rpm，再核對處理器架構是 x86_64 還是 aarch64。
適用於相容的 Debian、Ubuntu 等桌面發行版。套件名稱中的 amd64 代表 x64 架構，不限於特定處理器品牌。
適用於相容的 RPM 系發行版。還需確認相依套件與系統版本符合該套件需求，不能只看副檔名。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 處理器架構 | x86_64 選 x64；aarch64 選 arm64 | 在系統資訊中查看架構，必要時執行 uname -m |
| 發行版與格式 | Debian 系通常使用 deb；RPM 系通常使用 rpm | 查看發行版版本與套件管理工具的相容性 |
| 桌面環境與相依套件 | 需要可用的圖形桌面、網路連線，以及符合需求的系統程式庫 | 使用系統軟體安裝程式處理相依套件，並記下失敗訊息 |
下載符合需求的套件後，優先使用發行版內建的軟體安裝程式開啟。若系統提示相依套件不符，先記下缺少的程式庫名稱與最低版本，再判斷是否需要更新系統。請勿為了安裝客戶端而強制忽略相依需求，也不要將其他發行版的系統程式庫直接覆蓋至目前環境。即使架構相符，較舊的發行版仍可能缺少安裝套件所需的執行環境。
安裝完成後，從應用程式選單啟動 v2rayN，並以一般桌面使用者身分設定訂閱。系統代理通常只影響目前桌面工作階段，不一定涵蓋終端機工具或所有應用程式。請先在遵循系統代理設定的瀏覽器中測試，再分別檢查其他程式的代理設定。TUN 涉及額外網路權限，不建議長期以高權限執行整個圖形客戶端來取代正確的權限設定。
若要在開機後自動執行，請先確認手動啟動、更新訂閱及結束程式後的清理都正常，再使用桌面環境的啟動應用程式設定。升級後若出現兩個系統匣圖示，請檢查是否同時保留舊捷徑與新的自動啟動項目。更完整的桌面安裝說明請參閱deb/rpm 安裝與開機自動啟動。
安裝前後檢查
分開處理安裝問題與連線問題。每次只調整一項設定，並保留可重現問題的線索。
記下目前的客戶端名稱、介面分支、監聽連接埠與路由模式，並使用客戶端提供的匯出或備份功能儲存設定。訂閱網址可能包含存取憑證，備份請存放在安全位置；截圖和求助記錄中不要顯示完整網址。
先結束舊程式再安裝，並確認系統匣或背景沒有殘留執行個體。切換架構、安裝來源或桌面介面分支時，請先確認移轉方式。不要因安裝程式發生錯誤就立即刪除原有設定；能還原至原狀，比反覆覆寫更重要。
匯入訂閱後，確認伺服器清單已更新，選取一項設定再連線。訂閱是分發設定的方式，不代表客戶端附帶服務；訂閱網址失效、授權到期或設定內容不相容時，需在相應環節處理。
更新失敗時，先確認錯誤是無法連線、網址拒絕存取，還是內容無法辨識。若目前已有可用連線，可比較一般更新與「不透過代理」更新的結果。請勿將訂閱網址提交至來源不明的轉換網站，以免洩漏存取權限。
桌面版先確認本機監聽成功，再啟用「自動設定系統代理」。Android 版先確認 VPN 授權與連線狀態。開啟實際需要瀏覽的網站進行測試；單次延遲測試只能反映特定測試方式，無法取代完整的瀏覽結果。
瀏覽器正常但終端機連線失敗，通常需另外檢查終端機代理設定；若只有部分網域無法連線，則繼續檢查路由與 DNS。先以一種接管方式建立基準，不要同時啟用多個客戶端並疊加代理擴充功能。
記下作業系統版本、客戶端名稱、架構與完整錯誤訊息。說明問題是安裝程式無法開啟、程式啟動後立即結束、訂閱更新失敗，還是連線後無法瀏覽。不同階段的症狀對應不同的排查方式。
連接埠占用先檢查其他客戶端，名稱解析失敗先檢查 DNS，鎖定螢幕後斷線先檢查背景執行限制。提交記錄前請移除訂閱網址、存取憑證與個人網路資訊。請依症狀接著閱讀疑難排除手冊，避免將所有故障都歸因於安裝檔。
下載與安裝問答
安裝檔只提供客戶端程式，不含可用的伺服器設定。準備有權使用的訂閱網址或設定連結，在 v2rayN 的「訂閱群組」中新增網址並更新訂閱，或從剪貼簿匯入。Android 客戶端可在「訂閱群組設定」中新增網址，再執行「更新訂閱」。
初次使用可先選桌面版 Desktop，採用新一代跨平台介面。若熟悉經典 Windows 選單、希望延續原有操作習慣，可選擇經典穩定的 WPF 版。兩者是不同的介面分支，不代表下載後會附帶不同的伺服器資源。切換前請先備份設定，並結束執行中的客戶端。
2015 年後的主流手機通常可先選 arm64，但仍應以裝置系統實際支援的架構為準。若無法確認，或 arm64 套件顯示不相容，可改選通用版。通用版包含多種架構，檔案通常較大；同一客戶端的兩種套件不必同時安裝。
通常先備份設定，再結束客戶端，並以相同應用程式、安裝來源及架構進行升級，不要先刪除舊設定。Android 若顯示簽章衝突，請勿反覆覆蓋或立即解除安裝，應先確認應用程式來源，以及備份是否能還原。不同桌面介面分支之間的設定移轉，需另外確認。
先確認已匯入設定並選取伺服器，再查看記錄是否有本機連接埠占用或連線錯誤。桌面版請確認是否啟用「自動設定系統代理」；Android 版則檢查 VPN 授權與連線狀態。只有程式檔案損毀、架構不符或安裝失敗時，才優先處理安裝檔問題。
先查看瀏覽器下載清單是否已有下載工作，並確認磁碟空間及儲存資料夾權限。網路中斷時可重新下載同一安裝檔，避免將尚未下載完成的檔案當成安裝檔開啟。若仍失敗，記下作業系統、架構、套件格式及瀏覽器錯誤訊息，換用正常的網路再試一次。