Flowsint 是一款开源的 OSINT 图谱探索工具,专为道德调查、透明度和验证而设计。
伦理声明: 请阅读 ETHICS.md 了解负责任的使用准则。
https://github.com/user-attachments/assets/eaabfa81-d7b3-414d-8cf7-f69b4e37bab6
https://github.com/user-attachments/assets/7457d94a-cf1d-4a97-949f-f9b1d8d92644
https://github.com/user-attachments/assets/65c3f26e-7132-4853-be45-21b8933688bd
Flowsint 仍处于早期开发阶段,非常需要社区的帮助!欢迎提交 issue、提出功能建议等。
不想看文档?没问题。以下是安装说明:
git clone https://github.com/reconurge/flowsint.git
cd flowsint
make prod
无需 Make。在 命令提示符 (cmd) 和 PowerShell 中均可使用。
git clone https://github.com/reconurge/flowsint.git
cd flowsint
copy .env.example .env
copy .env.example flowsint-api\.env
copy .env.example flowsint-core\.env
copy .env.example flowsint-app\.env
docker compose -f docker-compose.prod.yml up -d
这会从 GitHub Container Registry 拉取预构建镜像——无需本地构建。
然后访问 http://localhost:5173/register 创建账户。默认情况下没有预置的凭据或账户。
✅ OSINT 调查需要高度的隐私保护。所有数据均存储在你的本机。
相同的配置可直接在服务器上使用:前端既提供 UI 界面,又在内部代理所有 API 调用,因此客户端无需额外配置。
git clone https://github.com/reconurge/flowsint.git
cd flowsint
cp .env.example .env
# 编辑 .env — 参见下方"暴露到网络前"
docker compose -f docker-compose.prod.yml up -d
网络中的任何用户都可以通过 http://<服务器IP>:5173 访问 Flowsint。
在暴露到网络之前,请修改 .env 中的默认密钥:
AUTH_SECRET — 用于签署认证令牌。生成方式:openssl rand -hex 32MASTER_VAULT_KEY_V1 — 用于加密存储的 API 密钥。生成方式:python3 -c "import os, base64; print('base64:' + base64.b64encode(os.urandom(32)).decode())"NEO4J_PASSWORD — Neo4j 数据库密码。同时将你的服务器主机名/IP 添加到 Host 头白名单,位置在 flowsint-app/nginx.conf(查找 map $http_host $is_flowsint_host)。默认白名单仅接受 localhost / 127.0.0.1 / [::1],这可以保护单用户安装免受 DNS rebinding 攻击;局域网和公网部署必须自行添加自己的主机名。同一 map 块中有两行注释掉的模板行展示了格式。
只有端口 5173 暴露到网络。PostgreSQL、Redis、Neo4j 和 API 均绑定到服务器的 127.0.0.1,只能通过前端代理访问。
如需固定到特定版本而非 latest,请在 .env 中设置 FLOWSINT_VERSION(例如 FLOWSINT_VERSION=1.2.10)。
HTTPS(建议在可信局域网之外使用): 在 5173 端口前放置任意反向代理。使用 Caddy 的示例:
flowsint.example.com {
reverse_proxy 127.0.0.1:5173
}
使用反向代理时,还需在 docker-compose.prod.yml 中将应用端口绑定到 localhost("127.0.0.1:5173:8080"),以确保客户端只能通过 HTTPS 访问。
Flowsint 是一款基于图谱的调查工具,专注于侦察和 OSINT(开源情报)。它允许你通过可视化图谱界面和自动化增强器探索实体之间的关系。
域名增强器
IP 增强器
ASN 增强器
CIDR 增强器
社交媒体增强器
组织增强器
加密货币增强器
网站增强器
邮箱增强器
电话增强器
个人增强器
集成增强器
项目由自治模块组成:
flowsint-app (前端)
↓
flowsint-api (API 服务器)
↓
flowsint-core (编排器、任务、保险库)
↓
flowsint-enrichers (增强器和工具)
↓
flowsint-types (类型)
Linux / macOS(需要 Make):
make dev
Windows(cmd 或 PowerShell,无需 Make — 请先创建 .env 文件,参见快速开始):
docker compose -f docker-compose.dev.yml up -d --build
docker compose -f docker-compose.dev.yml logs -f
应用可通过 http://localhost:5173 访问。
所有其他模块使用的核心工具和基类:
所有数据类型的 Pydantic 模型:
处理数据的增强器模块:
提供以下功能的 FastAPI 服务器:
前端应用。
flowsint-types 模块flowsint-enrichers 模块flowsint-api 模块flowsint-core 模块每个模块都有自己的(不完整的)测试套件:
# 测试核心模块
cd flowsint-core
uv run pytest
# 测试类型模块
cd ../flowsint-types
uv run pytest
# 测试增强器模块
cd ../flowsint-enrichers
uv run pytest
# 测试 API 模块
cd ../flowsint-api
uv run pytest
伦理声明: 请阅读 ETHICS.md 了解负责任的使用准则。
Flowsint 的设计目的严格限定于合法、道德的调查和研究用途。
它的创建旨在协助:
Flowsint 不得用于:
任何滥用本软件的行为均被严格禁止,并违反 ETHICS.md 中定义的道德原则。