Skip to content

데스크톱 런타임 ​

CaptchaLa 데스크톱 런타임은 데스크톱 SDK의 기반이 되는 Windows, macOS, Linux용 네이티브 라이브러리 모음입니다. 현재 버전: 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, x64Electron SDK에서 사용

1.2.0부터 런타임은 Server Core와 터미널 서버를 포함한 Windows Server에서도 추가 Windows 기능을 설치하지 않고 로드됩니다.

Ubuntu 22.04 / Debian 12보다 오래된 Linux 시스템에서는 네이티브 캡차 창을 사용할 수 없으며, 이 경우 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