hashtopolis/frontend

Hashtopolis Web UI Docker镜像文档

镜像概述与主要用途

Hashtopolis Web UI 是一个免费开源的平台，专为管理 hashcat 任务设计。本镜像为其官方 Angular 前端 Docker 镜像，提供基于 Web 的可视化界面，用于与 Hashtopolis 后端服务交互，实现对 hashcat 任务的全生命周期管理。

核心功能与特性

• 开源免费：遵循开源许可协议，代码完全公开可访问（https://github.com/hashtopolis/web-ui%EF%BC%89%E3%80%82
• 任务管理：提供直观的用户界面，支持 hashcat 任务的创建、配置、启动、暂停及终止。
• 状态监控：实时展示任务进度、执行状态及结果数据，便于用户跟踪任务动态。
• 现代前端框架：基于 Angular 构建，确保界面响应式设计与流畅的交互体验。

使用场景与适用范围

适用场景

• 安全测试与渗透测试中，批量管理 hashcat 密码破解任务。
• 密码恢复场景下，高效监控与调整破解任务配置。
• 研究环境中，对 hashcat 任务执行过程进行可视化分析与管理。

适用用户

• 安全工程师与渗透测试人员
• 负责密码恢复的系统管理员
• 密码学及网络安全研究人员

使用方法与配置说明

前置条件

• 已安装 Docker Engine（推荐 20.10+ 版本）或 Docker Compose。
• 已部署 Hashtopolis 后端服务（需获取后端 API 地址，供前端连接）。

Docker 部署方案示例

1. 基础 docker run 部署

bash
docker run -d \
  --name hashtopolis-webui \
  -p 80:80 \  # 映射主机端口（左侧）到容器内端口（右侧，默认80）
  -e API_URL=http://backend-server:8080/api \  # 后端API地址（必填）
  hashtopolis/web-ui:latest

2. Docker Compose 部署

创建 docker-compose.yml 文件，示例如下（包含前端与后端服务联动）：

yaml
version: '3.8'

services:
  # Hashtopolis 前端服务
  webui:
    image: hashtopolis/web-ui:latest
    container_name: hashtopolis-webui
    ports:
      - "80:80"  # 主机端口:容器端口
    environment:
      - API_URL=http://backend:8080/api  # 后端API地址（与后端服务互通）
      - NODE_ENV=production  # 运行环境（可选，默认production）
    depends_on:
      - backend  # 依赖后端服务启动
    restart: unless-stopped

  # Hashtopolis 后端服务（示例配置，具体参考后端文档）
  backend:
    image: hashtopolis/backend:latest  # 假设后端镜像名称
    container_name: hashtopolis-backend
    ports:
      - "8080:8080"  # 后端服务端口
    # 后端其他配置（如数据库连接、环境变量等）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

端口映射

容器内默认通过 80 端口提供服务，建议通过 -p <host-port>:80 映射到主机端口（如 80 或 8080），避免端口冲突。

社区支持

代码相关问题

• 提交 Bug 报告或功能需求：https://github.com/hashtopolis/web-ui/issues
• 贡献代码：通过 GitHub Pull Request 提交改进。

非代码支持

• 社区讨论、使用帮助、功能建议：通过 *** 服务器获取实时支持。

注意事项

• 版本状态：当前镜像处于 Beta 版本，仍在开发完善中，建议测试环境使用，生产环境需谨慎评估。
• 版本兼容性：确保前端与后端镜像版本匹配，推荐使用同一版本系列以避免兼容性问题。
• 官方文档：部署前建议参考 https://github.com/hashtopolis/web-ui/wiki 获取最新配置指南。