V2Ray 客戶端下載

Desktop 與 WPF 的安裝及切換

初次使用可先選擇 Desktop。請將下載的壓縮檔完整解壓縮至可寫入的資料夾，再執行其中的安裝程式。不要直接從壓縮軟體的預覽視窗啟動程式，否則暫存資料夾中的檔案可能無法完整保留。若出現執行環境提示，請依安裝程式說明補齊所需元件，再重新啟動客戶端。

已在使用 WPF 版且設定穩定時，可繼續沿用原有介面。兩種介面都可管理訂閱、節點與路由，但選單位置、設定編排及設定儲存方式可能隨版本變動。切換前請使用客戶端提供的備份或匯出功能保存設定，不要直接將舊資料夾中的所有檔案覆蓋至新資料夾，也不要讓兩個客戶端同時修改系統代理。

首次啟動後，先匯入訂閱並選取使用中的節點，再啟用系統代理。只有需要接管不遵循系統代理的應用程式時，才進一步了解 TUN。若視窗能開啟但核心沒有啟動，請先查看客戶端記錄，分辨是連接埠遭占用、設定欄位錯誤還是權限問題。反覆重新安裝介面通常無法修正設定本身的錯誤。

辨識晶片與首次啟動

開啟「關於這台 Mac」後，若晶片欄位顯示 Apple M 系列名稱，請選擇 Apple Silicon 安裝檔；若顯示 Intel 處理器名稱，則選擇 Intel 安裝檔。不要只憑裝置外觀或購買年份判斷。使用符合處理器架構的原生安裝檔，有助於排查相容性問題，也能避免將架構不符誤認為訂閱故障。

下載磁碟映像檔後，開啟檔案並將應用程式複製到「應用程式」資料夾，再從該資料夾啟動。若系統顯示安全性提示，請先閱讀具體原因，再依系統提供的流程前往「系統設定」中的「隱私權與安全性」頁面處理。不要為了啟動單一應用程式而全面關閉系統安全機制；若裝置由組織管理，請先確認是否允許安裝及調整網路設定。

安裝完成後，請檢查選單列中的客戶端狀態，匯入訂閱並選取使用中的設定。系統代理只會影響遵循該設定的應用程式，因此請先用瀏覽器測試，再判斷其他應用程式是否需要額外設定。結束或更換客戶端前，請先還原代理設定；多個工具同時管理同一組系統代理設定時，可能彼此覆蓋，造成看似隨機的連線問題。

架構選擇、安裝授權與核心差異

多數較新的手機可使用 arm64 安裝檔，但處理器支援 64 位元，不代表系統一定允許安裝所有 64 位元應用程式。若裝置資訊不足，可先選擇通用版，讓安裝程式配對適用的元件。出現「應用程式未安裝」時，除了架構，也請檢查剩餘儲存空間、系統相容性、既有應用程式是否使用不同簽章，以及是否嘗試安裝較舊版本。

安裝時只需授予目前使用的下載工具或檔案管理應用程式必要權限，安裝完成後可視需要撤銷。啟動客戶端並匯入設定後，首次啟用連線時會出現系統 VPN 授權對話框，這是建立本機虛擬網路介面的程序，不代表已連上遠端服務。請接著檢查使用中的節點與記錄，再測試應用程式的連線狀況。

選擇 v2rayNG 或 v2flyNG 時，應著重核心功能與設定相容性，而不是把兩者視為可任意互換的外殼。若設定涉及 REALITY、特定流控或較新的傳輸欄位，請確認所選客戶端核心確實支援相應格式。匯入成功只代表客戶端已讀取設定，不代表其中每項功能都能正常運作。

若連線只在切換到背景後中斷，請先檢查系統的電池最佳化與背景執行限制，並視需要允許客戶端在背景持續執行。不要同時啟用另一款需要 VPN 介面的應用程式。更換客戶端前，先停止原有連線並保留訂閱群組與路由記錄，再於新客戶端逐項還原，方便找出問題來源。

套件格式與桌面代理設定

請在系統資訊中確認發行版名稱與處理器架構，再選擇安裝檔。deb 與 rpm 是套件格式，不代表功能等級；x64 與 arm64 是不同處理器架構，也不是新舊版本之分。分別確認這兩項條件，可避免下載到格式正確但架構不符的檔案。

請使用發行版的套件安裝程式開啟下載的檔案，先檢查相依套件解析結果，再執行安裝。若安裝程式指出執行階段函式庫版本不符，請勿強行略過相依性，也不要從不明來源替換系統函式庫。確認套件是否適用時，必須同時考量發行版版本、桌面環境及套件需求，不能只因為屬於同一發行版家族就判定相容。

啟動 v2rayN 後，請先匯入設定並檢查本機監聽連接埠。不同桌面環境支援系統代理設定的方式不同，部分應用程式也可能使用自己的代理選項。瀏覽器能正常連線，不代表所有應用程式都已使用代理；請分別確認目標應用程式是否遵循桌面代理設定，再決定是否設定 TUN。啟用虛擬介面前，先記錄目前的路由，避免與其他網路管理工具互相覆蓋。