安裝檔先選作業系統，再選架構
桌面端選 v2rayN，Android 優先選 v2rayNG。依作業系統、處理器與安裝格式找到合適的下載入口，再匯入訂閱。
四個平台各自列出適用的安裝檔類型。卡片上的主要按鈕是常用選項，其他架構與經典介面則列在相鄰入口。
以下兩個安裝檔都是 x64 架構。首次安裝建議從 Desktop 開始；若已習慣經典介面，再考慮 WPF。
Desktop 採用新一代跨平台 UI；WPF 是經典穩定版，保留熟悉的 Windows 桌面操作配置。
先解壓縮，再安裝。目前兩個入口提供的都是 ZIP 壓縮檔。下載後請使用檔案管理員完整解壓縮，再從解壓縮資料夾中查看安裝程式與說明；不要直接從壓縮檔預覽視窗啟動。資料夾必須允許目前帳戶讀寫，並避免將設定存放在受保護的系統資料夾。
Desktop 與 WPF 的差異主要在介面技術和操作配置；使用同一台伺服器時，並不代表連線速度一定不同。選擇時請考量操作習慣、系統相容性和所需設定。如果舊版已有許多自訂規則，請先匯出備份，再逐項確認新介面中的設定；不要覆蓋唯一可用的設定。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 處理器架構 | 本頁提供 x64 安裝檔。請在系統設定的「系統資訊」或「關於」查看系統類型；32 位元系統無法安裝這些檔案。 |
| 作業系統與執行階段 | 請使用仍受支援的 64 位元 Windows；最低版本與桌面執行階段需求請以安裝檔說明為準。若啟動時出現錯誤，請依提示安裝對應架構的相依元件。 |
| 檔案與權限 | 請預留足夠的解壓縮空間。一般代理使用與虛擬網卡操作所需的權限不同；啟用 TUN 時可能需要提高權限。 |
若按兩下後沒有反應，請先查看系統錯誤訊息、執行階段提示與客戶端記錄檔。不要把長期以系統管理員身分執行當成通用解法。也可參閱 v2rayN 啟動閃退排除方法，確認問題是相依元件缺失、資料夾權限不足還是設定損毀。
從 Apple 選單開啟「關於這台 Mac」：若顯示 Apple M 系列晶片，請選 Apple Silicon；若顯示 Intel 處理器，請選 Intel。
優先選擇符合晶片架構的原生安裝檔，不要只憑裝置外觀或購買年份判斷。
從「應用程式」資料夾執行。開啟 DMG 後，依磁碟映像中的指示完成安裝，將應用程式移至「應用程式」資料夾，再從該資料夾啟動。首次開啟時可能會出現系統安全性提示；請先確認來源，再前往「系統設定 → 隱私權與安全性」，查看是否有針對這次開啟的允許選項。
應用程式獲准啟動，不代表系統代理或虛擬網卡所需權限也已就緒。匯入設定後，先透過系統代理測試瀏覽器連線，再視需要啟用 TUN。系統升級、移轉應用程式或重新安裝後，可能需要重新確認原有授權。受組織管理的裝置請遵循本機管理政策，不要繞過管理員設定。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 晶片架構 | Apple M 系列使用 arm64；Intel 處理器使用 x64。請使用相符的原生架構安裝檔，減少架構轉譯造成的相容性變數。 |
| 系統版本 | 先記下「關於這台 Mac」顯示的 macOS 版本；最低系統版本需求以目前安裝檔為準，不能只憑 DMG 格式判斷相容性。 |
| 安裝授權 | 需要具備寫入「應用程式」資料夾的權限。首次開啟、安全性核准與後續網路授權須分別處理；請勿關閉整體系統防護。 |
若出現「無法驗證開發者」或啟動後無法接管流量，可參考 macOS 安全性放行設定與網路權限說明進行檢查。先確認應用程式能正常開啟，再排查代理與網路權限，避免一次變更多項設定。
優先選擇 v2rayNG。2015 年後推出的主流手機通常適用 arm64；若無法確認架構，可使用通用版，但仍須符合系統版本需求。
適合日常 Android 使用，可透過訂閱群組管理設定、授權 VPN 接管流量，並設定個別應用程式代理。
arm64 安裝檔只包含對應架構的元件，適合支援 64 位元應用程式的裝置；通用版涵蓋更多架構，檔案通常也較大。有些手機雖採用 64 位元處理器，系統卻不一定支援 64 位元應用程式。安裝失敗時請確認系統與應用程式架構，不要只看處理器名稱。
開啟 APK 後，系統可能會要求允許目前使用的瀏覽器或檔案管理員安裝應用程式。請只對這次使用的來源授權，安裝完成後即可撤銷權限。首次點選連線時也會出現系統 VPN 授權提示；若另一個應用程式正在使用 VPN 通道，請先確認是否需要停止該連線，再建立客戶端連線。
適用於明確需要 V2Fly 核心，且設定相容的情況。選用前請確認協定、傳輸方式與參數，不要只因介面相似就假設功能支援範圍相同。
v2flyNG 與 v2rayNG 採用不同的核心路線，支援的協定與新參數也可能不同。若訂閱項目匯入失敗，請先確認設定所需的功能，再決定使用哪個客戶端。反覆匯入同一份設定，無法補足核心尚未支援的功能；也不應隨意切換設定選項來處理相容性問題。
移轉前請保留原客戶端中的訂閱網址、手動設定與個別應用程式清單。先在新客戶端匯入少量已知可用的設定，確認連線與 DNS 行為正常後，再移轉其餘內容。兩個客戶端可以各自保留設定，但同一時間只啟用需要使用的連線，方便判斷流量由哪一組規則接管。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 系統與架構 | 前往「設定 → 關於手機」查看 Android 版本，再依裝置支援的應用程式架構選擇安裝檔。通用版不代表相容所有舊版系統。 |
| 安裝條件 | 請預留下載與安裝所需空間，並依需求允許目前使用的來源安裝應用程式。若出現簽章衝突提示，請先備份，不要直接解除安裝唯一可用的設定。 |
| 連線權限 | 首次連線時須確認系統 VPN 授權。若要長時間在背景執行，請檢查電池最佳化設定；不必授予與連線無關的權限。 |
若出現「應用程式未安裝」，請依序檢查可用空間、Android 版本、架構，以及現有應用程式的簽章相容性。若問題發生在覆蓋安裝時，請先保留舊設定；若安裝成功但背景連線中斷，再檢查系統省電設定。這與安裝檔架構是不同的問題。
先依發行版選擇 deb 或 rpm，再依處理器選擇 x64 或 arm64。這裡提供圖形桌面客戶端，並非用來取代伺服器部署工具。
Ubuntu、Debian 等發行版請選 deb；Fedora 等 RPM 系發行版請選 rpm，並確認套件相依性符合目前的發行版。
使用系統軟體安裝程式開啟套件檔。安裝程式會顯示套件架構與相依資訊。相同的 deb 或 rpm 副檔名不代表不同發行版之間一定相容，尤其要留意系統函式庫版本與套件建置目標。若相依條件不符，請先確認發行版環境，不要強制忽略相依性完成安裝。
安裝完成後，從桌面應用程式選單啟動，先確認主介面與記錄檔都能正常開啟。有些桌面環境需要另外啟用系統匣支援；關閉主視窗後若找不到系統匣入口，請先檢查桌面擴充功能與客戶端背景執行設定。自動啟動建議設定為使用者登入後執行的桌面啟動項目，不要長期以系統管理員程序執行整個圖形客戶端。
| 檢查項目 | 選擇與處理方式 |
|---|---|
| 發行版套件格式 | Debian 系通常使用 deb，RPM 系則使用 rpm。安裝前請以軟體安裝程式顯示的相依資訊和發行版相容需求為準。 |
| 處理器架構 | x86_64、amd64 對應本頁的 x64；aarch64 對應 arm64。請勿混淆發行版位元數與套件格式。 |
| 桌面環境與權限 | 需要可用的圖形桌面環境。管理套件與設定 TUN 可能需要授權；一般介面操作不代表必須使用管理員工作階段。 |
若桌面應用程式已啟動，但瀏覽器未使用代理，請先確認桌面環境的代理設定與應用程式本身的代理策略，再判斷是否需要 TUN。安裝、自動啟動與系統匣入口的完整設定步驟，請參閱 Linux deb/rpm 安裝與登入後自動啟動說明。
請分開處理安裝與連線測試。每完成一個步驟再繼續，出錯時比較容易找出原因。
確認下載的安裝檔符合目前的作業系統與處理器，再依套件格式安裝。首次啟動時先確認介面、記錄檔與必要授權，不要急著同時修改 DNS、路由和 TUN。若應用程式本身無法啟動，請先處理系統相依元件與資料夾權限；更換訂閱無法修復啟動階段的問題。
在訂閱群組中新增有權使用的訂閱網址，更新後確認匯入結果。手動設定時，請逐項核對位址、連接埠、協定與傳輸參數。訂閱連結可能包含個人存取識別資訊，請勿當作一般網址公開分享。匯入完成後，請明確選取要使用的伺服器。
桌面端可先啟用系統代理；Android 端則須確認 VPN 授權。系統代理仰賴應用程式遵循系統設定，不保證所有程式都會使用。測試時請同時確認應用程式的連線結果與客戶端記錄檔，不要只以開關變色判定連線成功。若需要虛擬網卡，再另外設定 TUN 與相關路由。
客戶端程式、核心功能與訂閱內容屬於不同層面。升級可能會調整設定入口或設定結構，但不會自動修正伺服器端的參數錯誤。升級前請先記下目前使用的客戶端、代理連接埠、路由模式與重要 DNS 設定，再關閉程式，避免覆寫仍在寫入的設定檔。
備份至少應包含手動設定的伺服器、訂閱群組與自行編寫的路由。備份可能含有存取憑證，請限制可讀取的人員，不要存放在公開分享資料夾。跨介面或跨客戶端移轉時，優先使用匯入、匯出功能，並在新環境確認欄位是否完整；不要因資料夾名稱相同就直接替換。
先確認問題發生在下載、安裝、啟動或連線階段，再採取相應的處理方式。
首次安裝建議選擇 Desktop，採用新一代跨平台介面；習慣經典 Windows 介面的使用者，可選擇 WPF 經典穩定版。兩個下載入口都是 x64 安裝檔，處理器相容性不能只看介面名稱。切換前請先匯出訂閱、伺服器與自訂規則，避免直接共用目前使用中的設定資料夾。
2015 年後推出的主流手機通常建議優先選 arm64，但仍須確認裝置系統支援 64 位元應用程式。若無法確認架構，或 arm64 安裝檔顯示不相容，可改試通用版；通用版仍受客戶端最低系統需求限制。安裝前請確認系統版本、可用儲存空間，以及是否允許從該來源安裝。
客戶端可管理設定並轉送流量，但安裝檔不含可用的訂閱或伺服器。請自行準備有權使用的訂閱或連線參數，匯入並選擇伺服器後，再啟用系統代理或授權 VPN 連線。若無法連線，先查看記錄檔，不要反覆更換安裝檔。
請先備份訂閱群組、手動新增的伺服器、自訂路由與 DNS 設定，再關閉客戶端。備份檔可能含有訂閱網址和存取憑證，請存放在妥善控管的位置。更新後檢查代理連接埠、路由模式與 TUN 設定；不同介面版本不一定能共用同一個設定資料夾。
卡片上的版本文字取自應用程式版本欄位，實際下載網址則來自各平台的安裝檔欄位，兩者可能尚未同步。要確認特定安裝檔的版本，請一併參考實際下載的檔名與安裝後顯示的客戶端版本；不要只憑卡片文字判定所有平台的安裝檔都已更新。
先確認安裝檔來源與晶片架構。首次嘗試開啟後，前往系統設定的「隱私權與安全性」，依系統提供的選項決定是否允許開啟。受管理的裝置可能需要管理員核准。請勿為了執行客戶端而關閉整體系統防護；後續網路權限與系統代理授權也要分別確認。