Skip to content

v1.2.0 lw.PPOCR.Inference — Linux OpenCV DNN 首发版

Choose a tag to compare

View all tags
@lxw112190 lxw112190 released this 16 Jul 13:58
v1.2.0
0fcfbd2

lw.PPOCR.Inference v1.2.0

这是 lw.PPOCR.Inference 首个正式的 Linux 发布版本，面向 Ubuntu 20.04 x86_64，使用 OpenCV 5.0 DNN CPU 后端。

此 Release 仅提供 Linux x64 OpenCV DNN 包。
Windows 用户请继续使用 v1.1.0；不能通过替换少量文件将 Windows 包转换为 Linux 包。

主要功能

  • 支持完整 OCR：文字检测、方向分类、文字识别
  • 支持仅文字识别：直接识别客户已经裁剪好的文字区域
  • 保持稳定的 C ABI
  • 提供 JSON + Base64 HTTP API
  • 提供浏览器测试页面
  • 在原图上绘制检测到的文字区域
  • 显示图片解码、检测、分类、识别和服务总耗时
  • 支持 API Key，通过 X-API-Key 请求头认证
  • 支持前台运行和 systemd 系统服务
  • 随包提供 PP-OCRv6 tiny ONNX 模型、字典和测试图片
  • 随包提供 OpenCV 5.0 所需共享库
  • 提供 SHA-256 校验和自动验证脚本

下载文件

lw.PPOCR.Inference-v1.2.0-linux-x64-opencv.tar.gz
lw.PPOCR.Inference-v1.2.0-linux-x64-opencv.tar.gz.sha256

快速开始

sha256sum -c lw.PPOCR.Inference-v1.2.0-linux-x64-opencv.tar.gz.sha256
tar -xzf lw.PPOCR.Inference-v1.2.0-linux-x64-opencv.tar.gz
cd lw.PPOCR.Inference-v1.2.0-linux-x64-opencv

sudo ./install-deps-ubuntu.sh
./verify-linux-package.sh
./run-http-service.sh

浏览器访问：

http://127.0.0.1:8787/

HTTP API

GET  /health
POST /api/ocr
POST /api/recognize

完整 OCR：

{"image_base64":"data:image/jpeg;base64,..."}

识别已经裁剪好的文字区域：

{"image_base64":"data:image/png;base64,..."}

批量文字识别：

{"images_base64":["data:image/png;base64,...","data:image/png;base64,..."]}

API Key

默认未启用 API Key。可以在 http-service.json 中设置：

{
  "api_key": "请替换为自己的随机密钥"
}

启用后，客户端需要发送：

X-API-Key: 请替换为配置中的值

安装为 systemd 服务

sudo ./install-systemd.sh
systemctl status lw-ppocr-http.service
journalctl -u lw-ppocr-http.service -f

默认安装目录：

/opt/lw-ppocr

局域网访问

服务默认只监听 127.0.0.1。需要局域网访问时，将 http-service.json 中的配置改为：

{
  "listen_host": "0.0.0.0",
  "port": 8787,
  "api_key": "请替换为自己的随机密钥"
}

请同时配置防火墙，只允许可信客户端访问。不建议将未配置 API Key 的服务直接暴露到公网。

平台说明

  • 官方目标环境：Ubuntu 20.04 x86_64
  • 推理后端：OpenCV 5.0 DNN
  • 计算设备：CPU
  • 本版本不包含 Linux ONNX Runtime GPU、CUDA、DirectML、OpenVINO 或 TensorRT Runtime
  • Linux 不提供 WinForms Demo
  • 修改 device_id 不会启用 GPU

完整说明请参阅包内：

README.md
README_EN.md
docs/linux-opencv.md
docs/http-service.md

English Summary

This is the first official Linux release of lw.PPOCR.Inference. It targets Ubuntu 20.04 x86_64 and uses the OpenCV 5.0 DNN CPU backend.

The package includes full OCR, recognition-only inference, a JSON + Base64 HTTP API, browser test page, API Key authentication, systemd integration, PP-OCRv6 tiny ONNX models, OpenCV shared libraries, and package verification scripts.

This release contains Linux x64 files only. Windows users should continue using v1.1.0.

Assets 4
Loading