데스크톱 런타임
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 Server | x64, 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부터 런타임은 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
# 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 OKWindows에서는 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 레퍼런스를 참고하세요.