157 lines
3.3 KiB
Markdown
157 lines
3.3 KiB
Markdown
# 部署配置更新日志
|
||
|
||
## v1.0.1 (2024-12-23)
|
||
|
||
### 🔧 配置变更
|
||
|
||
#### 1. 前端端口调整
|
||
- **变更**: 前端默认端口从 `80` 改为 `8080`
|
||
- **原因**: 避免与常见服务冲突，提高兼容性
|
||
- **影响**:
|
||
- 访问地址变更为: `http://localhost:8080`
|
||
- 可在 `.env` 中配置 `FRONTEND_PORT` 自定义端口
|
||
|
||
#### 2. 存储目录映射优化
|
||
- **变更**: Storage 目录从 Docker Volume 改为宿主机目录映射
|
||
- **配置项**: 新增环境变量 `STORAGE_PATH`
|
||
- 默认值: `./storage`
|
||
- 支持相对路径和绝对路径
|
||
- 示例:
|
||
```bash
|
||
STORAGE_PATH=./storage # 相对路径
|
||
STORAGE_PATH=/data/nex-docus-data # 绝对路径
|
||
```
|
||
- **优势**:
|
||
- ✅ 便于直接访问和管理文件
|
||
- ✅ 方便备份和迁移
|
||
- ✅ 支持挂载到独立磁盘或网络存储
|
||
- ✅ 数据独立于容器生命周期
|
||
|
||
### 📝 配置文件更新
|
||
|
||
已更新以下文件：
|
||
- `.env.example` - 添加 `STORAGE_PATH` 配置，修改 `FRONTEND_PORT` 默认值
|
||
- `docker-compose.yml` - 修改 storage 为宿主机目录映射
|
||
- `deploy.sh` - 更新访问信息显示
|
||
- `DEPLOY.md` - 更新部署文档
|
||
|
||
### 🔄 迁移指南
|
||
|
||
如果您已经部署了旧版本，需要进行以下操作：
|
||
|
||
#### 方案 1: 保留现有数据（推荐）
|
||
|
||
```bash
|
||
# 1. 停止服务
|
||
./deploy.sh stop
|
||
|
||
# 2. 备份现有数据
|
||
docker run --rm -v nex-docus_storage_data:/from -v $(pwd)/storage:/to alpine sh -c "cd /from && cp -r . /to"
|
||
|
||
# 3. 更新配置文件
|
||
cp .env.example .env
|
||
vim .env # 配置 STORAGE_PATH=./storage
|
||
|
||
# 4. 重新启动
|
||
./deploy.sh start
|
||
|
||
# 5. 删除旧的 volume（可选）
|
||
docker volume rm nex-docus_storage_data
|
||
```
|
||
|
||
#### 方案 2: 全新部署
|
||
|
||
```bash
|
||
# 1. 备份数据库
|
||
./deploy.sh backup
|
||
|
||
# 2. 完全卸载
|
||
./deploy.sh uninstall
|
||
|
||
# 3. 重新初始化
|
||
./deploy.sh init
|
||
|
||
# 4. 恢复数据库（如需要）
|
||
./deploy.sh restore <backup_file>
|
||
```
|
||
|
||
### 📊 配置示例
|
||
|
||
#### 开发环境配置
|
||
```bash
|
||
FRONTEND_PORT=8080
|
||
BACKEND_PORT=8000
|
||
STORAGE_PATH=./storage
|
||
DEBUG=true
|
||
```
|
||
|
||
#### 生产环境配置
|
||
```bash
|
||
FRONTEND_PORT=80
|
||
BACKEND_PORT=8000
|
||
STORAGE_PATH=/data/nex-docus-storage
|
||
DEBUG=false
|
||
```
|
||
|
||
#### 多实例部署配置
|
||
```bash
|
||
# 实例 1
|
||
FRONTEND_PORT=8081
|
||
BACKEND_PORT=8001
|
||
STORAGE_PATH=/data/instance1/storage
|
||
|
||
# 实例 2
|
||
FRONTEND_PORT=8082
|
||
BACKEND_PORT=8002
|
||
STORAGE_PATH=/data/instance2/storage
|
||
```
|
||
|
||
### ⚙️ 存储路径说明
|
||
|
||
`STORAGE_PATH` 目录结构：
|
||
```
|
||
storage/
|
||
├── projects/ # 项目文档存储
|
||
│ ├── <uuid1>/ # 项目 1
|
||
│ │ ├── README.md
|
||
│ │ ├── docs/
|
||
│ │ └── _assets/ # 项目资源
|
||
│ └── <uuid2>/ # 项目 2
|
||
└── temp/ # 临时文件
|
||
```
|
||
|
||
### 🔒 安全建议
|
||
|
||
1. **权限设置**
|
||
```bash
|
||
# 设置适当的目录权限
|
||
chmod 755 storage
|
||
chown -R 1000:1000 storage # Docker 容器内用户
|
||
```
|
||
|
||
2. **备份策略**
|
||
```bash
|
||
# 定时备份 storage 目录
|
||
tar -czf storage_backup_$(date +%Y%m%d).tar.gz storage/
|
||
```
|
||
|
||
3. **网络存储**
|
||
```bash
|
||
# 挂载 NFS
|
||
mount -t nfs server:/share /data/nex-docus-storage
|
||
|
||
# 配置 .env
|
||
STORAGE_PATH=/data/nex-docus-storage
|
||
```
|
||
|
||
### 📞 支持
|
||
|
||
如有问题，请查看：
|
||
- [部署文档](DEPLOY.md)
|
||
- [项目文档](README_DOCKER.md)
|
||
- 或提交 Issue
|
||
|
||
---
|
||
|
||
**更新时间**: 2024-12-23
|