V2Ray 安装配置大全

快速上手适合跟着做完第一次连接。本页是系统查阅手册:先看通用准备,再跳到设备对应章节;已经装好客户端的读者,可以直接对照验证与排查章节。

v2rayN 桌面首选 v2rayNG 安卓首选 v2flyNG 安卓备选

通用准备:安装包、订阅与接管方式

先确认系统架构与客户端

桌面先选 v2rayN,安卓先选 v2rayNG。只有在配置提供方明确要求使用 V2Fly 内核,且已经确认协议、传输方式和安全层都受支持时,再考虑 v2flyNG。客户端是保存配置、发起连接和管理运行状态的界面;内核负责处理代理协议和路由。两个客户端能读入同一种分享格式,不代表它们都能运行该格式里的每一个选项。尤其不要把安卓客户端当成桌面客户端的同名移植版:两者的流量接管入口和应用范围不同。

打开客户端页面后,按当前系统和处理器架构选包。架构应从系统信息或设备已启用的应用架构中确认,不根据机器上市时间猜测。先保留原有客户端及配置备份,再测试新包。若旧客户端仍在后台运行,测试前从托盘或状态菜单退出,而不是只关闭窗口。两个实例可能争用同一个本地端口,也可能轮流写入系统代理设置。

系统客户端选包依据
Windowsv2rayN本站提供 x64 桌面版和经典 WPF 版入口
macOSv2rayNApple Silicon 选 arm64,Intel 选 x64
Linuxv2rayN先选 deb 或 rpm,再核对 x64 或 arm64
Androidv2rayNG、v2flyNG确认支持 arm64 后选对应包,架构不明时查看通用包

区分订阅地址、单条分享和备份

订阅地址是一份可重新获取的列表入口,通常保存到订阅分组,再执行更新;粘贴地址并保存只是登记来源,不等于列表已经下载。单条分享链接或二维码通常只导入一条配置,之后不会随原订阅自动更新。客户端备份则可能额外包含分组、路由和本地参数,主要用于同类客户端恢复,不是通用交换格式。跨设备时先复制必要的订阅或单条配置,再逐台确认接管方式;不把一个平台导出的完整备份直接覆盖到另一个平台。更多取舍见多设备配置同步方案。

订阅地址可能包含访问凭据。不要把地址贴到公开工单、在线解码工具或聊天截图里。需要排查时记录失败时间、报错类型和响应状态即可;分享日志前也应删去地址查询参数、账号标识和服务端信息。若更新返回的是登录页面或提示页面,核心问题通常是来源没有返回客户端可读的配置,不是把链接换个导入入口就能解决。

第一次配置只验证一条链路

导入后选中一条已知可用配置,保留默认路由,先验证本地代理是否能正常处理请求,再扩大接管范围。桌面的系统代理主要给读取系统设置的应用提供代理入口;TUN 则借助虚拟接口和路由处理选中的流量范围。安卓客户端常通过系统 VPN 接口取得应用流量,授权是启动链路的一部分。先分清哪个入口在工作,再测试业务应用;同时打开多种接管方式,结果可能正确,却很难知道是哪一层起了作用。

Windows:v2rayN 安装与系统代理

下载、安装与首次启动

到 Windows 下载入口选择桌面版或经典 WPF 版。桌面版使用跨平台界面框架,WPF 版是 Windows 专用界面。两者的窗口布局和设置入口不一定完全相同,选一个测试即可。打开系统设置的“系统 → 关于”,核对系统类型与处理器信息;不要将 x64 包当作所有 Windows 设备的原生安装包。已经在用 WPF 版且只想更新配置的人,也不必为了导入订阅更换界面版本。

安装程序按界面提示完成。如果拿到的是包含程序文件的压缩包,先完整解压到当前用户可读写的固定目录,再启动程序;不要直接在压缩预览里运行,也不要只复制一个可执行文件。首次启动若明确提示缺少运行时,按提示核对所需运行时类别和架构。界面能打开只说明图形程序已运行,不能证明内核已经启动。若选中配置后日志报找不到文件,先确认包内相关文件和目录结构完整,再检查当前使用的内核类型。

更新订阅并选定活动配置

在主窗口的“订阅分组”菜单打开“订阅分组设置”,新增分组,填写“备注”和“可选地址(url)”,确认该分组允许更新。首次验证不要填“过滤”,避免列表已经下载却被关键字筛空。保存后回到“订阅分组”,选择更新当前订阅而不通过代理的入口;若来源确实需要一个既有连接,再单独验证那个连接是否可用,避免新订阅依赖尚不存在的活动配置。多个来源的筛选方式见订阅分组与服务器过滤。

