1. 首页
  2. 参考
  3. 配置项

配置项参考

Qidun 没有配置文件:全部配置存于 SQLite settings 表(键带 cfg. 前缀),通过 WebUI 修改,保存即时生效(特别注明的除外)。布尔值为 1 / true / yes。MySQL 密码 AES-256-GCM 加密落库。

server / auth(服务与认证)

键默认含义
server.port529API + 面板 HTTPS 端口
server.host0.0.0.0监听地址
auth.token_ttl_minutes720登录 token 有效期(分钟)

sysmetrics + 磁盘 IO(系统指标)

键默认含义
sysmetrics.interval_sec60采集间隔(秒)
sysmetrics.cpu_max / mem_max / disk_max90CPU / 内存 / 磁盘告警阈值 %
sysmetrics.disk_thresholds{}逐盘阈值 JSON {挂载点:百分比},未配置回落 disk_max
sysmetrics.bandwidth_max_bytes104857600带宽告警阈值(100MB/s)
sysmetrics.self_mem_max_bytes1073741824服务自身内存阈值(1GB)
metrics.disk_io_enabledtrue磁盘 IO 采集(HDD 可关)
metrics.disk_io_busy_threshold90IO 繁忙率阈值 %(0 = 关闭繁忙告警)
metrics.disk_io_latency_ms50平均延迟阈值 ms
metrics.disk_io_saturate_pct90IOPS / 吞吐相对基线 95 分位的饱和度 %
metrics.disk_io_rq_sz_kb16请求块大小阈值 KB(小于视为随机 IO)
metrics.disk_io_cycles3条件持续 N 个采集周期才告警
metrics.disk_io_baseline_hours24基线统计滚动窗口(小时)
metrics.disk_io_svctm_rise / svctm_min_ms2.0 / 20服务时间上升倍数 / 判定下限 ms(介质退化)

loginmon / weblogin(登录防护)

键默认含义
loginmon.enabledtrue系统登录监控开关
loginmon.max_failures5窗口内失败阈值
loginmon.window_sec300统计窗口(秒)
loginmon.ban_sec259200封禁时长(秒),默认 3 天(v1.2.9 起)
loginmon.poll_sec10轮询间隔
loginmon.backfill_days30历史回填天数
loginmon.log_pathsLinux: auth.log,secure登录日志路径(Windows 走安全事件)
weblogin.enabledtrue面板登录防护开关
weblogin.max_failures / window_sec5 / 300软锁阈值 / 窗口
weblogin.lockout_sec900软锁时长(429)
weblogin.ban_threshold20防火墙封禁阈值
weblogin.ban_sec259200Web爆破封禁时长(秒),到期自动解封;0=永久
weblogin.ban_firewalltrue达阈值是否执行防火墙封禁
weblogin.whitelist内置 127.0.0.1,::1白名单(覆盖所有封禁点)
机器密钥:首次启动生成 <数据目录>/secret.key(32 字节随机,权限 0600),用于加密 MySQL 密码与自检 HMAC 签名(v1.2.10 起替代旧版按主机名派生,存量密文与基线签名自动迁移)。请勿删除;升级后请勿回退旧版本(旧版本无法解密新密钥密文)。

fim / webshell / keyops(文件与审计)

键默认含义
fim.enabled / interval_sectrue / 360文件指纹开关 / 校验周期(秒)
webshell.enabled / poll_sectrue / 360后门扫描开关 / 间隔
webshell.quarantine_autofalse自动隔离(默认仅告警)
webshell.dirs / ignore_dirs空监测 / 忽略目录(面板维护)
keyops.enabled / interval_sectrue / 60关键操作开关 / 轮询(HDD 可调大)

mysql(监控 + 备份)

