跳转至

文档中心

返回项目首页

首次使用从项目首页的快速开始进入;部署与日常操作按主题查阅,开发时参考协议或维护指南。

入门与操作

文档 内容
服务端部署指南 部署选型、两端安装顺序、原生托管、升级恢复与验收
Docker 构建与部署 Compose、首次登录与联调、持久化、升级排障及镜像构建发布
Docker 完整配置参考 全部 env 参数、类型、默认值、生效方式、Compose 设置及受限字段
服务端功能指南 功能入口、交互约束与配置示例
用户管理 CLI 用户、凭据、会话和登录限制的本地管理
资产搜索语法与 API 搜索字段、表达式语法与 API 契约

外部 API 与开放平台

文档 内容
外部 API v1 80 项接口、授权、请求参数、数据口径与示例
管理与上线 管理 Web、审批、密钥、回调、部署和停用
实现与回归 模块、数据模型、事务边界和检查
OpenAPI 3.1 可导入工具的机器可读规范

扫描与资产

文档 内容
扫描计划与结果协议 扫描阶段、能力声明和结果上传协议
双栈扫描、协议能力与自动目标 IPv4/IPv6 能力调度与自动目标生成
DNS 测绘 DNS 任务与解析结果处理
搜索触发目标更新 搜索触发更新的范围、去重与限制
资产端口状态与历史 端口当前状态与历史记录语义
扫描器任务恢复协议 服务端任务恢复与检查点协议

存储与分析

文档 内容
Elasticsearch 9.5.x 扫描结果存储 新安装、存储切换与历史数据迁移
扫描写入与后台资产发布 上传边界、投影租约、检查点与写入观测
扫描写入压力测试 大数据写入方法、延迟分布、吞吐与实测记录
扫描分析快照 分析快照模式与回填
统计分析 自定义汇总、图表及图片和数据导出
平台周报与月报 周报、月报、发送计划与归档

运维与诊断

文档 内容
服务端运行时配置 配置来源、发布接口及当前实现边界
扫描器错误诊断与日志采集 远程错误事件、日志采集与服务端治理
请求日志与错误识别 请求采集、查询与错误分类
审计日志 操作审计与查询约定
健康监控与告警 监控阈值、慢 SQL 和邮件告警
pgBackRest 备份管理使用指南 备份部署、权限、执行与恢复验证
系统业务时区与常规设置 业务时区与时间展示规则
系统资源读取与慢依赖隔离 资源读取、缓存与慢依赖处理

文档维护约定

  • README 提供项目定位、快速开始和主要入口;详细参数、协议及排障保留在专题文档。
  • 接口、配置或行为变更时,同步更新使用说明及配套组件文档。
  • 示例使用脱敏值,命令注明运行位置,代码块标明语言。
  • 区分当前实现与后续计划,保持相对链接和文档索引有效。

  • 智能目标与扫描器分配:地域调度、自动刷新、任务组与目标连接反馈。