threathuntproj/hunting

威胁狩猎与数据分析环境镜像

概述

该镜像包含完整的威胁狩猎与数据分析环境，基于Python、Pandas、PySpark和Jupyter Notebook构建。旨在通过提供"即开即用"的平台，简化分析型狩猎的入门流程，帮助用户快速开展相关工作。

下载镜像

可通过docker pull命令获取镜像，与其他Docker镜像操作方式一致。例如：

获取最新稳定版镜像：

bash
docker pull docker.xuanyuan.run/threathuntproj/hunting:latest

获取特定日期版本的镜像：

bash
docker pull docker.xuanyuan.run/threathuntproj/hunting:20180831

镜像通过CI系统自动构建，每次构建会生成包含日期代码和构建编号的镜像（如threathuntproj/hunting:20180831.37）。通常可忽略带构建编号的镜像，仅含日期代码的镜像始终是该日期的最新版本。

镜像内容

该镜像基于Jupyter PySpark官方镜像构建，并添加了狩猎相关的额外工具包。主要特性包括：

核心功能

• 支持传统Notebook界面和新的Lab界面
• 内置Notebook界面扩展管理器
• Python 3（默认）和Python 2内核

预装库

包含多个用于数据搜索、分析和可视化的预装库：

• elasticsearch-dsl
• splunk-sdk
• pandas
• pyspark
• numpy
• matplotlib
• seaborn
• plotly（支持cufflinks）
• scikit-learn
• ipywidgets

运行镜像

使用传统Notebook界面

bash
docker run -it -p 8888:8888 -e GEN_CERT=yes \
-v $WHERE_YOU_WANT_NOTEBOOKS_TO_LIVE:/home/jovyan/work \
docker.xuanyuan.run/threathuntproj/hunting:latest

使用Jupyter Lab环境

通过设置JUPYTER_ENABLE_LAB环境变量启用Lab界面：

bash
docker run -it -p 8888:8888 -e GEN_CERT=yes \
-e JUPYTER_ENABLE_LAB=yes \ 
-v $WHERE_YOU_WANT_NOTEBOOKS_TO_LIVE:/home/jovyan/work \ 
docker.xuanyuan.run/threathuntproj/hunting:latest

目录挂载说明

$WHERE_YOU_WANT_NOTEBOOKS_TO_LIVE可设为系统中的任何目录：

• 可设为$HOME以共享所有文件
• 也可使用特定子目录以限制文件共享范围

自定义模块支持

$WHERE_YOU_WANT_NOTEBOOKS_TO_LIVE/lib目录已添加到容器的PYTHONPATH中。在此目录安装Python模块后，Notebook可自动识别，无需重新构建镜像即可添加自定义模块。

访问Notebook环境

Notebook服务器启动后，会在控制台打印包含随机生成访问令牌的UI URL。点击或复制该URL到浏览器即可登录（令牌用于身份验证，替代密码）。

该镜像要求通过TLS访问Notebook，使用Kitematic等UI工具时需注意：Kitematic会生成HTTP URL，需手动改为HTTPS才能正常访问界面。