DeepFlow Docker 镜像文档

镜像概述

本镜像为 DeepFlow 项目的官方Docker封装，旨在为云原生开发者提供开箱即用的自动化可观测性解决方案。通过该镜像，用户可快速部署DeepFlow平台，实现对Kubernetes集群、微服务及分布式系统的全链路监控、性能分析与问题定位。

核心功能与特性

• 全链路追踪：自动发现服务依赖关系，生成分布式追踪链路，支持gRPC/HTTP/MySQL等多协议解析
• Metrics监控：内置丰富的云原生指标采集能力，覆盖Pod、Node、Service等K8s资源及应用层指标
• 日志分析：支持结构化日志解析与聚合查询，关联追踪数据与日志上下文
• 自动化配置：零侵入式部署，自动适配云原生环境，减少手动配置成本
• 多维度可视化：提供Web控制台，支持自定义仪表盘与告警规则配置

使用场景

• 云原生应用全生命周期可观测性管理
• 微服务架构下的性能瓶颈定位与优化
• 分布式系统故障排查与根因分析
• Kubernetes集群资源与应用性能监控
• DevOps流程中的持续可观测性集成

使用方法

基本部署（Docker Run）

docker run -d \
  --name deepflow \
  -p 8080:8080 \  # Web控制台端口
  -p 9090:9090 \  # Metrics采集端口
  -v /var/run/docker.sock:/var/run/docker.sock \  # 容器监控（可选）
  -e DEEPFLOW_MODE=standalone \  # 独立模式部署
  -e DB_TYPE=sqlite \  # 内置SQLite数据库（测试环境）
  deepflowys/deepflow:latest

Docker Compose部署（生产环境建议）

version: '3'
services:
  deepflow:
    image: deepflowys/deepflow:latest
    container_name: deepflow
    ports:
      - "8080:8080"
      - "9090:9090"
      - "6831:6831/udp"  # Jaeger追踪协议端口
    volumes:
      - ./data:/app/data  # 持久化数据目录
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - DEEPFLOW_MODE=cluster  # 集群模式（需外部数据库）
      - DB_HOST=mysql  # 外部MySQL地址
      - DB_PORT=3306
      - DB_USER=deepflow
      - DB_PASSWORD=your_password
      - DB_NAME=deepflow
    depends_on:
      - mysql

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=deepflow
      - MYSQL_USER=deepflow
      - MYSQL_PASSWORD=your_password
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

配置参数说明

访问控制台

部署完成后，通过 http://<宿主机IP>:8080 访问DeepFlow Web控制台，默认账号密码：admin/admin（首次登录需修改密码）。

注意事项

• 生产环境建议使用 cluster 模式并配置外部数据库（MySQL/PostgreSQL）
• 容器需挂载 docker.sock 或配置K8s API访问权限以采集容器/集群数据
• 高流量场景下建议调整资源限制（通过 --memory 和 --cpus 参数）