用戶端安裝檔
先選擇作業系統，再選擇處理器架構。
桌面平台使用 v2rayN；Android 首選 v2rayNG，另提供 v2flyNG 作為替代選項。各平台的安裝檔、相容性說明與設定方式集中列於此。
桌面用戶端
提供兩種介面版本，皆有 x64 安裝檔。先依介面偏好選擇，再確認系統與執行環境需求。
Desktop 桌面版採用新一代跨平台 UI；WPF 是經典穩定版，保留熟悉的 Windows 介面與操作方式。初次使用建議從 Desktop 開始；若已有固定使用習慣，可選擇 WPF。
檔案格式：兩個下載項目皆為 ZIP 壓縮檔。下載後請先完整解壓縮，再開啟資料夾中的安裝程式；請勿直接從壓縮檔預覽視窗執行。安裝完成後，從系統應用程式清單啟動用戶端，方便日後更新與解除安裝。
切換版本：兩個版本的介面配置不同，選單名稱與設定位置也可能隨版本更新而調整。切換前請保存訂閱網址、路由規則與自訂設定，不要假設另一版本會自動讀取原有資料夾。測試時一次只執行一個用戶端，避免本機監聽連接埠或系統代理設定衝突。
| 檢查項目 | 選擇依據 |
|---|---|
| 處理器與系統 | 本頁提供 x64 安裝檔；請至「設定 → 系統 → 關於」查看系統類型。 |
| 系統版本 | 建議使用仍在支援中的 64 位元 Windows；最低版本需求視目前用戶端及其執行階段程式庫而定。 |
| 執行環境 | 依安裝程式提示安裝所需執行階段程式庫；Desktop 與 WPF 的相依條件可能不同。 |
| 權限與代理 | 一般情況下先以一般權限啟動；需要變更受限制的設定時，再依系統提示授權。 |
若程式無法開啟，請先確認檔案已完整解壓縮、系統架構相符，並查看系統提示的具體元件名稱。不要只因「啟動失敗」就反覆重新安裝。若介面可以開啟，但瀏覽器無法連線，請檢查訂閱、目前使用的伺服器與系統代理設定；這與安裝問題不同。
Windows 安裝後設定步驟 →桌面用戶端
請依「關於這台 Mac」顯示的晶片資訊選擇，不要根據電腦外觀或購買年份判斷。
Apple M 系列晶片請選 Apple Silicon（arm64）；Intel 處理器請選 Intel（x64）。建議下載與本機晶片相符的安裝檔，不要預設以相容轉譯方式安裝。
確認晶片：在系統選單中開啟「關於這台 Mac」，查看「晶片」或「處理器」欄位。Apple Silicon 與 Intel 使用不同的程式架構；即使應用程式名稱相同，也要分別選擇。若下載後提示應用程式不適用於這台電腦，請先確認架構與系統版本。
安裝方式：開啟 DMG 後，依視窗指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。更新前請先關閉舊版執行個體，避免仍從已掛載的安裝映像檔執行。若系統阻止開啟，請先閱讀安全提示並確認下載來源，不要一概關閉系統安全功能。
| 檢查項目 | 選擇依據 |
|---|---|
| Apple Silicon | Apple M 系列晶片，使用 arm64 DMG。 |
| Intel | Intel 處理器，使用 x64 DMG。 |
| 系統相容性 | 最低系統版本會隨用戶端版本調整，請以應用程式的相容性提示為準。 |
| 代理設定 | 系統代理只會影響遵循該設定的應用程式，不代表所有網路流量都會經過用戶端。 |
首次啟動後，先匯入既有設定，再選擇伺服器與路由模式。若啟用系統代理時需要授權，請依系統對話框操作。退出用戶端前確認代理設定已清除，尤其是更換網路或停止使用用戶端後。部分應用程式使用獨立代理設定，還需在應用程式內確認連線方式。
macOS 安裝後設定步驟 →行動裝置用戶端
建議優先選擇 v2rayNG。若需使用既有的 V2Fly 設定，再考慮 v2flyNG。
Android 圖形化用戶端，採用 Xray 核心，支援訂閱分組、伺服器選擇與路由設定。2015 年後推出的主流手機通常可先選 arm64；若不確定裝置系統架構，可選通用版。
選擇架構：arm64 安裝檔適用於相容的 64 位元 Android 系統。處理器支援 64 位元，不代表裝置系統也能安裝此版本；部分裝置仍須使用通用版。通用版支援較多架構，檔案通常較大，但不會改變訂閱內容或提升伺服器速度。
首次啟動：安裝後新增訂閱分組並更新訂閱，確認清單中出現有效設定，再選擇伺服器啟動。首次連線時需確認系統 VPN 授權。這是用戶端在本機接收應用程式流量所需的系統介面，不代表安裝檔已附帶遠端伺服器。
採用 V2Fly 核心的 Android 替代用戶端，適合需要沿用相應設定體系的情境。兩款用戶端介面相似，不代表協定與傳輸選項可以完全互換。
遷移前準備：匯入前請確認現有設定使用的協定、傳輸方式與安全選項。不同核心的支援範圍有所差異，部分進階設定必須使用相符的用戶端。請保留原訂閱網址與必要參數，不要只靠截圖遷移，也不要公開傳送含有憑證的完整設定。
並行安裝：可以保留不同用戶端以比較相容性，但同一時間只能啟用一個 VPN 連線。切換前先停止目前的連線，再啟動另一個用戶端。切換後若網路異常，請先確認舊連線已結束，再檢查新用戶端的應用程式分流規則與路由設定。
| 檢查項目 | 選擇依據 |
|---|---|
| arm64 版本 | 適用於支援 arm64 應用程式的系統；新款主流裝置通常可優先選擇。 |
| 通用版 | 架構不明或專用版不相容時使用，仍須符合應用程式的最低系統需求。 |
| 安裝權限 | 授權目前使用的瀏覽器或檔案管理員安裝應用程式，完成後可撤銷此權限。 |
| 連線權限 | 首次啟動連線時，請確認系統 VPN 請求；並檢查是否已有其他 VPN 正在使用。 |
| 背景執行 | 若鎖定螢幕後經常斷線，請檢查省電限制、背景活動權限與目前的網路狀態。 |
出現「未安裝應用程式」時，請依序檢查儲存空間、架構、系統版本，以及既有應用程式的簽章相容性。不要立刻解除安裝舊版；解除安裝可能會清除本機訂閱與路由設定，請先備份。若安裝成功但訂閱更新失敗，請檢查訂閱網址是否有效及目前網路狀況，不必反覆更換安裝檔。
v2rayNG 與 v2flyNG 差異比較 →桌面用戶端
先依發行版選擇 deb 或 rpm，再依處理器選擇 x64 或 arm64。
Debian、Ubuntu 及相容發行版通常選 deb；Fedora、RHEL 系列及相容發行版通常選 rpm。下方主要下載項目適用於常見的 Intel、AMD x64 桌面裝置；ARM 桌面裝置請使用對應的 arm64 安裝檔。
辨識安裝檔名稱：amd64 與 x86_64 通常代表此處的 x64 架構；arm64 與 aarch64 則對應 ARM 64 位元架構。這些名稱代表處理器指令集，不是發行版名稱。選對安裝檔格式後，還須確認程式庫相依項目符合該版本需求。
圖形化安裝：使用發行版提供的軟體安裝程式或圖形化套件管理工具開啟安裝檔，閱讀相依套件與權限提示後再繼續。安裝完成後，從應用程式選單啟動。此處提供的是桌面圖形化用戶端，不適用於缺少圖形工作階段的伺服器環境。
| 檢查項目 | 選擇依據 |
|---|---|
| deb 格式 | Debian、Ubuntu 及相容的套件管理系統；必須符合套件宣告的相依性需求。 |
| rpm 格式 | Fedora、RHEL 系列及相容的套件管理系統；請確認發行版與執行階段程式庫相容性。 |
| 處理器架構 | 常見 Intel、AMD 桌面裝置選 x64；ARM 64 位元桌面裝置選 arm64。 |
| 桌面環境 | 需要可執行圖形應用程式的桌面工作階段；系統匣支援度視桌面環境而定。 |
| 系統代理 | 不同桌面環境與應用程式對代理設定的遵循程度不一，請分別測試。 |
遇到相依性衝突時，先查看套件管理工具列出的缺少元件，不要略過相依套件強行安裝。啟用系統代理後，瀏覽器與其他應用程式的連線狀況可能不同；通常需要檢查應用程式本身的網路設定。確認手動啟動、匯入與連線都正常後，再設定登入桌面時自動啟動，避免開機後重複執行多個執行個體。
Linux 安裝與桌面自動啟動說明 →安裝完成後
安裝檔只提供用戶端程式，伺服器設定需自行準備。若已有訂閱，請先新增訂閱分組，輸入完整網址並更新；若已有單一連線設定，請使用用戶端提供的匯入功能。匯入後檢查協定、位址與必要參數是否齊全，再選擇要使用的伺服器。
訂閱網址可能包含存取憑證，請勿放在公開截圖、討論區或共用文件中。更新失敗時，先檢查網址是否完整、是否仍有效，以及目前網路能否連上訂閱端點。反覆安裝相同的用戶端，通常無法解決網址失效問題。
查看訂閱匯入教學 →系統代理會引導遵循該設定的應用程式，將流量交由用戶端處理；路由則決定流量進入用戶端後要走代理、直連或其他規則。兩者屬於不同層次。桌面端若只選擇伺服器，卻未啟用相應的代理入口，瀏覽器可能仍沿用原本的網路路徑。
Android 啟動連線後，也請檢查應用程式分流設定與系統 VPN 狀態。測試時先以一種明確的應用情境確認，再逐步增加規則。若遇到無法連線、解析失敗或鎖定螢幕後斷線，記下錯誤訊息與觸發條件，比一次改動多項設定更容易找出問題。
依問題症狀進行疑難排解 →下載常見問題
初次安裝可先選 Desktop 桌面版，採用新一代跨平台介面。WPF 是經典穩定版，適合習慣原有 Windows 介面與操作方式的使用者。兩個下載項目皆為 x64 安裝檔；切換前請先備份訂閱、路由及其他自訂設定，避免同時執行兩個執行個體接管系統代理。
在系統選單中開啟「關於這台 Mac」，查看「晶片」或「處理器」欄位。若顯示 Apple M 系列晶片，請選 Apple Silicon，也就是 arm64；若顯示 Intel 處理器，請選 Intel，也就是 x64。建議下載與本機晶片相符的安裝檔，安裝前先關閉正在執行的舊版用戶端。
2015 年後推出的主流手機通常可先選 arm64，但仍須確認系統支援 64 位元應用程式。若不確定裝置架構，或 arm64 安裝檔顯示不相容，可改用通用版。通用版支援較多架構，檔案通常較大，但不會因此提升連線速度。
Debian、Ubuntu 及相容發行版通常選 deb；Fedora、RHEL 系列及相容發行版通常選 rpm。接著依處理器選擇 x64 或 arm64。格式相符不代表所有發行版版本都符合相依性需求；若圖形化安裝程式提示缺少相依套件，請先確認發行版版本與執行階段程式庫需求。
安裝檔只提供用戶端程式，不含可用的伺服器設定或訂閱服務。請先匯入有效的訂閱或連線設定，選擇伺服器與路由模式，再啟用系統代理或 Android VPN 連線。訂閱網址可能包含存取憑證，請妥善保密。
使用相同用戶端與設定資料夾進行一般更新時，原有設定通常會保留，但仍建議事先備份。更新前請保存訂閱網址、路由規則與自訂設定，並先退出程式再安裝。更換用戶端或設定資料夾時，可能需要重新匯入；更新用戶端和更新訂閱是兩項不同操作。