用户

用户是构成订阅的账户：通过分组获得对 inbound 的访问权限、流量限制、 到期时间和设备列表。面板中的 Users 区域是创建和修改用户的 唯一位置。

创建用户

打开 Users → Create 并填写字段。

字段	必填	规则
username	是	3–36 个字符：字母、数字、_、-
expireAt	是	到期日期，例如 2026-01-17T15:38:45.065Z
status	否	默认为 ACTIVE
trafficLimitBytes	否	以字节为单位的限制；0 表示不限
trafficLimitStrategy	否	流量重置周期，默认为 NO_RESET
hwidDeviceLimit	否	设备数量；0 表示不限制
tag	否	最多 16 个字符：大写字母、数字、_
telegramId、email、description	否	通知和备注
activeInternalSquads	否	用户的内部分组
externalSquadUuid	否	用户的外部分组

协议密码和标识符（trojanPassword、vlessUuid、 ssPassword）由面板自行生成——无需手动设置。

状态

状态	含义	如何变化
ACTIVE	访问已开放	在创建、启用、续期、重置流量时
DISABLED	被管理员禁用	通过 Disable 按钮，用 Enable 恢复
LIMITED	流量限制已用尽	由调度器自动设置
EXPIRED	expireAt 已过期	由调度器自动设置

LIMITED 和 EXPIRED 不会自行解除，只能通过有意的操作：重置流量或 延长期限。用户可以按状态筛选，也可以批量删除——Delete users by status。

流量限制

trafficLimitBytes 以字节为单位设置，0 表示取消限制。重置周期由 trafficLimitStrategy 决定：

值	周期
NO_RESET	流量不重置
DAY	每天
WEEK	每周
MONTH	日历月
MONTH_ROLLING	从用户创建之日起的一个月

手动重置流量：用户卡片 → Reset traffic。已用量计数器归零， lastTrafficResetAt 更新，LIMITED 状态变为 ACTIVE。对一组用户也可 批量重置——Bulk actions → Reset traffic（一次最多 500 个用户）。

有效期

expireAt 是用户转为 EXPIRED 的日期。通过 Extend 按钮续期会 按以下规则增加天数：

• EXPIRED —— 从当前时刻开始计算，状态变为 ACTIVE；
• ACTIVE —— 天数加到当前到期日期上；
• DISABLED 和 LIMITED —— 日期延长，状态不变。

批量续期：Bulk actions → Extend expiration date。

设备限制

hwidDeviceLimit 按 HWID 限制设备数量。0 完全关闭检查，而留空 表示「从订阅设置中取 fallbackDeviceLimit」。详情见 HWID 设备限制。

绑定分组

对 inbound 的访问由内部分组决定：用户只能看到其 inbound 属于 他所在分组的主机。外部分组 （externalSquadUuid）不授予任何权限，而是改变订阅的外观和行为—— 模板、请求头、HWID 设置。两种分组都在 分组 一节中说明。

订阅链接

链接由 SUB_PUBLIC_DOMAIN 和短标识符自动生成：

https://sub.example.com/<shortUuid>

它指向订阅页面，或直接返回配置。如果链接泄露，请撤销订阅 （Revoke subscription）：面板会生成新的 shortUuid 和新的协议密码，旧链接将失效。还有 「仅密码」模式——此时短标识符保持不变。

注意

撤销订阅会断开所有已导入旧链接的用户的访问。 请在分发新链接之前通知用户。

提示

短标识符由 SHORT_UUID_METHOD 中的方法生成。不建议 中途更改：这会改变所有新链接的格式。参见 环境变量。

接下来

• 分组 —— 如何授予对 inbound 的访问权限。
• 主机 —— 具体什么内容会进入订阅。
• HWID 设备限制 —— 设备限制。
• API Specification —— 用户管理端点。