Linux 安装 v2rayN:deb/rpm 包部署与开机自启动设置

安装前检查：发行版、架构与桌面会话

Linux 应选择 v2rayN 的 Avalonia 桌面版，WPF 版面向 Windows。deb 与 rpm 是发行版的软件包格式，不代表代理协议或内核类型。先在终端执行下面的命令，确认系统身份；桌面环境还会影响系统代理设置与自启动入口。

cat /etc/os-release
uname -m
printf '桌面：%s\n会话：%s\n' "$XDG_CURRENT_DESKTOP" "$XDG_SESSION_TYPE"

uname -m 返回 x86_64 时通常对应 x64；返回 aarch64 时通常对应 arm64。Debian 的包架构字段可能写作 amd64，名称不同但对应同一类处理器架构。前往下载页确认当前 Linux 资源；本文的安装步骤仅用于已经取得的对应格式安装包，不承诺每个版本都同时提供两种格式。

Debian 与 Ubuntu：使用 apt 安装 deb

建议将本次安装包单独放在一个目录中，再从该目录打开终端。下面先列出当前目录的 deb 文件，然后交互输入实际路径，例如通过终端拖入文件。使用变量可以保留文件名中的空格；不要一次混选多个历史版本。

find "$PWD" -maxdepth 1 -type f -name '*.deb' -print
read -r -p '输入 deb 文件的完整路径：' pkg
if [ -f "$pkg" ]; then
  dpkg-deb -f "$pkg" Package Version Architecture
  dpkg --print-architecture
else
  printf '文件不存在，请重新选择。\n'
fi

确认包的架构与系统一致后再执行安装。apt install 可以处理本地包声明的依赖；与仅解包相比，更适合普通桌面用户。首次安装需要管理员授权，但客户端日常运行不需要因此改用管理员身份。

if [ -f "$pkg" ]; then
  pkg="$(realpath "$pkg")"
  sudo apt update
  sudo apt install "$pkg"
fi

• 出现依赖下载失败时，先确认软件源可用，再重试安装；不要通过忽略依赖强行继续。
• 出现架构不匹配时，返回下载页重选资源，不要用强制安装参数绕过检查。
• 安装结束后，在桌面应用列表搜索 v2rayN。若入口未出现，可用 dpkg -L "$(dpkg-deb -f "$pkg" Package)" 查看该包实际安装的文件。
• 更新同一软件包时可以重新运行本地包安装命令。覆盖程序文件不等于备份订阅和路由配置，更新前仍应保存重要设置。

Fedora：使用 dnf 安装 rpm

Fedora 使用 dnf 处理本地 rpm 包。安装前读取包名称、版本和架构，避免把桌面程序名称当成准确的包管理器标识。下面的命令同样读取实际文件；包名由安装包元数据决定，而不是在教程中写死。

find "$PWD" -maxdepth 1 -type f -name '*.rpm' -print
read -r -p '输入 rpm 文件的完整路径：' pkg
if [ -f "$pkg" ]; then
  pkg="$(realpath "$pkg")"
  rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$pkg"
  uname -m
  sudo dnf install "$pkg"
else
  printf '文件不存在，请重新选择。\n'
fi

安装成功后，可以执行 rpm -ql "$(rpm -qp --queryformat '%{NAME}' "$pkg")" 查看程序与桌面入口的位置。如果应用列表能找到 v2rayN，却启动后立即退出，应从终端执行桌面入口记录的程序路径，观察缺失库或内核启动错误，而不是反复安装不同架构的包。

首次连接：订阅、监听端口与系统代理

安装完成只代表客户端可运行，不代表已经具备可用的远端连接。v2rayN 管理节点与配置，具体连接由选定内核执行。VMess、VLESS 是协议名称；订阅链接用于取得节点列表，与本地 HTTP 或 SOCKS 入口不是同一个地址。

1. 添加订阅

   打开「订阅分组」→「订阅分组设置」，新增分组并填写可信的订阅地址。不同版本按钮位置可能变化，应以当前界面的分组管理入口为准。

2. 更新列表

   在「订阅分组」菜单执行更新操作。首次连接尚未建立时选择不经过代理的更新方式；若地址本身无法直连，需要先准备可用连接，不能靠重复点击解决。

