CLIENT PACKAGES / 客戶端安裝
桌面端選 v2rayN，Android 優先選 v2rayNG。先選作業系統，再依處理器架構下載，避免安裝檔與裝置不相容。
依裝置選擇
平台選擇會保留在網址中，可複製目前頁面的連結。
兩個下載入口都是 x64 壓縮檔，下載後請先完整解壓縮，再開啟其中的安裝程式。
採用新一代跨平台介面，適合初次安裝，或希望在不同桌面系統使用相近介面的使用者。
下載桌面版 · x64v2rayN-Desktop-Setup-x64-7.24.1.zip
經典穩定版，採用傳統 Windows 介面。熟悉舊版選單配置，或習慣原有操作方式時可選。
下載經典 WPF 版 · x64v2rayN-Setup-x64-7.24.1.zip
兩個版本的主要差異在介面技術與配置，不代表同一台伺服器在其中一版必定更快。初次設定建議只執行其中一版，以免占用相同的本機連接埠。
| 檢查項目 | 下載前確認 |
|---|---|
| 系統架構 | 本頁提供 x64 套件。請至「設定 → 系統 → 系統資訊」查看系統類型。 |
| 執行環境 | 請依安裝程式的系統與執行階段提示操作；缺少元件時依提示補齊。 |
| 資料夾權限 | 請保留可寫入的設定資料夾；不要直接在壓縮檔預覽視窗中執行程式。 |
| 代理權限 | 一般系統代理與 Tun 的權限需求不同，請先測試基本代理連線。 |
先將壓縮檔解壓縮至獨立資料夾，再執行安裝程式。初次開啟時，確認視窗能正常顯示，並留意執行環境提示。暫時沒有伺服器清單時，不必反覆重裝客戶端；清單空白通常只是尚未匯入設定。
在「訂閱群組設定」中新增訂閱網址並儲存，再執行「更新訂閱（不透過代理）」。若訂閱服務明確要求透過代理更新，再依實際情況調整。選擇有效設定後，在「系統代理」中點選「自動設定系統代理」，再用瀏覽器測試。
從經典 WPF 版切換至桌面版前，請先匯出設定並記下路由模式。關閉舊版後再開啟新版，並確認本機監聽連接埠未被其他程式占用。暫時不需要代理時，請在結束客戶端前清除系統代理，避免瀏覽器繼續連到已停止的本機連接埠。
查看初次安裝與初始設定 →開啟系統選單中的「關於這台 Mac」，依晶片或處理器名稱選擇 DMG。
若「關於這台 Mac」顯示 Apple 系列晶片，請選擇此套件，使用適用該晶片架構的原生 App。
下載 Apple Silicon 版v2rayN-macos-arm64.dmg
若「關於這台 Mac」顯示 Intel 處理器，請選擇此套件。請勿只憑電腦外觀或購買年份判斷。
下載 Intel 版v2rayN-macos-64.dmg
下載後開啟 DMG，將 App 移至「應用程式」資料夾，再從該資料夾啟動。複製完成後即可退出磁碟映像檔。
| 檢查項目 | 下載前確認 |
|---|---|
| 晶片類型 | Apple Silicon 對應 arm64；Intel 對應 x64。 |
| 系統相容性 | 請以目前安裝檔的相容性提示為準；較舊的系統須先確認是否能執行。 |
| 安裝位置 | 請將 App 複製至「應用程式」，不要長期直接從磁碟映像檔執行。 |
| 系統授權 | 變更代理設定或啟用 Tun 時，可能需要系統授權或管理員權限。 |
先完成 App 複製，再啟動客戶端。系統顯示安全性提示時，請先確認下載來源與提示內容；若需要允許開啟，可前往「系統設定 → 隱私權與安全性」查看相關選項。請勿為了解決單一 App 的啟動問題而關閉整套系統安全機制。
開啟後先匯入有效訂閱，確認伺服器設定已出現在清單中，再設定系統代理。桌面 App 不一定都會遵循系統代理，因此請先用瀏覽器測試基本連線；只有特定 App 仍無法使用時，再檢查該 App 的代理設定或了解 Tun。
升級前先結束正在執行的舊版 App，保留訂閱與路由設定，再替換 App 檔案。若更新後介面可以開啟但網頁無法瀏覽，請優先檢查系統代理狀態與本機連接埠，不要立即更換協定。結束客戶端後若網路異常，也請先確認系統代理是否仍指向本機位址。
查看桌面端設定步驟 →2015 年後推出的主流手機通常可選 arm64；不確定裝置架構時可選通用版，並以裝置實際相容性為準。
適用於支援 64 位元應用程式的主流 Android 裝置。請優先依裝置架構選擇，不要只看處理器的行銷名稱。
下載 v2rayNG · arm64v2rayNG_2.3.11_arm64-v8a.apk
支援更多處理器架構。若不確定裝置資訊，或 arm64 套件顯示不相容，可試用此版本。
下載 v2rayNG · 通用版v2rayNG_2.3.11_universal.apk
卡片版本資訊與各平台檔案網址可能分別更新。下載檔名請見入口下方；實際安裝版本以客戶端的「關於」頁面為準。
適合明確需要 v2fly 核心，且裝置支援 64 位元應用程式的使用者。請先確認訂閱中的協定參數是否受支援。
下載 v2flyNG · arm64v2flyNG_1.10.31-fdroid_arm64-v8a.apk
提供給不確定裝置架構的使用者作為替代選項。安裝檔與裝置相容，不代表能解析所有訂閱與協定組合。
下載 v2flyNG · 通用版v2flyNG_1.10.31-fdroid_universal.apk
v2rayNG 與 v2flyNG 採用不同的核心生態。不要只因名稱相似，就認定所有設定參數都能直接互換。
| 檢查項目 | 下載前確認 |
|---|---|
| 應用程式架構 | arm64 需要系統支援 64 位元應用程式；不確定時可考慮通用版。 |
| 安裝權限 | 依系統提示，暫時允許目前使用的瀏覽器或檔案管理員安裝應用程式。 |
| 系統版本 | 請以安裝程式的相容性提示為準；通用版無法解決系統版本過舊的問題。 |
| 連線授權 | 初次啟動連線時，請確認系統 VPN 授權要求，避免同時由其他 VPN 應用程式接管連線。 |
安裝後開啟側邊選單，進入「訂閱群組設定」，新增名稱與訂閱網址，儲存後返回主畫面更新訂閱。不同版本的選單位置可能略有差異，重點是先儲存群組，再更新內容；只貼上網址而未更新，伺服器清單不會自動出現。
選取一筆有效設定，再點選連線按鈕。系統顯示 VPN 授權提示時，請確認要求來自目前使用的客戶端。狀態列出現連線圖示，只代表系統通道已啟動，仍須開啟瀏覽器測試是否能正常連線。匯入失敗時，先檢查訂閱網址是否完整、是否過期，再確認客戶端能否辨識其中的協定。
升級安裝時若出現簽章衝突，請勿立即解除安裝舊版。先匯出或備份設定，確認新舊版本的安裝來源與簽章是否一致，再決定如何移轉。系統省電策略也可能中斷背景連線；只有確實遇到背景程式遭停止時，再到應用程式的電池設定調整限制，並留意耗電量變化。
查看 v2rayNG 使用教學 →先確認發行版使用 deb 或 rpm，再依 x64 或 arm64 選擇。套件格式與處理器架構都必須相符。
適用於使用 deb 套件管理的發行版，常見於 Debian、Ubuntu 及採用相同套件格式的桌面系統。
下載 deb · x64v2rayn_7.24.1_amd64.deb
ARM 裝置：下載 deb · arm64 ↗
適用於使用 rpm 套件管理的發行版。安裝前仍須確認套件與目前發行版的相依環境相容。
下載 rpm · x64v2rayN-7.24.1-1.el10.x86_64.rpm
ARM 裝置：下載 rpm · arm64 ↗
檔名中的 amd64、x86_64 通常都代表 x64；arm64、aarch64 則代表 ARM 64 位元。請勿以重新命名檔案或更改副檔名的方式轉換安裝套件。
| 檢查項目 | 下載前確認 |
|---|---|
| 桌面環境 | 本頁提供圖形化客戶端，需要可用的桌面工作階段。 |
| 套件格式 | 請在系統資訊或軟體管理工具中確認發行版與套件管理類型。 |
| 處理器架構 | 一般 Intel、AMD 桌面裝置通常選 x64；ARM 裝置請確認是否為 arm64。 |
| 相依套件與權限 | 使用系統軟體安裝程式查看相依套件提示；系統代理與 Tun 的權限須分開處理。 |
下載符合格式的檔案後，使用系統軟體安裝程式開啟，先閱讀相依套件與相容性提示，再確認安裝。部分發行版雖然使用相同副檔名，基礎函式庫版本卻不同；若安裝程式提示相依套件無法滿足，請先確認相容性，不要把忽略相依套件當成一般安裝方式。
從應用程式選單啟動 v2rayN，匯入訂閱並選擇有效設定。Linux 桌面環境對系統代理的處理方式並不完全相同，有些應用程式也會使用自己的代理選項。若瀏覽器能連線、其他應用程式卻不行，請先確認目標應用程式是否遵循桌面系統代理，再考慮其他接管方式。
啟用 Tun 前，請先了解額外權限與路由變更，避免同時執行多個接管網路的程式。升級前保留設定，關閉舊版程序後再安裝新套件。若新版無法啟動，請記下軟體安裝程式或客戶端顯示的錯誤訊息，判斷問題來自桌面相依套件、權限或設定。
查看核心相容性與協定參考 →安裝完成後
客戶端是管理設定與建立連線的工具，訂閱則提供伺服器參數。先確認訂閱網址有效，更新後選擇一筆設定，再設定代理模式。初次測試時不要同時修改訂閱、路由、DNS 與核心；每次只調整一項，才能判斷變化原因。
系統代理只會影響遵循該設定的應用程式。桌面端可先使用「自動設定系統代理」，Android 則須確認系統 VPN 授權。瀏覽器測試成功後，再設定其他應用程式的連線方式。若顯示已連線卻無法瀏覽網頁，請依序檢查系統代理、本機連接埠、路由、DNS 與伺服器狀態。
更新客戶端前，請備份訂閱群組、自訂路由與手動新增的伺服器設定。訂閱網址可能包含個人存取憑證，請勿直接放入公開截圖或求助內容。描述問題時，保留錯誤訊息與操作步驟，並隱藏網址中的個人資訊。
客戶端介面與核心屬於不同層次。介面能儲存某個選項，不代表目前使用的核心一定支援該參數；更換客戶端也不保證訂閱能自動相容。選擇 VMess、VLESS、REALITY 等協定時，請先對照協定與核心的支援情況，再匯入完整參數。
查看顯示已連線但無法瀏覽的排查清單 →下載常見問題
請準備有效的訂閱網址或完整伺服器設定。客戶端負責讀取設定並建立連線，安裝檔本身不含可用伺服器。在 v2rayN 中開啟「訂閱群組設定」並儲存網址，再更新訂閱；在 v2rayNG 中開啟「訂閱群組設定」，新增後更新目前群組。
初次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。經典 WPF 版使用傳統 Windows 介面，適合習慣舊版配置或需要經典穩定版的使用者。兩者都需要有效設定；切換前請先匯出設定，並記下系統代理與路由設定。請勿同時執行兩個客戶端接管相同的代理連接埠。
2015 年後推出的主流手機通常可優先選擇 arm64，但仍須確認裝置系統支援 64 位元應用程式。若不確定裝置架構，或 arm64 安裝檔無法安裝，可改試通用版。通用版支援更多架構，檔案通常較大，但不會因此改善連線品質。
卡片版本資訊與各平台的檔案網址分別維護，更新時間可能不同。下載前請查看入口旁的檔名，安裝後則在客戶端的「關於」頁面確認實際版本。不要只看卡片上的版本號判斷各平台安裝檔版本，也不要自行修改下載網址中的數字。
先確認安裝檔是否符合目前的作業系統與處理器架構。Windows 壓縮檔須完整解壓縮後再執行安裝程式；macOS 請先將 App 移至「應用程式」資料夾；Linux 請檢查套件格式、架構與相依套件提示；Android 則確認安裝權限，以及是否與既有應用程式發生簽章衝突。保留錯誤訊息，再到教學中依照對應步驟排除問題。
初次連線不必啟用 Tun。桌面端可先選擇有效設定，再啟用「自動設定系統代理」，並用瀏覽器測試基本連線。若目標應用程式不遵循系統代理，再了解 Tun 對權限與路由的影響。Android 初次連線時會顯示系統 VPN 授權提示，確認後再繼續。