Improve markdown formatting

https://github.com/2dust/v2rayN/issues/7377
2dust 2025-06-02 16:12:39 +08:00
parent 34d2d25675
commit aea8f57554
7 changed files with 105 additions and 115 deletions

@ -6,35 +6,35 @@ JSON 数据如下
```json
{
"v": "2",
"ps": " 备注或别名 ",
"add": "111.111.111.111",
"port": "32000",
"id": "1386f85e-657b-4d6e-9d56-78badb75e1fd",
"aid": "100",
"scy": "zero",
"net": "tcp",
"type": "none",
"host": "www.bbb.com",
"path": "/",
"tls": "tls",
"sni": "www.ccc.com",
"alpn": "h2",
"fp": "chrome"
"v": "2",
"ps": " 备注或别名 ",
"add": "111.111.111.111",
"port": "32000",
"id": "1386f85e-657b-4d6e-9d56-78badb75e1fd",
"aid": "100",
"scy": "zero",
"net": "tcp",
"type": "none",
"host": "www.bbb.com",
"path": "/",
"tls": "tls",
"sni": "www.ccc.com",
"alpn": "h2",
"fp": "chrome"
}
```
### 属性详细说明
* v: 配置文件版本号,主要用来识别当前配置
* ps: 备注或别名
* add: 地址IP或域名
* port: 端口号
* id: UUID
* v: 配置文件版本号,主要用来识别当前配置
* ps: 备注或别名
* add: 地址IP或域名
* port: 端口号
* id: UUID
* aid: alterId
* scy: 加密方式(security),没有时值默认auto
* net: 传输协议(tcp\kcp\ws\h2\quic)
* type: 伪装类型(none\http\srtp\utp\wechat-video) *tcp or kcp or QUIC
* host: 伪装的域名
* net: 传输协议(tcp\kcp\ws\h2\quic)
* type: 伪装类型(none\http\srtp\utp\wechat-video) *tcp or kcp or QUIC
* host: 伪装的域名
1. http(tcp)->host中间逗号(,)隔开
2. ws->host
@ -42,13 +42,12 @@ JSON 数据如下
4. QUIC->securty
* path: path
1. ws->path
1. h2->path
2. QUIC->key/Kcp->seed
3. grpc->serviceName
1. ws->path
2. h2->path
3. QUIC->key/Kcp->seed
4. grpc->serviceName
* tls: 传输层安全(tls)
* sni: serverName
* alpn: `h2,http/1.1`
* fp: fingerprint

@ -17,6 +17,6 @@
### 通用提示
* 支持`Xray-core`和`sing-box-core`
* 订阅分组中的节点使用`Xray-core`时,前置代理和落地代理不支持`Hy2TUICWireGuard`
* 订阅分组中的节点使用`Xray-core`时,前置代理和落地代理不支持`Hysteria 2TUICWireGuard`
* 代理别名不存在时,产生配置时将会跳过此功能,且运行时不会提示用户
* 代理别名将在所有的配置文件中搜索,所以可单独建立一个分组存放前置代理和落地代理的配置,防止误删

