開源專案
2dust/v2rayNG avatar
2dust/v2rayNG

2dust/v2rayNG:從 README 拆解功能邊界與核驗路徑

一款適用於Android的V2Ray客戶端,支援Xray核心和v2fly核心。 v2rayNG 一款適用於 Android 的 V2Ray 用戶端,支援 Xray 核心和 v2fly 核心 下載/在此處下載最新版本: [!TIP] v2rayNG 是行動版本。

62,630 個 Star8,101 個 ForkKotlinGPL-3.0

秒懂

它是什麼?
以 README、倉庫資料與版本資訊整理 2dust/v2rayNG 的實際能力、操作入口和未說明限制。
適合誰用?
適合需要 2dust/v2rayNG 所處理工作、且能依 README 指定的命令與文件維護環境的人;不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。
可以商用嗎?
可以,但有條件。GPL-3.0 是 copyleft 授權:如果你散布包含它的軟體,就必須以同一授權公開該軟體的原始碼。只在內部執行、不對外散布,則不會觸發這項義務。
還在維護嗎?
有在維護。儲存庫最近一次提交在 3 天前。
用什麼語言寫的?
主要是 Kotlin(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月14日)與我們的分析,不構成法律意見。

開源專案深度解析

支援兩種核心的 Android V2Ray 用戶端

該倉庫將 v2rayNG 描述為一款適用於 Android 的 V2Ray 用戶端,支援兩種核心實作:Xray core 和 v2fly core。專案使用 Kotlin 撰寫。倉庫中繼資料記錄為 60631 個 star、7880 個 fork、16 個開放問題,預設分支為 master,專案未被封存,倉庫首頁為 v2rayng.2dust.link。README 本身沒有提供更多產品層面的描述,因此關於介面配置、路由行為、連線管理或效能特徵的細節均未被來源材料證實,需要從 wiki 或應用程式本身進一步核實。兩種核心之間的差異、切換方式以及各自的設定格式在 README 中也沒有展開。

在「支援兩種核心的 Android V2Ray 用戶端」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 1 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「支援兩種核心的 Android V2Ray 用戶端」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 1 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

發佈下載、GPG 簽章與手機版和電腦版的區分

README 將使用者引導至 GitHub releases 頁面以取得最新版本,並明確指出 v2rayNG 是手機版,電腦版請前往 v2rayN 倉庫。發佈檔案使用 GPG 簽章以校驗真實性與完整性,README 稱這有助於預防鏡像站、電信業者或 CDN 劫持。公鑰指紋印在 README 中:7694 5E9F 3E9A 168F 8070 F195 805D 661C 134D FAF6 8903 C199 463C 31E5 AE90 3AE0。除下載發佈檔案之外,README 沒有提供具體的安裝步驟,也沒有說明如何驗證簽章檔案的操作流程。下載頁面還包含其他版本的歷史紀錄,但 README 未列出任何具體版本號。

在「發佈下載、GPG 簽章與手機版和電腦版的區分」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 2 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「發佈下載、GPG 簽章與手機版和電腦版的區分」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 2 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

geoip 與 geosite 資料檔

README 說明了 geoip.dat 和 geosite.dat 在裝置上的位置:Android/data/com.v2ray.ang/files/assets,並註明部分裝置路徑可能不同。應用程式內的下載功能會從 Loyalsoldier/v2ray-rules-dat 倉庫取得增強版本,README 同時提醒該功能需要一個可用的代理。最新的官方網域清單和 IP 清單可以手動匯入,也可以在同一資料夾中使用第三方 dat 檔,README 以 v2fly 路由指南中的 h2y 為例。更多內容請見專案 wiki,但 wiki 的具體頁面和內容在 README 中沒有展開。這些資料檔的具體格式、更新頻率和路由規則的影響範圍同樣未在 README 中說明,使用者需要查看 wiki 或相關資料倉庫才能了解。

在「geoip 與 geosite 資料檔」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 3 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「geoip 與 geosite 資料檔」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 3 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

編譯專案與核心函式庫

README 的開發指南說明,V2rayNG 資料夾下的 Android 專案可以直接在 Android Studio 中編譯,或使用 Gradle wrapper 編譯,但 aar 內建的 v2ray core 可能已過時。aar 可以由 Golang 專案 AndroidLibV2rayLite 或 AndroidLibXrayLite 編譯而成,README 建議參考 Go Mobile 指南和 Makefiles for Go Developers 教學以快速上手。README 沒有列出具體的 Gradle 指令、Android SDK 版本要求或最低 API 等級,這些資訊需要從專案檔案或建置日誌中確認。開發指南也沒有說明如何將自訂核心打包進 aar 的具體步驟。

在「編譯專案與核心函式庫」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 4 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「編譯專案與核心函式庫」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 4 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

模擬器與 WSA 說明

README 指出 v2rayNG 可以在 Android 模擬器上執行。對於 Windows 子系統 Android(WSA),需要透過 appops set [package name] ACTIVATE_VPN allow 指令授予 VPN 權限,指令中的套件名稱佔位符需要替換為實際的套件名稱。除此之外,README 沒有提供其他平台相關的說明,也沒有說明模擬器上的網路設定或效能表現。模擬器與實機之間的行為差異需要使用者自行驗證,WSA 的版本要求也沒有在 README 中提及。

在「模擬器與 WSA 說明」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 5 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「模擬器與 WSA 說明」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 5 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

社群管道

README 列出了兩個 Telegram 目的地:群組 t.me/v2rayN 和頻道 t.me/github_2dust。來源材料中沒有提及論壇、Discord 伺服器或 IRC 頻道等其他社群場所,也沒有描述這兩個 Telegram 管道的預期內容、語言或行為準則。使用者若需要了解社群規則或使用方式,只能透過造訪連結自行確認。Telegram 群組和頻道在部分網路環境下可能無法直接存取,但 README 沒有討論這一情況。

在「社群管道」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 6 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「社群管道」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 6 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

GPL-3.0 授權及其邊界

該倉庫採用 GPL-3.0 授權。授權文字將其定義為自由軟體使用的 copyleft 授權,授予散佈副本、取得原始碼、修改軟體或在新的自由程式中使用其片段的权利,同時明確該自由軟體不提供任何擔保,並要求修改版本必須標記為已變更。授權文字沒有涉及安全狀況、支援承諾或超出標準 GPL 條款之外的商業使用問題,README 也沒有提及這些主題。對於使用者而言,授權的主要可見後果是:使用該軟體時不存在來自作者的擔保或支援義務。GPL-3.0 的完整條款包含對專利的明確限制,但 README 中沒有任何關於專利或法律建議的說明。

在「GPL-3.0 授權及其邊界」這個面向,2dust/v2rayNG 不能只看功能名稱。README 明列的 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 讓使用者可以把第 7 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。

「GPL-3.0 授權及其邊界」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 2.3.5;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayNG 在第 7 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。

編輯結論

適合需要 2dust/v2rayNG 所處理工作、且能依 README 指定的命令與文件維護環境的人;不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 v2rayNG 把節點、訂閱、路由與 VPN 服務放在 Android 端;核對時應看 Android 權限、tun 模式、核心版本和匯入設定是否互相匹配。 建立隔離測試,確認輸入、輸出、權限與失敗訊息,再決定是否納入正式流程。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記