更新后确认列表显示的是新分组,不是旧分组或当前搜索结果。选中一条服务器并设置为活动服务器,检查客户端日志有没有配置解析、端口占用或启动失败提示。切换活动项后重开测试网页或新开连接;已经建立的长连接不一定随之切换。服务器列表里有一条记录,只证明导入成功,不能代替这一步。

先测系统代理,再决定是否用 TUN

用读取系统代理的浏览器测试时,从 v2rayN 的“系统代理”菜单选“自动配置系统代理”。“不改变系统代理”表示客户端不主动改写系统设置,并不等同于把已有代理关掉;需要撤下 v2rayN 写入的代理时,使用“清除系统代理”,然后到 Windows 的“网络和 Internet → 代理”复查。原先使用了手动代理或脚本的设备,清除后可能需要按先前记录恢复,而不是假设系统能自动还原。

若浏览器可用、某个桌面应用仍直连,先看该应用有无自己的代理设置。只有需要接管不读系统设置的程序时,再测试 v2rayN 的“启用 TUN”入口;切换前先撤下本轮设置的系统代理,减少重复接管。TUN 需要创建虚拟接口并修改路由,按客户端或系统提示处理相应授权,不要为了测试长期以管理员权限运行所有程序。启用后若局域网访问也变化,先关闭 TUN 恢复原路径,再判断是否需要针对性的路由调整。

处理托盘残留、端口冲突和退出断网

关闭窗口后仍显示端口被占用时,检查托盘有没有旧实例,也检查是否启动了另一份相同客户端。先确认占用者,再决定退出旧实例还是在客户端中改用不同端口。改端口之后,手动配置过的浏览器、开发工具或终端也要同步,系统代理则应在新端口生效后重新应用。若退出后浏览器失败,但关闭系统代理即恢复,通常是系统仍指向已停止监听的本地端口;若只有某一个应用失败,还要看该应用有没有独立保存代理地址。

macOS:芯片选包、网络服务与授权

选择磁盘映像并启动应用

从苹果菜单打开“关于本机”;显示 Apple 芯片的设备到 macOS 下载入口选 arm64,显示 Intel 处理器的设备选 x64。已经装了兼容层并不意味着应该优先安装另一种架构。桌面程序能打开,随包内核运行时也仍有自己的架构要求。更换安装包时先退出运行中的应用,再替换;不要同时从旧目录和新目录启动两份 v2rayN。

打开磁盘映像,按其中提示将应用复制到“应用程序”,再从目标目录打开,最后推出映像。这样启动位置固定,后续也容易分辨正在运行的是哪一份。若系统弹出安全提示,先核对应用来源与芯片架构,区分正常的首次确认、组织策略阻止和文件无法运行;不要关闭全局安全机制处理单个应用。窗口显示为空或启动后立刻退出时,先分辨应用本体有没有运行,再去看连接配置,避免把启动问题误记成订阅不可用。

在 v2rayN 中登记并更新订阅

打开主窗口的“订阅分组设置”,新增备注,在“可选地址(url)”填入来源提供的完整地址。保存后执行订阅更新,再切到相应分组查看结果。如果收到的内容只是单条分享,使用从剪贴板导入分享链接的入口,不要把分享文本填到订阅地址栏。粘贴后若报地址错误,先检查是否把说明文字、换行或引号一并复制进来,而不是删掉看不懂的查询参数。

拿到列表后选定活动服务器,确认日志中没有明显的内核启动错误。迁移自 Windows 的读者可以复用订阅地址,但不宜照搬系统代理状态或引用本机文件的路径。即使两台设备使用同一个订阅,它们的活动服务器、路由分组、局域网访问需求也可能不同。先让一条配置可用,再逐项恢复额外设置,便于找出是导入内容还是本机参数导致差异。

核对当前网络服务的代理状态

先在 v2rayN 中使用“自动配置系统代理”,然后到“系统设置 → 网络”,选择当前连接的网络服务,在“详细信息 → 代理”核对启用项目和本地地址。代理设置跟随具体网络服务;无线与有线连接来回切换时,先确认真正承担流量的是哪个服务。浏览器能访问并不等于终端也会走系统代理,有些命令行程序只看自己的参数或环境变量。不要因为终端测试和浏览器不同,就立刻把浏览器结果判成无效。

设备原来使用自动代理配置文件时,先记录它的启用状态。测试结束后撤下本轮变更并恢复原状态,不要让两套自动配置长时间并存。若客户端要求授权才能写入系统代理,核实提示确实来自本次操作;受管理设备不允许修改时,保留现状,改用应用自身支持的本地代理测试。用本地入口测试成功,只能证明客户端路径可用,不代表系统级配置权限已经具备。

