puppetma4ster/koyane-framework
GitHub: puppetma4ster/koyane-framework
一款模块化的字典生成、编辑、查找与分析框架,专为密码破解和道德安全测试设计。
Stars: 1 | Forks: 0
# Koyane-Framework :: 字典生成与分析工具包(早期阶段)
```
_ __ _____ __ __ ___ _ _ _____ ______ ______ ___ ___ ___ _____ _ _ _____ ______ _ __
| | / /| _ |\ \ / / / _ \ | \ | || ___| | ___|| ___ \ / _ \ | \/ || ___|| | | || _ || ___ \| | / /
| |/ / | | | | \ V / / /_\ \| \| || |__ ______ | |_ | |_/ // /_\ \| . . || |__ | | | || | | || |_/ /| |/ /
| \ | | | | \ / | _ || . ` || __| |______|| _| | / | _ || |\/| || __| | |/\| || | | || / | \
| |\ \\ \_/ / | | | | | || |\ || |___ | | | |\ \ | | | || | | || |___ \ /\ /\ \_/ /| |\ \ | |\ \
\_| \_/ \___/ \_/ \_| |_/\_| \_/\____/ \_| \_| \_|\_| |_/\_| |_/\____/ \/ \/ \___/ \_| \_|\_| \_/
Koyane-Framework :: wordlist forge & analysis toolkit
made by Puppetm4ster
```
**Koyane** 是一个模块化框架,用于生成、编辑、查找和分析字典,专为密码破解和道德安全测试而设计。
该项目以 *Ame-no-Koyane* 的名字命名,他是日本神话中的一位神明,代表着结构、仪式和言语的力量。
## 安装说明
### Makefile(推荐) koyane-framework 0.7.0-beta
到目前为止,安装仅在 Linux 操作系统上进行了测试。
由于程序的路径处理机制,它可能无法在 Windows 上运行。
未来版本也计划兼容 Windows。
#### 前置条件
- [golang](https://go.dev/) >= 1.25.0
- [make](https://www.gnu.org/software/make/)
Debian, Ubuntu:
```
sudo apt update
sudo apt install build-essential golang-go
```
- 其他使用的 go 库会在编译期间自动从源码下载。
#### 下载
下载最新版本 -> 解压目录 -> 进入程序目录:
```
wget https://gitlab.com/puppetm4ster/koyane-framework/-/archive/0.7.0-beta/koyane-framework-0.7.0-beta.zip?ref_type=tags
unzip koyane-framework-0.7.0-beta.zip\?ref_type\=tags
cd koyane-framework-0.7.0-beta
```
#### 构建与安装
你可以使用 **auto_install.sh** 进行安装
```
chmod +x auto_install.sh
sudo ./auto_install.sh
```
或者使用 make 手动安装
```
make build
sudo make install
make clean
```
#### 卸载
转到 **Makefile** 所在的项目目录并运行:
```
sudo make uninstall koyane-framework
```
### 从 pypi 安装 **(已过时)** koyane-framework 0.2.0-alpha
##### 不推荐使用此版本!
##### pypi 版本是一个非常早期的 alpha 版本。不推荐使用此版本。
你可以使用 pip 直接安装**已弃用**的构建版本:
```
pip install koyaneframework
```
## 状态:Beta
## 该项目目前处于早期开发阶段。功能有限且随时可能发生变更。
这是我第一个较大的代码项目,因此如果有什么改进建议,请发送至 **puppetma4ster@proton.me**,我将不胜感激。
我会尽量每周更新一次该项目。
## 功能
该程序作为一个实用的框架,用于开发、编辑、分析和查找字典,可应用于
密码哈希分析、目录发现、Web 模糊测试等领域。
以下功能按模块列出:
### 1. 生成 (kyfgen)
+ 支持使用 ?d(数字)等多种通配符的掩码生成,以及
使用 ! 的固定字符段(例如 !A 代表 'A',!abc123 代表自定义字符集)。
+ 从 hashcat potfile 中提取密码
+ 支持字符串排列
### 2. 编辑 (kyfedit)
+ 字典排序
+ 按长度移除单词
+ 移除匹配特定掩码的单词
+ 移除包含指定字符的单词
+ 过滤掉所有非欧洲字符的单词
### 3. 分析 (kyfinfo)
+ 分析字典的基本信息
+ 统计行数
+ 单词长度统计
+ 复杂度指标
+ 字符统计与频率分析
### 4. 查找外部字典 (kyfdb)
+ 搜索并过滤外部字典的统计数据
+ 在终端中下载它们
### 通用功能
+ CLI 界面
+ 基础状态消息
**尚未实现:**
- 去重与合并
- TUI 或富文本 CLI 前端
- 基于目标信息(姓名、位置、职业、爱好、生日等)的上下文生成
- 从字典中提取并构建规则
- 控制台版本
## 目标
Koyane 旨在成为一个快速、模块化且可脚本化的框架,用于:
- 使用规则、掩码、模板和个人上下文生成字典
- 大规模列表处理与清理
- 格式转换与统计检查
- 用于密码审计和红队工作流的高效 pipeline
## 示例用法
```
kyfgen -M !AS?l?l?l?lL?d?d?! -o ~/MyList.txt
kyfinfo --all ~/MyList.txt
kyfedit -r 8:* --european ~/MyList.txt ~/EditList.txt
kyfdb search --biggest-word 8:14 --smallest-word 8:8 --digits-perc 30.0:*
kyfdb show 22
kyfdb get -p ~/OuterList 22
```
## 许可证
本项目基于 Apache License 2.0 授权。
你可以自由使用、修改和分发它,前提是你必须包含适当的归属说明并保留该许可证。
完整的许可证文本请参见 [LICENSE](LICENSE) 文件。
## 免责声明
Koyane 仅用于**教育目的**和**授权的安全测试**。
作者坚决反对将此工具用于任何非法、不道德或压迫性目的。
**负责任地使用。打破常规,不触犯法律。**
标签:DOS头擦除, EVTX分析, Go, Ruby工具, 字典分析, 密码破解, 日志审计