Skip to content

user ​

这一页说明普通用户权限配置。user 决定哪些人可以使用受限指令、按钮和规则能力。

user
yaml
user:
  - 123456789
  - 987654321

说明

user 列表里的元素既可以是数字 UID,也可以是用户名(不带 @,大小写不敏感)。为了减少歧义,推荐直接写数字 UID。

user ​

解释

  1. 这是普通授权用户名单。
  2. 很多需要权限的交互式操作,都会先检查发起者是否在 user 里。
  3. 权限判断会拿发起者的 UID 和用户名,分别与这个列表比对,命中任意一个就算授权用户。

特性

  1. 类型:list[int | str]
  2. 实际推荐写法:list[int]
  3. 列表为空时,普通受限功能通常只剩管理员可用。
  4. 用户名匹配不区分大小写,但用户名可以随时改,想长期稳定管理权限最好使用不会变化的 UID。

配置示例

yaml
user:
  - 123456789
  - 987654321

与 admin 的关系 ​

解释

  1. 程序启动初始化时,会把 admin 里的成员合并进 user。
  2. 因此大多数情况下,你不需要把管理员再手动重复写一遍。
  3. user 更偏向“普通授权名单”,admin 更偏向“最高权限名单”。

特性

  1. 管理员和普通用户不是同一个概念。
  2. 想加普通用户,改 user 即可;想加管理员,要改 admin。
  3. 这个合并动作发生在启动初始化阶段,日常管理时最好仍然把两者分开理解。

配置示例

yaml
admin:
  - 111111111

user:
  - 222222222
  - 333333333

推荐管理方式 ​

解释

  1. 对日常增删普通用户来说,直接用 /grant 和 /ungrant 比手改配置更方便。
  2. 当前这两个命令会修改 CONFIG.user,再保存并重载配置。
  3. 所以 user 这页更适合拿来理解机制,而不是每次都手工编辑。

特性

  1. /grant 和 /ungrant 都是管理员命令
  2. 它们修改的是 user,不是 admin
  3. 如果你在群里频繁临时授权,这种方式明显更省事

配置示例

yaml
user:
  - 123456789

游客与受限指令 ​

解释

  1. 不在 user 里的用户,很多受限操作会直接被拦下。
  2. 一个比较特殊的例子是 /subinfo:如果发起者不在 user,而你又没有配置 network.httpProxy,当前实现会拒绝游客使用这个命令。
  3. 这样做是为了避免直接暴露主端 IP。

特性

  1. user 不只是“能不能点按钮”,它还会影响部分规则、任务和订阅查询入口
  2. 如果你希望游客也能安全地查 /subinfo,需要额外配好 network.httpProxy

配置示例

yaml
user:
  - 123456789
  - 222222222

相关命令可继续看:

相关内容

/grant

以及:

相关内容

/subinfo

文档内容同步自 koipy-public