键默认含义
mysql.enabled / interval_sectrue / 60监控开关 / 采集间隔
mysql.host / port / user / password_enc / db127.0.0.1 / 3306默认实例参数(多实例在面板按实例配置)
mysql.threads_running_threshold50运行线程告警阈值
mysql.conn_ratio_threshold0.9连接占用比阈值
mysql.slow_query_threshold100慢查询告警阈值
mysql.backup_enabledfalse自动备份总开关(公共默认)
mysql.backup_time03:00每日备份时刻
mysql.backup_keep7保留份数(1–60,实例可覆盖)
mysql.backup_compresstruegzip 压缩
mysql.backup_compress_transfertrue客户端-服务器压缩传输
mysql.backup_timeout_min240备份总超时(分钟,钳制 15–1440)
mysql.protect_enabledtrue数据库异常/攻击防护总开关
mysql.bruteforce_threshold / bruteforce_critical30 / 100认证/连接失败突增告警阈值(warning / critical,次/采集周期;critical=0 关闭)
mysql.drop_alerttrueDROP TABLE / DROP DATABASE 立即 critical 告警
mysql.dml_spike_threshold500DELETE/UPDATE/TRUNCATE/ALTER 每周期突增告警阈值

sqlite(监控 + 备份)

键默认含义
sqlite.interval_sec60SQLite 采集间隔(秒)
sqlite.backup_time / backup_keep / backup_compress03:00 / 7 / trueSQLite 公共备份默认(时刻 / 保留份数 / gzip 压缩)
sqlite.integrity_enabledtrue周期完整性检查(PRAGMA quick_check)开关
sqlite.integrity_interval_sec86400完整性检查间隔(秒,默认每天一次;异步执行不阻塞采集)
sqlite.shrink_pct30文件骤降告警比例(%),超过即记异常

portguard / pagekeep(拨测)

键默认含义
portguard.enabled / interval_sec / timeout_mstrue / 30 / 3000端口守护开关 / 默认间隔 / 默认超时
pagekeep.enabled / interval_sec / timeout_mstrue / 30 / 5000页面保活开关 / 默认间隔 / 默认超时

watchdog / push / guardian(上报与守护)

键默认含义
watchdog.enabledfalseWebhook 上报开关
watchdog.url / headers / template空上报地址 / 自定义头 / 模板
watchdog.timeout_sec10上报超时
watchdog.heartbeat_enabled / heartbeat_interval_sectrue / 360心跳开关 / 间隔(60–86400)
push.enabled / token / allow_ipsfalse / 空外部报警接收开关 / 鉴权 Token / IP 白名单
push.forwardtrue收到的报警转发看门狗
guardian.enabled / heartbeat_porttrue / 530双进程守护开关 / 心跳与蜜罐端口
guardian.ban_sec259200蜜罐封禁时长(秒),到期自动解封;0=永久

selfcheck / retention(自检与保留)

键默认含义
selfcheck.enabled / interval_sectrue / 3600自检开关 / 周期
selfcheck.extra_paths空附加受检路径
audit.retention_days90全部业务表保留天数(每日清理;可在「系统设置 → 数据保留」在线调整,7–3650,次日生效)

默认值速查(附录)

参数默认值修改位置
服务端口(API + 面板)529系统设置 → 通信端口
守卫 / 蜜罐端口530系统设置 → 通信端口
MySQL 采集间隔60 秒系统设置 → 数据库监控
MySQL 每日备份时间 / 保留份数03:00 / 7 份数据库监控 → MySQL 备份
系统指标采集间隔60 秒系统设置 → 系统指标
文件指纹 / 站点扫描周期6 分钟代码默认(DB 可改)
自检周期3600 秒代码默认(DB 可改)
磁盘默认阈值90%系统设置 → 系统指标 → 磁盘独立阈值
登录采集轮询间隔30 秒系统设置 → 登录监控
登录历史回填最近 30 天(启动时自动)系统设置 → 登录监控
看门狗心跳开启,360 秒看门狗页 / DB
Web 登录软锁5 次 / 300 秒,锁 900 秒登录监控 → Web 登录爆破防护
系统登录爆破封禁5 次 / 300 秒,封 3600 秒系统设置 → 登录监控
审计 / 各业务表保留90 天系统设置 → 数据保留(默认,可调 7–3650;后台每日清理)
初始密码随机生成init / user show 查看
客户端证书自动生成cert client -o x.p12 -name 名称(密码写入 <名称>.txt)
传输协议强制 HTTPS + mTLS移除 HTTP,客户端需导入 CA + 客户端证书(见 证书与首次登录)
各键对应的界面入口见 系统设置 与各功能手册页。
Qidun 启盾 v1.2.17 · 离线静态文档 · 界面基于 KuoqiUI · 返回首页