v2rayN
推薦桌面版採用新一代跨平台 UI；WPF 是經典穩定版，適合延續既有操作習慣。兩種版本皆以壓縮檔提供，下載後請先解壓縮，再執行資料夾內的安裝程式。
訂閱群組系統代理路由設定
安裝後如何匯入訂閱 →
V2Ray 下載
v2rayN 桌面版、v2rayNG Android 版與 v2flyNG 替代選項。
先選擇作業系統，再挑選處理器架構。
安裝檔用於安裝用戶端；連線所需的訂閱或服務設定需另外準備。初次安裝請先使用預設設定，匯入並成功連線後，再調整路由和 DNS。
4 個平台3 款用戶端Xray · v2fly 核心VMess / VLESS / Trojan / Shadowsocks
Windows 安裝準備
| 項目 | 檢查事項 |
|---|---|
| 系統架構 | 以上下載項目皆為 x64，請先在系統「關於」頁面確認系統類型。 |
| 系統相容性 | 請使用符合用戶端及其執行元件需求的 Windows 環境，並以安裝提示為準。 |
| 寫入權限 | 安裝位置與設定資料夾需有寫入權限；請先完整解壓縮再啟動。 |
| 網路權限 | 系統代理通常不需提升權限；TUN 可能需要管理員授權。 |
下載壓縮檔後，請勿直接從壓縮軟體的預覽視窗啟動程式。先將所有檔案解壓縮到可寫入的資料夾，再開啟安裝程式。若系統提示缺少執行元件，請依提示安裝所需元件，不要從其他安裝目錄任意複製檔案。
若已使用 v2rayN，請先記下本機監聽連接埠與系統代理狀態。更新或切換介面前，請先結束舊執行個體，避免兩個用戶端爭用連接埠。安裝完成後，先確認訂閱群組與選取的設定檔，再啟用系統代理；若瀏覽器另有設定代理，也請核對連接埠是否正確。
v2rayN
桌面版推薦開啟 Apple 選單 →「關於這台 Mac」。晶片資訊顯示 Apple M 系列時請選 Apple Silicon；處理器顯示 Intel 時請選 x64。請勿只憑機身外觀或購買年份判斷。
DMG訂閱管理系統代理
macOS 安裝與權限說明 →
macOS 安裝準備
| 項目 | 檢查事項 |
|---|---|
| 晶片架構 | Apple Silicon 對應 arm64，Intel 對應 x64。 |
| 系統相容性 | 系統須符合目前應用程式的最低需求，請以開啟應用程式時顯示的提示為準。 |
| 安裝位置 | 開啟 DMG，將應用程式拖移至「應用程式」資料夾後再執行。 |
| 權限確認 | 確認應用程式來源後，依系統設定處理啟動與網路相關授權。 |
首次開啟時若出現開發者驗證提示，請先確認下載來源和所選架構，再到系統設定的「隱私權與安全性」查看此次遭到封鎖的紀錄。只需針對目前的應用程式允許執行，不必為了安裝單一用戶端而全面關閉系統安全機制。
啟動後請留意，系統代理與 TUN 是不同的網路接管方式。先依照教學匯入訂閱，並使用系統代理測試基本連線。若應用程式要求網路相關授權，請依啟用的功能判斷用途。變更權限後，可結束並重新啟動用戶端，再檢查系統代理是否已正確設定，以免將權限問題誤判為服務設定失效。
v2rayNG
推薦2015 年後推出的主流手機通常建議優先選擇 arm64，實際仍應以系統支援的應用程式架構為準。不確定架構時可選通用版；通用版不代表能略過系統最低版本需求。
需要 Xray 設定功能時，建議優先使用 v2rayNG。安裝後可從主畫面新增設定；訂閱網址請新增至「訂閱群組設定」，儲存後再更新訂閱。匯入和連線是兩個步驟，清單出現設定檔後，仍須選取並啟動連線。
v2rayNG 初次設定步驟 →v2flyNG
替代選項適合已使用 v2fly 設定環境的使用者。架構選擇方式與 v2rayNG 相同，但核心功能和設定欄位可能不同，不能只因介面相似就視為完全一致。
從其他用戶端移轉時，請先確認伺服器要求的通訊協定與傳輸選項是否受支援。保留原始訂閱網址或分享連結，透過新用戶端的匯入功能重新建立設定；請勿直接覆寫兩個應用程式的私人資料夾。
比較核心與用戶端差異 →Android 安裝準備
| 項目 | 檢查事項 |
|---|---|
| 應用程式架構 | arm64 安裝檔適用於支援 64 位元應用程式的系統；不確定時請選通用版。 |
| 系統相容性 | 須符合所選用戶端目前安裝檔的 Android 系統需求，並以系統安裝結果為準。 |
| 安裝授權 | 依系統提示，允許這次使用的瀏覽器或檔案管理員安裝應用程式。 |
| 連線授權 | 首次啟動 VPN 模式時，請確認系統 VPN 連線要求；同一時間避免執行其他 VPN 連線。 |
若系統提示無法安裝，請先查看完整錯誤訊息。常見原因包括系統版本不符、架構不相容、儲存空間不足，或新舊應用程式的簽章不同。請勿一遇到錯誤就刪除舊應用程式；解除安裝可能會清除本機設定，請先匯出需要保留的資料，再判斷是否確實需要重新安裝。
安裝來源授權與 VPN 授權是兩回事，無法互相取代。前者允許系統安裝應用程式，後者則允許用戶端建立本機 VPN 介面。若連線建立後容易在背景中斷，請再檢查電池最佳化與背景執行限制。初次測試請先保留預設路由，暫不啟用 FakeDNS、Mux 或複雜的應用程式代理規則，以縮小排查範圍。
v2rayN
桌面版推薦請先依發行版選擇 deb 或 rpm，再依處理器選擇 x64 或 arm64。套件格式、架構和系統程式庫相容性是三項獨立條件，副檔名相同不代表一定適用於目前的系統。
安裝後的桌面代理設定 →Linux 安裝準備
| 項目 | 檢查事項 |
|---|---|
| 套件格式 | Debian、Ubuntu 系列通常使用 deb；Fedora、RHEL 系列通常使用 rpm。 |
| 處理器架構 | amd64、x86_64 對應 x64；aarch64 通常對應 arm64。 |
| 桌面環境 | 需要可執行圖形應用程式的桌面工作階段，以及安裝檔要求的相依程式庫。 |
| 操作權限 | 安裝套件需要相應授權；TUN 所需的網路權限需另外確認。 |
建議使用發行版的套件安裝程式開啟檔案，查看系統顯示的相依套件與相容性結果。若安裝程式指出相依套件版本不符，請勿強制忽略。先確認系統發行版、架構和軟體來源狀態，再判斷目前的安裝檔是否適用；只更改副檔名無法轉換套件格式。
用戶端啟動後，桌面環境的系統代理不一定涵蓋所有應用程式。瀏覽器、終端機工具和獨立網路應用程式可能各自使用不同的代理設定。請先選一個應用程式測試連線，再逐步擴大使用範圍；若要使用 TUN，請另外了解權限與路由變更，結束後也要確認原有網路已恢復。
安裝後檢查順序
用戶端、服務設定與網路接管方式應分開檢查。先確認基本連線正常，再新增個人化規則，避免一次變更多項設定而難以找出問題。
匯入服務設定
單一分享連結可從剪貼簿匯入；訂閱網址則需新增至訂閱群組，再執行更新。請勿將訂閱網頁的介紹頁網址誤當成訂閱介面，也不要在公開求助內容中貼上完整訂閱網址。
更新後清單空白時，請先確認網址是否完整、網路是否可連線，再暫時清除關鍵字篩選。用戶端下載成功不代表訂閱介面一定連得上，兩者應分開檢查。
訂閱格式與匯入入口 →選擇網路接管方式
桌面端請先使用系統代理；Android 則先以 VPN 模式完成初次測試。v2rayNG 的「僅代理模式」只會開啟本機代理入口，不會自動讓所有應用程式使用該入口，適合清楚了解如何設定應用程式代理的情況。
依應用程式設定代理會影響哪些應用程式透過連線。初次使用請先維持簡單設定，確認瀏覽器可以正常連線後，再逐一加入其他應用程式。請勿同時啟用多個負責網路接管的用戶端。
選擇模式並測試連線 →保留可還原的設定
修改路由、DNS 或 TUN 前請先備份。發生異常時，還原最近一次變更，重新啟動連線後再測試。遇到憑證錯誤，請先檢查系統時間和服務設定，勿直接停用憑證驗證。
記下錯誤提示、用戶端名稱、系統架構和操作步驟，有助於找出問題。記錄檔可能包含伺服器網址或認證欄位，分享前請移除敏感資訊，備份檔也請妥善保管。
路由、DNS 與進階設定 →安裝檔選擇與問題排查
「無法安裝」、「無法啟動」和「無法連線」應分開排查。無法安裝時先檢查套件格式、架構和系統需求；無法啟動時再確認執行元件、應用程式權限與錯誤提示；若能開啟但無法連線，則檢查訂閱是否有效、所選設定檔、系統時間和代理模式。反覆更換安裝檔通常無法解決伺服器認證或路由規則問題。
下載中斷時，請先查看瀏覽器下載紀錄和裝置剩餘空間，再重新點選相應入口。檔案儲存完成後再交由安裝程式處理，勿將尚未下載完成的暫存檔當成安裝檔。瀏覽器變更儲存檔名不會影響選擇邏輯，但排查問題時請記下實際選擇的用戶端、平台和架構，避免混淆不同下載入口。
版本文字與實際檔名可能分別由清單中的不同欄位維護，頁面不會據此推斷升級途徑。安裝後請查看用戶端的「關於」頁面確認實際版本，並保留一份可正常運作的設定。若出現新問題，請先檢視最近的變更，不要同時重設訂閱、連接埠、DNS 和所有路由規則。
下載與安裝常見問題
Android 要選 arm64 還是通用版？
2015 年後推出的主流手機通常建議優先選擇 arm64，但仍應以系統支援的應用程式架構為準。處理器支援 64 位元，不代表系統也支援 64 位元應用程式；不確定架構時可選通用版。若仍無法安裝，請檢查系統相容性與安裝提示。
Windows 桌面版和經典 WPF 版有什麼不同？
Desktop 桌面版採用新一代跨平台 UI，經典 WPF 版則使用 Windows 桌面介面。初次使用可先選桌面版；習慣 WPF 操作方式的使用者也可繼續選擇經典穩定版。切換前請先備份設定，並避免讓兩個執行個體同時接管系統代理。
macOS 要下載 Apple Silicon 還是 Intel 安裝檔？
開啟 Apple 選單中的「關於這台 Mac」，查看晶片或處理器資訊。顯示 Apple M 系列晶片時請選 Apple Silicon；顯示 Intel 處理器時請選 Intel。安裝檔架構應與這台 Mac 的硬體相符。
安裝完成後，為什麼還是無法連線？
安裝檔只提供用戶端，不含可用的服務設定。請匯入有效的訂閱或分享連結，選取設定檔後啟動連線。Android 需確認 VPN 授權；桌面端則依應用程式需求啟用系統代理，或設定應用程式代理。
更新用戶端前，要先保留哪些設定？
先使用用戶端提供的備份或匯出功能保存設定，並記下訂閱群組、路由、DNS、依應用程式設定的代理和本機監聽連接埠。備份請存放在自行控管的位置，勿分享含有訂閱網址或認證資訊的設定檔。
頁面顯示的版本和安裝檔檔名不同，該以哪個為準？
版本文字與安裝檔入口取自清單中的不同欄位，更新時可能暫時不同步。請勿依檔名手動修改下載網址。安裝後可在用戶端的「關於」頁面確認實際版本；需要更新時，請重新開啟本頁並選擇相應平台的下載入口。