Jackhammer多环境部署指南：从开发到生产的完整配置方案

Jackhammer多环境部署指南：从开发到生产的完整配置方案

【免费下载链接】jackhammerJackhammer - One Security vulnerability assessment/management tool to solve all the security team problems.项目地址: https://gitcode.com/gh_mirrors/ja/jackhammer

Jackhammer是一款全面的安全漏洞评估与管理工具，能够帮助安全团队解决各类安全问题。本指南将详细介绍如何在不同环境中部署Jackhammer，从开发测试到生产环境，提供完整的配置方案，让你快速上手这款强大的安全工具。

环境准备：快速搭建部署基础

在开始部署Jackhammer之前，需要确保你的系统满足以下基本要求：

• Docker和Docker Compose已安装
• 至少2GB内存和20GB可用磁盘空间
• Git工具

首先，克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/ja/jackhammer cd jackhammer

项目提供了两种Docker Compose配置文件，分别适用于不同场景：

• docker-compose-with-no-marathon.yml：适用于开发和测试环境，不包含Marathon组件
• docker-compose-with-marathon.yml：适用于生产环境，包含完整的Marathon和Mesos集群

开发环境部署：轻量级快速启动方案

开发环境部署旨在快速启动服务，方便开发和测试，不需要复杂的集群配置。

一键启动开发环境

使用不带Marathon的配置文件启动开发环境：

docker-compose -f docker-compose-with-no-marathon.yml up -d

这个配置文件定义了三个主要服务：

• mysqldb：MySQL数据库服务，使用5.7版本
• jch-server：Jackhammer后端服务
• jch-client：Jackhammer前端服务

开发环境配置说明

开发环境的主要配置位于docker-compose-with-no-marathon.yml文件中：

• 数据库默认凭据：用户名jch，密码jch，数据库名jackhammer
• 后端服务端口映射：8081:8080
• 前端服务端口映射：5005:8080
• 禁用Marathon：ENABLED_MARATHON: 'false'

服务启动后，可以通过http://localhost:5005访问Jackhammer前端界面。

生产环境部署：高可用集群配置

生产环境需要更高的可用性和可扩展性，因此我们使用包含Marathon和Mesos的完整配置。

生产环境架构组成

生产环境配置(docker-compose-with-marathon.yml)包含以下组件：

• 数据库层：MySQL数据库服务
• 应用层：Jackhammer前后端服务
• 编排层：Marathon服务编排
• 集群层：Mesos主从节点和Zookeeper协调服务

启动生产环境集群

docker-compose -f docker-compose-with-marathon.yml up -d

这个命令会启动所有必要的服务，包括Zookeeper、Mesos Master、Mesos Slave和Marathon。

生产环境关键配置

生产环境的关键配置项：

• Marathon端点：http://marathon:8080
• 资源分配：Mesos Slave配置了10个CPU核心、30GB内存和40GB磁盘
• 网络配置：使用自定义子网172.16.121.0/24
• 自动扩展：启用工具实例自动扩展功能

核心配置文件详解：定制你的Jackhammer

Jackhammer的核心配置文件是config.yml，通过修改这个文件可以定制系统的各种行为。

服务器配置

server: type: simple applicationContextPath: / connector: type: http port: 8080

数据库连接配置

database: driverClass: com.mysql.jdbc.Driver user: jch password: jch url: jdbc:mysql://mysqldb:3306/jackhammer

扫描管理器配置

scanManagerConfiguration: threadPoolSize: 5 # 线程池大小 initialDelay: 60 # 启动延迟时间(秒) period: 60 # 扫描周期(秒) alertMails: # 告警邮件地址 wpScanAlerts: true # WordPress扫描告警开关

工具管理器配置

toolManagerConfiguration: threadPoolSize: 5 # 线程池大小 initialDelay: 60 # 启动延迟时间(秒) period: 60 # 检查周期(秒) enableAutoScaling: true # 启用自动扩展

部署验证：确保系统正常运行

部署完成后，需要进行一些基本检查以确保系统正常运行。

检查服务状态

docker-compose -f [配置文件] ps

应该能看到所有服务都处于"Up"状态。

访问Web界面

• 开发环境：http://localhost:5005
• 生产环境：http://[服务器IP]:5005

查看日志

docker-compose -f [配置文件] logs -f jch-server

检查是否有错误信息，确保服务正常启动。

常见问题解决：部署过程中的挑战

数据库连接问题

如果出现数据库连接错误，检查config.yml中的数据库配置，确保与Docker Compose中的数据库服务配置一致。

端口冲突

如果启动时提示端口已被占用，可以修改Docker Compose文件中的端口映射部分，将主机端口改为未被占用的端口。

资源不足

生产环境需要较多资源，如果出现服务启动失败或运行缓慢，检查系统资源是否满足要求，特别是Mesos Slave的资源配置。

最佳实践：优化你的Jackhammer部署

数据持久化

确保数据库数据目录正确挂载，避免容器重启导致数据丢失：

volumes: - mysql-data:/var/lib/mysql

安全配置

生产环境中应修改默认密码和密钥：

• 修改数据库密码
• 更新JWT签名密钥(config.yml中的tokenSigningKey)
• 配置HTTPS

监控与维护

定期备份数据库，监控系统资源使用情况，特别是在生产环境中，确保Jackhammer能够高效稳定地运行。

通过本指南，你已经了解了如何在不同环境中部署Jackhammer，从简单的开发测试环境到复杂的生产集群。根据你的实际需求选择合适的部署方案，并通过配置文件定制系统行为，让Jackhammer成为你安全团队的得力助手。

【免费下载链接】jackhammerJackhammer - One Security vulnerability assessment/management tool to solve all the security team problems.项目地址: https://gitcode.com/gh_mirrors/ja/jackhammer