3. 选定节点

   在节点列表选择一个节点并设为活动服务器。确认协议、传输参数与服务端要求一致，再查看日志中的内核启动结果。

4. 核对端口

   进入「设置」→「参数设置」，检查本地监听地址与端口。本文使用 127.0.0.1:10808 作为混合入口示例；若界面显示其他端口，后续测试全部替换为实际值。

5. 设置代理

   先做显式代理测试，再尝试客户端的「系统代理」→「自动配置系统代理」。Linux 上的生效范围取决于桌面环境与应用是否读取相应设置。

这些数字是配置示例，不是性能实测或所有版本的默认值。只有确认入口支持 HTTP 与 SOCKS 后，才使用两种方式测试。socks5h 让 curl 将目标域名交给代理端处理，可帮助区分本机域名解析和代理连接问题。

ss -ltnp 'sport = :10808'
curl --noproxy "" --proxy http://127.0.0.1:10808 \
  --max-time 15 --head https://example.com
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 \
  --max-time 15 --head https://example.com

桌面登录自启动：使用现有 desktop 入口

通常所说的“开机自启动”在这里是用户登录图形桌面后启动。它不等于系统启动时运行后台服务，也不会在登录画面阶段自动提供代理。先手动运行并验证一次，再建立自启动项，可以避免每次登录重复触发同一个配置错误。

优先复用安装包提供的 desktop 文件。它通常已经包含正确的 Exec 路径和必要参数，比猜测可执行文件位置更可靠。下面从标准应用目录查找候选入口；若找到多个文件，逐个检查后只选择实际属于本次安装的那个。

find /usr/share/applications "$HOME/.local/share/applications" \
  -maxdepth 1 -type f -iname '*v2rayn*.desktop' -print 2>/dev/null

read -r -p '输入已确认的 desktop 文件完整路径：' desktop_file
if [ -f "$desktop_file" ]; then
  grep -E '^(Type|Name|Exec|TryExec|Hidden|OnlyShowIn|NotShowIn)=' "$desktop_file"
fi

确认 Type=Application、Exec 指向已安装程序，并且没有阻止当前桌面启动的限制后，执行下面的复制操作。目标目录是当前用户的 XDG 自启动目录，命令不需要 sudo。若旧文件中存在 Hidden=true，需要先理解其禁用原因，不能直接照搬。

if [ -f "$desktop_file" ]; then
  autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
  mkdir -p "$autostart_dir"
  cp -- "$desktop_file" "$autostart_dir/v2rayN.desktop"
fi

• 注销并重新登录后，检查 v2rayN 是否启动、内核是否运行、本地端口是否监听。
• 如果客户端已开启内置自启动功能，不要再保留第二个同类入口，避免重复运行。
• 若登录后网络尚未就绪，客户端窗口出现并不意味着订阅更新或节点连接立即成功，应在网络就绪后检查日志。
• 停用本文建立的入口可执行 rm -- "${XDG_CONFIG_HOME:-$HOME/.config}/autostart/v2rayN.desktop"；此操作只移除自启动文件。

权限与系统代理：按症状排查

本地代理、桌面系统代理和 TUN 是不同层级。普通应用可以通过 HTTP 或 SOCKS 连接本地端口；桌面设置只是向愿意读取它的应用提供代理信息；TUN 则涉及虚拟网络设备、路由与额外权限。先验证本地代理，再扩大接管范围，排查路径会更短。

在 GNOME 桌面，可进入「设置」→「网络」→「网络代理」检查手动代理；HTTP、HTTPS 代理可以指向支持 HTTP 的本地入口，SOCKS 则指向支持 SOCKS 的入口。这里的 HTTPS 代理字段通常仍填写本地 HTTP 代理的主机和端口，不是要求本地入口额外提供 TLS。其他桌面环境使用自己的设置入口，不要直接照抄 GNOME 专属命令。

# 仅影响当前终端及其随后启动的子进程
export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808
export all_proxy=socks5h://127.0.0.1:10808

# 结束测试后清除本次设置
unset http_proxy https_proxy all_proxy