安裝包 / 作業系統與架構
桌面版選 v2rayN，Android 裝置選 v2rayNG 或 v2flyNG。請先確認作業系統與處理器架構，再下載對應的安裝包。
用戶端可管理訂閱、伺服器與代理設定；可用的訂閱連結或伺服器參數需另外準備。首次安裝時，可同時開啟使用指南，依照步驟完成設定。
Desktop 桌面版採用新一代跨平台 UI；經典 WPF 版則保留熟悉的 Windows 桌面配置。首次安裝建議優先選桌面版；若已習慣 WPF，可繼續使用經典穩定版。
Desktop · 新一代跨平台介面
WPF · 經典 Windows 桌面配置
下載檔案為 ZIP 壓縮檔。請先完整解壓縮，再執行資料夾中的安裝程式；不要直接從壓縮檔預覽視窗啟動程式。
查看 v2rayN 安裝與匯入訂閱教學 →| 檢查項目 | 選擇與需求 | 確認方式 |
|---|---|---|
| 處理器架構 | 本區提供 x64 安裝包 | 開啟「設定 → 系統 → 關於」，查看系統類型 |
| 系統相容性 | 使用仍受支援的 Windows；最低版本以安裝程式提示為準 | 確認系統更新狀態，留意執行環境提示 |
| 解壓縮與資料夾 | 完整解壓縮至可寫入的本機資料夾 | 確認安裝程式與隨附檔案位於同一個解壓縮資料夾 |
| 執行權限 | 一般代理先以標準權限使用；TUN 可能需要額外權限 | 首次啟動先測試系統代理，再視需要設定 TUN |
「系統類型」比電腦型號更適合用來判斷安裝包。若處理器標示為 x64，且執行的是 64 位元系統，請選擇本區的 x64 安裝包。其他架構的裝置應先確認系統是否支援相容執行環境，不要只因為能開啟下載頁面，就認定程式可以執行。此處兩個入口的差異在介面方案，而不是依速度或節點能力區分等級。
執行安裝程式前，請先關閉正在使用的舊版用戶端。若啟動時提示缺少執行環境，請依提示確認所需元件與系統架構，不要隨意複製其他電腦上的執行檔。安裝資料夾中的多個程式與隨附檔案通常各有用途，請保留完整的檔案結構；只將主程式移到其他資料夾，可能會導致找不到元件。
首次開啟 v2rayN 後，請先匯入訂閱並選擇一組伺服器設定，再設定系統代理。Desktop 與 WPF 的選單配置可能不同，參照教學操作時，請以設定項目的名稱為準，不要只比對按鈕位置。切換版本前請備份訂閱群組、路由與 DNS 設定，先關閉舊程式再開啟另一版本，避免兩個程式同時變更系統代理。
在「關於這台 Mac」查看晶片資訊：若顯示 Apple M 系列晶片，請選 Apple Silicon；若顯示 Intel 處理器，請選 Intel。建議優先使用符合晶片架構的原生版本。
適用於 Apple M 系列晶片
適用於 Intel 處理器
開啟 DMG 後，將 App 複製到「應用程式」資料夾，再從該資料夾啟動。升級前請先退出正在執行的 v2rayN。
查看桌面用戶端設定步驟 →| 檢查項目 | 選擇與需求 | 確認方式 |
|---|---|---|
| 晶片架構 | Apple Silicon 選 arm64；Intel 選 x64 | 蘋果選單 → 關於這台 Mac |
| 系統版本 | 實際相容範圍請以 App 與系統提示為準 | 確認系統版本，使用仍受支援的系統 |
| App 安裝位置 | 複製到「應用程式」資料夾後啟動 | 不要長期從已掛載的 DMG 中執行 |
| 網路權限 | 依實際需求授權系統代理或虛擬網卡功能 | 查看系統設定中的權限提示 |
選擇架構時，不要只根據購買年份判斷，同一時期的裝置也可能採用不同晶片。複製 App 完成後，可退出磁碟映像，並保留下載檔，以便日後重新安裝。若系統阻止啟動，請先閱讀完整提示，判斷是系統相容性、App 來源限制還是檔案損毀；不建議為了執行單一 App 而全面關閉系統安全防護。
用戶端成功啟動後，仍需匯入伺服器參數並選擇代理模式。系統代理通常只影響遵循系統代理設定的 App；TUN 涉及虛擬網卡與額外權限，安裝後不必立即啟用。請先用較簡單的設定確認伺服器可用，再參考TUN 模式說明調整設定，排查時更容易分辨是用戶端還是網路問題。
Android 裝置建議優先選用 v2rayNG，可用來匯入訂閱、管理伺服器及建立本機 VPN 連線。2015 年後推出的主流手機通常可選 arm64，但仍應以實際系統架構為準。
優先適用於相容的 64 位元 ARM 系統
不確定裝置架構時可考慮通用版
版本標示與實際安裝包路徑可能更新不同步，請以實際檔名及安裝後「關於」頁面的資訊確認版本；不要自行改寫下載網址。
查看 v2rayNG 使用教學 →
若需要採用 V2Fly 核心家族的 Android 圖形化用戶端，可選擇 v2flyNG。選用前請先確認訂閱中的協定與傳輸設定受到目前版本支援，不要只因介面相似就直接移轉設定。
適用於相容的 64 位元 ARM 系統
適合需要支援更多架構的裝置
兩款 Android 用戶端可分別管理設定，但測試連線時請只啟用其中一個 VPN，避免系統取代先前的連線而造成誤判。
了解核心家族與相容性 →| 檢查項目 | 選擇與需求 | 確認方式 |
|---|---|---|
| 系統架構 | 相容的 64 位元 ARM 系統請選 arm64 | 查看裝置規格與系統架構；不確定時可考慮通用版 |
| 系統版本 | 請以 APK 安裝程式顯示的相容需求為準 | 查看「設定 → 關於手機」及安裝提示 |
| 安裝授權 | 授權實際用來開啟 APK 的 App 進行安裝 | 依系統提示，為相應來源開啟安裝權限 |
| 連線授權 | 首次連線時需確認系統 VPN 要求 | 確認 App 名稱後，再允許連線 |
| 背景執行 | 持續使用時，請檢查電池最佳化與背景限制 | 視需要在系統 App 設定中調整 |
arm64 指的是執行架構，不是軟體的功能等級。即使處理器支援 64 位元，若系統採用 32 位元執行環境，仍可能無法安裝 arm64 版。通用版也無法繞過最低系統版本、簽章衝突或安裝政策限制；若出現「未安裝應用程式」，請先查看安裝程式提示，再決定是否更換安裝包。
若裝置已有同名 App，更新通常要求簽章相容。系統提示衝突時，請先匯出或備份原有設定，不要立即解除安裝；解除安裝可能會清除訂閱與自訂設定。首次連線時，系統 VPN 授權只代表允許 App 接管網路，不代表已成功連上遠端伺服器；仍需測試網頁存取並查看記錄。
請先依發行版選擇 deb 或 rpm，再選擇 x64 或 arm64 架構。下方主要入口提供 x64；ARM 桌面裝置請使用相應的 arm64 入口。
適用於採用 deb 套件管理系統的發行版
適用於與此 rpm 套件相容的發行版
使用系統軟體安裝程式開啟套件，並留意相依性提示。套件格式相同不代表所有發行版版本都相容，尤其要留意 rpm 檔名中的目標發行環境資訊。
查看桌面用戶端入門說明 →| 檢查項目 | 選擇與需求 | 確認方式 |
|---|---|---|
| 套件格式 | 依發行版的套件管理系統選擇 deb 或 rpm | 查看系統說明及軟體安裝程式支援的格式 |
| 處理器架構 | amd64 / x86_64 對應 x64；aarch64 對應 arm64 | 查看系統「關於」中的硬體資訊 |
| 桌面環境 | 需要可執行圖形化 App 的桌面工作階段 | 本頁適用於桌面使用，不是背景服務安裝指南 |
| 相依性相容 | 系統函式庫與發行版版本需符合安裝包需求 | 查看軟體安裝程式的相依性與衝突提示 |
| 代理生效 | App 是否使用系統代理，取決於桌面環境與 App 設定 | 先在明確設定為使用代理的 App 中測試 |
不要更改副檔名，將 deb 當成 rpm 使用；也不要只因系統允許開啟檔案，就強制忽略相依性。安裝程式提示相依套件版本不符時，請先確認套件適用的目標環境；即使套件格式相同，也可能依賴不同的系統函式庫。此處不列出固定的最低發行版清單，因為相容範圍應以實際安裝包與系統環境為準。
Linux 桌面環境中的系統代理並非所有程式都會讀取。用戶端啟動、選取伺服器及啟用代理入口是三個不同步驟，測試時應逐一確認。若要啟用 TUN，請再檢查權限與路由變更，並記錄啟用前的狀態，以便退出後還原。自訂路由與 DNS 可參考進階設定手冊；不要把安裝與複雜的網路設定混在同一次操作中。
下載前可先回答三個問題，縮小選擇範圍：裝置使用哪個作業系統、系統採用哪種處理器架構，以及目前是否有需要保留的用戶端設定。作業系統決定平台入口，架構決定安裝包，而既有設定則關係到是否應先備份。先確認這三項，比反覆嘗試不同檔案更有效，也能避免更新後找不到原有訂閱。
本頁中的 x64、amd64 與 x86_64 指同一類 64 位元桌面架構；arm64 與 aarch64 則是 64 位元 ARM 架構。這些不是節點協定，也不是連線速度等級。安裝包必須符合裝置的執行環境。Windows 區提供的兩個入口都是 x64，Desktop 與 WPF 的差異在介面方案，不代表 WPF 是另一種處理器架構的安裝包。
Android 通用版支援較多架構，不代表它一定比 arm64 更適合所有裝置。支援 arm64 的手機通常可直接選擇相應安裝包；舊裝置、特殊系統或架構資訊不明時，再考慮通用版。macOS 請查看「關於這台 Mac」中的晶片資訊；Linux 則需同時確認套件格式與架構，兩者都符合後再安裝。
v2rayN、v2rayNG、v2flyNG 都是圖形化用戶端，負責將伺服器參數、訂閱與代理選項整理成可操作的介面。核心負責處理實際連線，伺服器則是遠端連線目標。下載用戶端不代表已取得伺服器服務；即使安裝完成，若沒有有效參數，也無法透過用戶端建立可用連線。這就是首次啟動後仍需匯入訂閱的原因。
桌面使用者通常可先選 v2rayN；Android 使用者可優先考慮採用 Xray 核心的 v2rayNG，若有明確的 V2Fly 核心需求，再考慮 v2flyNG。不同核心與版本支援的協定可能不同，尤其訂閱涉及特定傳輸方式或安全機制時，應確認參數相容性。協定名稱相同，也不代表所有擴充欄位都能直接沿用；相關定義可參閱術語手冊。
更新前請先確認目前的用戶端運作正常，並記下正在使用的代理模式。優先使用用戶端提供的備份或匯出功能，保存訂閱群組、手動新增的伺服器、自訂路由與 DNS 設定。不同版本的設定儲存方式可能有所變動，不能因為產品名稱相同，就認定覆蓋安裝一定會保留資料。
備份後請退出用戶端，再執行新安裝包。桌面版關閉視窗不一定代表已退出，部分程式仍會在系統匣中執行；請使用用戶端的退出功能結束程式。Android 端則先中斷 VPN，再依系統提示更新。更新完成後，請檢查版本與設定，並選一台已知可用的伺服器測試；確認無誤後，再恢復其他進階設定。
從 Desktop 切換到 WPF，或從一款 Android 用戶端換成另一款時，應視為一次設定移轉。先確認目標用戶端能否匯入原有設定格式，再檢查協定、路由與 DNS 欄位是否完整保留。訂閱可以重新匯入，但手動調整的群組與本機規則未必能隨訂閱一併還原，因此備份與記錄都很重要。
頁面中的版本標示與下載入口分別取自版本清單的不同欄位，兩者可能短暫不同步。要確認實際版本，請參考安裝包檔名與安裝後的「關於」頁面。不要依照版本號自行拼湊新檔名，也不要反覆安裝不同套件，只為了讓標示一致；請先保留目前可用的設定，再判斷是否需要更新。
若更新後連線異常，請先檢視更新前後設定的差異。系統代理狀態、目前選取的伺服器、路由模式與 DNS 都是較容易變動的項目。每次只調整一項，測試後記錄結果；若同時變更核心、DNS、TUN 與伺服器參數，排查時就難以找到明確起點。詳細設定方式請參閱訂閱管理與進階設定。
請先分辨「檔案下載失敗」、「程式安裝失敗」與「安裝成功但連線失敗」。下載失敗發生在瀏覽器取得檔案時；安裝失敗通常與架構、系統版本、權限或套件相依性有關；連線失敗則要檢查伺服器參數與代理狀態。三個階段的問題原因不同，不宜一律重新下載。
確認瀏覽器已完成下載，而不是仍只有暫存檔。ZIP 請先解壓縮，DMG 使用系統磁碟映像工具開啟，APK 交由系統安裝程式處理；deb 和 rpm 則使用適合該發行版的軟體安裝程式。檔案類型決定開啟方式，修改副檔名不會改變檔案內容。若瀏覽器明確顯示下載失敗，請透過相應入口重新下載。
請完整記錄安裝程式的提示，先確認架構與系統版本。Android 需分辨架構不符、簽章衝突與安裝權限限制；Linux 需分辨套件格式與相依性版本問題；桌面端也要留意執行環境提示。不要為了略過提示而刪除舊設定或強制忽略相依性，先確認錯誤發生在哪個環節再處理。
先確認裝置本身能正常連上網路、系統時間正確且訂閱尚未失效，再檢查目前選取的伺服器與代理模式。Android 端請確認 VPN 連線沒有被另一款 App 取代；桌面端則確認需要使用代理的 App 確實有讀取系統代理。將記錄中的錯誤時間與實際要求對照，通常比只看連線圖示更有幫助。
若用戶端能穩定開啟、訂閱也能更新，但某台伺服器始終逾時，請優先檢查該項設定與伺服器狀態。若只有部分 App 發生問題，應檢查 App 代理設定、路由與 DNS，而不是立刻更換安裝包。可繼續閱讀說明中心，依照問題症狀尋找後續處理方式。
還需要服務提供者提供的訂閱連結或伺服器設定。安裝包只提供圖形介面與執行元件，不會自動產生可用的伺服器。完成安裝後，請依使用指南匯入設定、選擇伺服器並啟用適合的代理模式。
第一次安裝建議優先選擇採用新一代跨平台介面的 Desktop 桌面版；習慣傳統 Windows 版面的使用者則可選 WPF 版。兩者都能管理伺服器與訂閱，但選單位置及操作方式可能不同。請先備份設定，測試時不要同時啟用兩個用戶端的系統代理。
arm64 版適用於相容的 64 位元 ARM 系統，2015 年後推出的主流手機通常可優先選用，但仍應以裝置的實際系統架構為準。通用版支援較多架構，適合不確定架構或需要兼顧不同裝置的情況。處理器支援 64 位元，不代表系統也一定是 64 位元。
版本標示與各安裝包路徑分別維護，可能會有更新不同步的情況。請以所選入口的實際檔名，以及安裝後用戶端「關於」頁面顯示的資訊確認版本；不要依版本標示自行改寫下載網址。更新前請先備份設定；如有疑慮，保留目前可正常使用的版本。
是否保留取決於用戶端版本、安裝方式及設定的儲存位置，不能只靠覆蓋安裝來保證。更新前請使用用戶端提供的備份或匯出功能，記錄訂閱群組、路由、DNS 與代理模式；更新後逐項檢查，並先測試一台已知可用的伺服器。
通常應先檢查本機網路、系統時間、伺服器參數、系統代理或 VPN 狀態，以及用戶端記錄。安裝成功只代表程式可以執行，不代表能連上伺服器。只有在安裝失敗、檔案缺失或啟動錯誤時，才考慮重新下載相應的安裝包。