Возможности

• Проверка одного пароля из командной строки
• Обработка паролей из файла
• Приём предварительно хешированных значений 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] Checking...
BAD PASSWORD — BREACH DETECTED (item #1)
	Password: 123456

Total runtime: 1.5s
Total passwords checked: 2
Bad passwords found: 1
Good passwords: 1

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

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

Разработка

make test    # run unit tests
make cover   # run tests with coverage summary

Документация: pkg.go.dev · Покрытие: Codecov

Лицензия

GNU General Public License v3.0