{"id":27838159,"url":"https://github.com/cea-sec/ivre","last_synced_at":"2025-12-30T08:05:34.654Z","repository":{"id":20678965,"uuid":"23961941","full_name":"ivre/ivre","owner":"ivre","description":"Network recon framework. Build your own, self-hosted and fully-controlled alternatives to Shodan / ZoomEye / Censys and GreyNoise, run your Passive DNS service, build your taylor-made EASM tool, collect and analyse network intelligence from your sensors, and much more! Uses Nmap, Masscan, Zeek, p0f, ProjectDiscovery tools, etc.","archived":false,"fork":false,"pushed_at":"2025-04-14T08:47:56.000Z","size":30334,"stargazers_count":3678,"open_issues_count":55,"forks_count":652,"subscribers_count":170,"default_branch":"master","last_synced_at":"2025-04-23T17:15:15.740Z","etag":null,"topics":["bro","easm","external-attack-surface-management","hacktoberfest","masscan","network","network-discovery","network-recon","network-reconnaissance","network-security","nmap","nmap-parser","nmap-results-analyse","nmap-scripts","osint","projectdiscovery","scan-ports","scans","security","zeek"],"latest_commit_sha":null,"homepage":"https://ivre.rocks/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["p-l-"]}},"created_at":"2014-09-12T13:34:56.000Z","updated_at":"2025-04-23T15:45:22.000Z","dependencies_parsed_at":"2023-10-04T05:32:29.059Z","dependency_job_id":"d4f817fa-f1cb-407b-9888-d6a98ac3947d","html_url":"https://github.com/ivre/ivre","commit_stats":{"total_commits":2732,"total_committers":47,"mean_commits":58.12765957446808,"dds":"0.42972181551976574","last_synced_commit":"06ed8a9875a4c1a7531bdf123f14b8ea5d1b4efa"},"previous_names":["cea-sec/ivre"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivre%2Fivre","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivre%2Fivre/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivre%2Fivre/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivre%2Fivre/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivre","download_url":"https://codeload.github.com/ivre/ivre/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252118316,"owners_count":21697583,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bro","easm","external-attack-surface-management","hacktoberfest","masscan","network","network-discovery","network-recon","network-reconnaissance","network-security","nmap","nmap-parser","nmap-results-analyse","nmap-scripts","osint","projectdiscovery","scan-ports","scans","security","zeek"],"created_at":"2025-05-02T23:01:52.538Z","updated_at":"2025-05-02T23:01:57.377Z","avatar_url":"https://github.com/ivre.png","language":"Python","readme":"[![Join the chat at Gitter](https://badges.gitter.im/ivre/ivre.svg)](https://gitter.im/ivre/ivre)\n[![Follow on Twitter](https://img.shields.io/twitter/follow/IvreRocks.svg?logo=twitter)](https://twitter.com/IvreRocks)\n[![Follow on Mastodon](https://img.shields.io/mastodon/follow/109349639355238149?domain=https%3A%2F%2Finfosec.exchange\u0026style=social)](https://infosec.exchange/@ivre)\n[![GitHub stars](https://img.shields.io/github/stars/ivre/ivre?style=social)](https://github.com/ivre/ivre)\n[![PyPI downloads](https://pepy.tech/badge/ivre)](https://pypi.org/project/ivre/)\n[![Docker pulls](https://img.shields.io/docker/pulls/ivre/web)](https://hub.docker.com/u/ivre/)\n\n[![MongoDB tests](https://github.com/ivre/ivre/actions/workflows/mongodb.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/mongodb.yml/?branch=master)\n[![Elasticsearch tests](https://github.com/ivre/ivre/actions/workflows/elastic.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/elastic.yml/?branch=master)\n[![PostgreSQL tests](https://github.com/ivre/ivre/actions/workflows/postgres.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/postgres.yml/?branch=master)\n[![TinyDB tests](https://github.com/ivre/ivre/actions/workflows/tinydb.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/tinydb.yml/?branch=master)\n[![SQLite tests](https://github.com/ivre/ivre/actions/workflows/sqlite.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/sqlite.yml/?branch=master)\n[![Maxmind tests](https://github.com/ivre/ivre/actions/workflows/maxmind.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/workflows/maxmind.yml/?branch=master)\n[![Linting tests](https://github.com/ivre/ivre/actions/workflows/linting.yml/badge.svg?branch=master)](https://github.com/ivre/ivre/actions/linting/mongodb.yml/?branch=master)\n[![Documentation Status](https://readthedocs.org/projects/ivre/badge/?version=latest)](https://doc.ivre.rocks/en/latest/?badge=latest)\n\n# IVRE #\n\n\u003cimg align=\"right\" src=\"https://ivre.rocks/logo.png\" alt=\"Logo\"/\u003e IVRE\n(Instrument de veille sur les réseaux extérieurs) or DRUNK (Dynamic\nRecon of UNKnown networks) is a network recon framework, including\ntools for passive and active recon. IVRE can use data from:\n\n- Passive tools:\n  - [Zeek](https://zeek.org/)\n  - [Argus](http://qosient.com/argus/)\n  - [Nfdump](https://github.com/phaag/nfdump)\n  - [p0f](https://lcamtuf.coredump.cx/p0f3/)\n  - [airodump-ng](https://www.aircrack-ng.org/)\n- Active tools:\n  - [Nmap](https://nmap.org/)\n  - [Masscan](https://github.com/robertdavidgraham/masscan)\n  - [ZGrab2](https://github.com/zmap/zgrab2)\n  - [ZDNS](https://github.com/zmap/zdns)\n  - [Nuclei](https://nuclei.projectdiscovery.io/)\n  - [httpx](https://github.com/projectdiscovery/httpx)\n  - [dnsx](https://github.com/projectdiscovery/dnsx)\n  - [tlsx](https://github.com/projectdiscovery/tlsx)\n  - [Dismap](https://github.com/zhzyker/dismap/)\n\nThe advertising slogans are:\n\n-   (in French): IVRE, il scanne Internet.\n-   (in English): Know the networks, get DRUNK!\n-   (in Latin): Nunc est bibendum.\n\nThe names IVRE and DRUNK have been chosen as a tribute to \"Le\nTaullier\".\n\n## Overview ##\n\nYou can have a look at the [project homepage](https://ivre.rocks/),\nthe\n**[screenshot gallery](https://doc.ivre.rocks/en/latest/overview/screenshots.html)**,\nand the\n[quick video introduction](https://www.youtube.com/watch?v=GBu5QMq6ewY)\nfor an overview of the Web interface.\n\nWe have a **demonstration instance**, just [contact us](#contact) to\nget an access.\n\nA few\n**[blog posts](http://pierre.droids-corp.org/blog/html/tags/ivre.html)**\nhave been written to show some features of IVRE.\n\n## Documentation ##\n\n[IVRE's documentation](https://doc.ivre.rocks/) is hosted by Read The\nDocs, based on files from the [doc/](doc/) directory of the\nrepository.\n\nOn an IVRE web server, the `doc/*` files are available, rendered,\nunder `/doc/`.\n\nOn a system with IVRE installed, you can use a `--help` option with\nmost IVRE CLI tools, and `help(ivre.module)` with most IVRE Python\nsub-modules.\n\n## License ##\n\nIVRE is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nIVRE is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\n[along with IVRE](doc/license.rst). If not, see\n[the gnu.org web site](http://www.gnu.org/licenses/).\n\n## Support ##\n\nTry `--help` for the CLI tools, `help()` under Python and the \"HELP\"\nbutton in the web interface.\n\nHave a look at the\n[FAQ](https://doc.ivre.rocks/en/latest/overview/faq.html)!\n\nFeel free to contact the author and offer him a beer if you need help!\n\nIf you don't like beer, a good scotch or any other good alcoholic\nbeverage will do (it is the author's unalienable right to decide\nwhether a beverage is good or not).\n\n## Contributing ##\n\nCode contributions (pull-requests) are of course welcome!\n\nThe project needs scan results and capture files that can be provided\nas examples. If you can contribute some samples, or if you want to\ncontribute some samples and would need some help to do so, or if you\ncan provide a server to run scans, please contact the author.\n\n## Contact ##\n\nFor both support and contribution, the\n[repository](https://github.com/ivre/ivre) on Github should be\nused: feel free to create a new issue or a pull request!\n\nYou can also join the\n[Gitter conversation](https://gitter.im/ivre/ivre) (that is the\npreferred way to get in touch for questions), or use the e-mail `dev`\non the domain `ivre.rocks`.\n\n## Talking about IVRE ##\n\n### Research ###\n\nIf you are using IVRE in you research, please cite it as follows:\n\nIVRE contributors. *IVRE, a network recon framework*.\n[https://github.com/ivre/ivre](https://github.com/ivre/ivre),\n2011-2022.\n\nHere is the appropriate bibtex entry:\n\n    @MISC{ivre,\n        title = {{IVRE}, a network recon framework},\n        author={IVRE contributors},\n        url = {https://ivre.rocks/},\n        howpublished = {\\url{https://github.com/ivre/ivre/}},\n        year = {2011--2022},\n    }\n\n### Technical documents \u0026 blog posts ###\n\nYou can mention \"IVRE, a network recon framework\", together with the\nproject homepage, [https://ivre.rocks/](https://ivre.rocks/) and/or\nthe repository,\n[https://github.com/ivre/ivre](https://github.com/ivre/ivre).\n\nOn twitter, you can follow and/or mention\n[@IvreRocks](https://twitter.com/IvreRocks).\n","funding_links":["https://github.com/sponsors/p-l-"],"categories":["Python","\u003ca id=\"170048b7d8668c50681c0ab1e92c679a\"\u003e\u003c/a\u003e工具","Python (1887)","\u003ca id=\"a76463feb91d09b3d024fae798b92be6\"\u003e\u003c/a\u003e侦察\u0026\u0026信息收集\u0026\u0026子域名发现与枚举\u0026\u0026OSINT"],"sub_categories":["\u003ca id=\"05ab1b75266fddafc7195f5b395e4d99\"\u003e\u003c/a\u003e未分类-OSINT"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcea-sec%2Fivre","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcea-sec%2Fivre","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcea-sec%2Fivre/lists"}