V2Ray 用戶端下載

系統需求與檔案格式

Windows 安裝步驟

1. 先確認系統架構，再下載一個版本。將 ZIP 完整解壓縮至獨立資料夾，請勿直接從壓縮檔預覽視窗啟動，也不要只抽出其中一個程式檔。
2. 開啟解壓縮資料夾中的安裝程式，閱讀提示並完成安裝。若系統安全防護顯示警告，請先確認檔案來源、名稱與提示內容，再決定是否繼續；切勿為了安裝而直接關閉防護功能。
3. 啟動 v2rayN，新增訂閱群組與訂閱網址，儲存後執行「更新全部訂閱」。設定清單出現後，選取一個設定，再依使用情境設定系統代理。

從 WPF 版改用 Desktop 版前，請先備份原有設定，再檢查新介面中的訂閱群組、路由與 DNS。兩個版本的設定資料夾或匯入方式不一定完全相同。測試時請先結束另一個版本，避免本機監聽連接埠衝突；結束用戶端前清除系統代理，可避免其他應用程式繼續連到舊連接埠。

系統需求與檔案格式

macOS 安裝步驟

1. 開啟下載的 DMG，將 v2rayN 複製到「應用程式」資料夾。複製完成後，請從「應用程式」資料夾啟動，不要一直從掛載的磁碟映像檔執行。
2. 若系統阻止開啟，請先確認檔案來源與系統提示，再到系統設定的「隱私權與安全性」查看相關說明。一般安裝問題不應透過關閉系統安全機制處理。
3. 匯入訂閱並更新設定。建議先使用系統代理測試瀏覽器連線，再視需要設定 TUN；出現權限要求時，請確認要求來自目前啟動的用戶端。

安裝檔架構決定應用程式如何執行，路由規則則決定流量如何轉送，兩者是不同問題。應用程式無法啟動時，先檢查系統版本、處理器與權限；可以啟動但無法連線時，再檢查設定、訂閱與代理模式。更新前請結束舊程序並備份設定，更新後確認本機連接埠，避免瀏覽器仍使用舊的手動代理設定。

系統需求與檔案格式

Android 安裝與初次連線

下載後使用檔案管理員開啟 APK，並閱讀安裝程式提示。若出現「未安裝應用程式」，先檢查架構、儲存空間、系統相容性，以及是否已有簽章不同的舊版。若舊版仍保存設定，請勿直接解除安裝；先匯出可用設定並確認備份檔案位置，再決定如何處理安裝衝突。

開啟用戶端後新增訂閱網址並更新，選取設定後點選連線。首次連線時，系統會顯示 VPN 授權對話框；確認應用程式名稱後再允許。Android 端使用系統 VPN 介面，與桌面端的「自動設定系統代理」操作不同，無法直接套用桌面版的選單步驟。

v2rayNG 與 v2flyNG 可作為不同方案比較，但同一時間只能讓一個應用程式建立 VPN 連線。切換用戶端後，請重新確認選取的設定與路由模式。若鎖定螢幕後連線中斷，先檢查背景限制，再查看記錄，避免將省電策略造成的斷線誤判為訂閱失效。

系統需求與檔案格式

Linux 圖形介面安裝步驟

1. 確認發行版、版本與系統架構，選擇相符的套件。按兩下下載的檔案，使用系統軟體安裝工具查看套件資訊與相依性說明。
2. 使用軟體安裝工具完成安裝並處理相依套件，再從應用程式選單啟動 v2rayN。若找不到應用程式入口，先確認安裝是否完成，再重新載入桌面工作階段或重新登入。
3. 新增並更新訂閱，選取設定後設定代理。不同桌面環境讀取系統代理的方式可能不同，建議先用遵循系統代理設定的瀏覽器測試。

若無法滿足相依套件需求，請記下軟體安裝工具列出的元件名稱與所需版本，再確認發行版相容性。切勿為了完成安裝而強行忽略相依套件。TUN、系統代理與應用程式本身的代理設定屬於不同層級，請逐項測試；終端機工具也不一定會自動遵循桌面系統代理。

若需要登入後自動啟動，請先確認手動啟動與連線均正常，再從桌面環境的「啟動應用程式」新增用戶端捷徑。安裝與自動啟動的詳細說明，請參閱Linux 桌面部署教學。