VLESS UUID 映射标准：将自定义字符串映射为一个 UUIDv5

[RPRX]

VLESS UUID 映射标准：将自定义字符串映射为一个 UUIDv5

这个想法很早就有了，这里感谢 @DuckSoft 提议参照 UUIDv5 标准作为映射方式。

特别注意：切勿把本机制理解为某种加密，而应假定得到映射出的 UUID 即相当于得到原始文本。

1. 范围

长度为 1-30 字节的任意字符串（因为 UUID 字符串长为 32-36 字节，又额外排除了 0 和 31）

UTF-8 编码，比如数字、英文字母、符号等 ASCII 字符占 1 个字节，汉字通常占 3 个字节，emoji 通常占 4 个字节。

1. 若存在非 ASCII 字符，JSON 等配置文件本身的编码格式必须为 UTF-8。
2. Xray-core 内置自动映射，包括 VMess。其它 VLESS 实现需要参照此标准进行映射。

2. 方式

选取 16 字节的空 UUID 作为 namespace，自定义字符串即为 name，遵循 UUIDv5 标准进行一系列变换，最终生成 UUIDv5。

我参考 go.uuid 库写了个简单的实现，并输出同一个 UUIDv5 的两种形式：

package main

import (
	"crypto/sha1"
	"encoding/hex"
	"fmt"
)

func main() {
	var Nil [16]byte

	var str = "example"

	h := sha1.New()
	h.Write(Nil[:])
	h.Write([]byte(str))

	u := h.Sum(nil)[:16]
	u[6] = (u[6] & 0x0f) | (5 << 4)
	u[8] = (u[8]&(0xff>>2) | (0x02 << 6))

	fmt.Println("UUIDv5:", u)

	buf := make([]byte, 36)

	hex.Encode(buf[0:8], u[0:4])
	buf[8] = '-'
	hex.Encode(buf[9:13], u[4:6])
	buf[13] = '-'
	hex.Encode(buf[14:18], u[6:8])
	buf[18] = '-'
	hex.Encode(buf[19:23], u[8:10])
	buf[23] = '-'
	hex.Encode(buf[24:], u[10:])

	fmt.Println("UUIDv5:", string(buf))
}

字符串为 example 时，以上代码的输出为：

UUIDv5: [254 181 68 49 48 27 82 187 166 221 225 233 62 129 187 158]
UUIDv5: feb54431-301b-52bb-a6dd-e1e93e81bb9e

也就是说下一个版本的 Xray-core 中，VLESS/VMess id 填 example 和 feb54431-301b-52bb-a6dd-e1e93e81bb9e 是等价的。

3. Q & A

Q: 为什么“范围”不包括更长的字符串？
A: 允许使用自定义字符串是方便记忆，过长的字符串也记不住，还不如直接用一个 UUID。

Q: UUIDv5 的 SHA-1 是否存在问题？
A: 不存在问题，因为我们只是需要把限定长度的字符串映射为不重复的 UUID 标识符，按照标准来即可。

补充

1. 建议 GUI 客户端等提供一个映射工具，任何人都可以创造等价 UUID，满足更多用途。
2. 对于分享、订阅，暂时规定需要先按此标准映射为 UUIDv5，不分享原始文本。

[badO1a5A90]

配置文件是:
服务端仍保持UUID,客户端可以使用 原字符串 / UUID 其中任一方式吗?

[RPRX]

@badO1a5A90 两边都可以使用任一方式，同出/入站多 UUID 时还可以混用

[badO1a5A90]

@badO1a5A90 两边都可以使用任一方式，同出/入站多 UUID 时还可以混用

都可以使用任一方式, 那么客户端使用 UUID 也能反映射到服务端的正常字符串?

[RPRX]

@badO1a5A90 是的，因为这两个是完全等效的，只是配置文件不同，内存中都是同一个 UUID。

无需担心与现在常用的全随机 UUIDv4 冲突，因为标志位不一样，分别是 5 和 4。

[DuckSoft]

五分钟撸了一个 Web App，但足够用了：https://xray-uuid.ducksoft.site/

[badO1a5A90]

补充: 对于汉字，Golang使用UTF-8字符集存储，默认用三个字节

[RPRX]

@badO1a5A90 已补充标准正文

[z826540272]

用普通话说就是 xray支持自定义密码了

[badO1a5A90]

建议给 xray uuid 命令增加一个 xray uuid map 命令

如: xray uuid map -id "我爱🍉老师1314"
则输出 : 5783a3e7-e373-51cd-8642-c83782b807c5

[RPRX]

@badO1a5A90 计划加 -map 参数，xray uuid -map "example"

---

后续：加了 -i 参数，xray uuid -i "example"

[secXsQuared]

多说一句，python里面这么用：

import uuid

UUID_NAMESPACE = uuid.UUID('00000000-0000-0000-0000-000000000000')
uuid.uuid5(UUID_NAMESPACE, "example")

输出：
UUID('feb54431-301b-52bb-a6dd-e1e93e81bb9e')

[epsilonzeio]

[FranzKafkaYu]

@epsilonzeio First xray core won't verify any web panels, developers have no time to review code and investigate whether there are some backdoors.anyone can submit such web panels to Xray Core.
Second you should file a issue in Hiddify official repo and ask for answers from their developers,if they didn't respond you you can file an issue in xray core and request to taken down from README.
Third from the Screenshots it seems the email is not real and it has a prefix will UUID,I think it's generated by Hiddify and used to distinguish users,you can find more information in here , also you can take a look at xray's config generated by hiddify to verify.
If you find something that may be backdoors in hiddify,feel free to file an issue here.