描述   |   安装   |   网站   |   模块   |   问题   |   赞助

iKy

描述

iKy 是一款 OSINT 工具，可收集电子邮件地址或其他选择器的信息，并将结果以可视化界面展示。

安装

前提条件

• Docker
• Docker Compose（Docker Desktop 已包含）
• （可选）just 任务运行器

快速开始

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

在浏览器中打开 http://localhost:4300

停止所有服务：

just down

just up 会启动 backend、iky-frontend 和 redis。默认不启动其他服务。

不使用 Docker（原生运行）

如果无法运行 Docker，iKy 可以原生运行：Caddy 提供预构建的前端服务，Redis + Celery + Uvicorn 作为本地进程运行。主机需要安装 redis-server、Python 3.12、curl 和 tar（Caddy 会自动下载）。

just setup          # 创建虚拟环境
just up-native      # 安装依赖、下载 Caddy 和前端、启动所有服务

在浏览器中打开 http://localhost:4300。按 Ctrl-C 或运行 just down-native 停止。

前端从最新的 GitHub 发布版拉取——无需 Node 构建。 原生模式下不启动 tor；只有 darkweb 模块需要它。

架构

模块

iKy 通过 backend/module_registry.py 路由 26 个模块：

API 密钥

应用在浏览器中加载后，在设置面板中输入你的 API 密钥。以下是 backend/factories/apikeys_default.json 中所有字段的完整表格：

标注 🍪 的 API 使用浏览器会话 cookie；其余使用服务令牌。

会话 cookie

某些模块（LinkedIn、Twitter、TikTok）需要来自浏览器的会话 cookie。Cookie 存储在 backend/cookies/ 中（挂载到容器内的 /app/cookies），重启后持久存在。有两种加载方式，均通过 just 实现。

Cookie 是个人会话令牌：请勿分享或提交到仓库（backend/cookies/ 已加入 gitignore）。

选项 A：导入浏览器导出文件

使用 Cookie-Editor 等扩展将网站 cookie 导出为 JSON 文件，然后导入：

just cookies-import linkedin ~/Downloads/linkedin_cookies.json

选项 B：从浏览器自动提取

直接从本地浏览器提取 cookie。运行前关闭浏览器（打开的浏览器会锁定其 cookie 数据库）：

# 尝试所有已安装的浏览器（firefox, chrome, brave, edge）
just cookies-grab linkedin linkedin.com

# 或指定某个浏览器
just cookies-grab linkedin linkedin.com brave

该命令会逐个浏览器报告读取情况（成功与失败），仅当找到模块所需的 cookie 时才写入文件。例如，LinkedIn 需要 li_at 和 JSESSIONID。

Cookie 会定期过期（LinkedIn 的 cookie 有效期 1 到 3 个月）。当模块无法认证时，重新运行上述命令。

开发

开发工作流使用虚拟环境进行 linting/pre-commit 钩子，并使用 Docker（或原生的 just up-native 流程）构建和运行应用。

设置开发环境

安装 just，然后：

just setup
source .venv/bin/activate

这将创建一个包含 pre-commit 和 ruff 的 Python 虚拟环境，并安装 git 钩子。

常用命令

更新 iKy

拉取最新更改并重新构建 Docker 镜像：

git pull
just rebuild

要在更新后保留 API 密钥，请使用图形界面中 API 密钥菜单的导出/导入选项。

Wiki

• iKy Wiki

视频演示

Vimeo

支持项目

无论你是使用这个项目、从中学习到了什么，还是只是喜欢它，请考虑通过请我喝杯咖啡来支持它，这样我就能将更多时间投入到像这样的开源项目上。

免责声明

任何为该项目做出贡献的人（包括我）都不对工具的使用负责（无论是合法使用、非法使用，还是“其他”使用）。

请记住，该软件最初是为一个玩笑而编写的，然后用于教育目的（自我教育），现在我们的目标是协作社区，制作高质量的免费软件。虽然质量并非卓越（有时甚至不好），但我们努力追求卓越。

请理解，所有收集的信息都是免费且在线公开的，该工具只是尝试发现、收集和展示它们。 很多时候，工具甚至无法实现其发现和收集的目标。在问候我母亲之前，请先加载必要的 API。 即使加载了 API，它也没有显示你期望看到的“漂亮”东西，请在问候我母亲之前尝试其他电子邮件。 如果你仍然没有看到你期望的“漂亮”东西，你可以创建 issue、通过电子邮件或任何社交媒体联系我们，但请记住，我的母亲既不是创建者，也不对该项目做出贡献。

如果你不满意，我们不退款。 我希望你享受使用该工具的过程，就像我们享受制作它一样。付出的努力是巨大且持续的（时间、知识、编码、测试、审查等），但我们愿意再做一次。 如果你无法阅读说明和/或本免责声明，请不要使用该工具。

顺便说一句，对于那些坚持问候我母亲的人，她已去世多年，但我仍然像她在身边一样爱她。