DeepSeek-OCR-2部署教程：Ubuntu 22.04 + NVIDIA驱动535 + CUDA 12.1完整配置
1. 项目概述
DeepSeek-OCR-2是一款基于深度学习的智能文档解析工具，能够将各类文档图片转换为结构化的Markdown格式。与传统的OCR工具不同，它不仅能识别文字内容，还能准确还原文档的排版结构，包括表格、多级标题和段落关系。
这个工具特别适合需要处理大量文档的办公场景，比如合同扫描件归档、纸质资料数字化、报告格式转换等。所有处理都在本地完成，无需联网，确保了文档内容的隐私安全。
2. 环境准备
2.1 硬件要求
- NVIDIA显卡（建议RTX 3060及以上）
- 至少16GB系统内存
- 50GB可用磁盘空间
2.2 软件依赖
在开始安装前，请确保你的Ubuntu 22.04系统已准备好以下组件：
- NVIDIA驱动535：这是支持CUDA 12.1的最低驱动版本
- CUDA 12.1：深度学习推理的核心计算平台
- cuDNN 8.9：NVIDIA深度学习加速库
- Python 3.10：推荐使用Miniconda管理Python环境
3. 安装步骤
3.1 安装NVIDIA驱动
首先更新系统并安装必要工具：
sudo apt update && sudo apt upgrade -y sudo apt install build-essential -y然后安装NVIDIA驱动535：
sudo ubuntu-drivers autoinstall sudo reboot重启后验证驱动安装：
nvidia-smi你应该能看到类似这样的输出，确认驱动版本为535.x：
+-----------------------------------------------------------------------------+ | NVIDIA-SMI 535.54.03 Driver Version: 535.54.03 CUDA Version: 12.2 | |-------------------------------+----------------------+----------------------+3.2 安装CUDA 12.1
下载并安装CUDA 12.1：
wget https://developer.download.nvidia.com/compute/cuda/12.1.0/local_installers/cuda_12.1.0_530.30.02_linux.run sudo sh cuda_12.1.0_530.30.02_linux.run安装完成后，将CUDA添加到环境变量：
echo 'export PATH=/usr/local/cuda-12.1/bin:$PATH' >> ~/.bashrc echo 'export LD_LIBRARY_PATH=/usr/local/cuda-12.1/lib64:$LD_LIBRARY_PATH' >> ~/.bashrc source ~/.bashrc验证CUDA安装：
nvcc --version3.3 安装cuDNN 8.9
从NVIDIA官网下载cuDNN 8.9的Debian安装包，然后执行：
sudo dpkg -i cudnn-local-repo-ubuntu2204-8.9.3.28_1.0-1_amd64.deb sudo cp /var/cudnn-local-repo-ubuntu2204-8.9.3.28/cudnn-local-*-keyring.gpg /usr/share/keyrings/ sudo apt update sudo apt install libcudnn8=8.9.3.28-1+cuda12.1 libcudnn8-dev=8.9.3.28-1+cuda12.13.4 创建Python环境
使用Miniconda创建专用环境：
conda create -n deepseek-ocr python=3.10 -y conda activate deepseek-ocr4. 部署DeepSeek-OCR-2
4.1 下载项目代码
克隆官方仓库：
git clone https://github.com/deepseek-ai/DeepSeek-OCR-2.git cd DeepSeek-OCR-24.2 安装依赖
安装Python依赖：
pip install -r requirements.txt4.3 下载模型权重
从官方渠道下载预训练模型：
wget https://models.deepseek.com/ocr/deepseek-ocr-2.pt -P models/5. 运行与使用
5.1 启动服务
运行以下命令启动Streamlit界面：
streamlit run app.py服务启动后，终端会显示访问地址，通常是：
You can now view your Streamlit app in your browser. Local URL: http://localhost:8501 Network URL: http://192.168.x.x:85015.2 界面操作指南
打开浏览器访问显示的URL，你会看到双栏界面：
左侧区域：
- 上传按钮：支持PNG/JPG/JPEG格式
- 图片预览区：显示上传的文档图片
- 提取按钮：开始OCR处理
右侧区域：
- 预览标签：查看转换后的Markdown渲染效果
- 源码标签：查看原始Markdown代码
- 检测标签：查看OCR识别区域的可视化结果
- 下载按钮：保存Markdown文件到本地
6. 常见问题解决
6.1 驱动兼容性问题
如果遇到CUDA相关错误，首先检查驱动版本：
nvidia-smi确保显示的CUDA版本与安装的版本一致。如果不一致，可能需要重新安装驱动。
6.2 显存不足
对于显存较小的显卡（如8GB），可以尝试以下方法：
- 降低批处理大小：修改config.py中的
batch_size参数 - 使用FP16精度：设置
use_fp16=True
6.3 字体显示问题
如果Markdown预览中的中文显示异常，可以安装中文字体：
sudo apt install fonts-wqy-zenhei7. 总结
通过本教程，你已经成功在Ubuntu 22.04系统上部署了DeepSeek-OCR-2文档解析工具。这套方案充分利用了NVIDIA GPU的加速能力，提供了高效的本地文档处理方案。相比传统OCR工具，它能更好地保留文档的原始结构，生成可直接使用的Markdown格式。
在实际使用中，你可以通过以下方式进一步提升体验：
- 定期检查更新，获取最新模型版本
- 对于大批量文档处理，可以编写自动化脚本
- 根据具体需求调整识别参数，优化结果质量
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
