【超详细】基于PaddleOCR 2.7.3 离线部署教程(Win + Linux,支持 base64 、kylin操作系统、java调用)
适用于 Python 3.9.13 + PaddlePaddle 2.6.2 / dev 版 + PaddleOCR 2.7.3。支持 Windows 10/11 和 Linux(aarch64)离线部署,并兼容 base64 图像输入。📦 5. 安装离线 PaddlePaddle(dev 版)🧠 5. 安装 PaddlePaddle(CPU 版)✅ 三、运行 PaddleOCR(支持 bas
适用于 Python 3.9.13 + PaddlePaddle 2.6.2 / dev 版 + PaddleOCR 2.7.3
支持 Windows 10/11 和 Linux(aarch64)离线部署,并兼容 base64 图像输入
一、Windows 系统部署(推荐 64 位)
🔧 1. 安装 Python 3.9.13
下载地址:Python 3.9.13 官网
选择:
Windows x86-64 executable installer (64 位)
安装时勾选 Add Python to PATH
🔍 2. 检查环境
bash
python -V
python -m pip -V
🧪 3. 创建虚拟环境(推荐)
bash
python -m venv paddle39
paddle39\Scripts\activate
⚠️ 后续所有命令都在该虚拟环境中执行!
⬆️ 4. 升级 pip
bash
python -m pip install -U pip
🧠 5. 安装 PaddlePaddle(CPU 版)
bash
python -m pip install paddlepaddle==2.6.2 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/
验证:
bash
python -c "import paddle, platform; print(paddle.__version__, platform.architecture()[0])"
📦 6. 安装 PaddleOCR 及依赖
bash
pip install paddleocr==2.7.3 shapely scikit-image imgaug -i https://pypi.tuna.tsinghua.edu.cn/simple
🧪 7. 一键测试 OCR(含 base64 支持)
python
python -c "
import json, cv2, os
from paddleocr import PaddleOCR
ocr = PaddleOCR(use_angle_cls=True, lang='ch')
img_path = r'F:\A-limitCode\PaddleOCR-2.7.3\doc\1.jpg'
result = ocr.ocr(img_path, cls=True)
out_dir = r'D:\OCR\输出'
os.makedirs(out_dir, exist_ok=True)
out_file = os.path.join(out_dir, 'result.json')
data = [{'text': line[1][0], 'confidence': float(line[1][1]), 'box': [int(x) for pt in line[0] for x in pt]} for line in result[0]]
json.dump(data, open(out_file, 'w', encoding='utf-8'), ensure_ascii=False, indent=2)
print('✅ 已写入 ->', out_file)
二、Linux 系统部署(aarch64 离线)
📁 1. 准备离线目录
bash
mkdir -p ~/paddle-offline && cd ~/paddle-offline
🛠️ 2. 安装依赖(如未安装)
bash
sudo yum groupinstall -y "Development Tools"
sudo yum install -y zlib-devel bzip2-devel openssl-devel \
ncurses-devel sqlite-devel readline-devel tk-devel libffi-devel xz-devel
🧱 3. 编译安装 Python 3.9.13
bash
tar xzf Python-3.9.13.tgz
cd Python-3.9.13
sudo ./configure --prefix=/usr/local/python39 \
--enable-shared \
--enable-optimizations
sudo make -j$(nproc)
sudo make altinstall
🔗 4. 创建软链接
bash
sudo ln -sf /usr/local/python39/bin/python3.9 /usr/local/bin/python3.9
sudo ln -sf /usr/local/python39/bin/pip3.9 /usr/local/bin/pip3.9
验证:
bash
python3.9 -V
pip3.9 -V
📦 5. 安装离线 PaddlePaddle(dev 版)
bash
# 假设 whl 文件已放入 ~/paddle-offline/whl/
mkdir -p ~/.pip
cat > ~/.pip/pip.conf <<EOF
[global]
no-index = true
find-links = file:///root/paddle-offline/whl
EOF
python3.9 -m pip install ./whl/paddlepaddle-3.0.0.dev*.whl --no-deps
✅ 三、运行 PaddleOCR(支持 base64)
📌 普通图片识别
bash
python3.9 tools/infer/predict_system.py \
--image_dir ./doc/1.jpg \
--det_model_dir ./ch_PP-OCRv4_det_infer \
--rec_model_dir ./ch_PP-OCRv4_rec_infer \
--cls_model_dir ./ch_ppocr_mobile_v2.0_cls_infer \
--use_angle_cls true
📌 base64 图片识别(无需保存图片)
bash
python3.9 tools/infer/predict_system.py \
--base64 "$(base64 -w 0 doc/1.jpg)" \
--det_model_dir ./ch_PP-OCRv4_det_infer \
--rec_model_dir ./ch_PP-OCRv4_rec_infer \
--cls_model_dir ./ch_ppocr_mobile_v2.0_cls_infer \
--use_angle_cls true
魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。
更多推荐

所有评论(0)