用戶端安裝套件／作業系統與架構選擇
先選作業系統，再選安裝套件。桌面端使用 v2rayN，Android 首選 v2rayNG，v2flyNG 則是備選。
已有設定？更新前請先備份。初次安裝？下載後請繼續閱讀快速入門教學 →
以下兩個下載項目都是 x64 壓縮套件。初次安裝可先選桌面版；習慣使用 WPF 的使用者可繼續選經典版。
新一代跨平台 UI。適合初次使用，或希望在不同桌面作業系統維持相近操作方式的使用者。
下載桌面版 · x64 ZIP 壓縮檔 · 下載後請先解壓縮經典穩定版，保留熟悉的 Windows 桌面操作版面。適合沿用既有操作習慣與設定流程。
下載 WPF 版 · x64 ZIP 壓縮檔 · 請使用獨立資料夾兩個版本的介面配置、執行環境與部分功能入口可能不同。已有設定時請先備份，再依所選版本的匯入方式進行轉移；勿將兩套程式檔案混放，也不要只為切換介面就覆蓋原有資料夾。
| 檢查項目 | 選擇與操作 |
|---|---|
| 作業系統與架構 | 適用於 Windows x64。前往「設定 → 系統 → 系統資訊」查看系統類型，支援範圍請以目前套件說明為準。 |
| 執行環境 | 不同版本可能需要對應的 .NET 桌面執行環境；若啟動時提示缺少元件，請依提示確認所需架構與類型。 |
| 資料夾與權限 | 請先將 ZIP 完整解壓縮至可寫入的資料夾，再開啟程式。避免直接從壓縮軟體執行，也不要放在受限制的系統資料夾中。 |
| 初次設定 | 準備有效的訂閱或設定，確認本機連接埠未被占用；一般系統代理可正常使用後，再考慮啟用 TUN。 |
初次開啟時，先確認程式能否正常顯示主視窗，別急著修改路由、連接埠或核心。若提示無法寫入設定，請先檢查解壓縮資料夾權限及安全軟體的攔截紀錄；只有明確需要提升權限的功能才使用相應權限，不必將所有啟動問題都歸因於權限不足。
先結束舊用戶端，再啟動新程式，可減少連接埠衝突及系統代理反覆變更的情況。若需要完整操作步驟，請參閱Windows 安裝與設定完整流程，依序完成解壓縮、啟動、匯入及啟用系統代理。
先在「關於這台 Mac」確認晶片。顯示 Apple M 系列就選 Apple Silicon；顯示 Intel 處理器就選 Intel。
適用於 Apple M 系列晶片。優先選擇符合處理器架構的 arm64 套件，避免預設使用轉譯執行方式。
下載 Apple Silicon 版 DMG 磁碟映像檔 · arm64適用於搭載 Intel 處理器的 Mac。請勿只依購買年份判斷，建議先查看系統列出的處理器資訊。
下載 Intel 版 DMG 磁碟映像檔 · x64開啟磁碟映像檔後，依安裝畫面指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。更新現有應用程式前，請先結束正在執行的程式並備份原有設定；不要長期從已掛載的磁碟映像檔執行。
| 檢查項目 | 選擇與操作 |
|---|---|
| 晶片架構 | Apple M 系列使用 arm64；Intel 使用 x64。請透過系統選單中的「關於這台 Mac」確認。 |
| 系統相容性 | 確認目前系統符合安裝套件需求；舊版系統若無法啟動，請先查看具體的相容性提示。 |
| 應用程式位置 | 請安裝至「應用程式」資料夾並從該處啟動。更新時先結束舊版程序，再替換應用程式。 |
| 網路權限 | 依需求允許網路相關操作；涉及系統代理或 TUN 的權限要求，請先確認來源與用途再授權。 |
遇到安全提示時，請先閱讀具體原因，再到系統設定的「隱私權與安全性」查看相關紀錄。系統版本不相容、檔案尚未下載完成與架構選錯是不同問題，不應一律透過關閉防護或執行來源不明的指令處理。
匯入訂閱後，先使用一般系統代理測試瀏覽器。若瀏覽器可正常使用，但其他應用程式仍無法連線，請先確認該應用程式是否遵循系統代理，再決定是否需要 TUN。切換模式前請保留一組已驗證可用的設定，方便發生問題時還原。
建議先選 v2rayNG。需要使用 V2Fly 核心或確認特定設定的相容性時，再考慮 v2flyNG。
2015 年後推出的主流手機通常優先選此套件，實際仍須依裝置支援的應用程式架構為準。適合大多數新款 Android 裝置。
下載 v2rayNG · arm64 APK 安裝檔 · arm64-v8a無法確認架構時可選用。支援更多架構，安裝檔通常較大；與 arm64 版的差異不在功能數量。
下載 v2rayNG · 通用版 APK 安裝檔 · universalv2rayNG 使用 Xray 核心。匯入設定後，先維持預設網路設定並選取有效設定，再啟動連線並確認系統 VPN 授權。是否支援特定協定或傳輸組合，仍須依目前用戶端、核心與伺服器參數判斷。
適用於支援 arm64 應用程式的裝置。需要 V2Fly 核心時可選此用戶端，不必只為了排查網路問題就同時更換所有設定。
下載 v2flyNG · arm64 APK 安裝檔 · arm64-v8a適用於架構不明或需要相容其他架構的裝置。安裝前請確認系統版本符合需求，並預留足夠的儲存空間。
下載 v2flyNG · 通用版 APK 安裝檔 · universalv2flyNG 與 v2rayNG 是不同應用程式，設定和權限都須分別確認。不要假設從另一個用戶端複製的進階設定可以直接沿用；尤其更換核心後，應重新確認協定、傳輸方式與網域策略。
| 檢查項目 | 選擇與操作 |
|---|---|
| 裝置架構 | 主流裝置通常選 arm64；仍須以系統支援的應用程式架構為準，不確定時可試用通用版。 |
| 系統版本 | 請以所選 APK 的安裝需求為準；若顯示剖析失敗，請同時檢查系統相容性及檔案是否完整下載。 |
| 安裝權限 | 依系統提示，授予實際開啟 APK 的瀏覽器或檔案管理員安裝權限；安裝完成後可撤銷。 |
| 連線權限 | 首次啟動 VPN 模式時需要系統授權。同一時間只啟用一個使用系統 VPN 通道的應用程式。 |
顯示「應用程式未安裝」不一定是架構錯誤，也可能與既有應用程式的簽章、安裝來源或版本有關。請先備份設定並確認舊應用程式資訊，避免解除安裝後才發現訂閱與自訂規則都未儲存。請一併查看安裝畫面上的版本資訊與實際下載檔案；頁面上的版本文字僅供參考。
連線後在背景中斷時，請檢查電池最佳化、背景執行與網路權限。依應用程式設定代理會影響哪些應用程式使用代理通道；測試時先確認預設範圍正常，再逐步加入排除規則。若手機已執行其他 VPN 應用程式，請先停止該程式，避免授權後又被其他應用程式取代。
先依發行版選擇 deb 或 rpm，再確認 x64 或 arm64。檔案格式與處理器架構都必須符合。
適用於採用 deb 套件管理系統的發行版，例如 Debian、Ubuntu。仍須確認目前發行版符合相依套件需求。
下載 deb · x64 使用 ARM 裝置？下載 deb · arm64 →適用於採用 rpm 套件管理系統的發行版。套件格式相同，不代表所有系統版本都符合執行環境需求。
下載 rpm · x64 使用 ARM 裝置？下載 rpm · arm64 →建議使用發行版的軟體安裝程式或套件管理員處理相依套件。勿混用 deb 與 rpm，也不要更改副檔名來嘗試安裝。x64 常見架構名稱為 amd64 或 x86_64；arm64 常見名稱為 aarch64。
| 檢查項目 | 選擇與操作 |
|---|---|
| 發行版套件格式 | 確認系統使用 deb 或 rpm，再檢查目前發行版版本是否符合軟體套件的相依需求。 |
| 處理器架構 | 在系統資訊中查看架構；x86_64 選 x64，aarch64 選 arm64，勿依裝置外觀判斷。 |
| 圖形桌面 | 本頁提供圖形介面用戶端，需要可用的桌面工作階段與相應圖形相依套件，不是伺服器背景服務安裝指南。 |
| 代理與權限 | 應用程式是否使用系統代理，取決於桌面環境與應用程式本身；TUN 則另需相關網路權限。 |
安裝程式提示缺少相依套件時，請先查看具體套件名稱與版本限制。不要強行忽略相依套件完成安裝，否則程式可能在啟動時失敗。不同發行版的系統程式庫版本差異很大，僅憑安裝檔副檔名無法判斷相容性。
程式開啟後，先匯入訂閱並測試一般代理連線。部分應用程式不會讀取桌面環境的系統代理，瀏覽器可用不代表所有終端程式都已使用代理。請先確認應用程式使用哪種代理入口，再檢查監聽位址、連接埠與路由；不要直接擴大監聽範圍至整個區域網路。
安裝程式只完成第一步。先匯入設定，再驗證連線，最後調整分流與進階模式。
已有用戶端時，請先停止目前連線，記下系統代理狀態與本機監聽連接埠，再使用用戶端提供的備份或匯出功能保存必要設定。訂閱連結可能含有存取憑證，請妥善保管；分享錯誤截圖前，記得遮蔽相關內容。跨用戶端移轉時，建議重新匯入原始訂閱，不要直接複製用途不明的資料庫或快取檔案。
同一用戶端的例行更新與更換用戶端是兩種不同操作。前者通常沿用原有設定；後者可能涉及不同的欄位、路由與核心功能。更新後先確認原有群組、規則與設定都能讀取，再測試連線；尚未確認前不要刪除舊備份。
用戶端安裝套件不包含訂閱服務。準備好有權使用的訂閱連結後，開啟訂閱群組設定、新增群組並貼上完整網址，儲存後執行更新。若清單為空，請先檢查更新記錄，確認回傳內容可由目前用戶端辨識，不要一再匯入相同連結。
更新成功後，選取要使用的設定，再啟動連線。節點測試僅供輔助判斷連線狀態，不能取代實際應用程式測試。某個設定無法連線時，可改用已知可用的設定進行比對；但不要同時修改 DNS、路由、連接埠與傳輸參數，否則很難判斷是哪個變更解決或造成問題。
桌面端先確認系統代理已啟用，且設定與用戶端的本機監聽連接埠一致；Android 則先確認已完成 VPN 授權。用瀏覽器開啟原本可穩定瀏覽的頁面，再測試目標應用程式。遇到異常時先查看用戶端記錄，區分本機網路故障、訂閱錯誤與連線參數錯誤。
基本連線正常後，再逐項啟用 TUN、依應用程式設定代理與自訂路由。每次只變更一項，並保留可還原的設定。關閉用戶端後若網路異常，請先檢查系統是否仍保留指向已停止程式的代理位址，再決定是否進一步排查。
依安裝套件選擇、設定移轉與首次連線分類。
初次使用可先選桌面版，採用新一代跨平台介面；習慣經典 Windows 版面配置的使用者則可選 WPF 版。兩個版本的設定入口與執行環境可能不同，切換前請先備份設定，並分別使用獨立資料夾，勿將兩版檔案覆蓋在一起。
2015 年後推出的主流手機通常優先選 arm64，但仍應以裝置實際支援的應用程式架構為準。無法確認架構或 arm64 套件無法安裝時，可改試通用版。通用版支援更多架構，檔案通常較大，但不代表功能較多。
用戶端是讀取設定並建立連線的工具，安裝套件不等於訂閱服務。請自行準備有權使用的訂閱連結或伺服器設定，再於訂閱群組中匯入、更新並選取設定。請勿公開含有存取憑證的訂閱連結。
通常不需要先刪除設定。更新前請停止連線、結束用戶端並備份設定；保持應用程式、架構及安裝方式一致。跨桌面版本或更換核心時，請先閱讀相關說明，確認設定可正常讀取後再清理舊檔案。
先確認作業系統、處理器架構與檔案格式，並確定下載已完成。Windows 的 ZIP 檔請先完整解壓縮；macOS 請區分 Apple Silicon 與 Intel；Linux 則須符合發行版的套件格式。遇到安全提示時先查看具體原因，勿直接關閉整體系統防護。
先關閉代理，確認基本網路正常，再檢查訂閱是否更新成功、是否已選取設定，以及用戶端是否正在執行。桌面版請確認系統代理與本機監聽連接埠；Android 請確認 VPN 授權。仍有問題時，依問題診斷頁逐項排除，勿同時變更多組設定。