167 lines
3.3 KiB
Markdown
167 lines
3.3 KiB
Markdown
# 05 domainCheck Linux 部署清单
|
||
|
||
## 一、目标形态
|
||
|
||
- `domain-web`：提供运营管理后台
|
||
- `domain-api`：提供接口、日志、运行中心、导入导出能力
|
||
- `domainCheck`：继续承载检测核心与 Worker
|
||
- `PostgreSQL + Redis`：建议同机或同内网部署
|
||
|
||
## 二、服务器准备
|
||
|
||
- 操作系统：Ubuntu 22.04 / Debian 12 / Rocky Linux 9 均可
|
||
- Python：`3.11`
|
||
- Node：仅构建前端时需要，运行静态文件不强依赖
|
||
- PostgreSQL：建议 `14+`
|
||
- Redis：建议 `6+`
|
||
|
||
## 三、目录建议
|
||
|
||
```text
|
||
/opt/domaincheck
|
||
├── domain-api
|
||
├── domain-web
|
||
└── domainCheck
|
||
```
|
||
|
||
## 四、上线前核对
|
||
|
||
### 1. 数据库
|
||
|
||
- `domains`
|
||
- `detect_tasks`
|
||
- `domain_detections`
|
||
- `domain_blacklist`
|
||
- `sensitive_words`
|
||
|
||
确认这几张核心表已经存在。
|
||
|
||
### 2. Redis
|
||
|
||
确认可以正常读写：
|
||
|
||
- `domain_tool:detect_options`
|
||
- `domain_tool:proxy_config`
|
||
- `domain_tool:thread_count`
|
||
|
||
### 3. Worker 配置
|
||
|
||
确认 `domainCheck/.env` 已配置：
|
||
|
||
- `DB_HOST`
|
||
- `DB_PORT`
|
||
- `DB_DATABASE`
|
||
- `DB_USER`
|
||
- `DB_PASSWORD`
|
||
- `REDIS_HOST`
|
||
- `REDIS_PORT`
|
||
- `REDIS_PASSWORD`
|
||
|
||
### 4. Web/API 配置
|
||
|
||
确认 `domain-api` 使用：
|
||
|
||
- `WORKER_MODE=linux-systemd`
|
||
- `WORKER_SERVICE_NAME=domaincheck-worker`
|
||
- `API_SERVICE_NAME=domaincheck-api`
|
||
|
||
## 五、部署顺序
|
||
|
||
1. 上传 `domainCheck`
|
||
2. 上传 `domain-api`
|
||
3. 上传 `domain-web`
|
||
4. 创建 Python 虚拟环境并安装依赖
|
||
5. 初始化或连接 PostgreSQL/Redis
|
||
6. 先执行 `domainCheck/init_database.py` 初始化数据库结构
|
||
7. 安装 `systemd` 服务
|
||
8. 启动 `domaincheck-api`
|
||
9. 启动 `domaincheck-worker`
|
||
10. 验证 Web 后台与运行中心
|
||
|
||
### 数据库初始化
|
||
|
||
如果目标 PostgreSQL 是一套新库，必须先执行：
|
||
|
||
```bash
|
||
cd /opt/domaincheck/domainCheck
|
||
python3 init_database.py
|
||
```
|
||
|
||
执行完成后，建议至少确认这些表已存在：
|
||
|
||
- `domains`
|
||
- `detect_tasks`
|
||
- `domain_detections`
|
||
- `domain_blacklist`
|
||
- `sensitive_words`
|
||
|
||
如果未先初始化数据库，下面这些接口会因为 `UndefinedTable` 直接失败：
|
||
|
||
- `/api/v1/dashboard/overview`
|
||
- `/api/v1/detect/status`
|
||
- `/api/v1/imports/summary`
|
||
|
||
### 前端补充
|
||
|
||
`domain-web` 建议：
|
||
|
||
1. 复制 `.env.production.example` 为 `.env.production`
|
||
2. 修改 `VITE_API_BASE_URL`
|
||
3. 执行 `deploy/linux/publish.sh`
|
||
4. 使用 `deploy/nginx/domain-web.conf` 配置 Nginx
|
||
|
||
## 六、上线后验证
|
||
|
||
### 1. API
|
||
|
||
访问：
|
||
|
||
```text
|
||
http://服务器IP:8100/health
|
||
```
|
||
|
||
### 2. Web 后台
|
||
|
||
确认能正常完成：
|
||
|
||
- 登录
|
||
- 系统设置读取
|
||
- 域名筛选查询
|
||
- 导出列表查看
|
||
- 日志诊断查看
|
||
|
||
### 3. Worker
|
||
|
||
确认：
|
||
|
||
- 运行中心显示 Worker 在线
|
||
- 检测控制可读到当前进程数
|
||
- `detect_worker.log` 正常写入
|
||
|
||
## 七、切换策略
|
||
|
||
建议按下面顺序平滑切换：
|
||
|
||
1. `Web 后台` 先接管配置、筛选、导出、日志
|
||
2. `Linux Worker` 再逐步接管检测主任务
|
||
3. `Windows 桌面端` 暂时保留为备用入口
|
||
4. 运行稳定后，再考虑淡出桌面检测端
|
||
|
||
## 八、当前完成度
|
||
|
||
截至当前版本，已完成：
|
||
|
||
- Web 后台主页面
|
||
- API 接口主链路
|
||
- 运行中心
|
||
- Windows 本地 Worker 控制
|
||
- Linux systemd 控制模式支持
|
||
- systemd 模板文件
|
||
|
||
仍建议上线前重点复测：
|
||
|
||
- Linux systemd 实机启停
|
||
- Linux 下日志路径与权限
|
||
- 真实代理池在国内服务器上的表现
|
||
- 大批量导入与导出任务表现
|