# fileCloud

仿百度网盘，实现个人文件存储云盘。

## 功能支持

- 账号登陆、验证
- 文件上传。 支持单文件、多文件、文件夹上传
- 文件、文件夹拷贝、移动
- 文件下载
- 分享链接 
- 在线预览 todo

## 页面展示

文件上传
![文件上传](assets/upload.png)
文件移动、拷贝
![文件移动](assets/move.png)
分享
![文件分享](assets/shared.png)
已分享列表
![分享列表](assets/shared_list.png)


## 分片上传、断点续传

文件过大时，上传文件需要很长时间，且中途退出将导致文件重传。

分片上传: 上传文件时，在本地将文件按照 4M 的大小将文件进行分片。在服务器端将文件组合。

断点续传: 如果文件没有上传完，关闭客户端。再一次上传文件时，对比服务器已经上传的分片，只需要上传没有的分片。

程序重启时，由于不保存目录结构和上传进度。会删除已经上传的文件分片，再次上传从头开始。

## 秒传

每一个文件都有对应的md5码。当检测上传文件时，如果本地已经存在相同md5的文件，则不需要用户上传。

## 链接分享

选择同一路径下多个文件、文件夹进行分享。后端生成一条访问链接及提取码。类似百度网盘

`链接: http://127.0.0.1:9987/shared/s/ODWA8WRPH9ZfWLea  提取码: EsRr`

说明： 后端仅缓存分享的路径及选择的文件，不做源文件的移动拷贝等。存在分享后又移除了分享的文件，
用户能正常访问链接，但不会展示该文件。

## 文件保存方案

SaveFileMultiple 文件是否保存为多份。

已经存在md5文件时
- 当 SaveFileMultiple=false，仅添加文件指向，当前文件夹下不存在该文件，即整个云盘只存在一份源文件。
删除时，判读文件引用，当引用为0时执行文件的删除;若删除源文件且还有文件引用，将文件移动到引用处。
- 当 SaveFileMultiple=true，会将源文件拷贝一份到当前目录。整个云盘存在多份文件，磁盘占用为N倍。删除时，直接删除当前文件。

由于不设计目录结构的保存，故 SaveFileMultiple=false时，程序重启会恢复到真实目录文件结构。

## 不做目录结构和文件上传分片保存说明

目录结构，文件上传分片保存在内存中。程序重启后会丢失信息。

若目录文件存在手动修改，保存信息后重启将导致文件数据不匹配，保不保存意义不大。

若目录文件不存在手动修改，仅有 SaveFileMultiple=false 时,重启时需要还原到停机状态才需要保存信息。
而 SaveFileMultiple=true，重启加载目录与停机时一致，不需要保存信息。

故重启目录结构显示是真实的目录结构。上传的文件分片会在重启加载时删除。

## Develop

前端： node20 + vue 2.7.15 + [antd.1x](https://1x.antdv.com/docs/vue/introduce-cn/)

后端： go 1.21.3 linux/amd64 + [gin](https://github.com/gin-gonic/gin)


1、配置 front-vue/public/config.js
```

```
2、前端编译；
```
export NODE_OPTIONS=--openssl-legacy-provider
yarn config set ignore-engines true
yarn
yarn build
yarn  serve
```

3、配置 back-go/cmd/config.toml :
```
  WebAddr   = "127.0.0.1:9987"            # web 地址
  WebIndex  = "../../front-vue/dist"      # web html目录
  FilePath  = "cloud"                     # 文件存放目录
  SaveFileMultiple = true                 # 文件是否保存为多份
  FileDiskTotal    = 50                   # 配置的网盘容量，单位 M
```

4、后端构建：
```
go mod init
go mod tidy
go mod vendor
cd back-go

# windows
GOOS=windows go build cmd/filecloud.go
make build_windows

# linux
go build cmd/filecloud.go
go run cmd/filecloud.go
```

5、浏览器访问 `http://127.0.0.1:9987` 

## Reference

- [filecloud](https://github.com/yddeng/filecloud)
- [CasaOS](https://github.com/IceWhaleTech/CasaOS)
- [gogs](https://github.com/gogs/gogs)