2dust/v2rayN:從 README 拆解功能邊界與核驗路徑
適用於 Windows、Linux 和 macOS 的 GUI 用戶端,支援 Xray 和 sing-box 等。
秒懂
- 它是什麼?
- 以 README、倉庫資料與版本資訊整理 2dust/v2rayN 的實際能力、操作入口和未說明限制。
- 適合誰用?
- 適合需要 2dust/v2rayN 所處理工作、且能依 README 指定的命令與文件維護環境的人;不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。
- 可以商用嗎?
- 可以,但有條件。GPL-3.0 是 copyleft 授權:如果你散布包含它的軟體,就必須以同一授權公開該軟體的原始碼。只在內部執行、不對外散布,則不會觸發這項義務。
- 還在維護嗎?
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的?
- 主要是 C#(依據 GitHub 的語言統計)。
以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。
開源專案深度解析
面向 Xray、sing-box 等核心的桌面用戶端
v2rayN 是一個面向 Windows、Linux 和 macOS 的圖形介面用戶端,儲存庫語言為 C#。儲存庫描述說明它支援 Xray、sing-box 以及其他核心,README 中給出了指向 wiki 的連結,用於列出受支援的核心。README 本身沒有逐項列出這些核心。它還明確指出 v2rayNG 是行動版本,因此 v2rayN 是桌面版本。專案首頁是 https://v2rayn.2dust.link。README 採用英文和中文雙語寫成,每個標題和說明都有兩種語言。儲存庫中繼資料中的描述是"A GUI client for Windows, Linux and macOS, support Xray and sing-box and others",這與其 README 開頭的描述一致。README 的第一部分是標題和簡介,隨後是下載、文件、平台、GPG 和社群等節。
在「面向 Xray、sing-box 等核心的桌面用戶端」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 1 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「面向 Xray、sing-box 等核心的桌面用戶端」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 1 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
支援的平台與 CPU 架構
README 中的平台表格使用勾號表示支援。Windows 支援 x64、x86 和 arm64;Linux 支援 x64、arm64、riscv64 和 loong64;macOS 支援 x64 和 arm64。表格中沒有列出 Windows 對 riscv64 或 loong64 的支援,也沒有列出 Linux 對 x86 的支援,macOS 則沒有 x86、riscv64 或 loong64。除了這些作業系統和架構,表格沒有提到其他內容。該表格不包含任何效能或相容性說明,README 也沒有解釋為什麼某些組合缺失。表格中的缺失項用連字號表示,但沒有附加文字說明。表格的標題是"Supported Platforms / 支援平台",這是 README 中唯一關於平台支援的部分。
在「支援的平台與 CPU 架構」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 2 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「支援的平台與 CPU 架構」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 2 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
下載與發行檔驗證
README 指示使用者到 GitHub releases 頁面下載最新版本。發行檔使用 GPG 簽章,README 稱這樣可以驗證檔案真實性與完整性,並幫助防止鏡像站、電信業者或 CDN 劫持。README 給出了公鑰指紋:7694 5E9F 3E9A 168F 8070 F195 805D 661C 134D FAF6 8903 C199 463C 31E5 AE90 3AE0。不過它沒有說明如何匯入公鑰,也沒有提供單獨的校驗和列表。指紋以文字區塊形式出現,使用者需要自行取得對應的公鑰。README 沒有給出公鑰的下載位址或驗證命令。該節的標題是"GPG Verification / GPG 簽章校驗",除了指紋之外沒有其他關於驗證的說明。
在「下載與發行檔驗證」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 3 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「下載與發行檔驗證」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 3 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
文件與社群
使用說明和組態教學位於專案 wiki,README 中給出了 wiki 的連結。README 還列出了一個 Telegram 群組(t.me/v2rayN)和一個 Telegram 頻道(t.me/github_2dust),除此之外沒有提到其他支援管道。因為 wiki 是外部頁面,本文不轉載其內容。README 自身關於文件的部分只有這些連結。另外,README 提示手機版是 v2rayNG,並給出了對應儲存庫位址。README 中的提示區塊明確寫著"v2rayN is the desktop version",因此桌面與行動版的區分是專案自己說明的。文件節的標題是"Documentation / 使用文件",社群節的標題是"Community / 社群",兩者都只包含連結。
在「文件與社群」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 4 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「文件與社群」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 4 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
授權條款及其涵蓋範圍
該儲存庫使用 GPL-3.0 授權。授權條款摘錄說明它授予使用者散布副本、接收或取得原始碼、修改軟體以及在新的自由程式中使用其中部分內容的自由。摘錄還說明該自由軟體不提供擔保,修改版本必須標記為已修改。README 本身沒有額外提供支援或保固條款。GPL-3.0 還包含關於專利和反使用者限制裝置的相關條款,但 README 未對這些條款展開說明。授權條款文字同時指出,散布副本時無論是否收費,都必須將相同的自由傳遞給接收者,並確保他們能夠取得原始碼。提供的授權條款摘錄只包含 GPL-3.0 的開頭部分,包括序言和定義,沒有列出完整的條款。
在「授權條款及其涵蓋範圍」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 5 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「授權條款及其涵蓋範圍」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 5 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
儲存庫中繼資料與狀態
儲存庫中繼資料顯示預設分支為 master,專案未被封存,目前有 21 個未關閉的 issue。儲存庫擁有 113,102 個 star 和 15,636 個 fork。主要語言是 C#。這些數字來自本次提供的中繼資料,README 中沒有描述。對於該專案的實際使用人數或效能,源材料中沒有相關資料。README 也沒有提及版本號、安裝步驟或命令列用法。專案首頁是 https://v2rayn.2dust.link,但 README 中沒有進一步說明該頁面的用途。儲存庫狀態顯示 archived 為 false,說明專案仍在維護中,但 README 沒有給出維護計畫或發布節奏。
在「儲存庫中繼資料與狀態」這個面向,2dust/v2rayN 不能只看功能名稱。README 明列的 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 讓使用者可以把第 6 項檢查拆成可觀察的步驟:先確認輸入是否被正確接受,再記錄產物、日誌或介面狀態,最後把結果和倉庫中的說明逐項對照。素材沒有明說的系統需求、錯誤處理或安全承諾,本文不替它補上結論。
「儲存庫中繼資料與狀態」也會受到版本與環境影響。倉庫資料記錄的預設分支是 master,最近版本為 7.24.9;這些是來源快照,不是效能保證。若要採用,應以同一版本重跑上述專案命令,觀察 2dust/v2rayN 在第 6 項測試中的輸出,而不是以 star、fork 或作者形容詞代替證據。
編輯結論
適合需要 2dust/v2rayN 所處理工作、且能依 README 指定的命令與文件維護環境的人;不適合把倉庫描述直接當成安全、效能或相容性保證的人。先以 v2rayN 的 Windows 桌面流程集中在伺服器訂閱、節點匯入、路由規則與系統代理;測試時要分開觀察核心程序、訂閱內容和代理開關。 建立隔離測試,確認輸入、輸出、權限與失敗訊息,再決定是否納入正式流程。
社群筆記