Deneth-Kavinda-00/octoclone
GitHub: Deneth-Kavinda-00/octoclone
一个基于 Python 的交互式网站克隆与侦察工具，集成子域名枚举、目录扫描等功能，用于授权安全测试的前期信息收集。
Stars: 0 | Forks: 0
# OctoClone 🐙
**版本：** v2025.08.13.GK0827
**作者：** MrSquidward
OctoClone 是一个基于 Python 的网站克隆和侦查工具。它允许用户：
* 克隆网站（HTML, CSS, JS, images）
* 通过 `crt.sh` 发现子域名
* 扫描隐藏目录（基于字典）
* 按扩展名下载文件
* 保存和加载项目配置
## 目录
1. [安装说明](#installation)
2. [依赖项](#dependencies)
3. [使用方法](#usage)
4. [可用命令](#available-commands)
5. [示例工作流](#example-workflow)
6. [配置](#configuration)
7. [字典](#wordlist)
8. [截图](#screenshots)
9. [许可证](#license)
10. [贡献](#contributing)
11. [故障排除](#troubleshooting)
12. [免责声明](#disclaimer)
## 安装说明
1. 克隆仓库：
```
git clone https://github.com/Squidward-Quincy-J-Tentacles/OctoClone.git
cd OctoClone
```
2. 安装 Python 依赖：
```
pip install -r requirements.txt
```
3. 可选：在 Linux/macOS 上使脚本可执行：
```
chmod +x octoclone.py
./octoclone.py
```
## 依赖项
* Python 3.x
* `requests`
* `beautifulsoup4`
* `colorama`
如有需要，请手动安装依赖：
```
pip install requests beautifulsoup4 colorama
```
## 使用方法
运行该工具：
```
python3 octoclone.py
```
你将看到如下提示符：
```
octoclone>
```
## 可用命令
在 OctoClone shell 中：
| 命令 | 描述 |
| -------------------- | ---------------------------------------- |
| `set url ` | 设置目标 URL |
| `set project ` | 设置项目文件夹路径 |
| `clone` | 克隆完整网站 |
| `verbose on/off` | 启用或禁用详细模式 |
| `subdomains` | 通过 crt.sh 查找子域名 |
| `subdirs` | 使用字典扫描隐藏目录 |
| `download <.ext>` | 下载特定文件类型 |
| `show config` | 显示当前设置 |
| `save config` | 将当前配置保存到文件 |
| `load config` | 从文件加载配置 |
| `cd ` | 更改工作目录 |
| `help` | 显示帮助 |
| `exit` | 退出工具 |
## 示例工作流
```
octoclone> set url https://example.com
octoclone> set project ~/Desktop/ExampleClone
octoclone> verbose on
octoclone> clone
octoclone> subdomains
octoclone> subdirs
octoclone> download .jpg
```
## 配置
OctoClone 支持保存/加载项目配置：
* 保存配置：
```
octoclone> save config
```
* 加载配置：
```
octoclone> load config
```
配置存储在 `octoclone_config.json` 中。
## 字典
包含一个示例 `common.txt` 字典用于隐藏目录扫描：
```
admin/
login/
dashboard/
config/
uploads/
images/
css/
js/
backup/
test/
```
你可以将其替换为你自己的自定义字典。
## 截图
1. 克隆网站
2. 子域名枚举
3. 目录扫描结果
## 许可证
MIT 许可证。详情请见 [LICENSE](LICENSE)。
## 故障排除
* **Python 版本错误：** 确保你使用的是 Python 3.x
* **找不到模块：** 运行 `pip install -r requirements.txt`
* **超时错误：** 检查你的网络连接或目标网站状态
* **权限错误：** 确保你对项目文件夹有写入权限
## 免责声明
本工具仅供**教育目的**使用。未经明确许可，请勿尝试克隆或访问网站。作者不对滥用行为负责。
标签：BeautifulSoup, CTF工具, ESC4, HTML下载, OSINT, Python, Splunk, VEH, WebRequest, 主机安全, 侦察工具, 大数据, 子域名枚举, 字典攻击, 安全测试, 密码管理, 攻击性安全, 数据展示, 无后门, 漏洞扫描辅助, 漏洞搜索, 目录扫描, 系统安全, 红队, 网站克隆, 网络信息收集, 网络安全, 脚本工具, 逆向工具, 隐私保护