Skip to content

Десктопная среда выполнения ​

Десктопная среда выполнения CaptchaLa — это набор нативных библиотек для Windows, macOS и Linux, на которых построены десктопные SDK. Текущая версия: 1.2.0.

Напрямую среду выполнения не интегрируют. Используйте один из этих SDK: они содержат или сами загружают подходящую версию среды выполнения:

  • Electron SDK (@captcha-la/electron): npm-пакет содержит среду выполнения для всех поддерживаемых платформ.
  • Flutter SDK (captchala): в Windows и Linux плагин загружает среду выполнения во время сборки и проверяет её по закреплённым хешам SHA-256.

Нативные приложения для macOS используют iOS / macOS SDK.

Нужна прямая интеграция?

Если ни Electron, ни Flutter не подходят для вашего приложения, свяжитесь с нами.

Платформы ​

ПлатформаАрхитектурыОкно капчи
Windows 10 1809+ и Windows Serverx64, arm64, x86Нативное окно (Microsoft Edge WebView2 Runtime)
Linux, glibc 2.17+x64, arm64Нативное окно: GTK 3 и WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ или аналог)
macOS 11+arm64, x64Используется Electron SDK

Начиная с 1.2.0 среда выполнения загружается и на Windows Server, включая Server Core и терминальные серверы, без установки дополнительных компонентов Windows.

В системах Linux старше Ubuntu 22.04 / Debian 12 нативное окно капчи недоступно; там Electron SDK показывает капчу в собственном окне.

Загрузка и проверка ​

Библиотеки публикуются на версионированном CDN пакетов вместе с контрольными суммами — для проверки безопасности или зеркалирования внутри вашей сети:

  • Базовый URL: https://pkg.captcha-pkg.net/desktop/1.2.0/ (зеркало: https://pkg.captcha-cdn.net/desktop/1.2.0/)
  • SHA256SUMS содержит каждый файл с его SHA-256; по одной папке на платформу: linux-x64, linux-arm64, win32-x64, win32-arm64, win32-ia32, darwin-arm64, darwin-x64
bash
# Linux (use "shasum -a 256 -c -" on macOS)
BASE=https://pkg.captcha-pkg.net/desktop/1.2.0
TARGET=linux-x64
mkdir -p vendor/captchala/1.2.0 && cd vendor/captchala/1.2.0
curl -fsSLO "$BASE/SHA256SUMS"
for f in $(grep " $TARGET/" SHA256SUMS | awk '{print $2}'); do
  mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "$BASE/$f"
done
grep " $TARGET/" SHA256SUMS | sha256sum -c -     # every line must say OK

В Windows сравните вывод Get-FileHash <file> -Algorithm SHA256 со строкой в SHA256SUMS. Чтобы собрать десктопное приложение Flutter из зеркала, укажите папку в CAPTCHALA_LOCAL_PREBUILDS (см. Flutter: нативные библиотеки).

Требования ​

  • Windows: Windows 10 1809+ или Windows Server; Microsoft Edge WebView2 Runtime для окна капчи.
  • Linux: glibc 2.17+ и libcurl; GTK 3 и WebKitGTK 4.1 (webkit2gtk-4.1) для окна капчи.
  • macOS: macOS 11+.

Проверка на сервере ​

Какой бы SDK вы ни использовали, отправьте pass token на ваш бэкенд и проверьте его через POST https://verify.captcha.la/v1/validate. См. справочник API.

MIT-licensed examples · CaptchaLa is operated independently