client shelf
桌面版使用 v2rayN，Android 優先選擇 v2rayNG。先確認作業系統與處理器架構，再安裝並匯入訂閱。
download
各平台提供相應的用戶端與套件格式。版本資訊列於卡片明細；實際功能與相容性請以安裝後的用戶端及系統提示為準。
Windows 桌面用戶端 · x64
兩個版本的主要差異在於介面與執行環境，並非採用不同的代理協定。Desktop 使用新一代介面，可支援多種桌面系統；WPF 則保留經典的 Windows 操作配置。已有設定的使用者可繼續使用熟悉的版本；準備遷移時，請先匯出訂閱群組與自訂路由，避免把介面變更誤認為設定遺失。
此處的兩個下載入口都是 x64 安裝檔。下載前請開啟「設定 → 系統 → 系統資訊」，確認系統類型。檔案下載完成後，請先完整解壓縮，再執行其中的安裝程式；請勿直接從壓縮軟體的暫存目錄啟動。若安裝精靈提示缺少執行元件，請依指示處理，不要反覆切換節點。
首次啟動時，先檢查本機監聽連接埠，再匯入訂閱並選擇節點。系統代理只會影響遵循系統代理設定的應用程式，不會自動涵蓋所有程式。若舊版仍在背景執行，兩個執行個體可能會占用同一連接埠；請先關閉舊程序，再測試新版，方便分辨安裝問題與連線問題。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 系統與架構 | 64 位元 Windows，請使用 x64 套件 | 在系統資訊中確認系統類型；實際支援的系統版本以安裝提示為準 |
| 執行環境 | Desktop 與 WPF 的相依元件可能不同 | 依所選版本的提示安裝執行元件，並保留完整的程式目錄 |
| 權限與連接埠 | 一般代理與 TUN 的權限需求不同 | 先測試一般代理；需要使用 TUN 時，再確認提升權限與網路驅動程式提示 |
macOS 桌面用戶端 · DMG
處理器類型比裝置外觀或購買年份更可靠。請在系統選單中開啟「關於這台 Mac」：顯示 Apple 晶片的裝置選擇 arm64，顯示 Intel 處理器的裝置選擇 x64。兩種安裝檔用途相同，差別在於執行架構；建議使用符合裝置規格的原生版本，不必為了介面一致而選擇不同架構。
下載後開啟 DMG，將應用程式拖曳至「應用程式」資料夾，再從該處啟動。請勿長期直接執行映像檔中的應用程式，否則更新與權限記錄可能不易管理。首次開啟若出現系統安全性提示，請確認下載來源，並依系統提供的單一應用程式授權流程處理；不建議全面關閉系統安全機制。
v2rayN 的系統代理設定須配合目前使用的網路服務。切換 Wi-Fi、有線網路或使用其他網路工具後，可到系統網路設定確認代理位址與連接埠。TUN 是另一種流量接入方式，啟用時可能需要額外權限；首次設定請先完成訂閱匯入並驗證一般代理，再嘗試較複雜的模式。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 處理器 | Apple Silicon 選 arm64；Intel 選 x64 | 請查看「關於這台 Mac」確認，不要只憑裝置年份判斷 |
| 系統環境 | 系統程式庫須符合目前桌面版的執行需求 | 維持系統更新；若出現版本不相容提示，請先確認系統版本 |
| 應用程式與權限 | 安裝至「應用程式」資料夾 | 首次啟動時依系統提示授權；TUN 權限須另外設定 |
Android 用戶端 · Xray 核心
v2rayNG 是 Android 端的優先選擇，適合使用 Xray 功能的設定。是否選擇 arm64，應以裝置支援的應用程式架構為準，而非 Android 版本號。部分舊裝置或特殊系統即使採用較新的處理器，也可能只提供不同的應用程式執行環境；若安裝時顯示架構不相容，可改用通用版排除這項因素。
開啟下載的 APK，依系統提示允許目前使用的瀏覽器或檔案管理員安裝應用程式。此權限只適用於發起安裝的應用程式，不代表允許所有來源。安裝完成後，可關閉不再需要的安裝權限。首次啟動連線時，Android 會顯示本機 VPN 權限對話框；確認後，用戶端才能接管流量。
Android 用戶端 · V2Fly 核心
v2flyNG 是採用 V2Fly 核心的替代選項，適合既有設定所需功能與該核心相符的情境。用戶端介面相似，不代表所有協定擴充功能都能互通。匯入前請確認訂閱所用的協定、傳輸方式與安全層需求；若核心不支援特定欄位，改用不同架構的套件通常無法解決，應重新確認用戶端與設定是否相符。
兩款用戶端可分別儲存設定，但 Android 通常一次只能啟用一個本機 VPN 連線。切換測試前，請先停止另一款用戶端，再啟動目前使用的應用程式。若螢幕熄滅後連線中斷，請檢查系統的電池最佳化與背景執行限制；不要把系統停止背景程序誤判為節點失效。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 應用程式架構 | 支援 arm64-v8a 時，優先選擇單一架構套件 | 不確定時使用通用版，但仍須符合用戶端的系統版本需求 |
| 系統與安裝 | 最低系統需求取決於所選的發行版本 | 查看安裝提示，授予目前安裝來源所需的權限 |
| 網路與背景執行 | 本機 VPN 權限與背景執行條件 | 停止其他 VPN 連線，並檢查省電與背景執行限制 |
Linux 圖形用戶端 · deb / rpm
Linux 安裝檔須同時符合發行版的套件管理系統與處理器架構。deb 與 rpm 代表不同的套件格式，並非兩種代理模式，也不能只靠更改副檔名互換。使用 Debian、Ubuntu 等發行版時，請優先選擇 deb；使用 Fedora、RHEL 等系統時，請確認 rpm 的相依套件需求。檔名中的發行版標示及系統程式庫版本也會影響相容性，支援 rpm 不代表能直接安裝在所有 rpm 系統上。
一般桌上型電腦多採用 x64，對應套件中的 amd64 或 x86_64；arm64 裝置則對應 arm64 或 aarch64。可在系統資訊查看處理器，也可執行下方指令查詢架構。v2rayN 是圖形用戶端，須使用可用的桌面工作階段；純終端環境不適用桌面版安裝步驟。
uname -m下載後，使用發行版的軟體安裝程式或套件管理工具開啟安裝檔，由套件管理器處理相依套件。若安裝程式回報缺少程式庫、架構不符或相依套件版本不足，請先解決這些問題；不要強制忽略相依性，再把啟動失敗歸咎於代理設定。套件管理器顯示的錯誤訊息，通常比重複下載安裝檔更有助於找出原因。
安裝完成後，請先在一般使用者工作階段啟動圖形介面，匯入訂閱並檢查本機監聽連接埠。不同 Linux 桌面環境處理系統代理的方式可能不同，部分終端工具也需要另外指定代理。若要讓更多應用程式使用用戶端，再查看 TUN 相關權限與路由說明；不要只為了首次連線就長期以高權限執行整個桌面程式。
| 檢查項目 | 選擇依據 | 安裝前準備 |
|---|---|---|
| 發行版 | deb 或 rpm 須符合套件管理系統 | 確認目前發行版的軟體來源、相依套件與系統程式庫相容性 |
| 處理器 | x86_64 選 x64；aarch64 選 arm64 | 使用系統資訊或 uname -m 確認架構 |
| 桌面與網路 | 可用的圖形桌面工作階段 | 先測試本機代理，再設定桌面系統代理或 TUN 權限 |
after install
安裝只是準備工作。用戶端負責管理設定與接入流量，遠端節點則須另外取得。依照下列順序操作，可減少同時變更多項設定所增加的排查難度。
01 / import
請使用有權存取的訂閱連結或節點分享連結。先建立訂閱群組，貼上網址後執行更新，再確認是否出現可選節點。複製時避免一併帶入空格或換行。訂閱連結可能包含存取權限資訊，請勿任意轉傳或放入公開截圖。
查看匯入訂閱步驟 →02 / mode
桌面端請先確認用戶端連接埠，再啟用系統代理；Android 端則先確認本機 VPN 權限。系統代理、路由模式與 TUN 是不同層面的設定：系統代理決定應用程式如何連入用戶端，路由決定流量進入後的出口，TUN 則會改變接入流量的範圍。
查看路由分流說明 →03 / verify
選擇節點並啟動後，分別檢查用戶端記錄、應用程式代理設定及目標網頁。介面顯示正在執行，不代表所有應用程式都已使用代理。若網頁無法開啟，請先確認時間、連接埠與代理設定，再檢查 DNS 和規則；每次只調整一項設定。
查看連線疑難排解 →Project V 是代理工具開源生態的背景專案，V2Fly 與 Xray 則是相關核心家族。圖形用戶端負責整合訂閱、節點、連接埠與路由設定，組成可執行的設定。v2rayN 適用於桌面系統，v2rayNG 與 v2flyNG 則面向 Android；選擇用戶端時，除了考量裝置平台，也應確認目前設定需要哪種核心功能。即使協定名稱相同，傳輸方式或安全層擴充不同，也可能造成相容性差異。
更新用戶端不代表更新訂閱，也不代表切換遠端節點。更新後若發生問題，請先比對本機設定與舊設定，再查看記錄中的具體錯誤。協定與 DNS 的詳細說明可繼續閱讀概念速查與DNS 設定章節；初次使用請依快速入門的步驟操作，不必一開始就調整所有進階參數。
download questions
先確認套件格式、架構與安裝環境，再設定訂閱與連線。
初次安裝建議選擇 Desktop 桌面版，採用新一代跨平台介面。經典 WPF 版保留熟悉的 Windows 操作介面，適合想延續既有操作習慣的使用者。遷移前請先匯出設定，並避免兩個執行個體同時監聽相同的本機連接埠。
2015 年後推出的主流手機通常可優先選擇 arm64，但仍須以裝置支援的應用程式架構為準。若不確定裝置架構，或 arm64 安裝檔顯示不相容，可改試通用版。通用版包含多種架構，但不代表舊版系統一定符合用戶端需求。
deb 適用於 Debian、Ubuntu 等採用相應套件管理系統的發行版；rpm 則適用於 Fedora、RHEL 等相應系統。請先確認發行版，再確認 x64 或 arm64 架構。即使套件格式相同，仍可能有相依套件或系統程式庫版本差異。
設定能否沿用，取決於用戶端版本、安裝方式與設定目錄。更新前請匯出設定，記下訂閱群組、連接埠及自訂路由，並完全關閉舊程序。更新後逐項確認，不要假設所有設定都會自動遷移。
用戶端安裝檔不含可直接使用的遠端節點。請匯入有權使用的訂閱或節點設定，選擇節點並啟動，再確認系統代理或本機 VPN 權限。安裝程式不代表代理連線已建立。
卡片上的版本文字與各架構安裝檔路徑取自清單中的不同欄位，更新時間可能不一致。下載後請在用戶端的「關於」頁面確認實際版本；遷移設定及確認功能支援時，請以已安裝的用戶端為準，不要只憑檔名判斷功能。