nex_docus/CHANGELOG_DEPLOY.md

部署配置更新日志

v1.0.1 (2024-12-23)

🔧 配置变更

1. 前端端口调整

• 变更: 前端默认端口从 80 改为 8080
• 原因: 避免与常见服务冲突，提高兼容性
• 影响:
  • 访问地址变更为: http://localhost:8080
  • 可在 .env 中配置 FRONTEND_PORT 自定义端口

2. 存储目录映射优化

• 变更: Storage 目录从 Docker Volume 改为宿主机目录映射
• 配置项: 新增环境变量 STORAGE_PATH
  • 默认值: ./storage
  • 支持相对路径和绝对路径
  • 示例:

    STORAGE_PATH=./storage              # 相对路径
    STORAGE_PATH=/data/nex-docus-data  # 绝对路径
    

• 优势:
  • ✅ 便于直接访问和管理文件
  • ✅ 方便备份和迁移
  • ✅ 支持挂载到独立磁盘或网络存储
  • ✅ 数据独立于容器生命周期

📝 配置文件更新

已更新以下文件：

• .env.example - 添加 STORAGE_PATH 配置，修改 FRONTEND_PORT 默认值
• docker-compose.yml - 修改 storage 为宿主机目录映射
• deploy.sh - 更新访问信息显示
• DEPLOY.md - 更新部署文档

🔄 迁移指南

如果您已经部署了旧版本，需要进行以下操作：

方案 1: 保留现有数据（推荐）

# 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: 全新部署

# 1. 备份数据库
./deploy.sh backup

# 2. 完全卸载
./deploy.sh uninstall

# 3. 重新初始化
./deploy.sh init

# 4. 恢复数据库（如需要）
./deploy.sh restore <backup_file>

📊 配置示例

开发环境配置

FRONTEND_PORT=8080
BACKEND_PORT=8000
STORAGE_PATH=./storage
DEBUG=true

生产环境配置

FRONTEND_PORT=80
BACKEND_PORT=8000
STORAGE_PATH=/data/nex-docus-storage
DEBUG=false

多实例部署配置

# 实例 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. 权限设置

   # 设置适当的目录权限
   chmod 755 storage
   chown -R 1000:1000 storage  # Docker 容器内用户
   

2. 备份策略

   # 定时备份 storage 目录
   tar -czf storage_backup_$(date +%Y%m%d).tar.gz storage/
   

3. 网络存储

   # 挂载 NFS
   mount -t nfs server:/share /data/nex-docus-storage
   
   # 配置 .env
   STORAGE_PATH=/data/nex-docus-storage
   

📞 支持

如有问题，请查看：

• 部署文档
• 项目文档
• 或提交 Issue

---

更新时间: 2024-12-23