Ubuntu 和 Debian 选 deb,Fedora 选 rpm,安装时才需要管理员权限。首次运行用当前桌面账号,先确认本地代理能用,再开启系统代理和登录自启动。下文给出安装命令、端口检查方法,以及应用菜单能启动但登录后不启动时的排查步骤。
Linux 安装包选择:发行版与 CPU 架构
先确定发行版,再确定架构。终端运行下面两条命令:第一条查看发行版及版本,第二条查看机器架构。Ubuntu 和 Debian 的包元数据通常把 x86_64 写作 amd64,把 aarch64 写作 arm64;Fedora 的包元数据通常使用 x86_64 和 aarch64。下载页上的 x64 指的是第一组。
cat /etc/os-release
uname -m
Debian 系安装包
- 桌面发行版
- Ubuntu、Debian
- 文件扩展名
.deb- 包架构字段
amd64或arm64- 安装工具
apt
用 apt 安装本地包,让它同时处理软件源中可用的依赖。
Fedora 安装包
- 桌面发行版
- Fedora
- 文件扩展名
.rpm- 包架构字段
x86_64或aarch64- 安装工具
dnf
同为 rpm 格式不代表依赖相同;其他发行版要单独确认包的兼容性。
如果报错明确指出架构不匹配,回到下载页换包,不要强制安装。如果架构匹配但提示缺少某个库,记下第一条无法满足的依赖及其版本,再检查当前发行版的软件源和版本;不要从另一种发行版单独搬入一个同名库。
deb 与 rpm 安装命令
下面两段只运行与你的发行版对应的一段。看到输入提示后,粘贴刚下载的安装包绝对路径,不要给输入额外加引号。安装命令里的双引号会保留路径中的空格。先看包元数据,确认名称、版本、架构,再运行带 sudo 的安装命令。
Ubuntu、Debian:用 apt 安装 deb
printf '输入 deb 安装包的绝对路径:'
IFS= read -r pkg
dpkg-deb -f "$pkg" Package Version Architecture
sudo apt install "$pkg"
如果终端提示依赖下载失败,先确认系统在代理关闭时能访问自己的软件源,再执行 sudo apt update 并重试。若安装计划列出要移除现有桌面组件,先取消,检查是否混用了不同发行版或不同版本的软件源。
Fedora:用 dnf 安装 rpm
printf '输入 rpm 安装包的绝对路径:'
IFS= read -r pkg
rpm -qp --queryformat '%{NAME} %{VERSION}-%{RELEASE} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
安装结束后,在桌面应用菜单搜索「v2rayN」。终端显示包已安装,只能说明部署完成,不代表图形界面和内核已经运行。若菜单没有入口,记下上面查到的包名:Ubuntu、Debian 可用 dpkg -L 后接包名,Fedora 可用 rpm -ql 后接包名,查看软件包提供的 .desktop 文件和安装路径。
首次启动权限与系统代理验证
先用普通桌面账号启动 v2rayN,暂不开启 TUN,也不要用 sudo 打开界面。安装软件需要管理员权限,读写个人配置和运行本地代理通常不需要。若启动日志出现 Permission denied,先看报错指向的是用户配置文件还是内核程序路径,不要给整个安装目录递归放开权限。
选择当前节点
已有配置时,在主界面的节点列表中选中节点,右键选择「设为活动服务器」;如果是新装且列表为空,先到「订阅分组」添加订阅并更新。再看主界面日志,确认内核没有启动错误。
核对监听端口
打开「设置」→「参数设置」,查看「本地监听端口」及本地入站设置。不同版本的字段名称可能略有差异;用界面中的实际端口,不要把节点服务器的远端端口填给本机应用。
验证本地代理
先让终端请求显式经过本地代理,区分内核连通问题和桌面代理设置问题。下面的命令以混合入站端口
10808为例;如果版本将 HTTP 和 SOCKS 分开,按入站协议和实际端口调整。设置系统代理
在 v2rayN 主界面底部或托盘打开「系统代理」,选择「自动配置系统代理」。GNOME 可在「设置」→「网络」→「网络代理」核对写入结果;若桌面设置没有变化,先让目标应用使用自己的代理入口,不必反复重启内核。
ss -ltn 'sport = :10808'
curl --max-time 15 -I --proxy socks5h://127.0.0.1:10808 https://example.com/
第一条命令只确认本地 TCP 端口有没有监听;第二条收到目标站点的 HTTP 响应头,才说明这次请求经过指定代理完成了访问。若立即提示连接本地端口失败,先查端口和内核日志;若端口在监听而请求超时,再查当前节点、网络和路由。浏览器能用但终端不能用时,不要据此判断安装失败:不少终端程序不会读取桌面的代理设置,可按应用单独指定代理。
开机自启动:登录桌面后运行 v2rayN
桌面版的自启动通常指登录图形会话后启动,不是在登录界面出现前就运行。先确认应用菜单可以正常打开 v2rayN,再在下面两种方式中选一种。重复配置会让同一次登录发起多次启动,也会让停用和排错变得不直观。
桌面会话的自启动设置
推荐KDE Plasma 打开「系统设置」,搜索「自动启动」,进入后选择「添加」→「添加应用程序」,从列表选 v2rayN。若 Ubuntu 应用菜单提供「启动应用程序(Startup Applications)」,可在其中选择「添加」,填写已验证能启动的实际程序命令。菜单名称可能随桌面版本变化。
适合:桌面已提供自启动管理,希望直接在图形界面启停。
用户级 XDG 自启动条目
从已安装包的文件列表中找到应用菜单对应的 .desktop 文件,把它复制到当前用户的自启动目录。保留原来的 Exec= 启动命令,比照着其他机器的安装路径手写更稳妥。
适合:桌面遵循 XDG 自启动规范,但未提供方便的图形入口。
用文件方式时,在终端运行下方命令,按提示输入已确认的 .desktop 文件绝对路径。不要加 sudo。未自定义 XDG_CONFIG_HOME 时,自启动目录就是 ~/.config/autostart。
printf '输入已安装的 .desktop 文件绝对路径:'
IFS= read -r desktop_file
autostart_dir="${XDG_CONFIG_HOME:-$HOME/.config}/autostart"
mkdir -p "$autostart_dir"
cp -i -- "$desktop_file" "$autostart_dir/"
注销并重新登录,不要先手动打开 v2rayN。等桌面加载完成后,查看托盘、窗口或本地监听端口。窗口出现但网页没走代理时,应重新核对系统代理的状态:启动程序与写入代理设置是两件事。要撤销文件方式的自启动,只移走当前用户自启动目录里的那份副本,应用菜单入口仍会保留。
Linux 安装与自启动常见问题
装好了,点菜单却没反应?
先看包内 .desktop 的 Exec= 指向什么;也可用 command -v v2rayN 检查该名称是否在搜索路径里。若不在,就以软件包文件列表为准找到实际可执行文件,再用普通账号从终端运行并读取报错。若提示找不到共享库,按库名和发行版版本排查依赖,而不是用管理员权限重开。
手动能开,重新登录却没启动?
先核实登录的是当初添加自启动项的账号,然后打开用户目录里的那份 .desktop 文件,检查是否有 Hidden=true、OnlyShowIn 或 NotShowIn 限制。若刚升级过包,对照应用菜单当前使用的文件,看副本的 Exec= 是否仍指向原来的位置。
日志提示端口已被占用怎么办?
用 ss -ltnp 'sport = :10808' 检查示例端口,实际端口不同就替换数字。先退出重复打开的 v2rayN;若端口由其他正常运行的程序占用,就在「设置」→「参数设置」调整本地监听端口,并同步修改手工配置过的浏览器或终端代理。
退出软件后,浏览器还是打不开网页?
若曾开启自动配置,退出前可在「系统代理」选择「清除系统代理」。如果已经退出,在桌面的网络代理设置里恢复启用前的选项;手工给浏览器指定过代理的,还要恢复浏览器自己的设置。否则应用可能继续连接已经停止监听的本地端口。