Technitium DNS

使用此技能对 Technitium DNS Server 实例执行只读检查。

配置

运行脚本前，请设置以下环境变量：

export TECHNITIUM_URL="http://dns-server.example:5380"
export TECHNITIUM_TOKEN="..."

Technitium v15+ 支持以下格式的 API/会话令牌：

Authorization: Bearer 

建议为监控用途创建专用的、权限受限且仅具备只读权限的用户，并为其配置一个永不过期的 API token。

健康检查

运行内置辅助脚本：

python3 scripts/technitium_health_check.py

或从其他工作目录运行：

TECHNITIUM_URL="http://dns-server.example:5380" 
TECHNITIUM_TOKEN="..." 
python3 /path/to/technitium-dns/scripts/technitium_health_check.py

该脚本输出 JSON 格式结果：

{
  "ok": true,
  "checked": [],
  "failures": []
}

退出码说明：

• 0：无严重故障
• 1：一个或多个被监控项检测到严重异常
• 2：配置错误或核心 API/会话检查失败

检查内容

检查的均为只读接口：

• /api/user/session/get — 验证 token/会话有效性及获取服务器基本信息
• /api/settings/get — 获取版本号、运行时间戳、DNS 设置可用性等信息
• /api/dashboard/stats/get?type=LastHour&utc=true — 获取最近一小时 DNS 统计数据
• /api/zones/list — 检查是否存在已禁用、已过期或同步失败的区域（zone）
• /api/dhcp/leases/list — 检查 DHCP 租约可见性（若已启用且权限允许）

触发告警/失败的情形包括：

• API/服务器不可达
• token 无效或已过期
• 区域（zone）状态为 disabled、isExpired 或 syncFailed
• SERVFAIL/REFUSED/丢包等错误率异常升高

DHCP 权限不足将作为警告记录在 checked 字段中，因为许多部署并未启用 Technitium DHCP 功能，或已限制 DHCP 相关权限。

主动式使用建议

用于心跳检测与主动监控时，请遵循以下原则：

1. 仅在预定时间点执行健康检查；避免每次唤醒都重复检查。
2. 若返回 JSON 中 ok 值为 true，则保持静默，无需输出。
3. 若 ok 值为 false，仅汇总并报告可操作的失败项。
4. 未经用户明确确认，不得修改任何设置、区域（zones）、DHCP 配置、缓存或日志。

API 文档

Technitium DNS Server API 官方文档：
https://github.com/TechnitiumSoftware/DnsServer/blob/master/APIDOCS.md