v2rayN-cli

Linux/macOS 无图形界面的 v2rayN 命令行与全屏终端客户端，支持订阅链接、单节点、节点管理、配置编辑、实时日志和中英文 TUI。

界面预览

使用 Release 包安装（推荐）

Release 包已经包含 .NET 运行环境和对应平台的代理核心，普通用户不需要安装 .NET，也不需要编译源码。

一键安装或更新

在 macOS 或 Linux 终端中执行下面这一条命令。安装器会自动识别系统和 CPU、下载最新 Release、校验 SHA256、安装程序并配置全局命令：

(set -o pipefail; curl -fsSL https://raw.githubusercontent.com/Ryderwe/v2rayN-cli/master/install-cli.sh | bash) && export PATH="$HOME/.local/bin:$PATH"

安装完成后只需输入：

v2rayN-cli ui

以后需要升级时，重新执行同一条安装命令即可。程序配置和节点数据保存在用户数据目录中，升级不会删除它们。

手动下载安装

先进入 GitHub Releases，根据系统和 CPU 下载对应的压缩包：

系统	CPU	下载文件后缀
macOS	Apple Silicon（M1/M2/M3/M4/M5）	osx-arm64.tar.gz
macOS	Intel	osx-x64.tar.gz
Linux	Intel/AMD 64 位	linux-x64.tar.gz
Linux	ARM64/AArch64	linux-arm64.tar.gz

不确定 CPU 架构时可以执行：

uname -m

输出 arm64 或 aarch64 时选择 ARM64；输出 x86_64 时选择 x64。

解压并直接启动

下面以 v2rayN-cli-7.23.4-osx-arm64.tar.gz 为例，请把 PACKAGE 改成实际下载的文件名：

cd "$HOME/Downloads"
PACKAGE="v2rayN-cli-7.23.4-osx-arm64.tar.gz"

tar -xzf "$PACKAGE"
cd "${PACKAGE%.tar.gz}"
chmod +x v2rayN-cli
./v2rayN-cli ui

macOS 如果提示程序来自身份不明的开发者，可以清除下载隔离标记后重新启动：

xattr -dr com.apple.quarantine .
./v2rayN-cli ui

安装为全局命令

如果希望在任意目录直接运行 v2rayN-cli：

cd "$HOME/Downloads"
PACKAGE="v2rayN-cli-7.23.4-osx-arm64.tar.gz" # 改成实际下载的文件名
INSTALL_DIR="$HOME/.local/share/v2rayN-cli"

mkdir -p "$INSTALL_DIR" "$HOME/.local/bin"
tar -xzf "$PACKAGE" -C "$INSTALL_DIR" --strip-components=1
chmod +x "$INSTALL_DIR/v2rayN-cli"
ln -sf "$INSTALL_DIR/v2rayN-cli" "$HOME/.local/bin/v2rayN-cli"

将命令目录加入 PATH。macOS 默认使用 Zsh：

grep -q 'HOME/.local/bin' "$HOME/.zshrc" 2>/dev/null || \
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.zshrc"
source "$HOME/.zshrc"

Linux 使用 Bash 时：

grep -q 'HOME/.local/bin' "$HOME/.bashrc" 2>/dev/null || \
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$HOME/.bashrc"
source "$HOME/.bashrc"

安装完成后启动全屏终端界面：

v2rayN-cli ui

在“节点”或“订阅”页面按 a 可以添加节点或导入订阅；按 Space 选择节点，按 s 启动代理，按 l 切换中文/英文。默认 SOCKS5/HTTP 混合代理地址为 127.0.0.1:10808。

也可以完全使用命令行：

v2rayN-cli subs add 'https://example.com/subscription' --name my-sub --update
v2rayN-cli nodes list
v2rayN-cli nodes select '节点ID前缀'
v2rayN-cli start
v2rayN-cli status

安装 .NET 10 SDK

只有从源码构建 v2rayN-cli 时才需要安装 .NET 10 SDK。通过 Release 下载的自包含程序不需要安装 .NET。

macOS 和 Linux 都可以使用微软官方安装脚本：

curl -fsSL https://dot.net/v1/dotnet-install.sh -o /tmp/dotnet-install.sh
bash /tmp/dotnet-install.sh --channel 10.0 --install-dir "$HOME/.dotnet"

让当前终端立即生效：

export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"
dotnet --version

如果使用 macOS 默认的 Zsh，将环境变量永久写入 ~/.zshrc：

grep -q 'DOTNET_ROOT="$HOME/.dotnet"' "$HOME/.zshrc" 2>/dev/null || cat >> "$HOME/.zshrc" <<'EOF'

export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"
EOF

source "$HOME/.zshrc"

如果 Linux 使用 Bash，将同样的配置写入 ~/.bashrc：

grep -q 'DOTNET_ROOT="$HOME/.dotnet"' "$HOME/.bashrc" 2>/dev/null || cat >> "$HOME/.bashrc" <<'EOF'

export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$DOTNET_ROOT:$PATH"
EOF

source "$HOME/.bashrc"

安装成功后，dotnet --version 应显示 10.x。

从源码构建

git clone https://github.com/Ryderwe/v2rayN-cli.git
cd v2rayN-cli

./package-cli.sh osx-arm64   # Apple Silicon macOS
./package-cli.sh linux-x64   # x86_64 Linux

# Apple Silicon 构建完成后启动
./release-cli/v2rayN-cli-*-osx-arm64/v2rayN-cli ui

GitHub Actions 自动发布

推送符合 v*-cli.* 格式的标签后，Actions 会自动构建 Linux/macOS 的 x64、ARM64 四个安装包，生成 SHA256SUMS 并创建 GitHub Release：

git tag -a v7.23.4-cli.1 -m "v2rayN-cli v7.23.4-cli.1"
git push origin v7.23.4-cli.1

也可以进入仓库的 Actions → Release v2rayN-cli → Run workflow，输入版本标签手动发布。

仓库还提供 Sync upstream and release 工作流，每 6 小时检查一次 2dust/v2rayN。上游 master 有新提交时会自动合并到本仓库， 但只有上游发布了新的 GitHub Release 时，才会构建四个平台安装包并创建本仓库的 Release。 也可以在 Actions 页面手动运行；启用 force_release 后，可以针对当前上游 Release 强制重新构建。

完整的构建、安装和快捷键说明见 v2rayN-cli 文档。

致谢

感谢 LINUX DO——新的理想型社区。

本项目基于 2dust/v2rayN 开发并继续遵循 GPL-3.0 许可证。下方保留上游项目说明。

Upstream v2rayN

A GUI client for Windows, Linux and macOS. Support Xray and sing-box and others

---

Download / 下载

Download the latest release here:

在这里下载最新版本：

https://github.com/2dust/v2rayN/releases

Tip

v2rayN is the desktop version. For the mobile version, please visit the v2rayNG
v2rayN 是电脑版，手机版请访问 v2rayNG

https://github.com/2dust/v2rayNG

---

Documentation / 使用文档

Read the Wiki for usage guides and configuration details.

请阅读 Wiki 获取使用说明和配置教程。

https://github.com/2dust/v2rayN/wiki

---

Supported Platforms / 支持平台

Platform / 平台	x64	x86	arm64	riscv64	loong64
Windows	✅	✅	✅	-	-
Linux	✅	-	✅	✅	✅
macOS	✅	-	✅	-	-

---

GPG Verification / GPG 签名校验

Release files are signed with GPG to verify authenticity and integrity, helping prevent mirror, ISP, or CDN hijacking.

发布文件已使用 GPG 签名，可用于校验文件真实性与完整性，预防镜像站、运营商或 CDN 劫持。

Fingerprint / 公钥指纹

7694 5E9F 3E9A 168F 8070 F195 805D 661C
134D FAF6 8903 C199 463C 31E5 AE90 3AE0

---

Community / 社区

Telegram Group / Telegram 群组：

https://t.me/v2rayN

Telegram Channel / Telegram 频道：

https://t.me/github_2dust