Skip to content

README.ru.md

Latest commit

 

History

History
121 lines (84 loc) · 6.45 KB

README.ru.md

File metadata and controls

121 lines (84 loc) · 6.45 KB

Логотип Proxy & API Key Checker

Proxy & API Key Checker

GitHub: https://github.com/nbox/Proxy-API-Key-Checker

🌐 Читать на: English | Русский | Español

Десктопное приложение для проверки API-ключей популярных сервисов и пакетных проверок с лимитами и отчетами. Поддерживает OpenAI (ChatGPT), Google Gemini, YouTube Data API и Custom эндпоинты.

Screenshot

🍺 Homebrew (macOS)

Установка:

brew install --cask nbox/tap/proxy-api-key-checker

Удаление:

brew uninstall --cask --zap proxy-api-key-checker

Скачать

Релизы: https://github.com/nbox/Proxy-API-Key-Checker/releases

macOS Gatekeeper

⚠️ macOS может блокировать неподписанные сборки, скачанные с GitHub. Если вы видите предупреждение, что приложение не подписано, и macOS предлагает переместить его в корзину, воспользуйтесь одним из вариантов ниже:

Вариант 1: Разрешить в System Settings -> Privacy & Security

  • Откройте приложение как обычно (двойным кликом).
  • Откройте System Settings -> Privacy & Security.
  • В предупреждении о Proxy & API Key Checker нажмите Open Anyway.
  • Подтвердите, нажав Open.

Вариант 2: Снять атрибут карантина

xattr -dr com.apple.quarantine "/Applications/Proxy & API Key Checker.app"

Возможности

  • Адаптеры: OpenAI, Gemini, YouTube, Custom
  • Пакетные проверки с параллельностью, случайной задержкой (jitter), ретраями, глобальным лимитом RPS
  • Несколько параллельных запусков с логами в реальном времени, статистикой и сводкой
  • Импорт ключей из TXT/CSV/JSON, выбор кодировки, дедупликация, предупреждения формата
  • Экспорт отчетов в CSV/JSON (маскированный или полный)
  • Языки UI: English (по умолчанию), Русский, Español

Проверка прокси

  • Типы: HTTP, HTTPS, SOCKS4, SOCKS5; схема в строке (http://, https://, socks4://, socks5://) фиксирует тип.
  • Источники: ручной ввод, импорт файла и URL агрегаторов (по одному в строке; поддерживаются # комментарии).
  • Форматы: ip:port или user:pass@ip:port; автонормализация и дедупликация.
  • Режимы: валидность или доступ к URL с настраиваемым целевым URL.
  • Поиск в HTML: один или несколько текстов (ИЛИ). Без headless читаются только первые N КБ.
  • Headless браузер: полная загрузка страницы с JS; скриншоты по желанию (папка, лимит, автоудаление, сохранять невалидные).
  • Headless и скриншоты доступны только в режиме URL и при включённом поиске в HTML.
  • Контроль: speed limit — мягкий порог задержки, timeout — жёсткий стоп на запрос. Плюс ретраи, параллельность, лимит RPS, задержка + джиттер, лимит прокси за запуск.
  • Результаты: каждый прокси проверяется по каждому выбранному типу; в логах/экспорте есть тип, режим, URL; в сводке — списки по типам с копированием/переносом.
  • Сводка: разделение по типам и кнопка "Переместить в Proxy list", чтобы быстро отсечь валидные и затем перепроверить их в более жестком режиме (сначала доступность, потом целевой сайт).
  • Предустановленные агрегаторы лежат в src/renderer/lib/proxyAggregators (это примеры; ссылки могут быть недоступны из-за региональных блокировок или потому что источники умерли).

Безопасность и приватность

  • Ключи отправляются только в выбранный API
  • Телеметрии нет
  • Используйте только ключи, которыми вы владеете или имеете право пользоваться
  • Полный экспорт сохраняет ключи в открытом виде (без шифрования). Используйте осторожно.

Требования

  • Node.js 20+
  • npm

Быстрый старт

npm install
npm run dev

Сборка

git clone https://github.com/nbox/Proxy-API-Key-Checker.git
cd Proxy-API-Key-Checker
npm install
npm run build
npm run dist

Сборочные артефакты записываются в dist/. DMG: release/Proxy & API Key Checker-1.0.0-{arch}.dmg. macOS: запускайте npm run dist на macOS — получите .dmg в release/. Windows: запускайте npm run dist на Windows — получите установщик .exe в release/.

GitHub Actions release

  • При пуше в main или теге v*
  • Сборка для macOS, Windows, Linux
  • Создается GitHub Release с артефактами

Пользовательский сервис

Используйте Custom адаптер, чтобы задать base URL, path, тип авторизации (bearer/header/query) и коды успешных ответов.

Структура проекта

  • src/main: основной процесс Electron и движок проверок
  • src/renderer: UI (React + Tailwind)
  • src/shared: общие типы и утилиты