一、本地部署前准备
1. 系统要求
-
操作系统:Ubuntu 20.04/22.04 LTS 或 CentOS 7.9/8.5
-
硬件配置:
-
CPU:4核(推荐8核)
-
内存:16GB(推荐32GB)
-
存储:50GB 可用空间(SSD推荐)
-
-
网络:开放端口
80
(HTTP)、443
(HTTPS)、8000
(API)
2. 安装依赖
# Ubuntu
sudo apt update && sudo apt install -y docker.io docker-compose git python3-pip
# CentOS
sudo yum install -y docker docker-compose git python3
sudo systemctl start docker && sudo systemctl enable docker
二、获取部署包与配置
1. 克隆仓库
git clone https://github.com/deepseek-ai/DeepSeek-R1.git
cd DeepSeek-R1/deploy
2. 修改配置文件
编辑 .env
文件,设置基础参数:
# API服务端口
API_PORT=8000
# 数据库密码
DB_PASSWORD=your_secure_password
# 域名(本地测试可设为IP)
DOMAIN=192.168.1.100
3. 构建镜像
sudo docker-compose build
三、启动服务
1. 一键部署
sudo docker-compose up -d
2. 验证服务状态
sudo docker ps -a
四、页面升级问题处理
1. 常见错误场景
-
场景1:静态资源加载失败(404错误)
原因:Nginx配置未更新或缓存未清除。
解决:# 重新生成前端静态文件 cd frontend && npm run build # 重启Nginx sudo docker-compose restart nginx
-
场景2:数据库迁移失败
原因:版本升级时Schema不兼容。
解决:# 回滚到旧版本 sudo docker-compose exec api python manage.py migrate --fake-initial # 手动修复迁移文件后重试 sudo docker-compose exec api python manage.py migrate
2. 手动升级步骤
-
拉取最新代码
git pull origin main
-
更新镜像与依赖
sudo docker-compose down sudo docker-compose build --no-cache sudo docker-compose up -d
-
执行数据迁移
sudo docker-compose exec api python manage.py migrate
-
清除浏览器缓存
-
按
Ctrl+F5
强制刷新页面。
-
五、验证部署成功
1. API测试
curl http://localhost:8000/api/health
-
预期响应:
{"status": "ok", "version": "1.2.0"}
2. 页面访问
浏览器打开 http://192.168.1.100
六、备份与恢复
1. 定期备份
# 备份数据库
sudo docker-compose exec db pg_dump -U postgres deepseek > backup.sql
# 备份配置文件
tar -czvf config_backup.tar.gz ./config/*
2. 灾难恢复
# 停止服务
sudo docker-compose down
# 恢复数据库
cat backup.sql | sudo docker-compose exec -T db psql -U postgres deepseek
# 重启服务
sudo docker-compose up -d
七、常见问题FAQ
-
Q:升级后页面空白怎么办?
-
A:检查前端构建日志
frontend/build.log
,确保无npm ERR!
。
-
-
Q:如何查看实时日志?
-
A:
sudo docker-compose logs -f api
-
-
Q:端口冲突如何修改?
-
A:编辑
docker-compose.yml
中ports
配置,如"8080:80"
。
-
按照本教程操作,可完成 DeepSeek-R1 的本地部署与平滑升级。若遇复杂问题,参考官方文档或提交Issue至GitHub仓库。
紧急页面访问升级:技术解决方案与预防措施