import{_ as i,o as a,c as n,a7 as t}from"./chunks/framework._avq4Ty7.js";const E=JSON.parse('{"title":"配置","description":"","frontmatter":{"title":"配置","order":2},"headers":[],"relativePath":"deploy/config.md","filePath":"zh/deploy/config.md","lastUpdated":1728838653000}'),l={name:"deploy/config.md"};function h(e,s,k,p,d,o){return a(),n("div",null,s[0]||(s[0]=[t(`
轻雪支持yaml
、json
和toml
作为配置文件,取决于你个人的喜好
首次运行后生成config.yml
和config
目录,你可修改配置项后重启轻雪,绝大多数情况下,你只需要修改superusers
及nickname
字段即可
启动时会加载项目目录下config.yml/yaml/json/toml
和config
目录下的所有配置文件,你可在config
目录下创建多个配置文件,轻雪会自动合并这些配置文件
nonebot:
# Nonebot机器人的配置,6.3.10版本后,NoneBot下配置已迁移至nonebot键下,不再使用外层配置,但是部分内容会被覆盖,请尽快迁移
command_start: [ "/", "" ] # 指令前缀,若没有""空命令头,请开启alconna_use_command_start保证alconna解析正常
host: 127.0.0.1 # 监听地址,默认为本机,若要接收外部请求请填写0.0.0.0
port: 20216 # 绑定端口
nickname: [ "liteyuki" ] # 机器人昵称列表
superusers: [ "1919810" ] # 超级用户列表
liteyuki:
# 写在外层的配置项将会被覆盖,建议迁移到liteyuki下
log_level: "INFO" # 日志等级
log_icon: true # 是否显示日志等级图标(某些控制台字体不可用)
auto_report: true # 是否自动上报问题给轻雪服务器
auto_update: true # 是否自动更新轻雪,每天4点检查更新
plugins: [ ] # 轻雪插件列表
plugin_dirs: [ ] # 轻雪插件目录列表
以下为默认值,如需自定义请手动添加
# 高级NoneBot配置
nonebot:
onebot_access_token: "" # 访问令牌,对公开放时建议设置
default_language: "zh-CN" # 默认语言
alconna_auto_completion: false # alconna是否自动补全指令,默认false,建议开启
safe_mode: false # 安全模式,开启后将不会加载任何第三方NoneBot插件
# 其他Nonebot插件的配置项
custom_config_1: "custom_value1"
custom_config_2: "custom_value2"
# 开发者选项
liteyuki:
allow_update: true # 是否允许更新
debug: false # 轻雪调试,开启会自动重载Bot或者资源,其他插件自带的调试功能也将开启
dev_mode: false # 开发者模式,开启后将会启动监视者,监视文件变化并自动重载
...
生产环境中推荐反向WebSocket 不同的实现端给出的字段可能不同,但是基本上都是一样的,这里给出一个参考值
字段 | 参考值 | 说明 |
---|---|---|
协议 | 反向WebSocket | 推荐使用反向ws协议进行通信,即轻雪作为服务端 |
地址 | ws://127.0.0.1:20216/onebot/v11/ws | 地址取决于配置文件,本机默认为127.0.0.1:20216 |
AccessToken | "" | 如果你给轻雪配置了AccessToken ,请在此填写相同的值 |