单独验证 TUN 与网络切换

确实需要接管不读取系统代理的应用时,再查看当前 v2rayN 构建和所选内核是否提供 TUN,按提示完成必要授权。界面开关亮起与虚拟接口成功接管是两件事;要结合客户端日志和新建连接判断。如果开启后内部域名或局域网服务失效,先关闭 TUN,并在相同网络上验证原路径。机器从休眠恢复或换到另一网络后出现问题,也先查活动网络服务和客户端运行状态。只在切换后发生的故障,通常不必先重新导入同一份订阅。

Linux:发行版选包、桌面代理与路由

按包管理体系和架构选择

打开 Linux 下载入口。Debian、Ubuntu 等使用 deb;Fedora 等使用 rpm。包格式匹配只是第一步,发行版仍需具备软件包声明的依赖和可用的图形会话。不要把桌面客户端当成无图形环境下直接运行的服务,也不要因为另一种包恰好能解包,就尝试把它装进不同的包管理体系。

用下面两条只读命令查看机器架构和发行版标识。常见输出 x86_64 对应下载页的 x64,aarch64 对应 arm64。若在容器或远程终端里运行命令,先确认查的是实际要安装桌面客户端的系统,而不是另一个运行环境。

uname -m
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release

下载后可用发行版的软件安装界面打开包。也可以在终端中输入 sudo apt install 或 sudo dnf install ,再接上已下载文件的绝对路径;路径有空格时用引号包住整段路径。让包管理器解析依赖,遇到冲突先看具体包名,不要强制忽略。安装完成后从应用启动器以普通用户打开 v2rayN。整套图形程序用管理员身份启动会改变配置归属,之后普通用户可能读不到刚才保存的分组或设置。

更新订阅并建立本地监听基线

在“订阅分组设置”登记备注和订阅地址,保存后更新对应分组。更新有结果却看不见记录时,先清除主窗口搜索词,再检查分组过滤条件。选定活动服务器后,确认内核启动成功;如果日志显示启动失败,应先解决缺依赖、文件架构不符或端口占用等本地问题。此时反复更新订阅不会让本地监听建立起来。

可以用 ss -ltn 查看当前 TCP 监听地址和端口,再与 v2rayN 设置中的本地监听值比较。有监听只说明某个程序占住了这个端口,不说明该程序就是 v2rayN,更不能证明远端连接已经建立。若在未运行客户端时已看到同样的监听,先查是否另有代理程序,不要直接结束不认识的进程。也不需要为了让同一台机器上的应用接入,把本地监听改到所有网络接口。

桌面系统代理、终端参数和 TUN 分开测

先试 v2rayN 的“自动配置系统代理”,再检查桌面环境的网络代理页面。GNOME、KDE 等环境的入口与支持范围并不一致,部分应用只读自身设置。一个终端窗口设置过代理环境变量,不等于桌面应用也继承它;反过来,图形设置变更也不保证已启动的命令行程序重新读取。判断差异时,用同一目标分别测试显式代理和桌面应用,不用一种结果推断所有程序。

需要 TUN 时,先从客户端日志确认所选内核具备该模式,系统也提供虚拟网络设备并允许相应路由操作。下面的只读检查可以辅助区分“设备路径不存在”和“设备存在但应用未获授权”。输出正常不代表权限已满足。若在容器或受管机器中,权限还可能受外层环境限制,应由管理者按用途授权,不以放宽设备全局权限作为通用处理。

ls -l /dev/net/tun
ip route show default

避免修改路由后失去管理连接

在远程桌面或远程终端里打开 TUN 前,先确认有本机控制台或其他恢复手段。默认路由未变也不代表流量没有改道,因为还可能存在策略路由。若只想验证安装是否成功,显式本地代理已足以提供证据,不必先改全局网络。切回非 TUN 模式后,检查桌面代理是否仍指向有效端口,再继续对比。在切换无线网络或从休眠恢复后才出现异常时,优先看接管状态,而不是重新安装软件包。

Android:安装包、订阅与 VPN 接管

选客户端和应用架构

到 Android 下载入口首选 v2rayNG;确实需要 V2Fly 内核且配置兼容时,再选 v2flyNG。每款都有 arm64 和通用版入口。处理器名称里有“64 位”不等于系统运行环境一定支持 arm64 应用,判断时优先看设备系统所支持的应用架构。已经确认支持 arm64 就选对应包,拿不准时先看通用包,但通用包也不能弥补系统版本不符合要求的问题。

