安全凭据

状态：Current

最后核对：2026-05-13

路由：/gateway/credentials

安全凭据为 L4 链和 L3 隧道提供可复用的传输密钥与 profile。页面包含 TLS、X25519、REALITY 三个 tab，统一使用 /api/credentials。

凭据类型

类型	用途
X25519	可复用 X25519 key pair，UDP Noise 和 REALITY 都可引用。
REALITY	目标/SNI/short ID profile，引用一个 X25519 key。
TLS Cert	TLS 传输选择使用的证书凭据。

创建、编辑或删除凭据需要 admin。

创建 X25519 Key

1. 打开 X25519 tab。
2. 点击 New X25519 Key。
3. 输入名称。
4. 点击 Create。

编辑 X25519 只修改显示名称，不旋转 key。

创建 REALITY Profile

1. 打开 REALITY tab。
2. 点击 New REALITY Profile。
3. 输入名称并选择 X25519 key。
4. 输入 target host、target port、server names 和 short IDs。
5. 点击 Create。

short ID 必须是偶数长度 hex，最多 16 个字符。相同 server_name + short_id 不能重复。

创建 TLS Cert

1. 打开 TLS tab。
2. 点击 Add。
3. 上传证书和私钥 PEM，或切换到生成 tab。
4. 生成证书时填写 domain、SAN 和有效期。
5. 提交。

后端会校验证书和私钥是否匹配。

删除凭据

删除前检查：

• 使用 TLS、REALITY 或 Noise 的 L4 链。
• 使用 REALITY profile 的 L3 隧道。
• 删除 X25519 key 前，确认没有 REALITY profile 引用它。