---
title: "安装v2rayN"
type: source
tags: [linux, v2rayn, windows, macos]
date: 2026-04-14
---

## Source File
- [[raw/Home Office/安装v2rayN.md]]

## Summary (中文)
- **核心主题**：v2rayN 跨平台代理客户端的官方发布包详解，涵盖 Windows/Linux/macOS 各平台下载选项、安装方式与依赖要求
- **问题域**：如何为不同操作系统选择正确的 v2rayN 版本，以及各平台安装注意事项
- **方法/机制**：
  - zip 便携版：解压即用，数据存储在同目录，多份独立运行
  - deb/rpm 安装版：存储在系统用户文件目录，通过 apt/dnf 安装
  - WPF 版需额外安装 .NET 8 Desktop Runtime；Avalonia UI 版为自包含
  - macOS DMG 版因无签名需执行 `xattr -cr` 修复
  - 支持多核心：Xray、sing-box、mihomo
- **结论/价值**：v2rayN 是支持 Windows/Linux/macOS 的可视化代理客户端，Windows 推荐 WPF 版，跨平台推荐 Avalonia UI 版；核心文件需单独下载

## Key Claims (中文)
- v2rayN 跨平台支持 Windows 10+、Linux（Debian 12+/Ubuntu 22.04+/Fedora 36+/RHEL 9+）、macOS 12+
- zip 便携版解压后直接运行 `./v2rayN`，数据存放在程序同目录，可多份独立使用
- deb/rpm 安装版存储位置为系统规定的用户文件目录
- Windows x64 WPF 版需预装 Microsoft .NET 8.0 Desktop Runtime，Avalonia UI 版为自包含无需额外依赖
- macOS DMG 版因应用无签名会提示"已损坏"，安装后需执行 `xattr -cr /Applications/v2rayN.app` 修复
- 发布包内含部分 Core（Xray/sing-box/mihomo），其他 Core 需从 v2rayN-core-bin 仓库单独下载

## Key Quotes
> "zip 格式包为便携版，解压缩到文件夹后直接可以运行，存储文件位置为本文件夹；可以复制多份互相独立" — 官方说明
> "v2rayN-windows-64.zip WPF实现的界面，需要安装 Microsoft .NET 8.0 Desktop Runtime" — Windows x64 WPF版依赖说明
> "v2rayN-macos-64.dmg 由于安装包没有签名，会提示应用已损坏；安装后需要运行：xattr -cr /Applications/v2rayN.app" — macOS签名问题解决方案

## Key Concepts
- [[代理客户端]]：运行在终端设备上，通过代理协议连接远程节点的软件
- [[代理协议]]：v2rayN 支持 VLESS/VMess/Trojan/SS 等协议
- [[Reality]]：Xray 的流量伪装方案，v2rayN 可配合 Reality 节点使用
- [[Avalonia UI]]：跨平台 .NET UI 框架，v2rayN Avalonia 版可运行在 Windows/Linux/macOS，无需额外运行时依赖
- [[WPF]]：Windows Presentation Foundation，Windows 原生 UI 框架，.NET 桌面应用首选
- [[.NET Desktop Runtime]]：.NET 桌面运行时环境，WPF 应用必需依赖
- [[便携版]] vs [[安装版]]：便携版数据自包含、安装版数据放系统目录
- [[代理核心]]：代理客户端的底层引擎，如 Xray、sing-box、mihomo

## Key Entities
- [[v2rayN]]：主产品，GitHub 2dust 维护的跨平台代理客户端，支持多种协议和核心
- [[Xray]]：v2rayN 支持的代理核心之一，Reality 流量伪装方案的内核
- [[sing-box]]：v2rayN 支持的代理核心，支持多协议
- [[mihomo]]：v2rayN 支持的代理核心，mihomo 协议实现
- [[2dust]]：v2rayN GitHub 仓库维护者
- [[Microsoft .NET 8.0 Desktop Runtime]]：Windows WPF 版的必需运行时环境
- [[Avalonia UI]]：跨平台 UI 框架，v2rayN desktop 版基于此构建

## Connections
- [[v2rayN]] ← 使用 ← [[Xray]]
- [[v2rayN]] ← 使用 ← [[sing-box]]
- [[v2rayN]] ← 使用 ← [[mihomo]]
- [[v2rayN]] ← 依赖 ← [[Microsoft .NET 8.0 Desktop Runtime]]（WPF 版）
- [[v2rayN]] ← 基于 ← [[Avalonia UI]]（desktop 版）
- [[3X-UI]] ← 服务端 ← [[Xray]]（v2rayN 的服务端 counterpart）
- [[v2rayNG]] ← 移动版 ← [[v2rayN]]（Android 版）
- [[Bandwagon VPS]] ← 托管 ← [[3X-UI]] + [[Xray]]（服务端节点）

## Contradictions
- 与 [[3x-ui-xray-on-bandwagonvps]] 互补而非冲突：v2rayN 是客户端，3X-UI 是服务端管理面板，共同构成完整代理链路（服务端 Xray ←→ 客户端 v2rayN）
- 与 [[ubuntu-server科学上网]] 各有侧重：v2rayN 提供图形界面，命令行代理适合服务器/路由器场景