threatstack/ts-docker2

Threat Stack Agent 容器化镜像文档

1. 镜像概述

本镜像提供Threat Stack agent 2.0+版本的容器化部署方案，旨在将Threat Stack安全代理集成到容器环境中。Threat Stack agent是一款轻量级安全监控工具，能够实时收集系统活动数据、检测潜在威胁并生成安全告警，帮助用户监控容器及主机环境的安全状态。

2. 核心功能与特性

• 容器化部署：将Threat Stack agent封装为Docker镜像，支持在各类容器环境（如Kubernetes、Docker Compose）中快速部署
• 完整agent功能：包含Threat Stack agent 2.0+的全部核心功能，包括系统活动监控、威胁检测、日志收集与分析
• 轻量级运行：优化镜像体积，减少资源占用，适合在资源受限的容器环境中运行
• 配置灵活：支持通过环境变量或配置文件自定义agent参数，满足不同场景的监控需求

3. 使用场景

• 容器环境安全监控：监控Docker容器内的进程活动、网络连接、文件系统变化等，及时发现异常行为
• 云原生应用防护：为Kubernetes集群中的应用提供安全监控，检测容器逃逸、权限提升等威胁
• 混合环境统一监控：与主机端Threat Stack agent配合，实现物理机、虚拟机与容器环境的统一安全监控
• 合规性审计：满足PCI DSS、HIPAA等合规要求，提供系统活动日志与安全事件记录

4. 使用方法

4.1 基本部署（Docker Run）

使用以下命令启动Threat Stack agent容器：

bash
docker run -d \
  --name threatstack-agent \
  --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc:/host/etc:ro \
  -e THREAT_STACK_API_KEY="your-api-key" \
  -e THREAT_STACK_REGION="us" \
  threatstack/agent:latest

参数说明：

• --privileged：赋予容器必要的系统权限，以收集主机和容器的监控数据
• 挂载卷：/var/run/docker.sock用于获取Docker容器信息，/host/proc、/host/sys、/host/etc用于读取主机系统信息（只读）
• 环境变量：THREAT_STACK_API_KEY（必填）为Threat Stack平台的API密钥，THREAT_STACK_REGION指定服务区域（如"us"、"eu"）

4.2 Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  threatstack-agent:
    image: threatstack/agent:latest
    container_name: threatstack-agent
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /etc:/host/etc:ro
    environment:
      - THREAT_STACK_API_KEY=your-api-key
      - THREAT_STACK_REGION=us
      - LOG_LEVEL=info
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

5. 配置说明

5.1 环境变量

5.2 自定义配置文件

若需使用自定义配置文件，可通过挂载卷方式提供：

bash
docker run -d \
  --name threatstack-agent \
  --privileged \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc:/host/etc:ro \
  -v /path/to/custom/config.json:/etc/threatstack/config.json \
  -e THREAT_STACK_API_KEY="your-api-key" \
  threatstack/agent:latest

配置文件格式参考Threat Stack官方文档，支持自定义监控规则、数据过滤策略等。

6. 注意事项

• 容器需以--privileged模式运行，以确保agent能够正常收集系统级监控数据
• 挂载的主机目录需保持只读（ro），避免容器对主机系统造成意外修改
• API密钥需妥善保管，避免泄露导致未授权访问
• 定期更新镜像以获取Threat Stack agent的最新安全补丁与功能更新