用戶端安裝檔
V2Ray 下載
V2Ray 下載
依系統選擇用戶端
桌面系統請選 v2rayN，Android 優先選 v2rayNG。先確認處理器架構，再下載適用的安裝檔。
已有訂閱嗎？安裝完成後，接著查看訂閱匯入步驟。初次使用時，請先完成一般代理連線，再設定路由與 TUN。
Windows：v2rayN
同一款用戶端，兩種介面。以下安裝檔皆適用於 x64 系統。
Windows 安裝需求
| 檢查項目 | 需求與操作方式 |
|---|---|
| 處理器架構 | 本頁提供的兩種安裝檔皆為 x64。請在系統設定的「系統資訊」中查看系統類型，不要將檔名中的 x64 誤認為適用所有架構。 |
| 系統與執行環境 | 請使用目前用戶端支援的 Windows 版本；最低版本與執行環境以安裝程式提示為準。若缺少相依元件，請依提示補齊。 |
| 檔案與權限 | 請將壓縮檔完整解壓縮至可寫入的資料夾。一般系統代理設定通常不需要全程以系統管理員身分執行；使用 TUN 可能需要提高權限。 |
安裝後先檢查系統代理
啟動 v2rayN 後，先匯入訂閱、更新伺服器清單並設定使用中的伺服器，再選擇「自動設定系統代理」。此設定主要影響遵循系統代理的應用程式，不代表所有網路流量都會由其接管。若瀏覽器能連線、其他應用程式卻不行，請先檢查該應用程式自己的代理設定，不必急著更換安裝檔。
升級時請先結束舊版用戶端，再執行安裝。桌面版與 WPF 版不建議同時作為日常使用的執行個體，否則系統代理設定可能互相覆寫。安裝後若無法啟動，請先保留錯誤訊息，檢查執行環境與解壓縮資料夾，再判斷是否需要重新安裝。單純反覆覆寫程式檔案，通常無法解決設定或權限造成的問題。
macOS：v2rayN
開啟「關於這台 Mac」，依晶片資訊選擇 DMG 安裝檔。
v2rayN
桌面用戶端macOS 安裝需求
| 檢查項目 | 需求與操作方式 |
|---|---|
| 晶片類型 | Apple M 系列請選 arm64；Intel 處理器請選 x64。可透過系統選單中的「關於這台 Mac」確認。 |
| 系統版本 | 請使用目前用戶端支援的 macOS。若啟動時提示系統版本不符合需求，請先確認提示內容；更換架構不能取代系統升級。 |
| 安裝與授權 | 請先完成應用程式複製再啟動。系統代理、網路延伸功能或 TUN 相關操作可能會要求授權，僅授予目前功能所需的權限。 |
分辨安裝遭阻擋與連線故障
若系統提示涉及應用程式相容性、來源或授權，請先詳閱完整訊息，再到系統設定檢查相關項目。不要將關閉系統防護當成通用安裝步驟，也不要執行來源不明的終端機指令。若應用程式已能開啟，但網路連線失敗，應改為檢查訂閱、伺服器與代理設定，而不是反覆拖曳安裝檔。
啟用系統代理前，請確認沒有其他用戶端同時修改網路代理設定。結束 v2rayN 前，可先清除系統代理，尤其是準備解除安裝或移轉設定時。若結束後瀏覽器仍無法正常連線，請檢查系統網路設定是否留有代理項目，再恢復正常連線。如此可將安裝、授權與實際通訊問題分開處理。
Android：優先選擇 v2rayNG
先安裝首選用戶端；只有明確需要特定核心時，再考慮替代方案。
v2rayNG
首選 Xray 核心v2flyNG
替代選項 V2Fly 核心Android 安裝需求
| 檢查項目 | 需求與操作方式 |
|---|---|
| 應用程式架構 | 請優先確認是否支援 arm64；無法確定時選擇通用版。通用安裝檔仍受系統版本與用戶端相容範圍限制。 |
| 安裝權限 | 系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝應用程式；安裝完成後，可視需要撤銷該來源的安裝權限。 |
| 連線權限 | 首次啟動代理連線時，請閱讀並確認系統 VPN 授權。其他 VPN 應用程式可能占用相同介面，測試前請先中斷連線。 |
保留設定，再處理安裝衝突
遇到「應用程式未安裝」時，先檢查剩餘儲存空間、系統版本與應用程式架構，再確認是否已有同名但簽章不同的版本。不要一遇到錯誤就解除安裝原有應用程式；解除安裝可能同時刪除訂閱群組與本機規則。若確實需要更換安裝來源，請先匯出必要設定，並妥善保存含有訂閱憑證的檔案。
頁面上的版本標示與安裝檔名稱分別來自清單欄位，更新時間可能不同。不要只根據檔名推算頁面標籤，也不要將差異誤認為安裝失敗。安裝後請前往用戶端的「關於」頁面查看實際建置版本；驗證連線時，請進行實際連線測試，並確認需要代理的應用程式已納入用戶端的應用程式分流範圍。
Linux：v2rayN
先確認發行版使用的套件管理系統，再核對處理器架構。
v2rayN
圖形介面桌面用戶端Linux 安裝需求
| 檢查項目 | 需求與操作方式 |
|---|---|
| 桌面環境 | 本頁提供圖形介面用戶端，需具備可用的圖形桌面與相應執行相依元件；這些套件並非用於部署背景服務的說明。 |
| 套件格式與相依性 | 依發行版選擇 deb 或 rpm，並使用軟體安裝程式檢查相依性。若缺少相依元件或目標環境不符，請先處理相容性問題。 |
| 處理器架構 | 一般 x64 電腦請選主要按鈕；arm64 裝置請使用卡片中的小字連結。架構必須與系統使用者空間相符。 |
| 網路權限 | 應用程式是否遵循系統代理，取決於桌面環境與應用程式本身的行為。TUN 可能需要額外權限，請先測試一般代理連線。 |
先完成桌面代理測試
安裝完成後，從應用程式選單啟動 v2rayN，再匯入訂閱並選擇使用中的伺服器。Linux 桌面上的瀏覽器、命令列程式與其他應用程式不一定共用同一套代理設定，因此「用戶端正在執行」不代表所有應用程式都已透過代理連線。請先在明確遵循系統代理的應用程式中測試，再逐一檢查其他應用程式的網路行為。
若軟體安裝程式回報相依性無法滿足，請記下具體套件名稱與版本需求，不要強制略過相依性。升級前記錄程式使用的設定位置，並保留自訂路由與 DNS 設定。遇到權限問題時，優先授予功能所需權限，不要將日常圖形工作階段整體改為高權限執行。
安裝與升級先處理設定，再測試連線
安裝檔只負責部署程式。訂閱、使用中的伺服器與代理模式，仍須在用戶端中設定。
初次安裝：依序完成設定
先確認下載檔案的架構與裝置相符，再完成解壓縮或安裝。啟動用戶端後新增訂閱群組，填入有權使用的訂閱網址並儲存，接著更新訂閱。看到伺服器清單後，選擇設定完整的伺服器並設為使用中項目，最後啟用相應的系統代理或 VPN 連線。
更新訂閱只會取得伺服器設定，不會自動選擇使用中的伺服器。初次測試請使用預設或基本路由，暫時不要調整複雜的 DNS 與 TUN 參數。先建立可用的連線，之後每次只修改一項設定，才能判斷問題出在哪個步驟。
繼續閱讀訂閱匯入方式 →覆蓋升級：先備份並結束用戶端
備份訂閱群組、自訂路由、DNS 設定與手動新增的伺服器資訊。備份檔可能包含存取憑證，請勿上傳至公開空間或直接放入求助截圖。先結束正在執行的用戶端，再進行安裝；不要在程式仍寫入設定時複製整個設定資料夾。
升級後請確認訂閱仍在、使用中的伺服器正確，且代理模式符合預期。確認瀏覽器與常用應用程式都能正常連線後，再清除舊資料夾。跨介面或跨用戶端移轉時，不要直接覆寫格式不明的設定檔，請優先使用用戶端支援的匯入方式。
查看完整維護流程 →安裝檔選擇與下載常見問題
先確認架構與套件格式，再處理安裝和連線問題。
Windows 桌面版與 WPF 版該選哪一個？
初次使用可先選採用新一代跨平台介面的桌面版 Desktop；習慣經典介面的使用者可選穩定的 WPF 版。兩者都是 v2rayN，切換前請先備份設定，避免兩個用戶端同時修改系統代理。
Android 該下載 arm64 還是通用版？
2015 年後推出的主流手機通常可優先選 arm64，但仍應確認系統支援的應用程式架構。無法確認架構，或 arm64 安裝檔無法安裝時，可試試通用版。通用版不會增加功能，仍須符合用戶端的系統需求。
下載用戶端後就已經包含訂閱嗎？
安裝檔只提供用戶端程式，不包含可直接使用的訂閱。請自行準備有權使用的訂閱網址或伺服器設定，匯入並更新訂閱後，再選擇使用中的伺服器並設定代理模式。
更新安裝檔前應備份哪些內容？
先結束用戶端，備份訂閱群組、自訂路由、DNS 和其他手動修改的設定。備份檔可能包含訂閱憑證，請存放在受控的位置。保留原設定副本，確認新版連線正常後再清除舊檔案。
Android 版本標示與安裝檔名稱為何可能不同？
清單中的版本標籤與安裝檔路徑是各自獨立的欄位，更新時間可能不同。頁面會保留清單提供的標籤與下載路徑，不會根據檔名推算版本；安裝後可在用戶端的「關於」頁面查看實際建置版本。
安裝成功後為什麼還是無法連線？
先確認訂閱是否更新成功、是否選取使用中的伺服器，再確認系統代理或 Android VPN 授權是否已啟用。接著查看記錄中的連線錯誤，依序檢查伺服器設定、系統時間、DNS 與路由；不要一次修改多項設定。