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 App 請使用 iOS / macOS SDK。

需要直接整合?

如果 Electron 與 Flutter 都不適合你的 App,請聯絡我們。

平台 ​

平台架構驗證碼視窗
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 功能。

在早於 Ubuntu 22.04 / Debian 12 的 Linux 系統上無法使用原生驗證碼視窗;此時 Electron SDK 會在自己的視窗中顯示驗證碼。

下載與校驗 ​

這些函式庫發布在附版本號的套件 CDN 上並附有校驗值,可用於安全審查,或在你的內部網路中建立鏡像:

  • 基礎位址: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 桌面 App,請將 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