Datalux/Osintgram
GitHub: Datalux/Osintgram
一款面向 Instagram 平台的 OSINT 侦察工具,通过交互式 shell 对公开账户进行多维度的信息收集与分析。
Stars: 13639 | Forks: 2957
# Osintgram 🔎📸
[](https://github.com/Datalux/Osintgram/releases/tag/1.3)
[](https://img.shields.io/badge/license-GPLv3-blue)
[](https://img.shields.io/badge/language-Python3-red)
[](https://t.me/osintgram)
[](https://img.shields.io/badge/Docker-Supported-blue)
Osintgram 是一个 Instagram 上的 **OSINT** 工具,用于收集、分析和执行侦察。
`
* 或直接执行您的命令 `python3 main.py --command `
* 或者通过环境变量使用 HikerAPI token 执行 `HIKERAPI_TOKEN= python3 main.py -c `
### 使用 Osintgram v2 (beta)
您只需切换到 `v2` [分支](https://github.com/Datalux/Osintgram/tree/v2)即可使用 Osintgram2 beta。
v2 进行了一些改进,并且凭借全新的命令执行界面运行速度更快。只需运行 `git checkout v2` 即可尝试。
## Docker 快速入门 🐳
本节将解释如何通过 `Docker` 或 `Docker-compose` 快速使用此镜像。
### 前置条件
在使用 `Docker` 或 `Docker-compose` 之前,请确保您已满足以下前置条件。
1. 已安装 **Docker** - [链接](https://docs.docker.com/get-docker/)
2. 已安装 **Docker-compose**(如果使用 Docker-compose)- [链接](https://docs.docker.com/compose/install/)
3. 已配置 **凭据** - 这可以手动完成,也可以通过在此代码库根目录下运行 `make setup` 命令来完成
**重要**:如果您没有执行第 3 步并配置您的凭据,您的容器将会运行失败
### Docker
如果已安装 docker,您可以构建镜像并将其作为容器运行。
构建:
```
docker build -t osintgram .
```
运行:
```
docker run --rm -it -v "$PWD/output:/home/osintgram/output" osintgram
```
- `` 是您希望作为侦察目标的 Instagram 账户。
- 必需的 `-i` 标志会开启一个交互式终端,以便在容器内使用命令。[文档](https://docs.docker.com/engine/reference/commandline/run/#assign-name-and-allocate-pseudo-tty---name--it)
- 必需的 `-v` 标志会在您的本地文件系统和容器之间挂载一个卷,以便保存到 `./output/` 文件夹。[文档](https://docs.docker.com/engine/reference/commandline/run/#mount-volume--v---read-only)
- 可选的 `--rm` 标志会在完成时移除容器文件系统,以防止残留垃圾堆积。[文档](https://docs.docker.com/engine/reference/run/#clean-up---rm)
- 可选的 `-t` 标志会分配一个伪 TTY,从而允许彩色输出。[文档](https://docs.docker.com/engine/reference/run/#foreground)
### 使用 `docker-compose`
您可以使用以下单条命令来运行 `docker-compose.yml` 文件:
```
docker-compose run osintgram
```
其中 `target` 是用于侦察的 Instagram 目标。
或者,您可以通过 `Makefile` 运行 `docker-compose`:
`make run` - 通过 compose 构建并运行。在运行之前会提示输入 `target`。
### Makefile (简单模式)
为了方便使用 Docker-compose,项目提供了一个 `Makefile`。
这是一个示例工作流,只需两条命令即可启动容器并运行 `osintgram`!
1. `make setup` - 设置您的 Instagram 凭据
2. `make run` - 构建并运行一个 osintgram 容器,并提示输入目标
用于开发的示例工作流:
1. `make setup` - 设置您的 Instagram 凭据
2. `make build-run-testing` - 构建并运行一个容器,而不调用 `main.py` 脚本。适用于进行 `it` Docker 开发会话
3. `make cleanup-testing` - 清理由 `build-run-testing` 创建的测试容器
## 开发版本 💻
要使用包含最新功能和修复的开发版本,只需使用 Git 切换到 `development` 分支:
`git checkout development`
并使用以下命令更新到最新版本:
`git pull origin development`
## 更新 ⬇️
要使用稳定版本更新 Osintgram,只需使用 Git 拉取最新的提交即可。
1. 确保您处于 master 分支,运行:`git checkout master`
2. 下载最新版本:`git pull origin master`
## 外部库 🔗
[Instagram API](https://github.com/ping/instagram_private_api)
标签:ESC4, Instagram, OSINT, Python, 实时处理, 无后门, 版权保护, 社交媒体分析, 请求拦截