v2rayN
優先推薦安裝前請先關閉正在執行的客戶端。初次比較兩種介面時,請分別啟動與測試,避免多個程式同時修改系統代理。
CLIENT PACKAGES / 安裝檔選擇
桌面端首選 v2rayN,Android 首選 v2rayNG。先確認作業系統與架構,再選擇安裝檔;下載客戶端和取得服務設定是兩個獨立步驟。
WINDOWS / X64
同一客戶端提供兩種介面版本。初次安裝建議選 Desktop;習慣經典介面再選 WPF。兩個版本皆適用 x64 架構。
安裝前請先關閉正在執行的客戶端。初次比較兩種介面時,請分別啟動與測試,避免多個程式同時修改系統代理。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統環境 | 建議使用仍受支援的 Windows 10 / 11;最低需求請以安裝檔提示為準。 |
| 處理器架構 | 本頁提供的兩個版本皆為 x64,請在系統「設定 → 系統 → 系統資訊」確認系統類型。 |
| 安裝方式 | 請將 ZIP 完整解壓縮至可寫入的資料夾,再執行其中的安裝程式;請勿直接從壓縮檔預覽中啟動。 |
| 執行階段相依元件 | 若安裝程式提示缺少執行階段元件,請依指示安裝相應元件;不要將相依元件錯誤與設定錯誤混為一談。 |
首次開啟後,先匯入一筆已知有效的設定,再選為目前使用的設定。匯入成功只代表客戶端已儲存參數,不代表系統代理已啟用。使用瀏覽器前,請確認客戶端的系統代理設定;命令列終端可能讀取獨立的代理環境變數,需另外確認。
升級時請勿直接刪除舊設定資料夾。先關閉程式並備份,再執行新版安裝程式。啟動後確認訂閱群組、自訂路由與本機連接埠,確認連線正常後再清理舊安裝檔。若只有特定應用程式未經代理,請先檢查該應用程式的代理選項,不要反覆更換安裝檔。
MACOS / ARM64 · X64
請依「關於這台 Mac」顯示的晶片選擇 DMG。Apple Silicon 與 Intel 使用不同架構,不能只根據電腦購買年份判斷。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統環境 | 請使用與目前客戶端版本相容的 macOS;若系統提示版本過舊,請先確認應用程式需求。 |
| 晶片架構 | Apple 選單 → 關於這台 Mac:Apple Silicon 選 arm64,Intel 選 x64。 |
| 安裝方式 | 開啟 DMG,將應用程式拖移至「應用程式」資料夾,複製完成後再啟動。 |
| 權限設定 | 請依系統提示檢查應用程式來源與授權項目,只授予清楚了解用途的權限。 |
應用程式複製完成後,可退出安裝磁碟映像。之後請從「應用程式」資料夾啟動,避免長期從掛載的 DMG 執行。若系統阻止開啟,請先確認下載的架構與系統相容性,再查看「系統設定 → 隱私權與安全性」中的具體說明。不建議為了處理單一應用程式的提示而關閉整體系統防護。
匯入設定後,請確認系統代理指向客戶端目前使用的監聽位址與連接埠。部分瀏覽器擴充功能會接管代理,可能覆寫系統設定;排查時請先只使用一種代理來源。關閉客戶端前恢復系統代理,可避免本機服務停止後,應用程式仍將請求送往舊連接埠。
將既有桌面設定移轉至 Mac 時,通常可以重新新增訂閱網址,但本機路徑、監聽位址與權限相關設定都應逐項確認。請勿直接將其他系統的資料夾路徑複製到自訂設定;若涉及規則檔,請使用目前裝置上實際存在的檔案位置。
ANDROID / ARM64 · UNIVERSAL
先查看 v2rayNG;若需要相容 V2Fly 核心的情境,再查看 v2flyNG。2015 年後的主流手機通常可先選 arm64,仍須以系統實際支援的架構為準。
版本資訊取自應用程式層級的清單,目前顯示的版本可能與個別套件檔名不同。請分別查看套件名稱與版本資訊,詳情請見下方下載常見問題。
| 檢查項目 | 選擇依據 |
|---|---|
| 系統環境 | 請以 APK 安裝程式顯示的相容性需求為準;處理器支援 64 位元,不代表系統一定支援 64 位元應用程式。 |
| 安裝授權 | 只授予實際用來開啟 APK 的瀏覽器或檔案管理員安裝權限,安裝完成後可關閉此授權。 |
| 連線授權 | 首次啟動連線時,請閱讀 Android VPN 連線要求並確認;同一時間只讓一個 VPN 服務接管連線。 |
| 背景執行 | 若鎖定螢幕後連線遭系統中止,請再檢查應用程式的電池最佳化與背景活動設定。 |
下載 APK 後,請從下載通知或檔案管理員開啟。若出現「無法安裝」,請先確認是架構不相符、系統版本不符、既有應用程式簽章不同,還是儲存空間不足。尚未備份設定前,請勿直接解除安裝舊應用程式;解除安裝可能一併刪除應用程式內儲存的訂閱與規則。
匯入設定後,選取一筆設定並啟動連線。系統顯示 VPN 標誌只代表本機 VPN 服務已建立,不表示遠端服務可用;請搭配客戶端記錄檔與實際應用程式請求判斷。若只有部分應用程式經過代理,請檢查客戶端的分應用程式設定與路由規則,確認測試用的應用程式未被排除。
LINUX / DEB · RPM
先依發行版選擇 deb 或 rpm,再確認 x64 或 arm64。套件格式相同不代表執行階段程式庫完全相容,安裝前請查看套件管理器的提示。
arm64 裝置下載入口 · 確認系統架構後選擇
| 檢查項目 | 選擇依據 |
|---|---|
| 桌面環境 | 需要可執行圖形應用程式的桌面工作階段;本頁提供圖形化客戶端套件。 |
| 處理器架構 | x86_64 / amd64 請選 x64;aarch64 / arm64 請選 arm64。 |
| 套件管理系統 | deb 與 rpm 請分別使用對應的軟體安裝程式或套件管理器,並由系統處理相依套件。 |
| 執行階段程式庫相容性 | 請以安裝程式回報的相依項目為準;遇到版本衝突時,不建議強制忽略相依性。 |
請使用發行版的軟體安裝程式開啟下載檔案,查看應用程式資訊與相依項目後再確認安裝。若安裝完成卻無法開啟,請先記下完整錯誤訊息,判斷是圖形環境、執行階段程式庫或檔案權限問題。請勿為了啟動一般桌面應用程式而長期以管理員身分執行整個客戶端。
不同桌面環境處理系統代理的方式不盡相同。客戶端切換系統代理後,仍可能有應用程式使用自己的代理設定;終端程式也可能只讀取環境變數。初次測試時,請選擇代理來源明確的應用程式,確認本機監聽連接埠一致後,再測試其他應用程式。
自訂路由與 DNS 設定須依目前客戶端實際使用的核心確認。套件安裝成功不代表所有設定欄位都受支援。移轉時先用最精簡的設定確認連線,再逐項恢復路由與解析規則,方便找出造成問題的設定。
AFTER INSTALL / 首次設定
客戶端負責儲存並執行設定。服務位址、驗證資訊與訂閱內容由實際服務提供者提供,本頁的安裝檔不包含可直接使用的服務設定。
01 / IMPORT
以 vmess://、vless:// 等協定開頭的分享連結通常對應單筆設定,適合從剪貼簿匯入。訂閱網址通常是完整的網路位址,應新增至訂閱群組後再更新。若將訂閱網址當成單一節點連結貼上,可能無法取得預期內容。
匯入後請確認協定、伺服器位址、連接埠與傳輸設定。記錄檔、螢幕截圖或備份可能包含驗證資訊,提供排查資料前請先移除敏感欄位。
02 / ACTIVATE
匯入只會儲存設定,還須選取該設定並啟動連線。桌面端請檢查系統代理或應用程式本身的代理設定;Android 端請確認 VPN 授權與分應用程式規則。不要讓多個代理程式同時修改相同的系統設定,否則很難判斷請求實際經過哪個程式。
驗證時先確認客戶端是否正常執行,再查看本機監聽狀態與連線記錄,最後測試實際使用的應用程式。遇到錯誤時請保留完整錯誤描述,不要只憑單一狀態標誌判斷原因。
先找出問題出在安裝檔、裝置環境或設定流程,再採取相應處理方式。
初次使用可先選擇 Desktop 桌面版,採用新一代跨平台介面。若熟悉經典介面,或想延續原有操作習慣,可選擇經典穩定的 WPF 版。兩者都建議先備份設定,再分別測試,避免同時接管系統代理。
2015 年後的主流手機通常可先選 arm64,但仍須以裝置系統實際支援的應用程式架構為準。無法確認架構或出現不相容提示時,可改試通用版。通用版包含多種架構元件,檔案通常較大。
版本資訊讀取應用程式層級的 latest 欄位,個別檔案則讀取各平台的 download 欄位,兩者在清單更新期間可能不同步。請分別查看版本資訊與檔名,不要將應用程式層級的版本資訊視為每個檔案的版本說明。
先使用客戶端提供的備份或匯出功能,保存訂閱群組、必要的自訂路由與 DNS 設定,並記下本機監聽連接埠。分享連結和訂閱網址可能包含存取憑證,請將備份存放在安全位置。升級後先測試既有設定,再恢復系統代理或 VPN 連線。
安裝只會提供客戶端程式,還需要有效且經授權的服務設定。匯入訂閱或分享連結後,選取設定並啟動服務;桌面端請確認系統代理或應用程式代理,Android 則確認 VPN 授權。接著參考記錄檔,區分設定、解析與連線問題。