DeepSeek-OCR实战(01)：基础运行环境搭建-Ubuntu

DeepSeek-OCR实战是一个系列文章，包含了从基础运行环境搭建到应用接入全过程。本章为：基础运行环境搭建,操作系统采用 Ubuntu Server 24

环境	版本
ubuntu-24.04.3 Server	release 10.0
Cuda	11.8
显卡 RTX 2080 Ti 22G	驱动 NVIDIA-Linux-x86_64-580.105.08
conda	25.9.1
git	2.47.3

1.操作系统基础安装

安装 Ubuntu 24 Server 版本后（全部默认安装），查看一下磁盘分区情况,我的磁盘是 500G：

1.1 查看分区情况

1sudo fdisk -l
2# 分区表
3Device       Start       End   Sectors   Size Type
4/dev/sda1     2048   2203647   2201600     1G EFI System
5/dev/sda2  2203648   6397951   4194304     2G Linux filesystem
6/dev/sda3  6397952 976771071 970373120 462.7G Linux filesystem
7
8Disk /dev/mapper/ubuntu--vg-ubuntu--lv: 100 GiB, 107374182400 bytes, 209715200 sectors
9Units: sectors of 1 * 512 = 512 bytes
10Sector size (logical/physical): 512 bytes / 512 bytes
11I/O size (minimum/optimal): 512 bytes / 512 bytes
12

sda1: EFI系统分区 1G，用于UEFI启动，存放引导加载程序
sda2: /boot分区 2G，存放内核和 initramfs
sda3: 它被用来创建LVM卷组(Volume Group), 进而花饭逻辑卷(Logical Volume) , /dev/sda3被用作LVM的底层存储

逻辑卷的容量只有 100G，默认安装的时候，虽然硬盘有 462.7GB 分配给了 LVM，但目前只用了其中的 100GB 创建了一个逻辑卷作为系统根目录。剩余空间仍保留在卷组中，可以随时扩展逻辑卷或创建新卷。

磁盘分区大致这样：

1物理磁盘 /dev/sda (500GB)
2├── /dev/sda1 → EFI 系统分区 (1GB)
3├── /dev/sda2 → /boot 分区 (2GB，可能)
4└── /dev/sda3 → LVM 物理卷 (462.7GB)
5        └── 卷组 ubuntu-vg
6                └── 逻辑卷 ubuntu-lv (100GB) → 挂载为 /
7

1.2 扩展逻辑卷并同时扩展文件系统

1# 确认文件系统
2dufo df -T /
3Filesystem                        Type 1K-blocks     Used Available Use% Mounted on
4/dev/mapper/ubuntu--vg-ubuntu--lv ext4 102626232 10978200  86388768  12% /
5
6

可以看到是 ext4 文件系统，使用西面命令完成扩容: 自动扩容LV 并 resize2fs

1sudo lvextend --resizefs -l +100%FREE /dev/mapper/ubuntu--vg-ubuntu--lv
2

-l +100%FREE：使用卷组中所有剩余空间

–resizefs：自动调整文件系统大小（对 ext4 有效）

1# 验证
2sudo lsblk
3NAME                      MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
4sda                         8:0    0 465.8G  0 disk
5├─sda1                      8:1    0     1G  0 part /boot/efi
6├─sda2                      8:2    0     2G  0 part /boot
7└─sda3                      8:3    0 462.7G  0 part
8  └─ubuntu--vg-ubuntu--lv 252:0    0 462.7G  0 lvm  /
9

可以看到逻辑卷容量已经全部是 sda3 分区的容量了

1.3 替换镜像源/更新

1# 查看当前镜像源, 发现是官方镜像源
2cat /etc/apt/sources.list.d/ubuntu.sources
3
4# 备份
5cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
6
7# 替换成华为云镜像源
8sudo sed -i 's|http://[a-z0-9\.]*\.archive\.ubuntu\.com|https://mirrors.huaweicloud.com|g' /etc/apt/sources.list.d/ubuntu.sources
9sudo sed -i 's|http://security\.ubuntu\.com|https://mirrors.huaweicloud.com|g' /etc/apt/sources.list.d/ubuntu.sources
10
11# 更新软件包列表（同步本地软件包索引和远程仓库）
12sudo apt update 
13# 升级所有已安装的软件包到最新版本（不处理依赖关系的重大变更）
14sudo apt upgrade -y
15# 清理无用包（系统运行并安装和卸载了不少东西后，使用，当前不需要执行）
16sudo apt autoremove
17

