AperiSolve

# Aperi'Solve

[![Website](https://img.shields.io/website?url=https://aperisolve.com)](https://aperisolve.com/)
![CI](https://github.com/Zeecka/AperiSolve/actions/workflows/release.yml/badge.svg)
![Lint](https://github.com/Zeecka/AperiSolve/actions/workflows/lint.yml/badge.svg)
![Docker](https://img.shields.io/badge/docker-compose-blue?logo=docker)
![Python Version](https://img.shields.io/badge/python-3.12+-blue)
![Ruff](https://img.shields.io/badge/lint-ruff-30173d)
![uv](https://img.shields.io/badge/package-uv-30173d)
![ty](https://img.shields.io/badge/types-ty-30173d)
![License](https://img.shields.io/github/license/Zeecka/AperiSolve)
![GitHub Issues](https://img.shields.io/github/issues/Zeecka/AperiSolve)
![GitHub Pull Requests](https://img.shields.io/github/issues-pr/Zeecka/AperiSolve)
![Last Commit](https://img.shields.io/github/last-commit/Zeecka/AperiSolve)
![Contributors](https://img.shields.io/github/contributors/Zeecka/AperiSolve)
[![Rawsec's CyberSecurity Inventory](https://inventory.raw.pm/img/badges/Rawsec-inventoried-FF5050_flat.svg)](https://inventory.raw.pm/tools.html#Aperi'Solve)

<p align="center">
  <a href="https://www.aperisolve.com">
    <img src="https://assets.kitploit.com/production/public/readmes/129/6ed4965b9771573193cfc55fe47f2e90294f70d4ee71c71cff064d5a6470f352.png" alt="Aperi'Solve स्क्रीनशॉट" />
  </a>
</p>

इसे अभी आज़माएँ: **https://www.aperisolve.com**

Aperi'Solve को सहयोग करें:

<a href="https://github.com/sponsors/Zeecka">
  <img src="https://img.shields.io/badge/Sponsor-Zeecka-ea4aaa?logo=githubsponsors&amp;logoColor=white&amp;style=for-the-badge" alt="GitHub पर Aperi'Solve को प्रायोजित करें" />
</a>

---

Aperi'Solve एक ओपन-सोर्स स्टेगनालिसिस वेब प्लेटफ़ॉर्म है, जो सामान्य स्टेग्नोग्राफ़ी टूल्स और तकनीकों का उपयोग करके छिपे हुए डेटा का पता लगाने और उसे निकालने के लिए छवियों का स्वचालित विश्लेषण करता है।

## मुख्य विशेषताएँ

- प्रत्येक छवि चैनल (R/G/B/Alpha) के लिए प्रत्येक बिट लेयर (LSB और अन्य लेयर्स) को विज़ुअलाइज़ करें।
- रंग पुनर्मैपिंग (8 जनरेटेड वेरिएंट्स के साथ रैंडम पैलेट रीमैप)
- 16 एनालाइज़र को समानांतर चलाता है और उनका आउटपुट प्रदर्शित करता है, जिसमें प्रति-टूल
  सफलता/कोई-परिणाम-नहीं बैज और निकाले गए फ़ाइलों का वन-क्लिक डाउनलोड शामिल है:
  - [binwalk](https://github.com/ReFirmLabs/binwalk) (एम्बेडेड आर्काइव)
  - [exiftool](https://exiftool.org/) (मेटाडेटा और जियोलोकेशन)
  - [file](https://manned.org/file.1) (MIME प्रकार और प्रारूप पहचान)
  - [GraphicsMagick identify](http://www.graphicsmagick.org/identify.html) (छवि जानकारी और गुण)
  - [foremost](https://foremost.sourceforge.net/) (कटी हुई फ़ाइलें)
  - [jsteg](https://github.com/lukechampine/jsteg) (JPEG LSB निष्कर्षण)
  - [jpseek / jphide](https://github.com/h3xx/jphs) (JPEG स्टेग्नोग्राफ़ी निष्कर्षण, पासवर्ड के साथ)
  - [openstego](https://www.openstego.com/) (पासवर्ड के साथ निष्कर्षण)
  - [outguess](https://www.rbcafe.com/software/outguess/) (पासवर्ड के साथ निष्कर्षण, गहन विश्लेषण)
  - [pcrt](https://github.com/sherlly/PCRT) (PNG जाँच और मरम्मत)
  - [pngcheck](https://www.libpng.org/pub/png/apps/pngcheck.html)
  - [steghide](https://steghide.sourceforge.net/) (पासवर्ड के साथ निष्कर्षण)
  - [strings](https://pubs.opengroup.org/onlinepubs/9799919799/utilities/strings.html)
  - [zsteg](https://github.com/zed-0xff/zsteg) (LSB टेक्स्ट/डेटा निष्कर्षण)
- **इन-ऐप विकी** ([`/wiki`](https://www.aperisolve.com/wiki/)): एक HackTricks-शैली की
  स्टेग्नोग्राफ़ी हैंडबुक — एक ट्राएज पद्धति, एक निर्णय-वृक्ष चीटशीट,
  प्रति माध्यम (छवि, ऑडियो, टेक्स्ट, फ़ाइलें) तकनीक पेज, और प्रति
  एनालाइज़र मार्गदर्शिका, सभी Markdown में लिखे गए हैं।
- **अंतर्राष्ट्रीयकरण**: यूआई अंग्रेज़ी, फ़्रेंच, स्पेनिश, जर्मन,
  रूसी, चीनी और पुर्तगाली में भाषा-उपसर्ग वाले URL (`/fr/`, `/es/`, …) पर उपलब्ध है।
- भारी/धीमे एनालाइज़र को ऑफलोड करने के लिए वर्कर कतार आर्किटेक्चर (Redis + बैकग्राउंड वर्कर)।
- सामग्री-आधारित परिणाम कैश, HTTP कैश, और प्रति-एंडपॉइंट रेट लिमिटिंग।
- परिणाम अस्थायी रूप से बाद में ब्राउज़िंग और डाउनलोड के लिए संग्रहीत किए जाते हैं, फिर एक
  अनुसूचित कार्य द्वारा स्वचालित रूप से साफ़ कर दिए जाते हैं।

## एनालाइज़र जोड़ना

एनालाइज़र जोड़ना एक एकल फ़ाइल है: `SubprocessAnalyzer` को सबक्लास करें, कुछ
क्लास विशेषताएँ (`name`, `has_archive`, `needs_password`, `deep_only`,
`display_order`) सेट करें, और टूल को `Dockerfile` में इंस्टॉल करें। वर्कर रन
सूची, डाउनलोड अनुमति-सूची, और फ्रंटएंड क्रम सभी स्वचालित रूप से प्राप्त होते हैं।
[docs/adding-analyzer.md](https://github.com/zeecka/aperisolve/blob/main/docs/adding-analyzer.md) देखें।

## त्वरित आरंभ (Docker)

यदि आप https://www.aperisolve.com/ का अपना स्वयं का संस्करण होस्ट करना चाहते हैं।

> आवश्यक: Docker + Docker Compose।

```bash
git clone https://github.com/Zeecka/AperiSolve.git
cd AperiSolve
cp .env.example .env
docker compose up -d
```

फिर URL खोलें: http://localhost:5000/

विज्ञापन और एनालिटिक्स डिफ़ॉल्ट रूप से अक्षम हैं; हर एकीकरण
(`CUSTOM_EXTERNAL_SCRIPT`, `GOOGLE_ADS_TXT`, `SITE_BASE_URL`, Sentry)
पर्यावरण चरों के माध्यम से वैकल्पिक है, जिन्हें [`.env.example`](https://github.com/zeecka/aperisolve/blob/main/.env.example) में दस्तावेज़ित किया गया है।
ऐप स्वयं कभी भी विज्ञापन मार्कअप इंजेक्ट नहीं करता है: `CUSTOM_EXTERNAL_SCRIPT` AdSense स्क्रिप्ट लोड करता है और प्लेसमेंट Auto ads पर छोड़ दिया जाता है।

## आर्किटेक्चर

यह स्टैक Docker Compose सेवाओं के रूप में चलता है:

- **web** — Flask ऐप जो gunicorn द्वारा परोसा जाता है (Jinja टेम्पलेट + वैनिला JS फ्रंटएंड)।
- **worker** — एक RQ वर्कर जो प्रत्येक सबमिशन के लिए एनालाइज़र चलाता है, प्रति टूल एक थ्रेड में फैन आउट करते हुए।
- **cron** — एक RQ क्रोन शेड्यूलर जो अनुरोध पथ से अलग रिटेंशन क्लीनअप चलाता है।
- **initdb** — एक वन-शॉट सेवा जो टेबल बनाती है और IHDR CRC रिकवरी डेटाबेस को पहले से भरती है।
- **postgres** — छवि मेटाडेटा और सबमिशन स्थिति संग्रहीत करता है।
- **redis** — RQ ब्रोकर (DB 0) और रेट-लिमिटर स्टोरेज (DB 1)।
- **rqdashboard** — कतार मॉनिटरिंग, localhost:9181 पर बाउंड।

यह अलगाव भारी टूल्स (binwalk, foremost, zsteg, आदि) को अलग रखता है
और वेब वर्कर को ब्लॉक होने से बचाता है। समान सबमिशन एक
कंटेंट हैश द्वारा डिडुप्लिकेट किए जाते हैं, और व्युत्पन्न छवियों को लंबे समय तक चलने वाले इम्यूटेबल HTTP हैडर के साथ कैश किया जाता है, इसलिए बार-बार आने वाला ट्रैफ़िक सस्ता होता है।

## दस्तावेज़ीकरण

- [docs/adding-analyzer.md](https://github.com/zeecka/aperisolve/blob/main/docs/adding-analyzer.md) — एक नया एनालाइज़र जोड़ें।
- [docs/deploy.md](https://github.com/zeecka/aperisolve/blob/main/docs/deploy.md) — टैग-संचालित प्रोडक्शन डिप्लॉय प्रवाह।
- [CONTRIBUTING.md](https://github.com/zeecka/aperisolve/blob/main/CONTRIBUTING.md) — डेव सेटअप, टेस्ट, विकी पेज और अनुवाद।

## परीक्षण

```bash
uv sync --extra dev
uv run pytest -q            # unit tests (no services needed)

# end-to-end analyzer tests through the running app:
docker compose -f compose.dev.yml up -d
uv run pytest tests/test_webapp_analyzers.py -v
```

## रोडमैप

[Issues](../../issues) देखें।

## योगदान

[CONTRIBUTING.md](https://github.com/zeecka/aperisolve/blob/main/CONTRIBUTING.md) देखें।

## सुरक्षा

> [!WARNING]
> यदि आपको कोई सुरक्षा समस्या मिलती है, तो कृपया सार्वजनिक इश्यू खोलने के बजाय इसे रिपॉजिटरी स्वामी को निजी रूप से रिपोर्ट करें।

## श्रेय

दानदाताओं का धन्यवाद:
- [Philip Zimmermann](https://github.com/Philip-Zimmermann)
- [Ed Guillory](#)
- [Silje Hollås](#)

योगदानकर्ताओं का धन्यवाद:
- [Zeecka](https://www.zeecka.fr/) - **(लेखक)**
- [aradhyacp](https://github.com/aradhyacp)
- [Philip Zimmermann](https://github.com/Philip-Zimmermann)
- [abneeeees](https://github.com/abneeeees)

ओपन-सोर्स समुदाय का धन्यवाद:
[binwalk](https://github.com/ReFirmLabs/binwalk), [exiftool](https://exiftool.org/), [GraphicsMagick identify](http://www.graphicsmagick.org/identify.html), [foremost](https://foremost.sourceforge.net/), [jsteg](https://github.com/lukechampine/jsteg), [jphide/jpseek](https://github.com/h3xx/jphs), [openstego](https://www.openstego.com/), [outguess](https://www.rbcafe.com/software/outguess/), [pcrt](https://github.com/sherlly/PCRT), [pngcheck](https://www.libpng.org/pub/png/apps/pngcheck.html), [steghide](https://steghide.sourceforge.net/), [strings](https://pubs.opengroup.org/onlinepubs/9799919799/utilities/strings.html), [zsteg](https://github.com/zed-0xff/zsteg), ...