CLIENT PACKAGES / V2RAY
桌面版選 v2rayN，Android 裝置優先選 v2rayNG。先確認作業系統與處理器架構，再下載相應安裝檔。
SELECT YOUR SYSTEM
同一款用戶端可能提供不同介面、處理器架構與套件格式。下方列出主要選項，其他版本接續其後；下載完成後，請依平台說明安裝。
此處提供 x64 安裝檔。請先在系統設定的「系統類型」確認處理器架構，再選擇桌面版或經典 WPF 版；不需要同時安裝兩種介面。
桌面版採用新一代跨平台 UI；經典 WPF 版則保留熟悉的操作配置，提供穩定的傳統介面。首次安裝建議先從桌面版開始。
介面選擇：桌面版適合希望在不同桌面作業系統間維持相近操作方式的使用者；WPF 版適合熟悉傳統選單、伺服器清單與設定位置的使用者。介面不同不代表伺服器設定可以任意互換，移轉時仍應保留原始訂閱和必要的自訂規則。
安裝步驟：下載 ZIP 檔後，先完整解壓縮至獨立資料夾，再執行其中的安裝程式。請勿直接在壓縮軟體中雙擊執行，也不要將新檔案直接覆蓋到仍在執行的舊程式資料夾。依安裝精靈完成安裝後，從開始功能表或安裝位置啟動用戶端。
更新準備：已有設定時，請先匯出或備份，再結束系統匣中的舊執行個體。新舊版本同時執行可能造成監聽連接埠衝突、系統代理反覆變更或設定儲存位置混淆。確認新版本可讀取設定後，再清除不再使用的舊資料夾。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 處理器 | 本頁提供的兩個版本皆為 x64；請在系統資訊中確認，不要憑裝置外觀判斷。 |
| 系統環境 | 請使用仍受支援的 Windows；實際系統版本與執行階段需求，請以該發行版的安裝提示為準。 |
| 安裝檔 | 先解壓縮 ZIP 檔，再執行安裝程式；請保留可寫入的設定位置。 |
| 權限與流量接管 | 一般系統代理與 TUN 所需權限不同；首次使用請先完成一般連線測試。 |
先開啟系統選單中的「關於這台 Mac」。若顯示 Apple 晶片名稱，請選擇 Apple Silicon；若顯示 Intel 處理器，請選擇 Intel。系統名稱相同，不代表安裝檔架構也相同。
依晶片選擇 DMG 安裝檔。Apple Silicon 請選 arm64，Intel 請選 x64；建議優先選擇與裝置原生架構相符的版本。
安裝位置：開啟 DMG 後，依視窗提示將應用程式拖入「應用程式」資料夾，再從該處啟動。請勿長期直接從掛載的磁碟映像執行，以免混淆更新、存取路徑與啟動位置。複製完成後即可退出磁碟映像。
首次啟動：若系統阻擋啟動，請先確認下載來源並閱讀系統提示，再依照「隱私權與安全性」中的支援流程處理。請勿全面關閉安全機制，也不要複製來源不明的終端機指令。若提示應用程式與系統不相容，請先確認晶片與系統版本。
連線準備：安裝成功後，先匯入訂閱並選擇有效伺服器，再開啟系統代理。系統代理只會影響遵循該設定的應用程式；瀏覽器能連線，不代表所有程式都會使用相同出口。若要使用 TUN，請另行參閱權限、路由與 DNS 設定說明。
| 檢查項目 | 需求與處理方式 |
|---|---|
| Apple Silicon | 「關於這台 Mac」顯示 Apple 晶片時，請選擇 arm64 DMG。 |
| Intel | 「關於這台 Mac」顯示 Intel 處理器時，請選擇 x64 DMG。 |
| 系統版本 | 最低系統需求請以該發行版說明和系統安裝提示為準；舊版系統應先確認相容性。 |
| 權限 | 請確認應用程式能正常儲存設定；若要接管系統網路，請依功能提示授權。 |
優先選擇使用 Xray 核心的 v2rayNG；若已有 V2Fly 設定需求，再考慮 v2flyNG。兩者的設定各自管理，切換前請保存訂閱與必要設定，勿預設另一款用戶端能直接讀取資料。
採用 Xray 核心的 Android 用戶端。2015 年後推出的主流手機通常建議優先選 arm64；不確定裝置架構時，可選通用版。
判斷架構：arm64 安裝檔適用於支援該應用程式架構的裝置；通用版包含多種架構，適合無法確認裝置規格時使用。購機年份只能作為初步參考，應以處理器支援能力和系統實際啟用的架構為準。通用版也無法突破 Android 系統版本需求。
安裝與授權：開啟下載的 APK，依系統提示允許目前使用的瀏覽器或檔案管理員安裝應用程式。只授予目前使用來源所需的權限，安裝完成後即可撤銷。首次連線時會出現系統 VPN 授權提示，這是用戶端建立本機流量接管通道所需的確認程序。
版本清單說明：版本標示取自清單中的最新版本欄位，檔案網址則取自平台下載欄位。若兩處數字不同，請保留原下載網址，不要手動更改檔名；實際安裝版本可在應用程式的關於頁面查看。
適合已習慣 V2Fly 設定的使用者。請先確認伺服器協定與設定欄位受目前核心支援，再決定是否更換用戶端。
選擇考量：用戶端介面相似，不代表核心功能完全相同。某個連結能在一款用戶端匯入，不代表所有傳輸參數都能在另一款用戶端中照常運作。若遇到無法辨識的協定欄位，請核對設定參考，不要反覆更換安裝檔。
切換方式：先停止原用戶端的連線，再啟動新用戶端並重新匯入設定。Android 通常一次只能有一個一般 VPN 服務處於啟用狀態，其他 VPN 類應用程式可能與流量接管功能衝突。請保留原用戶端資料，待新設定確認可用後，再決定是否清除。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 應用程式架構 | 支援 arm64 的裝置優先選 arm64；不確定時請選通用版。 |
| 系統相容性 | 請以對應版本的最低系統需求和安裝提示為準；通用版不是舊系統的相容性修補程式。 |
| 安裝來源 | 視需要允許目前用來下載或開啟 APK 的應用程式安裝軟體。 |
| 背景執行 | 若螢幕鎖定後連線中斷，請檢查電池最佳化、背景執行限制與 VPN 服務狀態。 |
先確認發行版使用的套件管理格式，再確認處理器架構。deb 與 rpm 是不同的套件格式；amd64、x86_64 通常表示 x64 架構，arm64、aarch64 則屬於另一組架構標示。
圖形介面桌面用戶端，主要提供 x64 套件。Debian、Ubuntu 等通常選 deb；採用 RPM 套件管理的發行版請選 rpm，並確認發行版相容需求。
安裝方式：下載後使用發行版內建的軟體安裝程式開啟套件，查看相依套件與安裝結果。副檔名相同不代表所有發行版都相容，尤其要留意套件的建置環境、系統函式庫版本與桌面元件需求。若安裝程式提示相依性未滿足，不建議強制忽略。
執行環境：此處提供的版本適用於具備圖形桌面工作階段的裝置。安裝後從應用程式選單啟動，確認主視窗、系統匣與記錄檔是否正常。各桌面環境處理系統代理的方式可能不同，請分別確認瀏覽器和其他應用程式是否採用系統代理設定。
網路流量接管：先以一般代理模式確認伺服器設定可用，再考慮使用 TUN。虛擬網卡、權限、DNS 與路由規則屬於執行設定，並非選擇 deb 或 rpm 就能自動解決。啟用新的接管方式前，請停止其他會修改預設路由的代理程式，避免產生難以追查的衝突。
| 檢查項目 | 需求與處理方式 |
|---|---|
| 套件格式 | 依發行版選擇 deb 或 rpm，不要透過變更副檔名轉換套件格式。 |
| 處理器架構 | x64 請使用 amd64 或 x86_64 套件；arm64 請使用 arm64 或 aarch64 套件。 |
| 桌面相依套件 | 需要可用的圖形桌面與相應相依套件；具體需求請以套件管理員及發行版說明為準。 |
| 安裝權限 | 依系統需求授予安裝權限；程式執行權限與 TUN 權限須分別處理。 |
AFTER INSTALLATION
下載只能取得程式，能否連線還取決於伺服器設定、代理模式與應用程式行為。分階段確認這些環節，比反覆重新安裝更容易找出問題。
DOWNLOAD QUESTIONS
先分清安裝、設定與網路連線三個階段，再決定接下來要檢查什麼。
用戶端負責讀取設定並轉送流量，安裝檔本身不包含可用的伺服器。安裝完成後，需匯入自行取得且有權使用的訂閱網址或伺服器設定，再選擇伺服器並啟用相應的代理模式。
第一次使用可從桌面版開始，它採用新一代跨平台介面；習慣傳統 Windows 操作配置的使用者可選 WPF 版。兩者都是 v2rayN，移轉前請先備份設定，避免兩個執行個體同時接管系統代理或監聽相同連接埠。
2015 年後推出的主流手機通常可優先選擇 arm64，仍須以裝置處理器及系統支援的應用程式架構為準。不確定架構時可選通用版。若安裝失敗，也請檢查系統相容性、剩餘儲存空間及既有應用程式的簽章，別只歸因於架構。
通常先備份，再以相同用戶端、相同發行來源和相同安裝方式更新。桌面版先結束執行中的程式；Android 版在簽章一致時通常可直接覆蓋安裝。若遇到簽章衝突，請勿直接解除安裝，先匯出設定並確認復原方式。
用戶端卡片上的版本標示取自版本清單的 latest 欄位，下載網址則取自對應平台的 download 欄位，兩者是獨立資料。若數字不同，請勿自行修改檔名或拼接網址；安裝後可在用戶端的關於頁面確認實際版本。
先確認用戶端能否正常啟動，再檢查訂閱更新、目前使用的伺服器、系統時間、代理模式與記錄檔。安裝問題和連線問題應分開處理；只有安裝檔無法開啟或程式啟動異常時，才優先檢查安裝步驟與系統相容性。