getDomain/docs/08_domainCheck_交付说明.md

08 domainCheck 交付说明

一、当前交付范围

本次已交付：

• domainCheck 桌面版主项目
• domain-api 轻量后端接口服务
• domain-web 轻量运营管理后台
• Windows 本地联调脚本
• Linux 部署材料
• Linux 自检与发布验收文档

二、Windows 本地脚本

可直接使用：

• start_domain_api.ps1
• stop_domain_api.ps1
• start_domain_web.ps1
• stop_domain_web.ps1
• start_domain_web_background.ps1
• start_domain_stack.ps1
• stop_domain_stack.ps1
• smoke_test_stack.ps1

推荐整套启动：

powershell -ExecutionPolicy Bypass -File .\start_domain_stack.ps1

推荐整套停止：

powershell -ExecutionPolicy Bypass -File .\stop_domain_stack.ps1

推荐整套自测：

powershell -ExecutionPolicy Bypass -File .\smoke_test_stack.ps1

三、Web/API 默认地址

• Web：http://127.0.0.1:3200
• API：http://127.0.0.1:8100

四、配置迁移能力

系统设置页已经支持：

• 手动创建配置备份
• 下载配置备份
• 导出当前配置快照
• 导入配置快照

配置快照内容包括：

• 检测选项和执行顺序
• 代理配置
• 线程数
• Web/API 运行配置

推荐场景：

• Windows 测试环境导出配置
• Linux 正式环境导入配置
• 发布前先做一次配置备份
• 导入配置前系统会自动生成一份导入前备份

五、Linux 部署相关

请优先阅读：

• docs/05_domainCheck_Linux部署清单.md
• docs/07_domainCheck_WebLinux发布验收清单.md
• domain-api/deploy/linux/README.md
• domain-web/README.md

六、上线前建议

1. 跑 API 自检

cd /opt/domaincheck/domain-api
python deploy/linux/smoke_test.py --base-url http://127.0.0.1:8100

2. 打开运行中心

确认：

• API 在线
• Worker 在线
• 运行模式正确
• 部署自检通过

3. 打开日志诊断

确认：

• 可正常查看日志
• 可正常下载诊断包

4. 导出一次配置快照

确认：

• 可以成功下载 JSON 快照
• 导入后配置能恢复

七、当前结论

当前项目已经进入“可交付、可联调、可部署”的状态。

剩余工作重点不再是基础开发，而是：

• Linux 实机联调
• 上线前复测
• 真实服务器灰度验证

如果当前已经进入“海外单脑控制面 + 多机联调 + 准备发布”阶段，建议改为按下面顺序执行：

1. docs/25_domainCheck_海外单脑控制面上线收口总表.md
2. bash domain-api/deploy/multi-region/drive_ops_center.sh go-live-export
3. bash domain-api/deploy/multi-region/drive_ops_center.sh go-live-review
4. docs/26_domainCheck_发布前运行验证与交付模板.md