getDomain/domain-api

domain-api

domainCheck 轻量 Web 管理后台后端。

当前能力

• 提供健康检查、登录、概览、系统设置、域名导入、检测控制、筛选、导出、日志诊断接口
• 已接入真实 PostgreSQL / Redis / domainCheck 配置
• 已支持 windows-local 与 linux-systemd 两种 Worker 控制模式
• 已支持导入任务化、导出任务记录、基础运行状态探测

Windows 启动

在工作区根目录执行：

powershell -ExecutionPolicy Bypass -File .\start_domain_api.ps1

停止：

powershell -ExecutionPolicy Bypass -File .\stop_domain_api.ps1

日志默认输出到：

• domain-api/runtime/logs/domain-api.stdout.log
• domain-api/runtime/logs/domain-api.stderr.log

Linux / systemd

当后端迁到 Linux 时，建议：

• domain-api 独立为一个 systemd 服务
• domainCheck/detect_worker.py 独立为一个 systemd 服务
• .env 仍由 domainCheck/.env 统一提供数据库和 Redis 配置

参考模板：

• deploy/systemd/domain-api.service
• deploy/systemd/domain-worker.service

更完整的上线步骤见：

• deploy/linux/README.md
• ../docs/05_domainCheck_Linux部署清单.md

启用前请按实际路径修改：

• WorkingDirectory
• ExecStart
• User/Group

同时在环境中设置：

WORKER_MODE=linux-systemd
WORKER_SERVICE_NAME=domaincheck-worker
API_SERVICE_NAME=domaincheck-api

关键环境变量

• API_PREFIX
• API_HOST
• API_PORT
• WORKER_MODE
• WORKER_SERVICE_NAME
• API_SERVICE_NAME

环境变量样板可参考：

• .env.example

默认情况下：

• WORKER_MODE=windows-local
• Web 前端地址：http://127.0.0.1:3200
• API 地址：http://127.0.0.1:8100