chenpei 7909c31479 🏠 添加NAS环境部署支持和配置修复
✨ 新增内容:
- 添加 NAS_DEPLOYMENT_GUIDE.md 详细部署指南
- 专门针对群晖、威联通等NAS环境的部署方案
- 包含一键部署脚本和故障排除指南

🔧 配置修复:
- 修复 docker-compose.base-aliyun-beijing.yml 构建配置
- 从 Dockerfile.git 改回 Dockerfile 避免文件缺失问题
- 保持存储路径为 /vol1/1000/yunpan2

🎯 现在支持:
- 本地Docker环境
- NAS Docker环境
- 阿里云环境
- 各种自定义环境
2025-08-24 11:41:57 +08:00
2025-08-24 11:21:48 +08:00
2025-08-24 11:21:48 +08:00
2025-08-24 11:21:48 +08:00

JmalCloud 公共空间版 - 个人网盘服务端

基于 JmalCloud 改造的公共空间版本

🚀 项目简介

这是一个基于原版 JmalCloud 改造的公共空间版本,将原来的用户独立文件空间模式改为所有用户共享同一文件空间的模式。

📋 主要变更

  • ✅ 公共文件空间:所有用户登录后看到相同的文件列表
  • ✅ 统一存储:文件存储在统一的公共目录中,不再按用户分离
  • ✅ 共享操作:任何用户都可以上传、下载、删除、重命名所有文件
  • ✅ 保留认证:用户登录验证和基本权限控制仍然有效
  • ✅ 元数据保留:文件的创建者信息仍保存在数据库中

🔧 核心改造内容

后端修改

  1. 文件存储路径统一化 - 移除用户名路径组件
  2. 数据库查询去用户化 - 移除 userId 过滤条件
  3. 文件操作公共化 - 所有文件操作适配公共空间
  4. 用户目录管理适配 - 不再创建用户专属目录

前端兼容性

  • ✅ 无需修改 - 前端代码完全兼容,无需任何变更
  • ✅ API向后兼容 - 保持原有接口参数,仅后端逻辑调整

🎯 适用场景

  • 家庭网盘 - 家庭成员共享文件存储空间
  • 小团队协作 - 团队内部文件共享和协作
  • 企业内网盘 - 企业内部公共文件存储
  • 学校/机构 - 教学资源共享平台

⚠️ 重要注意事项

数据迁移

# 需要手动将现有用户文件迁移到公共目录
# 原来的结构: /rootDir/user1/file1.txt
# 现在的结构: /rootDir/file1.txt

安全考虑

  • 文件安全性:所有登录用户都能访问所有文件
  • 权限控制:需要在应用层面控制用户访问权限
  • 数据备份:建议在使用前备份原始数据

🔄 从原版迁移

  1. 备份数据

    # 备份原有文件和数据库
    cp -r /your/original/files /backup/location
    
  2. 部署改造版

    # 部署修改后的代码
    # 使用相同的配置文件和数据库
    
  3. 文件迁移

    # 将用户目录中的文件移动到公共根目录
    # 注意处理文件名冲突
    

📁 文件结构对比

改造前

/rootDir/
├── user1/
│   ├── file1.txt
│   └── folder1/
└── user2/
    ├── file2.txt
    └── folder2/

改造后

/rootDir/
├── file1.txt
├── file2.txt
├── folder1/
└── folder2/

🛠️ 部署说明

环境要求

  • Java 21+
  • MongoDB 4.4+
  • Maven 3.6+

构建和运行

# 构建项目
mvn clean package -DskipTests

# 运行
java -jar target/clouddisk-*.jar

Docker 部署

🎯 方案1:从Git仓库构建部署(推荐)

# 一键构建和部署
./build-from-git.sh

# 或手动操作
docker-compose -f docker-compose.git.yml up -d --build

🎯 方案2:使用预构建镜像

# 使用提供的 docker-compose.yml
docker-compose up -d

🔗 Git仓库信息

📝 变更日志

v2.15.0-public-space

  • 改造为公共空间模式
  • 移除用户文件隔离机制
  • 统一文件存储路径
  • 保持前端API兼容性

🤝 贡献

如果你发现问题或有改进建议,欢迎提交 Issue 或 Pull Request。

📄 许可

MIT license.

Copyright (c) 2023-present jmal


免责声明: 这是基于开源项目 JmalCloud 的自定义改造版本,使用前请仔细评估安全性和适用性。原作者不对此改造版本承担责任。

Description
JmalCloud公共空间版 - 个人网盘改造项目
Readme MIT 13 MiB
Languages
Java 50.8%
Vue 27.1%
JavaScript 12.1%
HTML 3.8%
SCSS 3.2%
Other 2.9%