桌面端選 v2rayN，Android 首選 v2rayNG。先確認作業系統與處理器架構，再下載相應安裝檔。
主要下載入口優先提供常用架構；其他架構與版本列在同一張卡片中。下載前請先確認裝置資訊。
桌面版與經典 WPF 版都可管理訂閱、選擇伺服器及設定代理，主要差異在介面技術與操作配置。桌面版採用新一代跨平台介面，選單編排與經典版不盡相同；WPF 版則延續熟悉的 Windows 操作方式。版本名稱不代表伺服器品質，也不能取代對協定參數的確認。
下載後請將壓縮檔完整解壓縮至可寫入的位置，再執行檔案中的安裝程式。不要直接從壓縮軟體的預覽視窗啟動程式，否則相關檔案可能尚未正確解壓。安裝路徑盡量保持固定，以利日後升級與尋找設定；若出現執行環境提示，請依安裝程式或系統指示處理，不要到來源不明的網站下載替代檔案。
首次啟動後，先新增訂閱分組，再更新訂閱。選擇有效伺服器後，啟用系統代理自動設定並選擇路由模式。系統代理只會影響遵循該設定的應用程式，不代表所有程式都已接入。若要改用另一個介面版本，請先備份並結束舊執行個體；同時執行兩個執行個體，容易造成連接埠衝突或代理設定互相覆寫。
| 檢查項目 | 本頁安裝檔需求 | 確認方式 |
|---|---|---|
| 處理器架構 | x64；這兩個安裝檔並非供其他架構使用 | 開啟系統設定中的「系統資訊」或「關於」，查看系統類型 |
| 作業系統 | 須符合目前代理程式與執行環境的支援範圍 | 記下系統版本，安裝時留意相容性與執行環境提示 |
| 檔案與權限 | 完整解壓縮、設定位置可寫入，且磁碟空間足夠 | 確認安裝資料夾與使用者設定資料夾未受權限政策限制 |
本頁提供 x64 安裝檔。處理器名稱相近，不代表應用程式架構相同；受管理的公司裝置也須遵守所在地的安裝與代理政策。
先從系統選單開啟「關於本機」，查看晶片或處理器資訊。Apple Silicon 對應 arm64，Intel 對應 x64。不要依外觀、購買年份或系統版本推測架構，同一系列產品也可能採用不同處理器。選擇相符的原生安裝檔，有助於減少對額外相容層的依賴。
下載完成後開啟磁碟映像檔，依照檔案中的指示將應用程式移至「應用程式」資料夾，再從該資料夾啟動。不要長期從暫時掛載的磁碟映像檔執行；安裝完成並關閉相關視窗後，可退出磁碟映像檔。若系統顯示安全性限制，請先確認檔案來源與提示內容，再依系統提供的授權流程處理；不要為了啟動單一應用程式而全面關閉系統防護。
匯入訂閱後，確認目前使用的伺服器與路由模式，再檢查系統代理是否已套用至正在使用的網路服務。無線與有線網路可能各自有代理設定，切換網路後請重新確認。若要使用 TUN 模式，還可能需要額外權限並接管網路；初次使用建議先從系統代理開始，較容易區分安裝、設定與應用程式流量接入問題。
| 檢查項目 | 本頁安裝檔需求 | 確認方式 |
|---|---|---|
| 晶片 | Apple Silicon 選 arm64；Intel 選 x64 | 查看「關於本機」中的晶片或處理器資訊 |
| 系統版本 | 須符合目前桌面版的支援範圍 | 確認系統版本，並依安裝或啟動提示判斷相容性 |
| 應用程式與網路權限 | 可安裝應用程式，並允許變更必要的代理設定 | 查看系統安全性提示，以及目前網路服務的代理設定 |
若應用程式無法開啟，請先核對架構與系統提示。訂閱更新失敗屬於後續網路設定問題，不應直接歸因於安裝檔選擇錯誤。
v2rayNG 是 Android 端的首選，採用 Xray 核心，適合使用該生態系設定的使用者。2015 年後推出的主流手機通常支援 arm64，但部分裝置的系統僅提供較舊的應用程式架構，因此仍須以裝置系統實際支援的架構為準。通用安裝檔可支援更多架構，但不代表能繞過應用程式的系統版本需求。
開啟下載的安裝檔時，系統可能要求授予瀏覽器或檔案管理員「安裝未知的應用程式」權限。請只依需要授權目前發起安裝的應用程式，安裝完成後可還原原本設定。首次連線時會出現系統 VPN 授權提示，這是代理程式透過系統介面接收應用程式流量所需的步驟；若已有其他 VPN 應用程式執行，請先停止，避免搶用同一個連線位置。
安裝後新增訂閱分組並更新，選擇伺服器，再啟動連線。若切換至背景後經常斷線，請檢查電池最佳化、背景活動與省電政策，不要反覆改裝不同架構的安裝檔。訂閱含有存取憑證，分享截圖時應遮住完整網址；描述安裝問題通常只需提供代理程式名稱、架構與錯誤訊息。
v2flyNG 採用 V2Fly 核心，適合現有設定與該核心相容時作為備選。兩款 Android 代理程式的操作介面雖有相似之處，但協定支援、傳輸選項與設定欄位不一定完全相同。若設定使用 Xray 專屬功能，請先確認代理程式與核心是否支援，不能靠改用通用安裝檔補足協定功能。
從 v2rayNG 切換時，請先保留原有訂閱並記錄設定，再於新代理程式中重新匯入。系統授權不會自動轉移至另一個應用程式，首次連線仍須重新確認。測試時只執行一個代理程式，依序檢查「能否更新訂閱、能否啟動服務、應用程式能否存取網路」，方便區分安裝相容性與網路參數問題。
| 檢查項目 | 安裝與執行需求 | 確認方式 |
|---|---|---|
| 應用程式架構 | arm64 安裝檔須由系統支援 arm64；不確定時可考慮通用版 | 查看裝置技術資訊，留意安裝程式是否顯示架構不相容 |
| 系統與安裝權限 | 符合目前應用程式的系統需求，並允許安裝 APK | 查看系統版本，以及「安裝未知的應用程式」授權狀態 |
| 連線與背景執行 | 授予 VPN 權限；背景執行政策須允許代理程式持續運作 | 查看 VPN 授權、電池最佳化與其他 VPN 應用程式的狀態 |
「無法安裝」與「安裝後無法連線」是不同階段的問題。請先讓應用程式正常啟動，再排查訂閱、傳輸參數與網路權限。
Linux 須同時確認發行版的套件管理系統與處理器架構。採用 DEB 系統的發行版通常選 deb，採用 RPM 系統的通常選 rpm；x64 在檔名中可能標示為 amd64 或 x86_64，arm64 也可能標示為 aarch64。不要只看副檔名判斷相容性，套件相依性與系統元件版本也會影響安裝結果。
下載後建議使用發行版的軟體安裝程式或套件管理工具開啟檔案，讓系統處理相依性與安裝紀錄。若出現相依套件無法滿足的提示，請先查看缺少的項目與版本需求，不要強行忽略相依性，也不要任意將其他發行版的軟體來源加入目前系統。此處提供的是圖形桌面代理程式，須有可用的桌面工作階段；僅有遠端命令列的電腦不適用本頁的安裝方式。
啟動後先匯入訂閱，檢查代理程式的本機監聽狀態與桌面環境的代理設定。不同桌面環境、瀏覽器與終端機應用程式讀取系統代理的方式可能不同，因此「代理程式已啟動」不代表每個應用程式都已接入。初次驗證時，請選擇一個明確遵循系統代理設定的應用程式；若要使用 TUN，請再參照進階文件確認權限、路由與 DNS 接管設定，避免一開始就同時修改多層網路設定。
| 檢查項目 | 本頁安裝檔需求 | 確認方式 |
|---|---|---|
| 套件管理系統 | 依發行版選擇 deb 或 rpm | 查看發行版說明，使用系統適用的軟體安裝工具 |
| 處理器架構 | x64 或 arm64，須與套件內的元件相符 | 查看系統資訊，辨別 amd64、x86_64 與 aarch64 標示 |
| 桌面環境與相依套件 | 須有可用的圖形桌面工作階段，並符合套件宣告的相依需求 | 閱讀軟體安裝程式提示，確認圖形介面與執行環境元件 |
套件格式相同不代表所有發行版都相容。安裝程式列出的相依需求，比僅憑「屬於同一發行版家族」推測更可靠。
分開檢查安裝、匯入與流量接入。每完成一個階段，再進行下一步。
代理程式是管理設定與處理連線的工具，安裝完成不會自動取得可用伺服器。開始前請自行準備有效的訂閱網址，或一組完整且合法使用的伺服器參數。訂閱可將多組設定集中在同一個更新入口；手動匯入則須逐項確認位址、連接埠、協定、傳輸與安全性設定。兩種方式都要求參數正確，不能只填入伺服器位址就期待連線成功。
訂閱網址通常包含存取權杖，應像帳號憑證一樣妥善保管。新增分組時，備註僅供本機辨識，可依用途或來源命名；不要在公開截圖中顯示完整網址。匯入分組後，還須更新訂閱，讓代理程式取得實際設定。若更新失敗，請先檢查複製內容、訂閱有效期限與目前網路連線狀況，不要將安裝完成後的設定問題誤判為安裝檔損毀。
從剪貼簿或 QR Code 匯入時，也要確認解析後的協定與傳輸選項。有些連結雖能解析，其中的擴充欄位卻不一定受目前核心支援。REALITY 等設定須與伺服器端一致，不要直接沿用其他設定的參數。若不熟悉相關術語，可先閱讀REALITY 概念說明，再對照伺服器提供的資訊填寫。
桌面端通常先啟用系統代理；Android 端則透過 VPN 模式接收流量。系統代理是應用程式將要求送至本機代理的入口；路由模式則決定已接收的要求要從哪個出口送出。這是兩個不同層面的設定。若應用程式流量尚未接入，只調整路由模式，代理程式可能根本收不到要處理的要求。
初次使用時，先選擇有效伺服器，再啟用流量接入方式，最後用平常使用的應用程式測試。不要同時修改 DNS、TUN、自訂出站與複雜路由，否則發生問題時難以判斷原因。確認可以正常連線後，再依實際需求調整分流規則，並留存一份可還原的基本設定。網路設定就像接水管，先確認每一段都接妥，再考慮如何分流。
若應用程式無法連線，請先確認代理程式服務已啟動、本機連接埠未被其他執行個體占用，且系統時間正確。接著檢查伺服器參數與訂閱是否仍有效。桌面環境中的瀏覽器、命令列工具與其他應用程式可能使用不同的代理機制，不宜只憑單一應用程式的結果判斷整體網路狀態。完整操作請參閱快速入門教學；連線異常則可查看連線排除章節。
升級前請先保存目前設定。優先使用代理程式提供的備份或匯出功能，並另外記錄訂閱分組、路由例外、DNS 設定、本機監聽連接埠與啟動選項。只保留訂閱網址，無法完整還原自訂規則；只複製某個資料夾，也不一定包含系統層級的代理與權限設定。備份檔也可能包含憑證，請存放於安全的位置。
安裝新版本前請先結束舊執行個體，尤其是切換介面版本時。確認舊執行個體已停止接管代理後，再啟動新版本並檢查設定是否正確讀取。若新介面採用不同的設定格式，請使用支援的匯入方式遷移，不要直接覆寫用途不明的資料夾。完成訂閱更新與應用程式連線驗證後，再整理舊檔案；原有備份請先保留。
從一款 Android 代理程式遷移至另一款時，須重新確認協定功能與權限。訂閱網址可作為遷移入口，但核心專屬的傳輸設定未必通用，系統 VPN 授權也須重新核准。跨桌面平台遷移時，還要留意檔案路徑、系統代理介面與權限差異。升級後應依實際設定與應用程式連線狀況進行驗證，不能只以「安裝程式沒有報錯」判定全部完成。
先確認套件類型，再處理權限與設定。保留原始錯誤訊息，有助於避免重複嘗試。
初次使用可先選桌面版，採用新一代跨平台介面。經典 WPF 版則保留熟悉穩定的 Windows 操作介面，適合習慣既有操作方式的使用者。兩個版本的選單位置可能不同，切換前請先備份設定，也不要同時讓兩個執行個體接管系統代理。
2015 年後推出的主流手機通常可優先選 arm64，但仍應以系統支援的應用程式架構為準。較舊的裝置或無法確認架構時，可選通用版；若系統版本不符合應用程式需求，改用通用安裝檔也無法解決相容性問題。
代理程式負責讀取設定並處理連線，安裝檔不等於可用的伺服器設定。請自行準備有效的訂閱或完整伺服器參數，匯入後更新訂閱、選擇伺服器，再設定系統代理或授予 Android VPN 權限。
先使用目前代理程式提供的備份或匯出功能保存設定，並另外記錄路由、DNS 與本機連接埠。結束舊執行個體後再升級。跨介面版本或不同代理程式遷移時，請依新版本支援的匯入方式操作，不要直接覆寫用途不明的設定資料夾。
卡片顯示的版本來自應用程式版本欄位，下載連結則取自各安裝檔的獨立欄位，兩者可能暫時不同步。確認安裝檔版本時，請一併查看下載檔名與安裝後代理程式的「關於」頁面，不要自行修改下載網址中的版本號。
先確認下載是否完成、磁碟空間是否足夠，再核對作業系統、處理器架構與檔案格式。Windows 的 ZIP 檔須先解壓縮；Android 安裝則須授權發起安裝的應用程式。若仍無法安裝，請記下系統提示與所選檔案名稱，再參照安裝及連線排除說明檢查。