FAQ 与版本历史

安装与连接类 FAQ

问题	解答
浏览器访问 529 直接报错（ERR_HTTP_RESPONSE_CODE_FAILURE / 连接重置）？	529 是 HTTPS + mTLS：确认用了 https://，且浏览器已导入 CA 与客户端证书（证书与首次登录）。
为什么 530 端口浏览器打不开？	530 是守卫心跳 / 蜜罐端口，属于浏览器「不安全端口」列表，浏览器主动拒绝 —— 这是正常且预期的（安全设计）。
访问 530 的陌生 IP 被封了怎么办？	蜜罐生效了。误触（如监控拨测）请在防火墙页解封，并把探测源加入白名单。
杀毒软件报 qidun 可疑？	确认从可信渠道获取；构建时未使用 -s -w 压缩 / UPX。webshell 特征库已编码存储，如仍误报请加白名单。
初始密码忘了？	未修改过：qidun user show 可再看；改过：本机 qidun user set-password -p 新密码。
必须两个服务都装吗？	推荐双进程（互保 + 蜜罐）；确实只想要单进程可 service install guard 前跳过，但会失去互保能力。
登录提示「登录尝试过于频繁」？	Web 登录防护软锁生效，等待锁定结束；或到「登录监控 → Web 登录爆破防护」解锁该 IP（登录监控）。

功能类 FAQ

问题	解答
页面保活与端口守护有什么区别？	端口守护只测 TCP 端口通不通；页面保活真正发起 HTTP 请求并校验状态码，还记录响应大小与快照（页面保活）。
FIM 为什么一直报变更？	监测了高频写入的目录（日志 / 缓存）。这类目录应改用缓存目录管理；合法变更后点「重置指纹」。
后门防护误报正常文件？	特征扫描存在误报可能，先人工核对内容；确认误报后把路径片段加入「忽略目录」。
MySQL 备份怎么恢复？	面板不做在线恢复（防误操作），按恢复方法用 mysql < 备份文件 导入。
系统指标阈值在哪改？	系统设置 → 系统指标阈值，支持逐盘独立阈值（系统设置）。
数据存哪里？能保留多久？	SQLite 单库（数据目录下），默认保留 180 天自动清理（技术架构）。
页面保活监控 mTLS 站点失败？	拉取器不携带客户端证书，无法访问强制双向认证的站点，属预期行为。
MySQL 一直显示连接错误？	采集间隔默认 60 秒；账号需具备 SHOW GLOBAL STATUS 权限，可在实例「测试」确认连接；未配置有效账号时仅记录错误，不崩溃（MySQL 监控）。
双进程守护会不会互相「打架」导致服务抖动？	心跳基于回环地址，互不影响；受控重启请同时停止两个进程（或关闭守护开关），避免一方把另一方拉起。

告警与上报 FAQ

问题	解答
告警发到哪里去了？	看门狗 Webhook（自配 URL）。未配置时告警仍在「总览 / 系统日志」可见，只是不外发。
同一告警会反复发吗？	各模块有去重窗口（详见告警参考），down 类只在状态跳变时发。
上报失败怎么办？	自动 30 秒重试最多 4 次；「看门狗 → 上报记录」可查失败原因，修复后可等下轮或点发送测试。
多台服务器告警能汇总吗？	可以：A 台配置「报给其他 Qidun」，B 台开启外部报警接收（看门狗上报）。
升级后一直报「疑似被篡改」？	正常：到「系统自检」页重置基线（系统自检）。

版本历史

