CLIENT SHELF / 安裝套件選擇
先選擇作業系統，再確認處理器架構。桌面平台使用 v2rayN；Android 優先推薦 v2rayNG，另有 v2flyNG 可供選擇。
三款用戶端皆為免費開放原始碼軟體。安裝套件提供圖形介面與連線功能；訂閱網址、伺服器參數及路由規則須另外準備。以下下載連結依平台分類，設定匯入與軟體下載是不同步驟。
WINDOWS / x64
Desktop 與 WPF 是同一款用戶端的不同介面版本。請擇一安裝，避免多個執行個體同時變更系統代理設定。
Desktop 桌面版採用新一代跨平台 UI；經典 WPF 版使用 Windows 桌面介面，適合習慣傳統操作方式、希望選擇穩定版本的使用者。
兩個下載連結皆提供 ZIP 壓縮套件。請先將壓縮檔完整解壓縮至專用資料夾，再依套件內容執行安裝程式；請勿直接從壓縮檔預覽視窗啟動。首次執行後，查看系統匣中的程式狀態，確認用戶端已啟動，再設定訂閱與代理模式。
Desktop 與 WPF 的介面、選單名稱及設定儲存方式可能不同。若要遷移既有設定，請先使用用戶端提供的備份或匯出功能；請勿直接覆寫另一版本的設定資料夾。若系統提示缺少執行元件，請依目前安裝套件的指示處理，而非反覆切換節點。
| 檢查項目 | 需求與操作方式 |
|---|---|
| 處理器架構 | 本頁提供的兩個套件皆為 x64。請前往「設定 → 系統 → 系統資訊」查看系統類型，確認架構相符後再安裝。 |
| 系統與相依元件 | 最低系統版本、執行元件及驅動程式需求，請以所選套件的說明與安裝提示為準。 |
| 安裝位置 | 請選擇目前帳戶可寫入的獨立資料夾；升級前先結束舊的執行個體，並保留既有設定的備份。 |
| 連線模式 | 系統代理與 TUN 的權限需求不同。建議先使用系統代理建立基本連線，再依實際需求啟用其他模式。 |
下載完成後的匯入步驟請參閱 v2rayN 使用教學 →
MACOS / arm64 · x64
前往「蘋果選單 → 關於這台 Mac」查看晶片資訊。Apple Silicon 與 Intel 請分別使用對應的 DMG 安裝套件。
晶片欄顯示 Apple M 系列時，請選擇 Apple Silicon；顯示 Intel 處理器時，請選擇 Intel。依晶片選擇原生架構，不要根據電腦外觀或購買年份判斷。
開啟 DMG 後，將 App 拖曳至「應用程式」資料夾，再從該資料夾啟動。請勿長時間直接從已掛載的磁碟映像執行用戶端，否則退出映像、升級與權限處理可能互相干擾。移動完成並結束 App 後，即可退出安裝映像。
首次啟動若出現開發者驗證提示，請先確認安裝套件來源與檔案類型，再依系統提供的「隱私權與安全性」路徑處理。系統代理授權與網路延伸功能授權是不同步驟；只授予目前模式確實需要的權限。升級後若連線異常，請先確認原有權限是否仍有效。
| 檢查項目 | 需求與操作方式 |
|---|---|
| Apple Silicon | 「關於這台 Mac」顯示 Apple M 系列晶片時，請選擇 arm64 DMG。 |
| Intel | 「關於這台 Mac」顯示 Intel 處理器時，請選擇 x64 DMG。 |
| 系統相容性 | 最低系統版本請以目前安裝套件的說明為準；若無法啟動，請保留系統顯示的原始錯誤訊息。 |
| 權限與資料夾 | 請將 App 放入「應用程式」資料夾；首次啟動時，依需求處理系統代理及網路相關權限。 |
權限設定方式請參閱 macOS 安裝與權限說明 →
ANDROID / arm64 · universal
先選擇核心，再選擇架構。2015 年後推出的主流手機通常優先選擇 arm64；安裝前仍須確認系統支援該架構。
Android 優先推薦的下載選項。採用 Xray 核心，實際支援的協定、傳輸方式與安全參數，取決於套件內的核心版本及用戶端介面。
arm64 套件適用於系統支援該架構的裝置。不確定裝置架構時，可選擇包含多種架構的通用版；但通用版不代表相容所有系統版本。若安裝程式顯示解析失敗，請先確認檔案已下載完成，再檢查系統相容性與架構。請勿修改副檔名嘗試安裝。
首次啟動連線時，Android 會顯示 VPN 連線授權提示。此授權用於建立本機網路接管通道，並不代表訂閱已生效。匯入設定、選擇伺服器並啟動後，請查看記錄與實際連線結果；裝置上的其他 VPN App 可能與目前連線衝突。
採用 v2fly 核心的替代用戶端。若既有設定明確依賴 V2Fly 行為，或需要比較核心差異，再考慮使用此選項。
v2rayNG 與 v2flyNG 並非只更換名稱的同一個安裝套件。請分別確認設定中的協定、傳輸方式與安全選項；訂閱可匯入，不代表所有欄位都能正常使用。若涉及 REALITY 等功能，請先查明所用核心是否支援。
切換用戶端前，請記下原有的路由模式、DNS 設定及按 App 代理的範圍。測試另一款用戶端時，先停止目前連線，避免兩個 App 爭用系統 VPN 通道。兩款用戶端的設定分開儲存，匯入訂閱後仍須重新確認目前選取的設定。
| 檢查項目 | 需求與操作方式 |
|---|---|
| 處理器架構 | 通常優先選擇 arm64；無法確認裝置是否支援時，可考慮通用版，並留意安裝提示。 |
| 系統版本 | 最低系統需求請以對應 APK 的說明為準；通用版無法突破系統版本限制。 |
| 安裝來源 | 安裝 APK 時，依系統提示允許目前使用的瀏覽器或檔案管理員安裝 App；安裝完成後可撤銷此權限。 |
| 背景執行 | 切換 App 後若連線中斷，請檢查電池最佳化與背景執行限制，不必急著重新安裝用戶端。 |
首次使用可接著參閱 v2rayNG 使用教學 →。
LINUX / deb · rpm
先確認發行版使用的套件格式，再確認系統架構。deb 與 rpm 並非不同功能版本，兩者不能互相替代。
一般 x64 桌面環境可從以下主要選項下載。Debian 系發行版通常使用 deb，RPM 系發行版則使用 rpm；相依套件與相容性仍須由套件管理工具確認。
檔名中的 amd64、x86_64 通常對應 x64；arm64、aarch64 則對應 ARM 64 位元。請勿只依裝置品牌判斷架構，也不要藉由重新命名安裝套件來改變適用架構。圖形介面安裝程式若回報相依套件、架構或套件格式問題，請先查看提示內容。
請使用發行版的軟體安裝工具開啟對應套件，確認相依套件的解析結果後再安裝。檔名中的發行版標記，不代表所有使用相同套件格式的系統都能直接執行。若相依套件無法滿足，請先確認系統與套件是否相容；不要強制略過相依套件，也不要替換系統基礎程式庫。
啟動後，確認桌面環境是否接受系統代理設定。部分 App 不會讀取桌面代理設定，須在 App 內另行指定代理位址與連接埠。TUN 模式還涉及權限與路由接管，建議先完成一般代理連線，再依目前用戶端的支援情況啟用。
| 檢查項目 | 需求與操作方式 |
|---|---|
| 套件管理格式 | 依發行版選擇 deb 或 rpm，並使用對應的軟體安裝工具處理相依套件。 |
| 系統架構 | x64 請使用 amd64 或 x86_64 套件；ARM 64 位元請使用 arm64 或 aarch64 套件。 |
| 桌面環境與相依套件 | 此處提供圖形用戶端；桌面執行環境、系統程式庫及最低系統需求請以安裝套件說明為準。 |
| 權限與網路 | 先以一般帳戶執行並確認基本代理可用；需要使用 TUN 或接管系統路由時，再依需求授權。 |
設定欄位說明請參閱 V2Ray 設定參考 →
INSTALL → IMPORT → CONNECT
安裝成功、設定可讀取與連線可用是三個不同的檢查項目。依序處理可減少重複下載與不必要的重新安裝。
首次安裝時，先確認用戶端能否正常開啟，以及記錄中是否出現核心啟動錯誤。裝置上已有用戶端時，先結束舊的執行個體，避免本機監聽連接埠被占用。安裝失敗通常與系統或軟體套件有關；啟動失敗可能與用戶端、設定或執行環境有關；無法連線時，才進一步檢查節點、路由與 DNS。將這三類狀況分開記錄，比直接更動所有設定更容易找出問題。
在用戶端的訂閱管理或匯入選單中，填入有權使用的網址並儲存，接著更新清單，再選取要使用的設定。訂閱網址可能包含帳戶識別資訊，請妥善管理，勿貼在公開截圖或問題描述中。匯入單一連線時，協定、位址、連接埠、傳輸方式與安全參數須與伺服器設定一致；用戶端不會在安裝過程中自動補齊這些資料。若已有自訂規則，請先保留原設定副本，再測試新匯入的內容。
桌面端可先使用系統代理模式；Android 則依系統提示核准 VPN 連線。啟動後，請使用實際需要的 App 測試，並同時查看用戶端記錄。瀏覽器可以連線，不代表所有程式都已透過代理；測試工具的結果也不能取代實際 App 的連線測試。若網域解析失敗，請檢查 DNS；若出現直連或遭封鎖，請檢查路由順序；若握手失敗，請檢查連線參數與系統時間。
PACKAGE / UPDATE NOTES
升級前備份訂閱群組、自訂路由、DNS 設定及本機連接埠紀錄。若用戶端提供匯出功能，請優先使用並妥善保存含有訂閱資訊的備份檔。確認新版本可正常使用前，請勿刪除舊設定，也不要假設不同介面版本能共用設定資料夾。升級後先確認原設定已載入，再檢查系統代理與網路權限，最後測試連線。
卡片上的版本文字取自版本清單的發布欄位，安裝套件連結則依平台個別解析。發布更新期間，顯示文字與檔名可能暫時不同步；請勿手動修改網址或檔名來尋找其他套件。安裝後，請至用戶端的「關於」或版本資訊確認實際安裝版本。保留下載紀錄中的檔名與錯誤訊息即可；分享排查資料前，請先隱藏訂閱網址、伺服器憑證及個人資料夾資訊。
v2rayNG 與 v2flyNG 採用不同的核心分支，桌面用戶端的核心選擇也應依實際功能判斷。切換核心並非解決所有連線問題的通用方法；協定名稱相同，不代表安全參數與傳輸欄位完全相容。若要比較支援情況，請先閱讀 Xray 與 V2Fly 核心差異，再決定是否調整用戶端或核心。
用戶端負責讀取設定並建立連線，安裝套件並不包含可用的伺服器設定。安裝後仍須準備有權使用的訂閱網址或連線參數，匯入並選取設定後，再啟用適合目前環境的代理模式。訂閱網址可能包含存取憑證，請勿公開分享。
先查看系統顯示的處理器架構，再選擇安裝套件。Apple Silicon 請選 macOS arm64，Intel Mac 請選 x64；Linux 則依系統架構選擇 x64 或 arm64。2015 年後推出的主流 Android 手機通常優先選 arm64，但仍須確認系統支援；不確定時可考慮通用版。
通常選一種即可。Desktop 採用新一代跨平台介面，WPF 則是經典穩定版。切換介面版本前，請先備份設定，並避免兩個執行個體同時接管系統代理或監聽相同的本機連接埠。介面與設定的儲存位置依實際版本而異。
先查看瀏覽器的下載紀錄，確認下載已完成，再核對副檔名與系統平台是否相符。Windows 的 ZIP 檔須先解壓縮；Android 的 APK 須允許目前的安裝來源；macOS 的 DMG 須掛載後將 App 拖至「應用程式」資料夾。若仍無法安裝，請記下系統顯示的原始訊息，再依安裝教學排查。
先使用用戶端支援的匯出或備份功能，保留訂閱群組、自訂路由、DNS 設定與本機連接埠紀錄，並妥善保存備份檔。結束舊的執行個體後再升級；升級完成後，先確認原設定可正常讀取，再檢查系統代理、網路權限與訂閱更新。尚未確認還原方式前，請勿刪除舊設定資料夾。
版本文字取自版本清單中的 latest 欄位，下載連結則取自對應平台的 download 欄位；發布更新期間，兩者可能暫時不同步。請勿自行改寫檔名來推測其他安裝套件。安裝後可在用戶端的「關於」或版本資訊中確認實際版本，再依套件提示判斷是否更新。