国内其它镜像源

镜像站	URIs 值
清华大学	https://mirrors.tuna.tsinghua.edu.cn/ubuntu
阿里云	https://mirrors.aliyun.com/ubuntu
中科大	https://mirrors.ustc.edu.cn/ubuntu
华为云	https://mirrors.huaweicloud.com/ubuntu

1.4 安装常用软件

1sudo apt update && sudo apt install -y vim wget telnet net-tools  lrzsz unzip   gcc libnuma-dev  dnsutils perl pciutils git wget htop jq make
2

显卡检查时会用到 lspci命令，该命令在 pciutils包中, 源码下载会用到git

2.显卡驱动安装

2.1确认显卡型号

1lspci | grep -i nvidia
201:00.0 VGA compatible controller: NVIDIA Corporation TU102 [GeForce RTX 2080 Ti Rev. A] (rev a1)
301:00.1 Audio device: NVIDIA Corporation TU102 High Definition Audio Controller (rev a1)
401:00.2 USB controller: NVIDIA Corporation TU102 USB 3.1 Host Controller (rev a1)
501:00.3 Serial bus controller: NVIDIA Corporation TU102 USB Type-C UCSI Controller (rev a1)
6
7# 确认你运行的内核版本，然后安装对应的开发包：
8# 查看当前运行的内核版本
9uname -r
10# 安装对应版本的内核开发包
11sudo apt install -y "linux-headers-$(uname -r)"
12

确认内核版本以及安装对应版本内核开发包很重要，要不然驱动无法安装

2.2检查是否存在开源驱动nouveau

1lsmod | grep nouveau
2

有输出说明存在。开源驱动会与NVIDA 驱动冲突。我的是有输出的

如果存在，则需要关闭 nouveau 驱动

1sudo tee /etc/modprobe.d/blacklist-nouveau.conf <<EOF
2blacklist nouveau
3options nouveau modeset=0
4EOF
5# 更新initramfs
6sudo update-initramfs -u
7# 重启
8sudo reboot 
9
10# 重启后确认,如果没有输出则表示已经关闭了
11sudo lsmod | grep nouveau
12

2.3驱动下载

https://www.nvidia.cn/drivers/lookup/

选择一个版本下载

将下载的文件存放到 /home/qy/soft目录备用

2.4执行安装

1cd /usr/local/src
2# 添加可执行权限
3 chmod +x NVIDIA-Linux-x86_64-580.105.08.run
4# 执行安装
5 sudo ./NVIDIA-Linux-x86_64-580.105.08.run
6

安装的时候，会让你选择许可证，我们直接选择 **NVIDIA Proprietary**即可

选项	许可证	特点	推荐选择
NVIDIA Proprietary	专有许可证	• 传统的NVIDIA专有驱动 • 经过长期测试，稳定性高 • 与各种NVIDIA功能完全兼容	大多数用户
MIT/GPL	开源许可证	• 较新的开源内核模块 • 更好的内核兼容性 • 遵循开源协议	特定场景用户

如果操作系统安装的是字符界面，则会出现一个警告:

WARNING: nvidia-installer was forced to guess the X library path ‘/usr/lib64’ and X module path ‘/usr/lib64/xorg/modules’;

这个警告信息表明NVIDIA安装程序无法自动检测到X Window系统的开发文件位置,解决这个警告你需要安装X.Org的开发包和pkg-config工具，

这个警告不会影响CUDA计算功能，只会影响图形显示，如果你只在字符界面使用Rocky Linux进行计算任务，可以暂时忽略这个警告

2.5 验证

1#  若输出显示显卡信息、驱动版本，则安装成功
2nvidia-smi
3

