CLIENT PACKAGES / 客戶端安裝套件
v2rayN、v2rayNG 與 v2flyNG
依系統、架構及介面版本選擇。
先確認裝置資訊，再選擇安裝套件。連線參數與訂閱需另外準備；首次使用可搭配快速入門教學完成匯入。
PACKAGE SELECTOR
下載項目依平台分類。切換標籤後，查看該系統的客戶端、架構說明與安裝條件。
同一款客戶端，提供兩種桌面介面。Desktop 採用新一代跨平台 UI；WPF 是經典穩定版。以下兩個下載項目皆為 x64 安裝套件。
Desktop 採用 Avalonia 介面，適合希望在多種桌面系統間維持相近操作習慣的使用者。節點管理、訂閱更新與設定入口皆以桌面工作流程為主。教學中的選單名稱可能隨介面版本調整；若設定位置不同，請依功能名稱尋找，不要只對照截圖中的位置。
WPF 版專為 Windows 設計，保留經典的清單、選單與設定視窗，適合已熟悉這套介面的使用者。選擇不同介面不代表連線協定速度有所差異；連線結果仍取決於核心支援、伺服器參數與網路狀況。切換介面版本前請先匯出設定，避免在兩個執行個體中重複修改訂閱。
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 系統與處理器 | 本頁兩個套件皆為 x64；系統版本是否支援，請以對應的發行說明為準。 | 在系統設定的「系統資訊」或「關於」中查看系統類型。 |
| 執行環境 | 相依需求可能隨客戶端版本調整。 | 若啟動時提示缺少執行環境，請依提示安裝相符元件後再試。 |
| 目錄與權限 | 一般代理功能與需要提升權限的功能應分開判斷。 | 選擇可正常讀寫的目錄；只有需要虛擬網卡功能時，才依提示授予權限。 |
若系統類型不是 x64，請勿只因檔名含有 Windows 就安裝。先確認系統是否支援該架構的程式；模擬執行能力與客戶端功能相容性是兩回事。
依處理器選擇 DMG。Apple Silicon 適用 arm64，Intel 適用 x64；建議優先使用符合本機架構的安裝套件。
從系統選單開啟「關於這台 Mac」，查看「晶片」或「處理器」欄位。若顯示 Apple 晶片型號，請選擇 Apple Silicon 套件；若顯示 Intel 處理器，則選擇 Intel 套件。不要依外觀或購買年份推測；外觀相同的裝置可能採用不同處理器，也不能只憑檔案大小判斷安裝套件。
開啟 DMG 後，依視窗提示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。首次開啟若出現系統安全性提示，請先確認提示中的程式與下載來源，再依系統設定提供的流程處理。不要將關閉整體系統安全機制當作一般安裝步驟，也不要長期從掛載的磁碟映像執行應用程式。
匯入設定後，先測試客戶端內的節點連線，再設定系統代理。應用程式的連線要求是否會進入客戶端，也取決於該應用程式是否遵循系統代理設定。若需使用虛擬網卡，請另外詳閱權限提示與相關教學，避免將安裝成功直接視為所有應用程式都已接入。
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 晶片架構 | Apple Silicon 使用 arm64；Intel 使用 x64。 | 在「關於這台 Mac」查看晶片或處理器資訊。 |
| 系統相容性 | 最低系統版本以該版本的發行需求為準。 | 記下目前的系統版本；舊版系統請先確認介面與相依項目是否支援。 |
| 應用程式與權限 | 使用可正常寫入的應用程式資料夾；額外的流量接管功能可能需要授權。 | 更新前先結束舊版應用程式，首次啟動時逐項閱讀系統提示。 |
Android 優先選擇 v2rayNG。2015 年後推出的主流手機通常選 arm64；若不確定系統架構，可選通用版。
目前下載檔案：v2rayNG_2.3.11_arm64-v8a.apk。頁面版本資訊與檔名分別讀取；安裝後可在「關於」頁面確認實際版本。
arm64 套件適用於相應的應用程式執行架構，通用版則包含更多架構元件。處理器支援 64 位元，不代表系統一定能執行所有 64 位元應用程式；若出現不相容提示，請進一步確認系統資訊。透過瀏覽器或檔案管理員安裝時，只授權目前使用的來源安裝應用程式；安裝完成後，可依個人安全設定撤銷權限。
匯入可用設定並選好節點後，首次啟動連線時會出現系統 VPN 授權提示。這是客戶端接收應用程式流量的系統入口，與節點帳號所需的權限不同。若已有其他 VPN 連線，請先排除衝突。若鎖定螢幕後連線中斷，再檢查電池最佳化與背景執行限制，不必先反覆更換安裝套件。
適用於明確需要 V2Fly 核心環境的設定。選擇前請先確認協定、傳輸方式與設定欄位是否受目前版本支援。
v2flyNG 與 v2rayNG 的介面概念相近，但核心家族與版本更新週期不同。能匯入相同的分享連結，不代表所有擴充參數都能以相同方式運作。尤其是依賴特定核心功能的連線，請先查看設定提供者的說明，再決定是否更換客戶端。
若要比較兩款客戶端，請先備份原有設定，再逐一測試，避免同時啟動連線。若訂閱內容含有不支援的欄位，改用通用架構套件也不會增加協定支援能力；架構影響安裝相容性，核心功能則影響設定相容性，兩者應分開判斷。
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 應用程式執行架構 | 主流裝置優先選 arm64；無法確認時選 universal。 | 查看系統或裝置規格；安裝失敗時記下完整提示。 |
| 系統版本 | 最低版本依各客戶端的發行需求而定。 | 通用套件不代表支援所有舊版系統，請先確認發行需求。 |
| 系統授權 | 安裝來源授權與 VPN 連線授權需分別處理。 | 安裝完成後匯入設定，再確認連線所需的系統提示。 |
| 已安裝應用程式 | 覆蓋更新須符合應用程式簽章與版本條件。 | 若出現簽章不一致提示，請先備份，再決定如何移轉。 |
先依發行版選擇 deb 或 rpm，再確認處理器架構。主要下載項目為 x64，arm64 安裝套件列於下方。
Debian、Ubuntu 及其衍生系統通常使用 deb；Fedora、openSUSE 等系統通常使用 rpm。格式相同不代表適用於所有發行版版本，仍須確認套件相依項目與建置目標。檔名中的 amd64、x86_64 是常見的 x64 架構標記；arm64 與 aarch64 則用於相應的 ARM 64 位元環境。
在檔案管理員中開啟安裝套件，使用系統的軟體安裝程式查看相依項目與安裝位置。若提示缺少相依項目或版本衝突，請先閱讀錯誤詳情，確認發行版與軟體來源狀態。不要只為了繼續安裝就強行忽略相依問題；介面無法啟動、系統匣圖示未顯示與網路連線失敗，也應分別排查。
此處提供的是圖形桌面客戶端，使用時需要可用的桌面工作階段。不同桌面環境對系統匣與自動啟動項目的處理方式可能不同。安裝完成後，先從應用程式選單啟動，確認設定資料夾可正常寫入，再設定登入後自動啟動；自動啟動應用程式與自動連線節點是兩種不同選項。
| 檢查項目 | 選擇依據 | 安裝前處理 |
|---|---|---|
| 套件管理系統 | 依發行版選擇 deb 或 rpm。 | 在系統資訊中確認發行版名稱與版本。 |
| 處理器架構 | x64 對應 amd64 / x86_64；arm64 對應 aarch64。 | 查看系統硬體資訊，勿將套件格式與架構混為一談。 |
| 桌面環境與相依項目 | 需要桌面工作階段，以及目前版本要求的圖形相依項目。 | 讓系統安裝程式檢查相依項目，閱讀衝突資訊後再處理。 |
首次使用時，請準備有權使用的訂閱網址或完整節點參數。若已安裝客戶端，請先透過介面的匯出或備份功能保存目前設定，並記下本機連接埠、核心選擇、路由模式與自訂 DNS。只記錄訂閱網址無法保存手動新增的節點與本機規則；切換介面版本時，尤其要分別保留這些資訊。
訂閱網址可能包含存取憑證，分享連結也可能帶有連線識別資訊。請將備份存放在存取權受控的位置，排查問題時不要直接公開完整設定檔。若截圖包含網址、識別資訊或訂閱參數，請先移除敏感內容，再保留與錯誤相關的欄位。
客戶端能開啟，只表示程式已啟動。接著請在圖形介面新增訂閱或匯入節點，確認清單中出現預期項目，再選擇要使用的連線。訂閱群組與目前使用中的節點是不同概念；更新某個群組，也不一定會自動切換目前的連線。若匯入失敗，請先檢查連結格式與客戶端支援範圍。
測試時一次只變更一項設定。先保留預設監聽位址，確認所選節點的位址、連接埠、協定與傳輸參數完整，再測試連線。不要同時調整 DNS、流量嗅探、路由與本機連接埠，否則很難判斷是哪項變更影響結果。
系統代理設定會影響遵循該設定的應用程式；核心路由則負責分配已進入客戶端的要求。兩者位於不同層。若瀏覽器可以連線、其他應用程式卻沒有變化，請先確認應用程式是否使用系統代理，不要馬上更換客戶端。Android 還需確認 VPN 連線狀態與應用程式範圍設定。
若想了解路由、DNS 與入站之間的關係，可接著閱讀 JSON 設定手冊。手動編輯設定前，請先確認客戶端如何產生執行設定：圖形介面的設定可能會在啟動時重新寫入檔案，直接修改暫時產生的內容不一定能持續生效。
DOWNLOAD NOTES
五項說明，協助選擇安裝套件、確認版本資訊與移轉設定。
客戶端負責讀取設定、管理連線及轉送流量。安裝套件不含可直接使用的伺服器連線資訊。請先準備有權使用的訂閱網址或節點參數，匯入後再選擇節點、設定路由與應用程式代理入口。
Desktop 採用新一代跨平台介面，適合希望在不同桌面系統維持相近操作方式的使用者。WPF 是經典穩定版，適合習慣傳統 Windows 介面的使用者。兩者都必須符合系統架構；切換前請先備份設定，並避免同時監聽相同連接埠。
2015 年後推出的主流手機通常優先選擇 arm64，但仍須確認系統支援相應的應用程式執行環境。若無法確認架構，或 arm64 套件顯示不相容，可改選通用版。通用版支援更多架構，但無法取代客戶端對系統版本的要求。
版本資訊與檔名取自清單中的不同欄位，更新期間可能出現差異。請查看實際下載檔案的名稱，安裝後再透過客戶端的「關於」頁面確認版本；不要依頁面上的版本資訊自行修改下載網址。
先使用客戶端的匯出或備份功能，保存節點、訂閱、路由及自訂設定，並記下目前選用的核心與本機連接埠。更新前先退出正在執行的客戶端。還原後先測試一個連線，再啟用系統代理或其他流量接管方式；備份檔案應妥善保管，視為敏感資訊。