mirror of
https://github.com/XTLS/Xray-docs-next.git
synced 2026-10-14 10:09:16 +03:00
Clean up Vmess alterId
This commit is contained in:
yuhan6665
@@ -6,7 +6,7 @@
|
||||
|
||||
VLESS 是一个无状态的轻量传输协议，它分为入站和出站两部分，可以作为 Xray 客户端和服务器之间的桥梁。
|
||||
|
||||
与 [VMess](./vmess.md) 不同，VLESS 不依赖于系统时间，认证方式同样为 UUID，但不需要 alterId。
|
||||
与 [VMess](./vmess.md) 不同，VLESS 不依赖于系统时间，认证方式同样为 UUID。
|
||||
|
||||
## InboundConfigurationObject
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[VMess](../../development/protocols/vmess.md) 是一个加密传输协议，通常作为 Xray 客户端和服务器之间的桥梁。
|
||||
|
||||
::: danger
|
||||
VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在 90 秒之内，时区无关。在 Linux 系统中可以安装`ntp`服务来自动同步系统时间。
|
||||
VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在 120 秒之内，时区无关。在 Linux 系统中可以安装`ntp`服务来自动同步系统时间。
|
||||
:::
|
||||
|
||||
## InboundConfigurationObject
|
||||
@@ -14,18 +14,15 @@ VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在
|
||||
{
|
||||
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
|
||||
"level": 0,
|
||||
"alterId": 0,
|
||||
"email": "love@xray.com"
|
||||
}
|
||||
],
|
||||
"default": {
|
||||
"level": 0,
|
||||
"alterId": 0
|
||||
"level": 0
|
||||
},
|
||||
"detour": {
|
||||
"to": "tag_to_detour"
|
||||
},
|
||||
"disableInsecureEncryption": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
@@ -45,22 +42,12 @@ VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在
|
||||
|
||||
可选，clients 的默认配置。仅在配合`detour`时有效。
|
||||
|
||||
> `disableInsecureEncryption`: true | false
|
||||
|
||||
是否禁止客户端使用不安全的加密方式，如果设置为 true 当客户端指定下列加密方式时，服务器会主动断开连接。
|
||||
|
||||
- `"none"`
|
||||
- `"aes-128-cfb"`
|
||||
|
||||
默认值为`false`。
|
||||
|
||||
### ClientObject
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
|
||||
"level": 0,
|
||||
"alterId": 4,
|
||||
"email": "love@xray.com"
|
||||
}
|
||||
```
|
||||
@@ -88,18 +75,6 @@ Vmess 的用户 ID，可以是任意小于 30 字节的字符串, 也可以是
|
||||
|
||||
level 的值, 对应 [policy](../policy.md#policyobject) 中 `level` 的值。 如不指定, 默认为 0。
|
||||
|
||||
> `alterId`: number
|
||||
|
||||
为了进一步防止被探测，一个用户可以在主 ID 的基础上，再额外生成多个 ID。这里只需要指定额外的 ID 的数量，推荐值为 0 代表启用 VMessAEAD。
|
||||
最大值 65535。这个值不能超过服务器端所指定的值。
|
||||
|
||||
不指定的话，默认值是 0。
|
||||
|
||||
::: tip
|
||||
客户端 AlterID 设置为 0 代表启用 VMessAEAD ；服务端为自动适配，可同时兼容启用和未开启 VMessAEAD 的客户端。
|
||||
客户端可通过设置环境变量 `Xray_VMESS_AEAD_DISABLED=true` 强行禁用 VMessAEAD
|
||||
:::
|
||||
|
||||
> `email`: string
|
||||
|
||||
用户邮箱地址，用于区分不同用户的流量。
|
||||
@@ -120,8 +95,7 @@ level 的值, 对应 [policy](../policy.md#policyobject) 中 `level` 的值。
|
||||
|
||||
```json
|
||||
{
|
||||
"level": 0,
|
||||
"alterId": 0
|
||||
"level": 0
|
||||
}
|
||||
```
|
||||
|
||||
@@ -130,35 +104,3 @@ level 的值, 对应 [policy](../policy.md#policyobject) 中 `level` 的值。
|
||||
用户等级，连接会使用这个用户等级对应的 [本地策略](../policy.md#levelpolicyobject)。
|
||||
|
||||
level 的值, 对应 [policy](../policy.md#policyobject) 中 `level` 的值。 如不指定, 默认为 0。
|
||||
|
||||
> `alterId`: number
|
||||
|
||||
动态端口的默认`alterId`，默认值为`0`。
|
||||
|
||||
## VMess MD5 认证信息 玷污机制
|
||||
|
||||
为了进一步对抗可能的探测和封锁，每个 VMess 认证数据的服务端结构都会包含一个一次写入的玷污状态标记，初始状态为无瑕状态，当服务器检测到重放探测时或者因为其他原因入站连接出错以致校验数据不正确时，该连接所对应的请求认证数据会被玷污。
|
||||
|
||||
被玷污的认证数据无法被用于建立连接，当攻击者或客户端使用被玷污的认证数据建立连接时，服务器会输出包含 `invalid user` `ErrTainted` 的错误信息，并阻止该连接。
|
||||
|
||||
当服务器没有受到重放攻击时，该机制对正常连接的客户端没有影响。
|
||||
|
||||
如果服务器正在被重放攻击，可能会出现连接不稳定的情况。
|
||||
|
||||
::: tip
|
||||
拥有服务器 UUID 以及其他连接数据的恶意程序可能根据此机制对服务器发起拒绝服务攻击，受到此类攻击的服务可以通过修改 `proxy/vmess/validator.go` 文件中 `func (v \*TimedUserValidator) BurnTaintFuse(userHash []byte) error` 函数的 `atomic.CompareAndSwapUint32(pair.taintedFuse, 0, 1)` 语句为 `atomic.CompareAndSwapUint32(pair.taintedFuse, 0, 0)` 来解除服务器对此类攻击的安全保护机制。使用 VMessAEAD 认证机制的客户端不受到 VMess MD5 认证信息 玷污机制 的影响。
|
||||
:::
|
||||
|
||||
## VMess MD5 认证信息 淘汰机制
|
||||
|
||||
VMess MD5 认证信息 的淘汰机制已经启动。
|
||||
|
||||
自 2022 年 1 月 1 日起，服务器端默认禁用对于 MD5 认证信息 的兼容。任何使用 MD5 认证信息的客户端将无法连接到禁用 VMess MD5 认证信息的服务器端。
|
||||
|
||||
::: tip
|
||||
在服务器端可以通过设置环境变量 xray.vmess.aead.forced=true 以关闭对于 MD5 认证信息的兼容，或者 xray.vmess.aead.forced=false 以强制开启对于 MD5 认证信息 认证机制的兼容（不受到 2022 年自动禁用机制的影响）。
|
||||
:::
|
||||
|
||||
::: tip
|
||||
如无兼容旧客户端必要，应在服务端配置移除 `"alterID"` 参数。
|
||||
:::
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
|
||||
VLESS 是一个无状态的轻量传输协议，它分为入站和出站两部分，可以作为 Xray 客户端和服务器之间的桥梁。
|
||||
|
||||
与 [VMess](./vmess.md) 不同，VLESS 不依赖于系统时间，认证方式同样为 UUID，但不需要 alterId。
|
||||
与 [VMess](./vmess.md) 不同，VLESS 不依赖于系统时间，认证方式同样为 UUID。
|
||||
|
||||
## OutboundConfigurationObject
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
[VMess](../../development/protocols/vmess.md) 是一个加密传输协议，通常作为 Xray 客户端和服务器之间的桥梁。
|
||||
|
||||
::: danger
|
||||
VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在 90 秒之内，时区无关。在 Linux 系统中可以安装`ntp`服务来自动同步系统时间。
|
||||
VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在 120 秒之内，时区无关。在 Linux 系统中可以安装`ntp`服务来自动同步系统时间。
|
||||
:::
|
||||
|
||||
## OutboundConfigurationObject
|
||||
@@ -17,7 +17,6 @@ VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在
|
||||
"users": [
|
||||
{
|
||||
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
|
||||
"alterId": 0,
|
||||
"security": "auto",
|
||||
"level": 0
|
||||
}
|
||||
@@ -62,7 +61,6 @@ VMess 依赖于系统时间，请确保使用 Xray 的系统 UTC 时间误差在
|
||||
```json
|
||||
{
|
||||
"id": "5783a3e7-e373-51cd-8642-c83782b807c5",
|
||||
"alterId": 0,
|
||||
"security": "auto",
|
||||
"level": 0
|
||||
}
|
||||
@@ -81,18 +79,6 @@ Vmess 的用户 ID，可以是任意小于 30 字节的字符串, 也可以是
|
||||
|
||||
你可以使用命令 `xray uuid -i "自定义字符串"` 生成自定义字符串所映射的的 UUID, 也可以使用命令 `xray uuid` 生成随机的 UUID。
|
||||
|
||||
> `alterId`：number
|
||||
|
||||
为了进一步防止被探测，一个用户可以在主 ID 的基础上，再额外生成多个 ID。这里只需要指定额外的 ID 的数量，推荐值为 0 代表启用 VMessAEAD。
|
||||
最大值 65535。这个值不能超过服务器端所指定的值。
|
||||
|
||||
不指定的话，默认值是 0。
|
||||
|
||||
::: tip
|
||||
客户端 AlterID 设置为 0 代表启用 VMessAEAD ；服务端为自动适配，可同时兼容启用和未开启 VMessAEAD 的客户端。
|
||||
客户端可通过设置环境变量 `Xray_VMESS_AEAD_DISABLED=true` 强行禁用 VMessAEAD
|
||||
:::
|
||||
|
||||
> `level`: number
|
||||
|
||||
用户等级，连接会使用这个用户等级对应的 [本地策略](../policy.md#levelpolicyobject)。
|
||||
|
||||
Reference in New Issue
Block a user