打开下载文件后,系统可能要求为当前打开文件的浏览器或文件管理器授予安装权限。这项权限针对安装来源,不是连接授权;只在确有需要时临时使用,安装完成后可撤回。若提示与已有应用冲突,不要立即卸载。先判断是尝试覆盖不同签名的同名应用,还是设备上已有一个工作资料中的安装。卸载可能清除本地分组和路由,先在可信位置备份,再决定是否迁移。

添加订阅与导入单条配置

在 v2rayNG 中打开侧边菜单的“订阅分组设置”,新增分组、填写备注和地址,保存后回到服务器列表,从右上角菜单执行更新订阅。使用 v2flyNG 时也应先区分侧栏中的订阅设置和列表上的更新动作;不同界面中的菜单措辞可能有所差别。收到分享链接时走主界面添加菜单里的剪贴板导入入口;收到二维码时使用扫描入口,摄像头授权只在需要扫码时授予。

更新后切到相应分组,检查是否有记录,再点选活动服务器。手机上复制时很容易把一段说明与地址一起选中;更新失败时先从来源重新复制完整地址,并清掉前后空白,不手动拆改参数。如果只使用单条分享,换机前需要重新保留该分享或做支持的备份,不能指望订阅更新找回本来就不属于订阅的条目。

启动连接并确认应用范围

点主界面的连接按钮,首次使用 VPN 模式时接受系统的连接请求,再观察客户端运行状态和系统 VPN 标识。这里使用的是 Android 的 VPN 接口来取得设备流量,不需要照搬桌面上的“自动配置系统代理”菜单。若系统已经启用另一款 VPN,先分辨是否是工作资料、受管理连接或常开 VPN;未确认用途前不替换它。系统图标存在只表示接口已建立,仍要用新的请求验证实际链路。

如果在 v2rayNG 中启用了“分应用代理”,还要检查测试应用是否在所选范围内,并确认列表是包含还是排除的含义。勾选了一个应用不一定代表该应用会接管,取决于当前列表模式。使用浏览器验证而浏览器恰好被排除时,结果不能代表全部应用。更改范围后按客户端提示重新连接,再用目标应用发起新请求,不要只观察原本已经建立的会话。

区分锁屏断开、网络切换和系统阻断

应用在前台可用、锁屏后断开时,先检查系统的应用电池管理、后台限制和 VPN 状态。只调整发生问题的应用,不需要关闭整台设备的节电策略。无线网络正常、移动数据失败时,先查移动数据权限和客户端日志,再用同一活动服务器做对照。若断开 VPN 后全机仍无法联网,检查系统 VPN 设置里的常开项和无 VPN 时阻止连接的策略;受管理设备上的条目应交由管理者确认。不要把这些系统级限制与订阅失效混为一谈。

连接验证:按层定位请求在哪一步失败

先保留不经过客户端的对照

连接前,选择一个有权限访问且平时稳定的 HTTPS 页面,记录在当前网络上能否新开连接。网络需要先完成登录时,先用系统的登录页面完成,再启用客户端。测试时尽量保持同一网络、同一地址和同一应用,避免同时更换服务器、协议和代理模式。直连也失败时,先解决基础网络问题;否则无法判断后续差异是来自客户端,还是测试目标本来就不可达。

接着选中活动服务器,观察日志,检查本地监听或安卓 VPN 状态。把结果分成三层:客户端有没有拿到配置、内核有没有开始工作、请求有没有经过预期入口。列表有条目解决的是第一层,绿色开关或系统图标主要描述第二层。第三层要用新连接和对应日志确认。浏览器可能复用旧连接,也可能直接使用缓存,所以不要只看已经打开的标签页能不能显示。

桌面用显式代理做一次可重复的测试

下面的命令适用于已安装 curl、且客户端确实在回环地址的 10808 端口提供 SOCKS 服务的桌面设备。先在 v2rayN 设置或日志中核对协议、地址和端口;如果监听值不同,把命令里的值换成实际设置。Windows 可显式使用 curl.exe,避免某些命令环境将短名称解释为其他工具。示例请求公开示例站点,不带账号信息,也不需要打开系统代理。

curl --max-time 15 --socks5-hostname 127.0.0.1:10808 --head https://example.com/