版本	主要内容
v1.2.17	性能与存储优化 + 保留期可配：历史数据保留期默认由 180 天改为 90 天，并可在「系统设置 → 数据保留」在线修改（7–3650 天，次日清理生效、无需重启），新增「压缩数据库 (VACUUM)」按钮；仪表盘/登录监控「今日/按日」统计改为可命中索引的时间范围查询，补齐缺失时间索引；保留期清理改分批删除；TrendAll 改单次窗口函数查询；WebUI 静态资源启动预压缩 gzip 传输。
v1.2.16	数据库监控基础防护：MySQL 认证/连接失败突增检测与破坏性语句检测（DROP 即 critical）；攻击来源自动封禁（查询 performance_schema.host_cache，按来源超阈自动防火墙封禁，开关/阈值/时长按实例独立配置，白名单与回环永不封禁）；SQLite 周期完整性检查与篡改检测；MySQL 可选连接 TLS、连接测试权限降权提示、日志密码脱敏；超阈值一律记异常，看门狗上报 category 统一 mysql，封禁失败亦记异常。详见 MySQL 监控、系统设置、防火墙。
v1.2.14	防火墙配置集中化：自动封禁配置与系统防火墙开/关统一移至「系统设置 → 防火墙配置」；防火墙页未开启时门禁化（仅显示「防火墙未开启，请先开启防火墙」+ 一键开启按钮），开启后展示完整台账。
v1.2.17	修复中文 Windows 系统防火墙状态误报：Windows 系统防火墙状态检测改直接读取注册表（GPO 优先 / 本地存储 / 缺省视为开启，与系统语言无关），修复中文等多语言系统下 netsh 输出本地化编码导致解析失败、面板恒显示「防火墙未开启」门禁、一键开启提示成功但刷新依旧的问题；netsh 解析保留为注册表读取异常时的回退。
v1.2.13	防火墙新增系统防火墙状态检测与一键开启/关闭（Windows netsh advfirewall 三档 / Linux ufw·firewalld）；一键开启默认放行常用端口 22/80/443/3389 与本面板 529/530（写入端口规则列表可维护，先放行再开启防自锁），关闭需二次确认并写审计 + 看门狗 critical。
v1.2.12	稳定性与前端安全：修复 portguard/pagekeep 热重载数据竞争；保留期清理不再删永久封禁并回收 WAL；sysmetrics 采集超时守卫 + 批量写失败落日志；长任务单独延长写截止；push 去重表容量治理；WebUI 会话改 HttpOnly Cookie（去 localStorage）+ CSP connect-src 'self' + HSTS/Referrer-Policy/Permissions-Policy；新增 scripts/check.sh。
v1.2.11	P1 可靠性：webshell 扫描串行化 + 隔离一致性回滚；FIM 拒绝 FIFO/软链、错误落事件、mtime 纳秒精度；keyops 指纹索引与保留期；MySQL/SQLite 备份兼容 5.7/MariaDB 与级联清理；watchdog 发送认领与日志轮转；蜜罐封禁异步化；客户端证书自动续签与 CA 链校验。
v1.2.10	安全加固：修复 syslog 接口 SQL 注入；随机机器密钥 secret.key 替代主机名派生；数据/库文件权限 0700/0600；Config 并发加锁；webshell 拒绝非常规文件与 NUL 前缀绕过；Windows PDH 布局修复；Linux 缓存目录修复。
v1.2.9	登录爆破封禁可靠性：修复重启/规则丢失后旧封禁记录永久占坑的死锁，新增启动与每 10 分钟对账重建规则、到期解除；新增 IPv6 封禁；解析 Invalid user / maximum authentication attempts exceeded；默认封禁时长 1 小时 → 3 天。
v1.2.8	登录监控：不再记录 sshd 连接噪声行（Received disconnect from ... / POSSIBLE BREAK-IN ATTEMPT），登录事件不再出现空「用户 / IP / 结果」行，统计计数不再被公网扫描器灌水；日志显示：通用日志列表的 DATETIME 列统一转本地时间字符串，修复 2026-09-28 06:41:43 +0000 UTC 原始格式显示。
v1.2.7	服务管理（Linux/systemd）：修复卸载后 systemd 残留的占位单元（LoadState=not-found，无法启动任何进程）被误判为「仍已安装」的问题——service uninstall 改为以「磁盘 unit 文件 + systemd 实际加载态」双重口径回验，占位符视为已卸载并正常返回成功；service status 对该残留态显示「已安装: 否」，不再中途报错。
v1.2.6	服务管理（Linux/systemd）：service uninstall 卸载后强制清扫并回验，删除残留 unit 文件与 systemd 内存加载，不再出现「已卸载却仍显示已安装」；service status 的「已安装 / 状态 / 说明」统一判定口径，消除自相矛盾输出；Windows 与其他平台行为不变。
v1.2.5	看门狗：移除 Webhook URL 回环限制（本机 / 回环 / 局域网 / 公网均可，便于同机多实例互报）；「发送测试」改为直接使用表单当前值（无需先保存、停用状态亦可测），并展示请求头 / 请求体 / 响应头 / 响应体 / 状态码 / 耗时详情卡片。
v1.2.0	新增 MySQL 备份（mysqldump 定时 / 手动 / gzip / 保留策略 / 卡死中止，实例级覆盖公共配置）；新增 页面保活 模块（状态码校验 / 响应快照 / 连续失败阈值）；侧栏新增「站点防护」分组（后门防护 / 页面保活 / 端口守护）；系统日志新增「页面保活」模块。
v1.1.0	API 与面板合并为单端口 529（HTTPS + mTLS）；修复 6 项高危与 12 项中危问题。
v1.0.0	首发：登录监控 / Web 登录防护 / 文件指纹 / 站点后门扫描 / MySQL 监控 / 系统指标与磁盘 IO / 关键操作审计 / 看门狗 Webhook / 系统自检（SHA-256 + HMAC）/ 双进程守护与守卫蜜罐 / 系统日志。