@ -2,24 +2,22 @@
此文档只介绍说明比较复杂的功能和其内部的逻辑,那些只看文字就能明白的功能就省略了。
### 从剪贴板导入分享链接 (Ctrl+V)
在非输入框区域可使用快捷键 Ctrl+V 触发。读取系统剪贴板中的内容;支持明文和 BASE64 编码的内容,会先后用 BASE64 编码和明文解析。
解析逻辑:
1. 检查是否 https 开头,如果是则按新增订阅逻辑处理,否继续往下
1. 检查是否 v2rayN 的分享内容,如果是则按新增混合配置逻辑处理,否继续往下
1. 检查是否 SIP008 的分享内容,如果是则按新增 Shadowsocks 配置逻辑处理,否继续往下
1. 检查是否 sing-box 或 v2ray 的多个自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
1. 检查是否 sing-box 或 v2ray 的单个自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
1. 检查是否 Clash 或 Hysteria 的自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
1. 如果无法解析成功,则会生成一个无 Core 类型的自定义配置,需要用户编辑
2. 检查是否 v2rayN 的分享内容,如果是则按新增混合配置逻辑处理,否继续往下
3. 检查是否 SIP008 的分享内容,如果是则按新增 Shadowsocks 配置逻辑处理,否继续往下
4. 检查是否 sing-box 或 v2ray 的多个自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
5. 检查是否 sing-box 或 v2ray 的单个自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
6. 检查是否 Clash 或 Hysteria 的自定义配置,如果是则按新增自定义配置逻辑处理,否继续往下
7. 如果无法解析成功,则会生成一个无 Core 类型的自定义配置,需要用户编辑
### 添加自定义配置配置文件
> Socks 端口
> Socks 端口
因为自定义配置支持很多 Core 类型v2rayN 无法解析当前配置中哪个值是本地监听Socks端口所以需要你手工填写Socks端口值。
当设置此值后,将使用 Xray 或 sing-box(Tun) 额外启动一个前置服务,提供分流和速度显示等功能。
@ -30,39 +28,39 @@
### 订阅分组新增或编辑
> 可选地址和更多地址
> 可选地址和更多地址
如果你想每个订阅地址都更新在独立的分组下,那只需要填写可选地址即可。
如果你想很多个订阅地址更新在一个分组下,那填写可选地址后剩下的订阅地址全部填入更多地址中,用逗号隔开。
当更多地址中有数据时,后面的订阅转换将失效;地址中的订阅类型要一致,因为更新时将依次下载每个订阅的内容然后合并在一起解析。
> 别名正则过滤
> 别名正则过滤
在更新订阅解析后,检查每个配置的别名是否符合正则表达式,符合的保留。
如果你想设置排除规则,请学习下正则表达式。
目前只实现了 v2rayN 订阅内容的过滤。
> 订阅转换目标类型
> 订阅转换目标类型
如果设置了,则在更新订阅时,会调用订阅转换服务获得转换后的内容,然后解析。
> User Agent
> User Agent
很多提供订阅的后台服务会根据 v2rayN 获取订阅内容时发送 User Agent 数据值来决定返回的内容v2rayN 正常发送的值是 `v2rayN/版本号`
你可以填写一些特定的 User Agent 来达到你想要内容的目的,具体的你可以在网上搜索各个订阅的后台服务支持的 User Agent 。
> 前置代理别名和落地代理别名
> 前置代理别名和落地代理别名
[前置代理和落地代理说明](Description-of-proxy-chain.md)
> 自定义配置的Socks端口
> 自定义配置的Socks端口
当设置此值后,更新订阅时,如果订阅内容解析后是自定义配置,则会把此值填入 Socks 端口项中。
### 更新订阅
> 不通过代理或通过代理更新订阅
> 不通过代理或通过代理更新订阅
更新订阅的逻辑:
@ -74,107 +72,104 @@
6. 如果本分组已经产生流量数据,则处理流量数据
7. 延迟和速度数据将被清空
### 基础设置
> 本地混合监听端口
> 本地混合监听端口
* 同时监听 socks5 和 http的端口值
* 第二个本地监听端口值 = 本地混合监听端口值 +1
* 新的局域网端口值 = 本地混合监听端口值 +2
* 第二个本地监听端口值 = 本地混合监听端口值 +1
* 新的局域网端口值 = 本地混合监听端口值 +2
* Pac端口值 = 本地混合监听端口值 +3
* Xray API 端口值 = 本地混合监听端口值 +4
* mihomo API 端口值 = 本地混合监听端口值 +5
* 测试时产生的临时配置中使用的端口值 = 本地混合监听端口值 +21
> 开启 Mux 多路复用
> 开启 Mux 多路复用
开启后,只有 VMess 和 VLESS 协议能使用,如果你想设置更多参数请看 [未做界面设置的参数说明](Description-of-some-parameters)。
sing-box 需要再选择多路复用协议才能正常生效。
> 启用日志存到文件
> 启用日志存到文件
启用后核心产生的日志会存储到 guiLogs 文件夹中,不启用时直接显示在主界面信息栏中。
> 默认跳过证书验证
> 默认跳过证书验证
当导入分享链接和更新订阅时,配置文件中默认值从此设置获取。
如果你想修改订阅中所有的跳过证书验证值,比较方便的做法就是删除组中所有配置,设置默认跳过证书验证,重新更新订阅。
> 启用分片
> 启用分片
分片功能只有 Xray 支持,所以 Tun 模式不支持。分片的实现类似代理链,所以开启后,前置代理和落地代理就会失效。
### v2rayN 设置
> 开机启动
> 开机启动
以管理员权限设置此项,在启动后获得管理员权限,主要作用就是可以启动 Tun 模式。如果不需要开机就启动 Tun则随意。
> 自动更新 Geo 文件的间隔(小时)
> 自动更新 Geo 文件的间隔(小时)
如果你不需要自动更新 Geo 文件,则设置为 0。
> 托盘右键菜单配置文件展示数量限制
> 托盘右键菜单配置文件展示数量限制
Windows 版本的托盘菜单可以切换配置文件,当你的分组中配置文件数量超过了设置值时,切换配置文件选项将会隐藏。
> 测试时自动分批的每批数量最大1000
> 测试时自动分批的每批数量最大1000
由于各种原因,现在测延迟和测速都会分批次进行,这样可以提高成功率和降低资源占用。如果你不设置则默认为 1000 。
### 代理配置设置
> 例外:对于下列地址不使用代理配置文件。使用逗号(,)分隔。
> 例外:对于下列地址不使用代理配置文件。使用逗号(,)分隔。
Windows Linux macOS 的系统代理设置都有一个选项叫`例外`或`忽略`的,意思是这个选项中的目标地址请求不走系统代理。 此选项有默认值,你可以自己按需修改。
注意,此选项不能为空,为空时 v2rayN 会自动填充默认值。
> 高级代理设置,协议选择(可选)
> 高级代理设置,协议选择(可选)
Windows 部分用户有些比较特殊的应用需要设置系统代理的协议,请按需选择。普通用户请不要设置此选项,以免出现奇怪的问题。
### Tun 模式设置
> 启用额外监听端口
> 启用额外监听端口
普通使用时,流量应该从 Tun 入口进入,所以在产生的配置文件中不存在其他入口。有部分用户需要同时存在 Mixed 入口,这时才需要开启此选项。
### Core 类型设置
在启动 Core 时,先判断当前配置文件配置中的 Core 类型前面为空时检查Core 类型设置中的 Core 类型。
### 路由设置
> 一键导入规则集
> 一键导入规则集
如果你是初次使用,其实 v2rayN 在初始时已经生成了默认的规则集了,这个时候你不需要使用此功能。
当你已经使用了一段时间后且开发者有在发布中有提醒修改了默认的规则集时,你可以选择使用此功能。此功能不会删除和修改你原来的规则集,只会新增默认的规则集。
> 域名解析策略
> 域名解析策略
此选项和规则集是强关联的,初始值和初始规则集是适合普通用户使用的,在修改之前请仔细阅读官方文档。
> 域名匹配算法
> 域名匹配算法
此选项默认是空,意思是让核心自己选择默认算法。
> 导入规则
> 导入规则
1. 从文件中导入规则
2. 从剪贴板中导入规则
3. 从订阅URL中导入规则需要填写下方的可选地址
> 自定义图标
> 自定义图标
当在 Windows 版本中选择 PNG 图片后,系统托盘的图标会跟随用户选择的路由规则而改变,非 Windows 版本无此功能。此时系统代理的托盘图标不起作用。
> 自定义 sing-box rule set
> 自定义 sing-box rule set
此项目就可以由用户自己设置 sing-box rule set 的来源,可以是本地和远程混合,非常的灵活。设置文件是 JSON 格式,参考 https://github.com/2dust/v2rayCustomRoutingList/blob/master/singbox_custom_ruleset_example.json
@ -185,11 +180,11 @@ sing-box rule set 文件来源逻辑:
3. 检查 v2rayN 设置中 sing-box ruleset文件来源可选非中国区是否存在不存在继续
4. 检查 v2rayN 默认的来源 https://github.com/2dust/sing-box-rules
> 规则列表
> 规则列表
路由的匹配是按照规则的先后顺序作用的,一旦匹配到前面的规则,后面的就不起作用了。所以当你新添加了规则,请记得调整规则先后顺序。具体的请查看官方文档。
> 路由规则详情设置
> 路由规则详情设置
规则使用以下匹配逻辑:(Domain 或 IP 或 进程名) 与 Port 与 Protocol 与 InboundTag 与 network => OutboundTag
每条规则中的 Domain 或 IP 或 进程名三项目请只填写一项即使你在一条规则中全填了v2rayN 也会自动拆成多条规则。
@ -199,19 +194,18 @@ sing-box rule set 文件来源逻辑:
现有的 v2rayN 支持 Xray 和 sing-box 两个内核,所以 DNS 分为两大部分。在没有特殊要求的情况下,点击导入默认 DNS 配置已经足够使用;进阶设置你可以参考相关的文档和 Github 上的用户讨论结果。
> 使用系统 hosts
> 使用系统 hosts
开启后会把 Windows 系统的 hosts 文件内容加入到 DNS 的 hosts 中。
> Outbound 域名解析地址
> Outbound 域名解析地址
设置本机解析 Outbound 域名的地址。
> Outbound 域名解析策略
> Outbound 域名解析策略
对域名解析结果的处理,使用 ipv4 或 ipv6 等
### 解除 Win10 UWP 应用回环代理限制
简单的说就是 Windows10+ UWP 应用存在沙盒机制,正常情况下无法访问 localhost即无法访问回环地址进而没法通过本机代理上网。这时候你就需要想使用此功能解除这个限制了。更详细的文档你可以 Google 搜索。
@ -221,7 +215,6 @@ sing-box rule set 文件来源逻辑:
如果你开启了流量统计功能,此功能可以清所有配置文件的上传和下载数据,不包括延迟和速度数据。
### 区域预置设置
@ -250,27 +243,26 @@ Github API 接口有调用限制,如果你在短时间内更新了很多次,
在 Windows 系统点击会隐藏主界面,从任务栏消失。
在非 Windows 系统点击会结束运行并退出所有进程;窗口关闭功能受到设置选项控制,可以隐藏主界面或只是最小化窗口。
### 主界面
> 配置文件列表
> 配置文件列表
1. 点击列标题可以按此列正向或反向排序。延迟和速度列排序比较特殊,无效数据会永久排在最后面。
2. 拖动列可以改变列顺序,列宽度也可以改变,并在正常退出后保存布局。
3. 配置文件过滤只是模糊查询,不支持正则表达式。
> 多配置文件最低延迟
> 多配置文件最低延迟
根据用户选择的多个配置文件和当前设置项,产生 sing-box 配置文件, 自动生成 URLTest 组和 Selecctor 组。 在用户不干预的情况下sing-box 会自动选择延迟最低的配置文件做出口。
如果用户想手工选择出口,可在当前代理页面中 Selecctor 组中选择。
根据用户选择的多个配置文件和当前设置项,产生 sing-box 配置文件, 自动生成 URLTest 组和 Selector 组。 在用户不干预的情况下sing-box 会自动选择延迟最低的配置文件做出口。
如果用户想手工选择出口,可在当前代理页面中 Selector 组中选择。
此功能过于复杂,所以会跳过前置代理和落地代理功能。
> 多配置文件负载均衡
> 多配置文件负载均衡
根据用户选择的多个配置文件和当前设置项,产生 Xray 配置文件,自动生成负载均衡器配置。
此功能过于复杂,所以会跳过分片功能,前置代理和落地代理功能。参考 https://xtls.github.io/config/routing.html#balancerobject
> 信息
> 信息
信息过滤支持正则表达式;过滤器只对后面产生的数据起作用,如果你有比较复杂的要求,请复制到第三方编辑器中处理。

