hashtopolis/agent

Hashtopolis Python Agent Docker镜像

该镜像为Hashtopolis官方Python代理镜像，用于与Hashtopolis服务器（版本0.5.0及以上）协同工作，实现分布式哈希破解任务。用户可通过配置连接服务器，执行由服务器分配的哈希破解任务（如使用Hashcat工具）。

核心功能

• 与Hashtopolis服务器通信，接收并执行哈希破解任务；
• 支持Hashcat等多种破解工具（兼容版本见下文）；
• 提供命令行参数及配置文件两种方式进行设置；
• 支持自动更新（需保持镜像内代理的zip包结构）；
• 支持rsync和multicast方式分发文件（如字典、规则文件）；
• 可配置调试模式、路径设置、代理支持等选项。

使用场景

• 企业密码恢复: 管理员用于找回丢失的内部系统用户密码；
• 安全测试: 安全团队在渗透测试中评估目标系统的密码强度；
• 研究分析: 研究机构对哈希算法安全性进行测试与分析。

配置说明

命令行参数

镜像支持以下关键命令行参数：

--voucher VOUCHER    # 注册使用的凭证
--url URL            # Hashtopolis API端点地址
--debug              # 启用调试模式
--cpu-only           # 仅使用CPU执行任务

配置文件

首次运行镜像时，代理会自动生成config.json配置文件，示例如下：

json
{
  "url": "https://example.org/hashtopolis/api/server.php",
  "token": "ABCDEFGHIJ",
  "uuid": "49dcd31c-3637-4f2a-8df1-b545202df5b3"
}

主要配置选项：

Docker部署示例

基本运行（挂载配置目录）

bash
docker run -d \
  -v /path/to/local/config:/app/config \
  docker.xuanyuan.run/hashtopolis/agent

说明：/path/to/local/config为本地目录，用于持久化config.json文件。

带命令行参数运行

bash
docker run -d \
  -v /path/to/local/config:/app/config \
  docker.xuanyuan.run/hashtopolis/agent \
  --url https://your-hashtopolis-server/api/server.php \
  --voucher YOUR_REGISTRATION_VOUCHER \
  --debug

Hashcat兼容性

该代理支持以下Hashcat版本（其他版本可能也兼容）：

• 7.1.1、7.1.0、7.0.0
• 6.2.6 ~ 6.0.0
• 5.1.0、5.0.0
• 4.2.1 ~ 4.0.0

通用破解工具支持

该代理支持符合Hashtopolis最小功能要求的通用破解工具，详情可参考https://github.com/s3inlc/hashtopolis/tree/master/doc/README.md%E5%8F%8Ahttps://github.com/hashtopolis/generic-***er%E3%80%82