hashview/hashview
GitHub: hashview/hashview
Hashview 是一个基于 Web 的分布式密码破解任务管理与数据分析平台。
Stars: 388 | Forks: 47
# Hashview v0.8.1
## 注意:如果您正在运行 v0.8.0 版本并希望升级。您只需要在主分支上执行 git pull 并启动 hashview.py,这应该会自动将您的实例升级到最新版本。
## 服务器要求
1. Python 3.7+
2. 已安装 MySQL 数据库,并具有已知的用户名/密码
3. 访问 SMTP 电子邮件服务(用于密码重置和通知)
## Agent 要求
1. Python 3.7+
2. Hashcat 6.2.x+
## 安装说明
请按照以下说明在 Ubuntu 20.04.3 LTS 服务器上安装 Hashview Server。理论上 Hashview 应该能够运行在任何 *nix 系统上,但开发人员仅在 Debian/Ubuntu 上进行过安装和测试。
#### 1) 设置 MySQL
```
sudo apt update
sudo apt install mysql-server
sudo service mysql start
sudo mysql_secure_installation
```
#### 2) 配置 MySQL
登录到您的 mysql 服务器并为 hashview 创建一个专用用户。Hashview 可以以 root 身份运行,但并非必须。而且既然我们践行我们所宣扬的,我们应该为此使用一个低权限账户。如果您正在安装 hashview 的服务器与运行 mysql 数据库的系统不同,请相应调整账户创建操作。
```
sudo mysql
CREATE USER 'hashview'@'localhost' IDENTIFIED BY 'DoNotUseThisPassword123!';
GRANT ALL PRIVILEGES ON hashview.* TO 'hashview'@'localhost';
FLUSH PRIVILEGES;
create database hashview;
exit
```
#### 3) 安装 Hashview Server
以下步骤用于在设置好 mysql 数据库后安装 hashview。
```
sudo apt-get install python3 python3-pip python3-flask
git clone https://github.com/hashview/hashview
cd hashview
pip3 install -r requirements.txt
./setup.py
./hashview.py # (note you can add a --debug if you are attempting to troubleshoot an issue)
```
#### 4) 登录您的 hashview 服务器
导航到您的服务器,默认端口是 8443。https://IP:8443
(注)
由于 hashview 是使用自签名证书安装的,您将会收到关于其无效的提示。欢迎您通过替换 `hashview/hashview/control/ssl/` 下的文件来使用正式签名的证书。
登录后,在开始破解哈希之前,您需要安装一个 Hashview-Agent。
## 安装 Hashview-Agent
安装 hashview 后,您需要安装一个 hashview-agent。Agent 可以运行在与 hashview 相同的系统上,但并非必须。
#### 1) 以管理员身份登录 hashview
#### 2) 导航到 Agents 菜单
#### 3) 点击 Download Agent 以获取 hashview-agent 的 .tgz 包
#### 4) 将 agent 移动到您希望运行它的系统上
#### 5) 安装 Agent
您需要解压该包并运行 `hashview-agent.py` 脚本。首次执行时,它会提示您输入有关 hashview 服务器的信息。
```
tar -xzvf hashview-agent..tgz
cd install/
cp -r hashview-agent ../
cd ../hashview-agent
pip3 install -r requirements.txt
python3 ./hashview-agent.py
```
#### 6) 运行后,您(或其他管理员)需要返回 Hashview->Manage->agents 并批准该 agent。
### 开发与贡献
请参阅[贡献指南](https://github.com/hashview/hashview/wiki/Contributing)以了解如何开发和贡献。
如果您有任何问题,请先查阅[Issues](https://github.com/hashview/hashview/issues)页面。如果您没有发现相关问题,请随意添加一个,我们会为您提供帮助。
### 功能请求
我们接受 Pull Requests :)。如果您希望获得某项功能但不想提交代码,请先检查 issues 部分以查看是否有人已经提出过该请求。如果是,请给该请求点赞。否则,请随时创建您自己的新功能请求。我们不承诺一定会实施,但提出来也无妨。
### 作者
在 Twitter 上联系我们
@jarsnah12
## 使用 Docker
提供了用于开发的基本 Docker 设置。它并不意味着可用于生产环境。使用风险自负。
### 1) 创建一个 `./hashview/config.conf` 文件,并根据需要进行自定义。请注意,hostname 应更改为 `db`,以便 app 容器能找到正确的主机
### 2) 务必更改 `docker-compose.yml` 中的 MYSQL_PASSWORD(并与 `config.conf` 中的值保持一致)。
### 3) 运行 `docker compose up`
## 测试
请参阅 `TESTING.md` 了解本地和 CI 测试工作流(包括开发 Docker 容器和 Playwright E2E)。
标签:Bitdefender, DOS头擦除, Flask, Hashcat, Python, SMTP邮件通知, Ubuntu部署, Web前端, Web管理界面, 代理节点, 分布式破解, 哈希分析, 密码分析, 密码审计, 密码破解, 无后门, 自动化任务, 请求拦截, 逆向工具