--socks5-hostname 将目标域名交给 SOCKS 服务处理,与先由 curl 本地解析再发请求不同。它可以用来验证显式代理链路,但不能推断浏览器的 DNS 路径,更不能推断所有应用已被接管。若报无法连接到本地端口,先核对监听地址和协议;若已经连到本地监听,随后才超时,结合该次请求附近的日志检查出站、解析和远端握手。收到 HTTP 响应则说明本次请求达到了某个可响应的服务,某些状态码仍可能表示目标拒绝访问,不宜一概记成网络失败。

分开检查流量入口、路由和解析

显式测试成功但浏览器不通时,优先复查浏览器是否读取系统代理,是否有覆盖它的独立设置。如果只在 TUN 中失败,检查 TUN 启动日志及具体受影响的应用,再对照局域网和网络切换场景。遇到按域名分流不符预期时,先确认该请求是否被客户端接管,再看域名规则及规则顺序。入口未接管时,改几十条路由规则也不会影响请求。

同一域名可以解析到多个地址,域名规则和 IP 规则也不是同一层。应用先自行解析并把 IP 交给客户端时,不一定能直接匹配期望的域名规则;直接输入 IP 又可能因为 HTTPS 证书或虚拟主机配置而失败,不能简单当作 DNS 故障的反证。在日志能看到规则或出站信息时,优先以实际命中为依据。需要核对规则库时参阅 GeoIP 与 GeoSite 规则库更新方法,不要在同一轮对照中既换库又换路由顺序。

配置常见问题:从症状找下一项检查

更新失败、更新成功但列表为空

更新请求失败时,先确认测试的是哪个分组,以及本次请求是否选择通过已有代理。第一次导入最常见的误判,是通过一条还不能连接的代理拉取新配置。把更新结果拆成请求能否发出、来源是否返回内容、内容能否被客户端读入。超时先查网络路径;明确拒绝访问时向来源确认授权和入口;返回内容不可读时,核对它是兼容订阅、登录页面还是其他类型的配置文件。不要把订阅原文贴到非必要的第三方服务进行判断。

成功提示后没有看到条目,先切到对应分组并清除搜索,再暂时取消分组内的关键字过滤重新更新。若其他分组仍有条目,不必清空全部配置。删除和重建前考虑是否有本地编辑过的记录,以及更新后客户端是否会替换旧条目。若只是一条分享格式不兼容,单独测试该条,不用把所有来源混到同一个分组。更多界面问答见 FAQ。

有列表,但活动配置一启动就报错

先复查是否设置了活动服务器,再阅读最早一条有实质内容的报错。地址、协议、传输和安全层必须彼此匹配。比如导入后界面保留了服务端地址,但未正确识别传输参数,列表看起来正常,启动或握手时仍可能失败。若错误指向不支持的配置字段或协议,核对实际使用的内核,再向配置来源索取兼容内容。不要把 TLS 验证关闭作为排查握手的通用步骤;先检查系统时间、连接地址和服务端名称等应当一致的参数。

如果报的是端口占用、文件路径不存在、权限不足或架构错误,先修复本地环境。这些问题发生在连到服务端之前,反复换列表里的服务器没有帮助。本地内核可以启动,但只有一条配置反复握手失败时,再在同一网络下用另一条已知可用配置对照。若两条都失败,再回头验证公共的入口和路由,不把所有症状都归到单条配置上。

浏览器正常,其他应用不通,或者退出后断网

不同应用不一定共享同一入口。桌面优先查应用独立代理、系统代理和终端环境变量;安卓查分应用范围和系统 VPN 状态。部分应用禁止在代理环境中运行,也有应用必须访问特定内网资源,这时强制扩大接管范围未必合适。若关闭客户端后只有桌面浏览器断网,先检查系统或浏览器是否仍指向本地代理。若安卓断开后全部应用受影响,则另查系统配置是否阻止无 VPN 连接。

恢复时按变更的逆序处理:先停用本轮开启的 TUN 或断开 VPN,再复查本轮写入的系统代理和应用独立设置,最后重新验证基础网络。不清空组织下发的代理或 VPN 策略,不把重装当成第一选择。重装可以替换程序文件,却未必清掉系统代理、已有配置目录或设备管理策略。只有明确定位到安装文件损坏、架构错误或更新冲突,重新安装才是针对性的处理。

把排查结果留下来,而不是只记“连不上”

记录系统和架构、客户端名称、接管模式、是否选定活动项,以及失败发生在更新、启动还是新建连接阶段。加上一组对照最有用,例如同一网络下显式代理成功而系统代理失败,或切换网络后才失效。日志只留复现时间附近的必要片段,删去订阅地址和账户信息。需要从头重做时,回到快速上手,只恢复导入、选择、接管、验证这条主线;验证通过后再按本页对应平台小节恢复额外设置。