CheckTMDB-Next

一站式 DNS 检查与 Hosts 管理工具。通过多源 DNS over HTTPS (DoH) 回退查询和 TCP 延迟测速，自动为 TMDB / IMDb / TVDB 等影视元数据站点生成最优 hosts 文件，解决 DNS 污染导致的访问问题。

功能特性

• 多源 DoH 回退查询 — 阿里 DNS、360 DNS、Google DNS 三个 DoH 源，遵循 RFC 8484，自动回退
• TCP 延迟测速 — 对解析到的 IP 进行 TCP 443 端口延迟测试，选择最快节点
• Hosts 自动生成 — 支持合并 GitHub520 等公共 hosts 源，生成格式标准的 hosts 文件
• Web 可视化管理 — React SPA 仪表盘，任务状态、DNS 结果、延迟图表一目了然
• 定时任务调度 — 内置 cron 触发接口，可配合群晖任务计划或 crontab 定期更新
• RESTful API — 完整 API 支持 JWT 认证，适合自动化集成

技术栈

层级	技术
后端	Go 1.22+ / Gin / GORM / SQLite（纯 Go，免 CGO）
前端	React 19 / TypeScript / Vite / Recharts
认证	JWT Bearer Token + API Key（内部接口）
DNS	DoH (RFC 8484) / TCP Ping

快速开始

环境要求

• Go 1.22+
• Node.js 18+

启动开发服务

# 后端（端口 8989）
make dev-server

# 前端（端口 5173，自动代理 API 到后端）
make dev-web

浏览器访问 http://localhost:5173，默认账号 admin。密码在首次启动时随机生成并输出到终端（stderr），请注意查看。

构建

make build-all       # 编译 server + cli
make build-web       # 编译前端
make release         # 交叉编译 Linux amd64 + arm64 + 前端

文档

文档	说明
系统设计	架构设计、模块划分、数据流
API 文档	全部 21 个 API 端点的详细说明
通用部署	环境要求、编译、systemd、Nginx 反向代理
群晖部署	DSM 7.x 详细部署指南
Hosts 写入功能	系统 hosts 修改原理、使用方式、安全机制、常见问题
使用说明	Web 界面操作、CLI 工具、定时任务
常见问题	FAQ 及故障排查

许可证

MIT License