用戶端安裝檔／平台與架構
桌面版選 v2rayN，Android 首選 v2rayNG。先確認作業系統，再依處理器與安裝格式選擇檔案。
以下兩個下載項目皆為 x64 安裝檔。桌面版採用跨平台介面，經典 WPF 版則保留熟悉的視窗配置。
桌面代理用戶端 · 7.24.1
檔案為 ZIP 壓縮檔。下載後請先解壓縮至獨立資料夾，再執行其中的安裝程式。
第一次使用可從桌面版開始。它採用新一代跨平台 UI，適合希望在不同桌面系統間維持相近操作習慣的使用者。WPF 是經典穩定版，適合熟悉傳統介面的使用者。兩個版本都能管理訂閱與代理設定，不必為了匯入同一份訂閱而同時安裝。
切換版本前，請先記下原有的訂閱群組、路由選擇與自訂連接埠。不要將兩個程式都設為開機自動啟動，否則可能搶占本機監聽連接埠，或互相改寫系統代理設定。介面差異不會影響伺服器品質，也不代表同一份設定能取得不同的網路資源。
| 檢查項目 | 本頁提供 | 安裝前確認 |
|---|---|---|
| 處理器架構 | x64 | 在「設定 → 系統 → 系統資訊」中確認系統類型 |
| 系統相容性 | Windows 桌面安裝程式 | 請以安裝程式提示為準；舊版系統需確認執行環境是否支援 |
| 檔案格式 | ZIP 內含安裝程式 | 完整解壓縮後再啟動，請勿直接從壓縮檔預覽視窗執行 |
| 權限 | 一般代理與 TUN 可依需求設定 | 僅在安裝程式或 TUN 明確要求時授予管理員權限 |
安裝完成後，先新增訂閱並確認清單中出現伺服器，再選擇系統代理模式。TUN 並非安裝必要步驟；一般瀏覽器使用者可先從系統代理開始，較容易找出設定問題。
開啟 Apple 選單 →「關於這台 Mac」，查看「晶片」或「處理器」欄位，再選擇相符的安裝檔。
macOS 桌面用戶端 · 7.24.1
Apple M 系列晶片請選 Apple Silicon，Intel 處理器請選 Intel。兩個下載項目皆為 DMG 格式。
晶片架構請以系統資訊為準，不要只憑電腦外觀判斷。開啟下載的磁碟映像，依視窗提示將應用程式拖入「應用程式」資料夾，再從該資料夾啟動。請勿長期直接從已掛載的磁碟映像執行，也不要在更新時保留多個位於不同位置、名稱相同的應用程式副本。
首次啟動若遇到系統阻擋，請先確認檔案來源、檔案類型與錯誤提示，再到「系統設定 → 隱私權與安全性」查看是否有該應用程式的處理選項。請勿全面關閉安全檢查。應用程式成功開啟後，再設定訂閱與代理；安裝成功不代表代理連線已建立。
| 檢查項目 | 對應選項 | 確認方式 |
|---|---|---|
| Apple Silicon | arm64 DMG | 「關於這台 Mac」的晶片欄顯示 Apple M 系列 |
| Intel | x64 DMG | 「關於這台 Mac」的處理器欄顯示 Intel |
| 系統相容性 | 請以目前應用程式的需求為準 | 若系統提示版本不相容，請先確認系統更新條件 |
| 應用程式位置 | 「應用程式」資料夾 | 複製完成後，從該資料夾啟動，再退出磁碟映像 |
需要讓遵循系統代理設定的應用程式使用代理時，再於用戶端選擇相應的代理模式。若某個應用程式未走代理，請先確認它是否會讀取系統設定，不要只因這個現象就反覆更換安裝檔。
建議先選 v2rayNG；需要 V2Fly 核心相容性時，再考慮 v2flyNG。兩款用戶端各自管理設定。
Xray 核心 · 2.2.6
2015 年後的主流手機通常可先選 arm64，實際仍以系統支援的 ABI 為準。不確定架構時，可考慮通用版。
v2rayNG 適合作為 Android 的日常選擇。安裝 APK 後，先透過訂閱群組或剪貼簿匯入設定，再選擇要使用的伺服器。首次連線時，系統會要求授權建立 VPN 連線；這是用戶端接管裝置流量的系統入口，不代表已取得可用的遠端服務。
主流手機使用 arm64 安裝檔，通常可縮小下載檔案。通用版包含較多架構程式碼，主要是為了解決安裝相容性問題，不會讓同一份伺服器設定自動變快。較舊的裝置即使處理器支援 64 位元，也可能執行 32 位元系統，因此不能只看處理器的宣傳名稱。
V2Fly 核心備選 · 1.10.31
依裝置架構選擇；安裝與訂閱設定均獨立於 v2rayNG。
若現有設定是以 V2Fly 核心為主，可選擇 v2flyNG。兩款應用程式並非只有名稱不同的同一個程式；實際支援的協定與傳輸方式，取決於各自整合的核心版本。匯入後若有設定無法辨識，請先確認所需功能，不要反覆切換 arm64 與通用版。
測試其他用戶端前，請先停止另一款應用程式的連線。Android 的 VPN 連線通常由單一應用程式接管，同時啟動多個代理應用程式會增加排查難度。也不要為了移轉設定就先刪除原應用程式；確認訂閱與自訂規則已儲存後，再整理舊安裝。
| 檢查項目 | 建議選擇 | 注意事項 |
|---|---|---|
| 系統 ABI | arm64 或通用版 | 硬體架構與系統架構可能不同，請以系統支援情況為準 |
| 安裝格式 | APK | 允許目前使用的瀏覽器或檔案管理應用程式安裝未知來源的應用程式 |
| 系統相容性 | 依 APK 的系統需求而定 | 安裝程式提示系統版本不相容時，請先檢查系統資訊 |
| 連線權限 | 系統 VPN 授權 | 首次連線時確認；測試前先停止其他 VPN 應用程式 |
若安裝程式顯示「應用程式未安裝」，也可能是既有安裝的簽章、版本或儲存空間條件不符。請先保存原有設定並查看錯誤訊息，不要一開始就解除安裝重裝；解除安裝可能會一併刪除本機設定。
先確認套件管理系統，再確認處理器架構。deb 與 rpm 是不同的套件格式，不是兩種功能版本。
Linux 圖形介面用戶端 · 7.24.1
Debian、Ubuntu 系統通常使用 deb；採用 RPM 套件管理系統的發行版則選 rpm，並確認套件相依性相容。
請在系統的「關於」或硬體資訊頁面確認處理器。常見的 Intel、AMD 桌面裝置通常選 x64；arm64 桌面裝置則選擇相應架構。檔名中的 amd64 與 x86_64 都代表 x64；arm64 與 aarch64 則代表相應的 ARM 64 位元架構。
建議使用發行版的軟體安裝程式開啟套件，讓套件管理工具顯示相依性與相容性提示。副檔名相同不代表所有發行版都能安裝，執行環境函式庫版本也會影響結果。請勿強制忽略相依性；應用程式正常啟動後，再逐步設定訂閱、系統代理與路由。
| 檢查項目 | 對應安裝檔 | 安裝前確認 |
|---|---|---|
| Debian 系套件管理 | deb | 使用軟體安裝程式檢查相依性與發行版相容性 |
| RPM 套件管理 | rpm | 確認目前的發行版符合該套件的相依性需求 |
| 處理器架構 | x64 / arm64 | 套件架構必須與系統相符 |
| 執行環境 | 圖形桌面工作階段 | 本頁提供圖形介面用戶端，不適用於伺服器安裝 |
應用程式是否會讀取系統代理設定，取決於桌面環境與應用程式本身的設定。請先用明確支援代理設定的應用程式測試，再評估是否需要 TUN。TUN 需要額外權限與路由設定，第一次啟動時不宜同時變更多項網路設定。
安裝前確認
先確認裝置使用的作業系統，不要只看裝置品牌。接著查看系統提供的處理器與架構資訊，最後選擇安裝格式。同一款用戶端的不同架構套件主要是為了相容性，不會改變訂閱內容，也不代表服務等級不同。
下載卡片上的版本號由版本清單提供，實際檔名也可能包含發行編號。兩者不一致時，不要把顯示的數字當成已安裝版本；安裝完成後，請在用戶端的「關於」頁面確認目前程式資訊。請勿為了讓數字一致而自行修改下載檔名。
第一次設定時，每次只變更一個項目。先確認程式能開啟，再確認設定可成功匯入，最後測試流量是否依預期轉送。
桌面版請在「訂閱群組」中新增群組，填入訂閱網址並儲存，再執行更新訂閱。貼上網址只是儲存訂閱來源；更新成功後，才會出現可選擇的伺服器。若收到的是分享連結，可在主視窗使用從剪貼簿匯入的功能，不要誤填在訂閱網址欄位。
Android 版也要先完成訂閱設定，再更新設定清單。不同用戶端的選單文字可能略有差異，但「儲存訂閱來源」與「取得訂閱內容」是兩個步驟。清單空白時，請先查看更新結果，不要直接認定是安裝檔有問題。
查看訂閱匯入步驟 →桌面版選擇「自動設定系統代理」後，只有遵循系統代理設定的應用程式會使用這個代理入口。路由選項則決定哪些連線走代理、哪些連線直連，與系統代理屬於不同層次的設定。請先確認選取的設定可用，再調整分流規則。
TUN 透過虛擬網路介面接管流量，涉及權限、DNS 與路由設定。它不是安裝必備功能，也不是解決所有連線問題的開關。Android 使用系統 VPN 介面時，請先停止其他正在使用該介面的應用程式。
閱讀代理模式說明 →已有用戶端正常使用時，請在更新前整理需要保留的訂閱群組、手動新增的設定、自訂路由與連接埠設定。訂閱可以重新取得，不代表手動調整的項目也會自動還原。若用戶端提供匯出或備份功能，請先使用，並將備份存放在安裝資料夾之外。
開始安裝前，請關閉正在執行的程式與開機啟動項目。尤其在桌面版與經典版之間切換時，不要同時啟動兩個執行個體來測試相同連接埠。安裝後先確認應用程式資訊，再檢查訂閱群組與預設選項是否保留，最後還原代理模式。若同時變更用戶端、訂閱、DNS 與路由，將難以判斷問題出在哪裡。
Android 提示無法覆蓋既有應用程式時，請先查看版本與簽章相關提示，不要直接解除安裝。Linux 更新時則建議沿用原本的套件管理方式，避免留下多個安裝來源。若新安裝無法啟動，請記下系統顯示的原始錯誤，通常比反覆點選下載更有助於找出相容性問題。
前往常見問題，依現象繼續排查 →第一次安裝可先選桌面版 Desktop，採用新一代跨平台介面。習慣經典版面配置的話，可選 WPF 版，也就是經典穩定版。兩者都是 v2rayN，不必同時安裝；切換前請先備份訂閱群組與自訂設定。
2015 年後推出的主流手機通常可先選 arm64，但仍應以裝置系統支援的 ABI 為準。若不確定裝置架構，或確認系統不是 64 位元，可考慮通用版。通用版包含較多架構程式碼，檔案通常較大，但不代表連線速度較快。
開啟 Apple 選單中的「關於這台 Mac」。晶片欄顯示 Apple M 系列時，選擇 Apple Silicon；處理器欄顯示 Intel 時，選擇 Intel。請依硬體選擇相符的檔案，不要只憑電腦外觀或購買年份判斷。
請自行準備可用的訂閱網址或分享連結。安裝檔只提供用戶端程式，不含可直接使用的伺服器設定。桌面版可在「訂閱群組」中新增網址，儲存後更新訂閱；也可以從剪貼簿匯入分享連結。
更新前請備份訂閱群組、自訂路由及其他重要設定，關閉舊版用戶端後再安裝。建議沿用原本的用戶端、架構與安裝方式；切換介面版本或套件類型時，不要假設所有設定都會自動移轉。更新後請檢查訂閱清單、代理模式與路由選擇。
先確認作業系統、處理器架構與檔案格式，再查看系統顯示的具體錯誤。Windows 的 ZIP 檔需先解壓縮；Android 需允許目前使用的下載或檔案管理應用程式安裝未知來源的應用程式；Linux 則可透過套件管理工具查看相依性提示。請勿為了安裝而全面關閉系統安全防護。