206 lines
4.6 KiB
Markdown
206 lines
4.6 KiB
Markdown
|
# 甲辰藏品管理系统 v1.0.1 升级指南
|
|||
|
|
|
|||
|
|
**版本**: v1.0.1
|
|||
|
|
**发布日期**: 2026-03-16
|
|||
|
|
**前置版本**: v1.0.0
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 升级内容
|
|||
|
|
|
|||
|
|
### 主要修复
|
|||
|
|
|
|||
|
|
1. **Logo 显示规范化** - 仅在登录页、首页显示
|
|||
|
|
2. **图片代理修复** - Nginx location 优先级调整
|
|||
|
|
3. **后端图片数据加载** - 藏品列表 API 返回图片
|
|||
|
|
4. **前端图片路径修复** - 避免路径重复
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📋 升级步骤
|
|||
|
|
|
|||
|
|
### 方案一：完整升级（推荐）
|
|||
|
|
|
|||
|
|
#### 1. 备份当前版本
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 备份数据库
|
|||
|
|
sudo -u postgres pg_dump zodiac > /backup/zodiac_v1.0.0.sql
|
|||
|
|
|
|||
|
|
# 备份代码
|
|||
|
|
cp -r /opt/jiachenlong-backend /opt/jiachenlong-backend.backup
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 2. 拉取最新代码
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd /opt/jiachenlong-backend
|
|||
|
|
git pull origin master
|
|||
|
|
git checkout v1.0.1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 3. 更新后端
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装依赖（如有更新）
|
|||
|
|
pip3 install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 重启后端服务
|
|||
|
|
pkill -f 'python.*uvicorn'
|
|||
|
|
sleep 2
|
|||
|
|
export DATABASE_URL='postgresql://postgres:postgres@47.98.171.101:5432/zodiac'
|
|||
|
|
nohup /usr/bin/python3.11 -m uvicorn app.main:app --port 3000 --host 0.0.0.0 > /tmp/uvicorn.log 2>&1 &
|
|||
|
|
|
|||
|
|
# 验证服务
|
|||
|
|
sleep 5
|
|||
|
|
curl http://localhost:3000/health
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 4. 更新前端
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 构建前端
|
|||
|
|
cd /path/to/jiachenlong/frontend
|
|||
|
|
npm install
|
|||
|
|
npm run build
|
|||
|
|
|
|||
|
|
# 部署到前端服务器
|
|||
|
|
scp -r dist/* root@8.149.137.26:/var/www/html/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 5. 更新 Nginx 配置
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 复制新配置
|
|||
|
|
scp config/nginx.conf root@8.149.137.26:/etc/nginx/conf.d/jiachenlong.conf
|
|||
|
|
|
|||
|
|
# 重启 Nginx
|
|||
|
|
ssh root@8.149.137.26 "nginx -t && nginx -s reload"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 6. 验证升级
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 测试 Logo 显示
|
|||
|
|
curl http://8.149.137.26/ | grep "甲辰收藏"
|
|||
|
|
|
|||
|
|
# 测试图片代理
|
|||
|
|
curl -o /dev/null -w '%{http_code}' http://8.149.137.26/uploads/collections/admin-0001-J051963351.jpeg
|
|||
|
|
|
|||
|
|
# 测试 API
|
|||
|
|
TOKEN=$(curl -s -X POST http://47.110.37.129:3000/api/auth/login -d 'username=admin&password=admin123' | grep -oP '"access_token":\s*"\K[^"]+')
|
|||
|
|
curl -s -H "Authorization: Bearer $TOKEN" http://47.110.37.129:3000/api/collections?limit=1 | python3 -c "import sys,json; d=json.load(sys.stdin); print('图片数:', len(d.get('data',[{}])[0].get('images',[])))"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 方案二：快速升级（仅修复图片问题）
|
|||
|
|
|
|||
|
|
#### 1. 仅更新 Nginx 配置
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 复制 Nginx 配置
|
|||
|
|
scp config/nginx.conf root@8.149.137.26:/etc/nginx/conf.d/jiachenlong.conf
|
|||
|
|
|
|||
|
|
# 重启 Nginx
|
|||
|
|
ssh root@8.149.137.26 "nginx -t && nginx -s reload"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 2. 仅更新后端代码
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 更新 collections.py
|
|||
|
|
scp backend/app/routers/collections.py root@47.110.37.129:/opt/jiachenlong-backend/app/routers/
|
|||
|
|
|
|||
|
|
# 重启后端
|
|||
|
|
ssh root@47.110.37.129 "pkill -f uvicorn && sleep 2 && export DATABASE_URL='postgresql://postgres:postgres@47.98.171.101:5432/zodiac' && cd /opt/jiachenlong-backend && nohup /usr/bin/python3.11 -m uvicorn app.main:app --port 3000 --host 0.0.0.0 > /tmp/uvicorn.log 2>&1 &"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 3. 仅更新前端代码
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 构建并部署
|
|||
|
|
cd frontend
|
|||
|
|
npm run build
|
|||
|
|
scp -r dist/* root@8.149.137.26:/var/www/html/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔍 验证清单
|
|||
|
|
|
|||
|
|
### Logo 显示
|
|||
|
|
- [ ] 登录页面显示 Logo
|
|||
|
|
- [ ] 首页显示 Logo
|
|||
|
|
- [ ] 藏品详情页无图片时显示"无图片"
|
|||
|
|
- [ ] Logo 不替代缺失的藏品图片
|
|||
|
|
|
|||
|
|
### 图片功能
|
|||
|
|
- [ ] 藏品列表显示缩略图
|
|||
|
|
- [ ] 藏品详情显示大图
|
|||
|
|
- [ ] 图片预览弹窗正常
|
|||
|
|
- [ ] 图片切换功能正常
|
|||
|
|
- [ ] 后端图片代理正常（HTTP 200）
|
|||
|
|
|
|||
|
|
### API 接口
|
|||
|
|
- [ ] GET /api/collections 返回图片数据
|
|||
|
|
- [ ] GET /api/collections/:id 返回图片详情
|
|||
|
|
- [ ] GET /uploads/collections/xxx.jpg 返回 200
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ⚠️ 注意事项
|
|||
|
|
|
|||
|
|
### 升级前
|
|||
|
|
1. ✅ 备份数据库
|
|||
|
|
2. ✅ 备份代码
|
|||
|
|
3. ✅ 通知用户系统维护
|
|||
|
|
|
|||
|
|
### 升级中
|
|||
|
|
1. ✅ 按顺序执行步骤
|
|||
|
|
2. ✅ 每步验证成功再继续
|
|||
|
|
3. ✅ 记录遇到的问题
|
|||
|
|
|
|||
|
|
### 升级后
|
|||
|
|
1. ✅ 验证所有功能
|
|||
|
|
2. ✅ 检查错误日志
|
|||
|
|
3. ✅ 监控系统性能
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🐛 回滚方案
|
|||
|
|
|
|||
|
|
### 回滚到 v1.0.0
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 回滚代码
|
|||
|
|
cd /opt/jiachenlong-backend
|
|||
|
|
git checkout v1.0.0
|
|||
|
|
|
|||
|
|
# 恢复 Nginx 配置
|
|||
|
|
ssh root@8.149.137.26 "cp /etc/nginx/conf.d/jiachenlong.conf.backup /etc/nginx/conf.d/jiachenlong.conf && nginx -s reload"
|
|||
|
|
|
|||
|
|
# 重启服务
|
|||
|
|
pkill -f uvicorn
|
|||
|
|
cd /opt/jiachenlong-backend
|
|||
|
|
nohup /usr/bin/python3.11 -m uvicorn app.main:app --port 3000 --host 0.0.0.0 &
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📞 技术支持
|
|||
|
|
|
|||
|
|
- **代码仓库**: http://47.253.189.47:3000/coolbot/jiachenlong
|
|||
|
|
- **版本标签**: v1.0.1
|
|||
|
|
- **相关文档**:
|
|||
|
|
- `docs/RELEASE_v1.0.1.md` - 发布说明
|
|||
|
|
- `docs/IMAGE_PROCESSING_FLOW.md` - 图片处理流程
|
|||
|
|
- `docs/DEPLOYMENT_COMPLETE_v1.0.1.md` - 部署报告
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**升级完成！系统运行正常！** 🎉
|
|||
|
|
|
|||
|
|
**甲辰藏品管理系统开发团队**
|
|||
|
|
2026-03-16
|