@ -15,5 +15,6 @@
这一功能的常见用法是分流国内外流量,核心可以通过内部机制判断不同地区的流量,然后将它们发送到不同的出站代理。
### 常规用法
1. 系统代理 选择 自动配置系统代理
2. 路由功能 选择 绕过大陆
2. 路由功能 选择 绕过大陆

32
Faq.md

@ -1,10 +1,10 @@
## 常见问题
### 反馈问题时,开发者需要的日志从哪里找到?
反馈问题时应该在重现之前,先把原来的日志删除,重现后再把详细步骤和日志提交。
问题分为 v2rayN 问题 和 核心问题两种,所以日志也对应的有两种:
1. v2rayN 问题:比如界面操作,设置,测速,检查更新等,日志存放在 guiLogs 文件夹。
2. 核心问题:日志显示在主界面信息栏中,可以复制出来。
@ -18,23 +18,22 @@
### 在 Windows 7 / Win7 下能使用吗?
理论上可以。v2rayN 依赖 .NET 8 ,请看微软官方文档 https://learn.microsoft.com/zh-cn/dotnet/core/install/windows
相关的 issue 挺多的,搜索 https://github.com/2dust/v2rayN/issues?q=win7
理论上可以。v2rayN 依赖 .NET 8 ,请看微软官方文档 https://learn.microsoft.com/zh-cn/dotnet/core/install/windows
相关的 issue 挺多的,搜索 https://github.com/2dust/v2rayN/issues?q=win7
因为 Golang 最新版本已经停止了支持 Win7 ,所以各个核心对 Win7 给出了特殊版本,需要你手动下载后放入 bin 文件夹中
1. Xray : 下载文件中包含有 win7 的包
2. sing-box : 下载文件中包含有 Windows legacy 的包
3. mihomo : 下载文件中包含有 Windows go120 的包
1. Xray : 下载文件中包含有 win7 的包
2. sing-box : 下载文件中包含有 Windows legacy 的包
3. mihomo : 下载文件中包含有 Windows go120 的包
### 为什么 Windows 自动配置系统代理模式下系统代理中只有HTTP代理而没有SOCKS代理
### 为什么 Windows 自动配置系统代理模式下系统代理中只有HTTP代理而没有SOCKS代理
Windows 的系统代理正常只能配置HTTP代理不支持SOCKS5代理但是支持SOCKS4代理。
Windows 的系统代理正常只能配置HTTP代理不支持SOCKS5代理但是支持SOCKS4代理。
参考讨论区: https://github.com/2dust/v2rayN/discussions/1553
### 在 macOS 系统上运行,开启自动配置系统代理,无法自动添加网络设置内的代理地址
v2rayN macOS 版本开启自动配置系统代理实际上是调用脚本实现的,所以可能是在你的设备环境下调用失败了,你可以查看日志来判断。脚本执行失败的日志可以在 guiLogs 文件夹中找。
v2rayN macOS 版本开启自动配置系统代理实际上是调用脚本实现的,所以可能是在你的设备环境下调用失败了,你可以查看日志来判断。脚本执行失败的日志可以在 guiLogs 文件夹中找。
解决办法可能需要你自己写个脚本来实现,参考 issue https://github.com/2dust/v2rayN/issues/6462
### 电脑翻墙后能否共享热点给其他设备
@ -58,7 +57,7 @@ https://github.com/2dust/v2rayN/discussions/5287
https://github.com/2dust/v2rayN/discussions/6457
### 为什么我在开启v2ray之后无法使用bing搜索
### 为什么我在开启v2ray之后无法使用bing搜索
https://github.com/2dust/v2rayN/discussions/3489
@ -72,15 +71,16 @@ https://github.com/2dust/v2rayN/discussions/5795
### 启用TUN模式问题的统一回复
TUN模式问题很复杂直接看 issue 和 discussion
* https://github.com/2dust/v2rayN/issues/4539
* https://github.com/2dust/v2rayN/discussions/3888
* https://github.com/2dust/v2rayN/discussions/5828
TUN模式问题很复杂直接看 issue 和 discussion
* https://github.com/2dust/v2rayN/issues/4539
* https://github.com/2dust/v2rayN/discussions/3888
* https://github.com/2dust/v2rayN/discussions/5828
### 在测试真连接时会显示运行 core 失败
信息框中显示运行 core 失败,一般是在延迟测试和测速中出现,有时候也会在启动活动配置文件出现。请把日志等级设置为 Debug ,然后把运行 core 失败时界面上显示的日志发出来。
提示内容大部分是因为配置错误或你的配置 Core 已经不支持了;或者就是本地监听端口已被其他应用占用,比如虚拟机。
提示内容大部分是因为配置错误或你的配置 Core 已经不支持了;或者就是本地监听端口已被其他应用占用,比如虚拟机。
相关的 issue 挺多的,搜索 https://github.com/2dust/v2rayN/issues?q=Hyper
如果自己解决不了,请统一反馈到 https://github.com/2dust/v2rayN/issues/6428

