【DeepSeek 本地部署最详细指南】

通过以上步骤，你应该能够成功在本地部署 DeepSeek。如果在部署过程中遇到问题，可以参考官方文档或社区支持。希望这个详细的指南能帮助你顺利完成部署！注意：本文假设你已经具备基本的 Linux 命令行操作知识。如果你在部署过程中遇到问题，欢迎在评论区留言，我会尽力解答！

demotang1

886人浏览 · 2025-02-24 15:02:46

demotang1 · 2025-02-24 15:02:46 发布

DeepSeek 本地部署最详细指南

本文将详细介绍如何在本地部署 DeepSeek，包括环境准备、依赖安装、配置调整、服务启动等内容。每一步都配有详细的命令和说明，确保即使是初学者也能顺利完成部署。

1. 环境准备

1.1 操作系统

推荐操作系统: Ubuntu 20.04 LTS 或 CentOS 7
其他支持的操作系统: Windows 10, macOS

1.2 硬件要求

CPU: 至少 4 核
内存: 至少 8GB
存储: 至少 50GB 可用空间

1.3 软件依赖

Docker: 用于容器化部署
Docker Compose: 用于管理多容器应用
Git: 用于代码版本控制

2. 安装依赖

2.1 安装 Docker

在终端中运行以下命令安装 Docker：

# 更新包索引
sudo apt-get update

# 安装必要的包
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common

# 添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加 Docker 仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 更新包索引
sudo apt-get update

# 安装 Docker CE
sudo apt-get install docker-ce

# 启动 Docker 服务
sudo systemctl start docker

# 设置 Docker 开机自启
sudo systemctl enable docker

2.2 安装 Docker Compose

运行以下命令安装 Docker Compose：

# 下载 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 赋予执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

2.3 安装 Git

运行以下命令安装 Git：

sudo apt-get install git

3. 获取 DeepSeek 代码

3.1 克隆代码库

在终端中运行以下命令克隆 DeepSeek 代码库：

git clone https://github.com/deepseek/deepseek.git
cd deepseek

4. 配置 DeepSeek

4.1 配置文件

在 deepseek 目录下，找到 config 文件夹，编辑 config.yaml 文件，根据你的需求调整配置。

# 示例配置
database:
  host: localhost
  port: 5432
  user: deepseek
  password: deepseek
  dbname: deepseek

server:
  host: 0.0.0.0
  port: 8080

4.2 环境变量

在 deepseek 目录下，创建 .env 文件，设置环境变量。

# 示例环境变量
DATABASE_URL=postgres://deepseek:deepseek@localhost:5432/deepseek
SERVER_HOST=0.0.0.0
SERVER_PORT=8080

5. 启动 DeepSeek

5.1 使用 Docker Compose 启动

在 deepseek 目录下运行以下命令启动服务：

docker-compose up -d

5.2 验证服务

运行以下命令查看容器状态：

docker ps

你应该看到类似以下的输出：

CONTAINER ID   IMAGE           COMMAND                  CREATED        STATUS        PORTS                    NAMES
abc12345678   deepseek_app    "python app.py"          5 minutes ago  Up 5 minutes  0.0.0.0:8080->8080/tcp   deepseek_app_1

6. 访问 DeepSeek

打开浏览器，访问 http://localhost:8080，你应该能看到 DeepSeek 的欢迎页面。

7. 常见问题排查

7.1 端口冲突

如果端口 8080 已被占用，可以在 config.yaml 中修改 server.port 配置。

7.2 数据库连接失败

确保数据库服务已启动，并且配置文件中数据库连接信息正确。

7.3 Docker 容器无法启动

检查 Docker 日志，使用以下命令查看日志：

docker logs <container_id>

8. 图示

8.1 目录结构

deepseek/
├── config/
│   └── config.yaml
├── .env
├── docker-compose.yml
├── Dockerfile
└── README.md

8.2 Docker Compose 文件示例

version: '3'
services:
  app:
    image: deepseek_app
    build: .
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=${DATABASE_URL}
      - SERVER_HOST=${SERVER_HOST}
      - SERVER_PORT=${SERVER_PORT}
    depends_on:
      - db

  db:
    image: postgres:13
    environment:
      POSTGRES_USER: deepseek
      POSTGRES_PASSWORD: deepseek
      POSTGRES_DB: deepseek
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data: