# 部署配置更新日志

## 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