@ -1,6 +1,7 @@
> #### A GUI client for Windows, Linux and macOS, support Xray and sing-box and others
## 沟通
* [常见问题](https://github.com/2dust/v2rayN/wiki/Faq) 页面是查看您的问题是否已被问到的好地方。
* 如果您需要帮助,请在 [GitHub Discussions](https://github.com/2dust/v2rayN/discussions) 中提问。
* 如果您发现错误或有功能请求,请 [提交 issue](https://github.com/2dust/v2rayN/issues/new)。
@ -21,4 +22,3 @@
* [未做界面设置的参数说明](Description-of-some-parameters)
* [VMess 分享链接说明](Description-of-VMess-share-link)
* [v2rayN 订阅功能说明](Description-of-subscription)

@ -7,14 +7,14 @@
### Windows
1. 支持的系统版本
```
Windows 10+
1. 支持的系统版本
```
Windows 10+
```
#### Windows x64
- `v2rayN-windows-64.zip` WPF实现的界面需要安装 [Microsoft .NET 8.0 Desktop Runtime]
- `v2rayN-windows-64.zip` WPF实现的界面需要安装 [Microsoft .NET 8.0 Desktop Runtime]
- `v2rayN-windows-64-SelfContained.zip` WPF实现的界面
- `v2rayN-windows-64-desktop.zip` Avalonia UI 实现的界面
- 其他 Core 你可以从 [这里](https://github.com/2dust/v2rayN-core-bin/blob/master/v2rayN-windows-64-other-bins.zip) 下载后放入 bin 文件夹
@ -24,7 +24,6 @@
- `v2rayN-windows-arm64.zip` WPF实现的界面需要安装 [Microsoft .NET 8.0 Desktop Runtime]
- `v2rayN-windows-arm64-desktop.zip` Avalonia UI 实现的界面
### Linux
1. 非`zip`格式包为安装版,存储文件位置为系统规定的用户文件中
@ -37,17 +36,16 @@
#### Linux x64
- `v2rayN-linux-64.zip` 执行: `chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-linux-64.zip` 执行: `chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-linux-64.deb` 安装:`sudo dpkg -i v2rayN-linux-64.deb` ,无法使用内置检查更新升级版本
- `v2rayN-linux-64.AppImage` 无法使用内置检查更新升级版本
#### Linux arm64
- `v2rayN-linux-arm64.zip` 执行: `chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-linux-arm64.zip` 执行: `chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-linux-arm64.deb` 安装:`sudo dpkg -i v2rayN-linux-arm64.deb` ,无法使用内置检查更新升级版本
- `v2rayN-linux-arm64.AppImage` 无法使用内置检查更新升级版本
### macOS
1. 非`zip`格式包为安装版,存储文件位置为系统规定的用户文件中
@ -58,10 +56,10 @@
#### macOS x64
- `v2rayN-macos-64.zip` 执行:`chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-macos-64.zip` 执行:`chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-macos-64.dmg` 由于安装包没有签名,会提示应用已损坏;安装后需要运行:`xattr -cr /Applications/v2rayN.app`
#### macOS arm64
- `v2rayN-macos-arm64.zip` 执行:`chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-macos-arm64.dmg` 由于安装包没有签名,会提示应用已损坏;安装后需要运行:`xattr -cr /Applications/v2rayN.app`
- `v2rayN-macos-arm64.zip` 执行:`chmod +x v2rayN` 普通用户运行 `./v2rayN`
- `v2rayN-macos-arm64.dmg` 由于安装包没有签名,会提示应用已损坏;安装后需要运行:`xattr -cr /Applications/v2rayN.app`