CUDA Version: 13.0 表示支持的 cuda 版本最高到 13.0 版本

3.安装CUDA

CUDA 是 Compute Unified Device Architecture 的缩写，是NVIDIA推出的并行计算平台和编程模型。

**本质：**让GPU不仅能处理图形，还能进行通用计算的平台

**作用：**允许开发者使用C/C++等语言直接在GPU上编写程序

**应用领域：**AI/深度学习、科学计算、数据分析、图形渲染等

前提条件，需要先安装 NVIDIA 驱动

1nvidia-smi  # 有输出，则确认驱动正常工作
2

3.1 下载CUDA Toolkit并安装

RTX 2080 Ti 的最优 CUDA 版本为 11.7 或 11.8，我们选择 11.8 版本下载，下载地址：https://developer.nvidia.com/cuda-toolkit-archive ，找到对应的版本，选择合适的环境下载。下载后，文件存放到 /home/qy/soft

1cd ~/soft
2
3wget https://developer.download.nvidia.com/compute/cuda/11.8.0/local_installers/cuda_11.8.0_520.61.05_linux.run
4
5sudo sh cuda_11.8.0_520.61.05_linux.run
6

安装的时候，会出现错误：unsupported compiler version: 14.2.1. Use --override to override this check. 此时使用下面命令跳过检查。原因是当前系统版本的gcc版本过高，cuda_11.8.0 不识别这个gcc版本。生产环境可以降低 gcc版本，比如gcc 10 版本。因为现在是测试，直接跳过检查

sudo sh cuda_11.8.0_520.61.05_linux.run --override

因为驱动已经安装了，所以这里需要将 “Driver” 选项去掉

安装完毕后，Toolkit 被安装在了 /usr/local/cuda-11.8, 同时有个链接文件 /usr/local/cuda指向了这个目录

3.2环境变量配置

1# 编辑bash配置文件
2sudo vim ~/.bashrc
3
4# 添加以下内容
5export PATH=/usr/local/cuda/bin${PATH:+:${PATH}}
6export LD_LIBRARY_PATH=/usr/local/cuda/lib64${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}
7export CUDA_HOME=/usr/local/cuda
8
9# 使配置生效
10 source ~/.bashrc
11

3.3验证

1# 检查CUDA编译器
2nvcc --version
3nvcc: NVIDIA (R) Cuda compiler driver
4Copyright (c) 2005-2022 NVIDIA Corporation
5Built on Wed_Sep_21_10:33:58_PDT_2022
6Cuda compilation tools, release 11.8, V11.8.89
7Build cuda_11.8.r11.8/compiler.31833905_0
8
9# 检查CUDA工具包版本
10nvidia-smi  # 查看右上角的CUDA Version
11

nvidia-smi 显示的CUDA版本是驱动程序支持的最高 CUDA版本，不是实际安装的CUDA版本，使用 nvcc --version显示的才是实际安装的版本。

4.安装Conda

Conda 是一个开源的包管理和环境管理系统，最初由 Anaconda 公司开发，主要用于 Python 及其他语言（如 R、Ruby、Lua、Perl、Haskell、C/C++）的包管理和环境管理。它可以安装、更新、卸载软件包，并创建隔离的虚拟环境，使得不同项目之间的依赖不会相互干扰。Conda与pip的区别：

1cd ~/soft
2# 下载安装脚本
3wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
4
5 # 执行安装
6sh Miniconda3-latest-Linux-x86_64.sh
7
8# 手动激活 base环境
9eval "$(/home/qy/miniconda3/bin/conda shell.bash hook)"
10
11# 接收许可
12conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
13conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
14
15# 查看源
16conda config --show-sources
17==> /home/qy/miniconda3/.condarc <==
18channels:
19  - defaults
20  
21conda config --set show_channel_urls yes
22
23conda config --show channels
24
25 # 自动激活base环境
26conda config --set auto_activate_base true
27
28

《DeepSeek-OCR实战(01)：基础运行环境搭建-Ubuntu》是转载文章，点击查看原文。