Deepseek在Linux上的安装与配置指南

一、安装前环境检查与准备

1.1 系统兼容性验证

Deepseek支持主流Linux发行版（Ubuntu 20.04+/CentOS 8+/Debian 10+），建议使用64位系统。通过以下命令确认系统架构：

uname -m
# 应返回x86_64（64位）或aarch64（ARM64）

如果本地环境暂不具备部署条件，也可以直接在千帆大模型平台了解Deepseek等热门模型的在线调用方式，作为本地安装之外的选择。

1.2 依赖项预安装

核心依赖包括：

• Python 3.8+：建议使用虚拟环境隔离

# Ubuntu示例
sudo apt update && sudo apt install -y python3.9 python3.9-venv

• GCC工具链：用于编译扩展模块

sudo apt install -y build-essential

• 系统库：

# Ubuntu/Debian
sudo apt install -y libopenblas-dev liblapack-dev libatlas-base-dev

# CentOS/RHEL
sudo yum install -y openblas-devel lapack-devel

1.3 网络配置优化

• 确保端口8080（默认API端口）未被占用：

sudo netstat -tulnp | grep 8080

• 如需代理访问，配置环境变量：

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=$HTTP_PROXY

二、Deepseek安装流程

2.1 官方包安装（推荐）

从Deepseek官方仓库获取最新版本：

# 添加GPG密钥（示例）
wget -qO- https://deepseek.ai/repo/gpg.key | sudo tee /etc/apt/trusted.gpg.d/deepseek.asc

# 添加仓库（Ubuntu示例）
echo "deb [arch=amd64] https://deepseek.ai/repo/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/deepseek.list

# 安装
sudo apt update && sudo apt install -y deepseek-server

2.2 源码编译安装（高级用户）

# 下载源码
git clone https://github.com/deepseek-ai/deepseek.git
cd deepseek

# 创建虚拟环境
python3.9 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 编译C扩展
python setup.py build_ext --inplace

2.3 Docker容器部署

# 拉取官方镜像
docker pull deepseek/deepseek-server:latest

# 运行容器
docker run -d --name deepseek \
  -p 8080:8080 \
  -v /path/to/config:/etc/deepseek \
  -v /path/to/data:/var/lib/deepseek \
  deepseek/deepseek-server

三、安装后配置与验证

3.1 服务配置

编辑/etc/deepseek/config.yaml：

server:
  host: 0.0.0.0
  port: 8080
  workers: 4

model:
  path: /var/lib/deepseek/models/default.bin
  device: cuda  # 或cpu

3.2 模型文件部署

• 将预训练模型文件放入指定目录：

sudo mkdir -p /var/lib/deepseek/models
sudo chown -R deepseek:deepseek /var/lib/deepseek

• 验证模型完整性：

md5sum /var/lib/deepseek/models/default.bin | grep "预期哈希值"

3.3 服务状态检查

# Systemd服务（包安装方式）
sudo systemctl status deepseek

# 进程检查
ps aux | grep deepseek

# 端口监听
sudo ss -tulnp | grep 8080

四、常见问题解决方案

4.1 依赖冲突处理

症状：ModuleNotFoundError: No module named 'numpy'
解决：

# 在虚拟环境中重新安装
source venv/bin/activate
pip install --upgrade --force-reinstall numpy

4.2 CUDA支持配置

步骤：

1. 确认NVIDIA驱动已安装：

nvidia-smi

1. 安装CUDA工具包：

# Ubuntu示例
sudo apt install -y nvidia-cuda-toolkit

1. 在配置中启用GPU：

model:
  device: cuda
  cuda_device: 0  # 指定GPU编号

4.3 日志分析

日志文件通常位于/var/log/deepseek/，关键日志级别说明：

• ERROR：必须立即处理
• WARNING：建议检查
• INFO：正常操作记录

如果希望减少本地部署与运维的负担，也可以直接使用云端大模型服务，可以查看当前的产品专题活动千帆大模型专题活动页。

五、性能优化建议

5.1 内存管理

• 对于大型模型，建议设置交换空间：

sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

5.2 并发配置

根据服务器核心数调整worker数量：

server:
  workers: $(nproc)  # 使用所有CPU核心

5.3 监控集成

推荐使用Prometheus+Grafana监控：

# 安装Prometheus节点导出器
sudo apt install -y prometheus-node-exporter

在Grafana中添加Deepseek的metrics端点（通常为http://localhost:8080/metrics）。

六、升级与维护

6.1 版本升级

# 包安装方式
sudo apt update && sudo apt upgrade -y deepseek-server

# Docker方式
docker pull deepseek/deepseek-server:latest
docker restart deepseek

6.2 备份策略

# 模型备份
tar -czvf deepseek-models-backup-$(date +%Y%m%d).tar.gz /var/lib/deepseek/models

# 配置备份
cp /etc/deepseek/config.yaml ~/deepseek-config-backup.yaml

本指南涵盖了Deepseek在Linux环境下的完整安装生命周期，从环境准备到高级优化。实际部署时，建议先在测试环境验证配置，再迁移到生产环境。对于企业级部署，可考虑结合Kubernetes实现高可用集群部署。如果希望以API方式快速接入大模型能力，也可以选购大模型相关的token套餐，例如面向个人开发者的Token plan个人版购买页。

购买入口说明

以下链接直接进入购买页面，不是介绍页，下单前请自行核对内容与金额。

• 个人版Token购买：面向个人开发者
• 企业版Token购买：面向企业团队
• Token福利包：通用积分，可叠加购买，用于通用模型调用、百度搜索等工具调用、OCR等AI开放能力调用
• 通用资源点：可在百度搭子、百度秒哒、百度胜算、百度伐谋之间灵活抵扣