Возможности

• Проверка одного пароля из командной строки
• Обработка паролей из файла
• Приём предварительно хэшированных SHA-1 входных данных с помощью -hashed
• Проверка зашифрованных экспортов Bitwarden с помощью -bw
• Скрытие паролей в открытом виде в выводе с помощью -hide
• Вывод диагностики HIBP на уровне запроса с помощью -v
• Вывод статистики по завершении с помощью -stats

Установка

Готовый релиз

Вы можете загрузить предварительно скомпилированный статический бинарный файл для вашей операционной системы напрямую со страницы релизов:

1. Перейдите на страницу релизов.
2. Загрузите архив, соответствующий вашей платформе и архитектуре:
   • Linux: pwnedcheck_x.x.x_linux_amd64.tar.gz (или arm64)
   • macOS: pwnedcheck_x.x.x_darwin_amd64.tar.gz (или arm64)
   • Windows: pwnedcheck_x.x.x_windows_amd64.zip
3. Извлеките содержимое архива, чтобы получить исполняемый файл.

Запуск исполняемого файла

Linux / macOS: Откройте терминал в папке с извлечённым файлом, сделайте бинарный файл исполняемым и выполните:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: не тестировалось, но отзывы приветствуются

Откройте PowerShell или командную строку в папке, содержащей извлечённый pwnedcheck.exe, и выполните:

.\pwnedcheck.exe -h

С помощью Go

Установите CLI в каталог Go bin:

go install github.com/mohamedation/PwnedCheck/cmd/pwnedcheck@latest

Из исходников с Make

git clone https://github.com/mohamedation/PwnedCheck.git
cd PwnedCheck
make install

Эта команда устанавливает бинарный файл для текущей хост-системы в ваш каталог Go bin.

Сборка бинарных файлов для конкретных платформ

Используйте Makefile для создания релизных бинарных файлов для Linux или macOS:

make build-linux
make build-macos

Бинарные файлы записываются в dist/ с указанием текущей архитектуры Go в имени файла.

Если вы хотите скопировать бинарный файл в каталог Go bin с именем, специфичным для ОС, используйте:

make install-linux
make install-macos

Эти команды устанавливают как pwnedcheck.

Использование

Запуск из исходников:

go run ./cmd/pwnedcheck -v god

Или запуск установленного бинарного файла:

pwnedcheck -i passwords.list -stats

Типичные примеры

Проверка одного пароля:

pwnedcheck password123

Проверка нескольких паролей:

pwnedcheck love sex secret god

Проверка паролей из файла:

pwnedcheck -i passwords.list

Проверка предварительно хэшированных SHA-1 значений:

pwnedcheck -hashed -i passwords.list

Проверка зашифрованного экспорта Bitwarden:

pwnedcheck -bw -i bitwarden_encrypted_export.json -hide -stats

Включение подробного логирования запросов HIBP:

pwnedcheck -v password123

Параметры

• -i, --input <string> : Входной файл, содержащий пароли или JSON-экспорт (по умолчанию "passwords.txt")
• -bw, --bitwarden : Считать входной файл защищённым паролем зашифрованным JSON-экспортом Bitwarden
• -H, --hashed : Считать входные данные предварительно вычисленными SHA-1 хэшами, а не открытым текстом
• -x, --hide : Скрыть пароли в открытом виде в выводе консоли
• -s, --stats : Показать сводку времени выполнения и результатов после завершения
• -v, --verbose : Выводить статус каждого запроса HIBP и ответа для диагностики API
• -c, --credits : Показать информацию об авторах
• -h, --help : Показать справку

Модель безопасности

PwnedCheck использует подход k-анонимности, применяемый в HIBP:

• Для API отправляются только первые 5 символов SHA-1 хэша
• Полный пароль никогда не передаётся
• Экспорты Bitwarden расшифровываются локально в памяти перед проверкой

Пример вывода

[1/2] Проверка...
ПЛОХОЙ ПАРОЛЬ — ОБНАРУЖЕНА УТЕЧКА (#1)
	Пароль: 123456

Общее время выполнения: 1.5s
Всего проверено паролей: 2
Найдено плохих паролей: 1
Хороших паролей: 1

Структура репозитория

• cmd/pwnedcheck: точка входа CLI и парсинг флагов
• internal/checker: основной цикл и форматирование вывода
• internal/hibp: клиент HIBP и хэширование паролей
• internal/bitwarden: расшифровка экспортов Bitwarden

Лицензия

GNU General Public License v3.0