forked from bot/app
61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
---
|
||
title: 配置
|
||
icon: cog
|
||
order: 2
|
||
category: 使用指南
|
||
tag:
|
||
- 配置
|
||
- 部署
|
||
---
|
||
|
||
首次运行后生成`config.yml`，你可以修改配置项后重启轻雪，绝大多数情况下，你只需要修改`superusers`和`nickname`字段即可
|
||
|
||
## **基础配置项**
|
||
|
||
```yaml
|
||
command_start: [ "/", "" ] # 指令前缀，若没有""空命令头，请开启alconna_use_command_start保证alconna解析正常
|
||
host: 127.0.0.1 # 监听地址，默认为本机，若要接收外部请求请填写0.0.0.0
|
||
port: 20216 # 绑定端口
|
||
nickname: [ "liteyuki" ] # 机器人昵称列表
|
||
superusers: [ "1919810" ] # 超级用户列表
|
||
```
|
||
|
||
## **其他配置**
|
||
|
||
以下为默认值，如需自定义请手动添加
|
||
|
||
```yaml
|
||
onebot_access_token: "" # 访问令牌，对公开放时建议设置
|
||
default_language: "zh-CN" # 默认语言
|
||
log_level: "INFO" # 日志等级
|
||
log_icon: true # 是否显示日志等级图标（某些控制台字体不可用）
|
||
auto_report: true # 是否自动上报问题给轻雪服务器
|
||
auto_update: true # 是否自动更新轻雪，每天4点检查更新
|
||
alconna_auto_completion: false # alconna是否自动补全指令，默认false，建议开启
|
||
safe_mode: false # 安全模式，开启后将不会加载任何第三方插件
|
||
|
||
# 其他Nonebot插件的配置项
|
||
custom_config_1: "custom_value1"
|
||
custom_config_2: "custom_value2"
|
||
...
|
||
```
|
||
|
||
> [!tip]
|
||
> 如果要使用dotenv配置文件，请自行创建`.env.{ENVIRONMENT}`，并在`config.yml`中添加`environment:{ENVIRONMENT}`字段
|
||
|
||
## **OneBot实现端配置**
|
||
|
||
生产环境中推荐反向WebSocket
|
||
不同的实现端给出的字段可能不同，但是基本上都是一样的，这里给出一个参考值
|
||
|
||
| 字段 | 参考值 | 说明 |
|
||
|-------------|------------------------------------|----------------------------------|
|
||
| 协议 | 反向WebSocket | 推荐使用反向ws协议进行通信，即轻雪作为服务端 |
|
||
| 地址 | ws://127.0.0.1:20216/onebot/v11/ws | 地址取决于配置文件，本机默认为`127.0.0.1:20216` |
|
||
| AccessToken | `""` | 如果你给轻雪配置了`AccessToken`，请在此填写相同的值 |
|
||
|
||
## **其他**
|
||
|
||
- 要使用其他通信方式请访问[OneBot Adapter](https://onebot.adapters.nonebot.dev/)获取详细信息
|
||
- 轻雪不局限于OneBot适配器，你可以使用NoneBot2支持的任何适配器
|