user
这一页说明普通用户权限配置。user 决定哪些人可以使用受限指令、按钮和规则能力。
user
yaml
user:
- 123456789
- 987654321说明
user 列表里的元素既可以是数字 UID,也可以是用户名(不带 @,大小写不敏感)。为了减少歧义,推荐直接写数字 UID。
user
解释
- 这是普通授权用户名单。
- 很多需要权限的交互式操作,都会先检查发起者是否在
user里。 - 权限判断会拿发起者的 UID 和用户名,分别与这个列表比对,命中任意一个就算授权用户。
特性
- 类型:
list[int | str] - 实际推荐写法:
list[int] - 列表为空时,普通受限功能通常只剩管理员可用。
- 用户名匹配不区分大小写,但用户名可以随时改,想长期稳定管理权限最好使用不会变化的 UID。
配置示例
yaml
user:
- 123456789
- 987654321与 admin 的关系
解释
- 程序启动初始化时,会把
admin里的成员合并进user。 - 因此大多数情况下,你不需要把管理员再手动重复写一遍。
user更偏向“普通授权名单”,admin更偏向“最高权限名单”。
特性
- 管理员和普通用户不是同一个概念。
- 想加普通用户,改
user即可;想加管理员,要改admin。 - 这个合并动作发生在启动初始化阶段,日常管理时最好仍然把两者分开理解。
配置示例
yaml
admin:
- 111111111
user:
- 222222222
- 333333333推荐管理方式
解释
- 对日常增删普通用户来说,直接用
/grant和/ungrant比手改配置更方便。 - 当前这两个命令会修改
CONFIG.user,再保存并重载配置。 - 所以
user这页更适合拿来理解机制,而不是每次都手工编辑。
特性
/grant和/ungrant都是管理员命令- 它们修改的是
user,不是admin - 如果你在群里频繁临时授权,这种方式明显更省事
配置示例
yaml
user:
- 123456789游客与受限指令
解释
- 不在
user里的用户,很多受限操作会直接被拦下。 - 一个比较特殊的例子是
/subinfo:如果发起者不在user,而你又没有配置network.httpProxy,当前实现会拒绝游客使用这个命令。 - 这样做是为了避免直接暴露主端 IP。
特性
user不只是“能不能点按钮”,它还会影响部分规则、任务和订阅查询入口- 如果你希望游客也能安全地查
/subinfo,需要额外配好network.httpProxy
配置示例
yaml
user:
- 123456789
- 222222222相关命令可继续看:
相关内容
以及:
相关内容
