CLIENTS / PACKAGE SELECTION
先選擇作業系統，再選架構與安裝檔。
桌面版使用 v2rayN，Android 優先選擇 v2rayNG。需要相容 V2Fly 設定時，再考慮 v2flyNG。
安裝後查看設定教學 →以下兩個下載入口皆為 x64 架構。請先確認系統類型，再選擇介面版本。
Xray / V2Fly · 繁體中文圖形介面
採用新一代跨平台 UI。第一次安裝，或想在不同桌面系統間延續操作習慣，可優先選擇此版本。
下載桌面版 · x64ZIP 壓縮檔 · 下載後請先解壓縮
經典穩定版，保留熟悉的 Windows 桌面操作方式。已有使用習慣的話，可繼續選擇此版本。
下載經典 WPF 版 · x64ZIP 壓縮檔 · 設定請與桌面版分開保存
版本標記：7.24.1
| 檢查項目 | 需求與判斷方式 | 處理方式 |
|---|---|---|
| 系統架構 | 本頁提供 x64 安裝檔 | 請在系統資訊中確認，不要依裝置外觀判斷。 |
| 系統與執行環境 | 須符合目前版本及其執行階段需求 | 較舊的系統請先確認相容性；若缺少執行階段元件，請依安裝提示處理。 |
| 檔案與權限 | 可寫入的設定位置與完整解壓縮資料夾 | 一般使用系統代理通常不需提升權限；TUN 功能則依提示授權。 |
透過「關於這台 Mac」確認晶片。Apple Silicon 與 Intel 分別有對應的下載入口。
依晶片選擇原生架構
「關於這台 Mac」若顯示 Apple M 系列晶片，請選擇 arm64 安裝檔，優先使用符合處理器架構的原生應用程式。
下載 Apple Silicon · arm64DMG 磁碟映像檔
「關於這台 Mac」若顯示 Intel 處理器，請選擇 x64 安裝檔。請勿只依裝置購買年份推測晶片類型。
下載 Intel · x64DMG 磁碟映像檔
版本標記：7.24.1
| 檢查項目 | 需求與判斷方式 | 處理方式 |
|---|---|---|
| 晶片 | Apple Silicon 選 arm64；Intel 選 x64 | 從 Apple 選單中的「關於這台 Mac」查看。 |
| 系統版本 | 須符合目前版本的需求 | 系統版本過舊時，請先確認相容範圍；更換晶片架構的安裝檔無法解決系統版本限制。 |
| 安裝與網路權限 | 可安裝至「應用程式」資料夾；依功能完成授權 | 分別確認應用程式啟動、系統代理與 TUN 的提示。 |
優先選擇 v2rayNG。只有設定明確需要 V2Fly 核心時，才使用 v2flyNG。
Android 圖形化客戶端 · APK 安裝
2015 年後推出的主流手機通常可優先選擇此版本。裝置仍須支援 64 位元應用程式，不能只依處理器的宣傳規格判斷。
下載 v2rayNG · arm64適用於支援 arm64-v8a 的裝置
包含多種架構。若無法確認裝置架構，或安裝 arm64 時出現不相容提示，可改選通用版，再確認系統需求。
下載 v2rayNG · 通用版支援多種架構，檔案通常較大
清單版本標記：2.2.6。清單會分別維護版本標記與套件檔名；安裝時顯示的應用程式版本請以安裝檔資訊為準。
適用於需要 V2Fly 設定的情境
適用於支援 arm64 應用程式的裝置。選擇前請先確認節點協定與傳輸參數，不要假設兩種核心的所有欄位都能互換。
下載 v2flyNG · arm64V2Fly 核心 · APK
適用於尚未確認架構的裝置。通用安裝檔涵蓋更多處理器架構，但不會自動增加核心支援的協定功能。
下載 v2flyNG · 通用版多架構安裝檔 · APK
版本標記：1.10.31
系統要求允許目前使用的瀏覽器或檔案管理員安裝應用程式時，只授權實際用來安裝的來源。安裝完成後，可依需求撤銷該來源的安裝權限。首次啟動並連線時會出現 VPN 授權提示，確認後才能建立本機轉送通道。
同一台裝置上的其他 VPN 應用程式可能占用此通道。測試連線前，請先中止其他同類連線，再檢查系統狀態列與客戶端記錄。若切換至背景後頻繁中斷，也應檢查系統的電池最佳化、自動啟動與背景執行限制，而非反覆更換安裝檔。
v2rayNG 與 v2flyNG 的主要差異之一，在於使用的核心不同。協定名稱相同，不代表所有傳輸方式、安全設定與新增欄位都完全一致。使用 REALITY、flow 或特定傳輸方式時，請先確認所選客戶端目前使用的核心是否支援。
升級時若出現簽章不一致的提示，請勿直接解除安裝。先匯出可保存的節點與路由設定，確認目前安裝的應用程式來自哪個發行管道，再決定是否移轉。解除安裝可能連同應用程式資料一併刪除，訂閱網址也未必能從系統備份還原。
| 檢查項目 | 需求與判斷方式 | 處理方式 |
|---|---|---|
| 應用程式架構 | arm64 或通用版 | 優先確認裝置支援的應用程式 ABI；不確定時請選通用版。 |
| 系統相容性 | 符合所選應用程式版本的最低需求 | 安裝程式提示系統版本過低時，通用版無法取代系統升級。 |
| 權限與儲存空間 | 安裝來源授權、VPN 授權與足夠的儲存空間 | 下載與安裝都需要儲存空間；連線前請確認 VPN 權限。 |
| 覆蓋升級 | 應用程式識別碼與簽章相容 | 保留資料後再處理發行管道移轉，請勿貿然解除安裝。 |
先確認發行版採用的套件管理系統。deb 與 rpm 是兩種安裝格式，不是兩種連線模式。
圖形桌面環境 · x64 與 arm64
適用於支援 deb 套件管理系統的相容發行版。一般 x64 桌面裝置選擇主要下載入口；ARM 裝置請選下方的 arm64 套件。
下載 deb · x64 ARM 裝置：下載 deb · arm64 →適用於採用 rpm 套件管理系統且符合套件相依需求的發行版。副檔名相符只是第一步，也須符合系統程式庫版本需求。
下載 rpm · x64 ARM 裝置：下載 rpm · arm64 →版本標記：7.24.1
| 檢查項目 | 需求與判斷方式 | 處理方式 |
|---|---|---|
| 架構 | x64 或 arm64 | 請同時確認系統架構與套件檔案架構。 |
| 套件系統與相依性 | deb / rpm，並符合目前套件的相依需求 | 使用發行版的軟體安裝程式檢查，勿跨套件系統強行安裝。 |
| 執行環境 | 可用的圖形桌面工作階段與所需系統程式庫 | 純命令列環境不適用於此處提供的圖形化客戶端。 |
| 功能權限 | 分別設定系統代理與 TUN | 依實際功能授權，不要提升整個日常工作階段的權限。 |
INSTALLATION / CONFIGURATION
01 / IMPORT
客戶端安裝完成後，仍須匯入自行取得且有權使用的訂閱連結、分享連結或設定檔。訂閱用來取得節點參數，安裝檔本身不包含可連線的節點。請先確認複製的內容完整，再透過客戶端的匯入功能新增；一般網頁網址不能當作訂閱網址使用。
訂閱連結可能包含帳戶識別資訊或存取權杖，請視為敏感資訊妥善保存。若解析失敗，先檢查連結是否過期、回傳內容是否為登入頁面，以及提供者要求的格式。請勿將私人連結上傳至不熟悉的線上轉換工具。
02 / ROUTING
匯入後，先選擇參數完整的節點，再決定使用系統代理或 TUN。系統代理主要影響遵循系統代理設定的應用程式；TUN 的流量涵蓋範圍不同，通常也需要額外權限。初次測試可先使用結構較簡單的設定，確認基本連線後再加入複雜的分流規則。
路由模式決定要求如何選擇出口，不會修改伺服器協定。切換分流規則後，應重新載入設定並建立新的要求。瀏覽器中已存在的連線可能繼續沿用原本的路徑，不能只看已開啟的頁面能否重新整理。
03 / VERIFY
查看客戶端是否正常啟動監聽，再透過瀏覽器送出新的要求，搭配記錄判斷實際出口。連接埠可連線不代表代理要求成功，延遲測試也不能取代實際瀏覽驗證。先排除節點參數與系統時間問題，再檢查 DNS、路由及應用程式是否遵循代理設定。
若只有特定應用程式連線異常，請優先檢查該應用程式本身的網路設定，不要立刻重新安裝客戶端。可穩定重現的錯誤訊息，比「無法連線」更有助於診斷；記錄時請保留錯誤類型，並隱藏訂閱網址、認證資訊與私人伺服器識別資料。
MAINTENANCE / BACKUP
程式更新與設定移轉是兩回事。更換應用程式檔案前，請先保存可還原的資料。
更新前，使用客戶端目前提供的匯出或備份功能，保存訂閱群組、手動新增的節點、自訂路由與 DNS 設定。也請記下本機監聽連接埠、系統代理方式，以及是否啟用 TUN。只記下訂閱網址不一定能還原手動規則；只複製程式檔案，也不一定包含使用者資料夾。
先關閉舊版客戶端再安裝，避免檔案遭執行中的程序占用。更新後首次啟動，先確認群組與節點是否保留，再查看核心是否成功載入，最後測試代理要求。若要改回舊版，請保留更新前的設定副本，不要讓不同版本輪流改寫唯一一份資料。
判斷安裝檔格式時，也要一併確認執行條件。架構不符通常會在安裝或啟動時顯現；系統程式庫、執行階段或權限問題也可能讓程式無法啟動。相較之下，訂閱過期、伺服器參數不一致及 DNS 規則錯誤都屬於設定問題，改用其他架構的安裝檔通常無濟於事。
DOWNLOAD / QUESTIONS
第一次安裝可先選桌面版 Desktop，採用新一代跨平台介面。經典 WPF 版則保留傳統 Windows 操作方式，適合想延續既有使用習慣的使用者。兩個版本的設定應分開保存；切換前請先備份，避免同時接管系統代理。
2015 年後推出的主流手機通常可優先選 arm64，但仍應以裝置支援的應用程式架構為準。通用版包含多種架構，適合無法確認架構或安裝 arm64 時出現不相容提示的裝置；通用版仍須符合客戶端的系統需求。
安裝檔只提供客戶端程式，不包含節點帳號或訂閱。安裝後須匯入自行取得且有權使用的訂閱連結、分享連結或設定，再選擇節點並測試連線。訂閱連結屬於敏感資訊，請勿公開。
先使用客戶端提供的匯出或備份功能，保存訂閱群組、手動新增的節點、自訂路由與 DNS 設定，並記下本機監聽連接埠。關閉舊版程式後再安裝；首次啟動時檢查設定是否成功移轉，請勿直接刪除舊設定資料夾。
先查看客戶端記錄，確認訂閱有效、節點參數完整、系統時間正確，且代理或 VPN 權限已啟用。接著檢查本機連接埠衝突、路由模式與 DNS 設定。只有安裝檔無法開啟、架構選錯或程式檔案缺漏時，才優先處理安裝問題。