后端对象存储【免费下载链接】cloudreve Self-hosted file management and sharing system, supports multiple storage providers项目地址https://gitcode.com/gh_mirrors/cl/cloudreve点击查看免费下载Cloudreve 是一个开源的、自托管的公有云文件系统官方定位是支持多家云存储驱动的文件管理与分享平台。它以 Go 编写后端、React 编写前端并以 All-in-One 方式打包开箱即用。本文以仓库根目录的 README_zh-CN.md 为骨架结合仓库源码逐项印证其核心特性、部署方式、构建流程与代码架构帮助你既能在生产环境中快速落地也能从源码层面理解它的工作方式。一、项目定位从 README 看 Cloudreve 是什么README_zh-CN.md 用一句话概括了项目本质支持多家云存储驱动的公有云文件系统。英文版 README 则将其描述为 Self-hosted file management system with multi-cloud support而仓库中 cmd/root.go 的命令行长帮助文本进一步明确为 Self-hosted file management and sharing system, supports multiple storage providers。从仓库的模块声明go.mod 首行module github.com/cloudreve/Cloudreve/v4可以看出当前仓库对应 Cloudreve 的 v4 主线后端基于 Go 1.26 开发。它的整体形态是一个可独立部署的 Web 服务默认监听 5212 端口见 Dockerfile 的EXPOSE 5212 443 6888 6888/udp既可作为单机网盘使用也可扩展成由多个从机节点组成的下载/存储集群。二、核心特性与源码级印证README 列出的一系列特性并非宣传语而是可以在仓库中一一找到对应实现的真实能力。下面逐项对照。2.1 多存储驱动本机、从机与各大云厂商README 明确列出支持的存储端本机、从机、七牛 Kodo、阿里云 OSS、腾讯云 COS、华为云 OBS、金山云 KS3、又拍云、OneDrive包括世纪互联版以及 S3 兼容协议。这一清单与源码目录完全对应在 pkg/filemanager/driver 下可以看到每个存储后端的独立驱动包——local本机存储、remote从机节点、qiniu七牛 Kodo、oss阿里云 OSS、cos腾讯云 COS、obs华为云 OBS、ks3金山云 KS3、upyun又拍云、onedrive含 OAuth 认证以及s3S3 兼容协议。存储策略Policy在数据模型层也有完整定义ent/schema 下的policy.go、storagepolicy.go以及 inventory/policy.go。值得说明的是从机这一特殊存储端Cloudreve 支持主从Master/Slave架构从机节点既承担存储职责也可分担离线下载等任务。路由层 routers/router.go 的InitRouter会根据配置中的系统模式conf.MasterMode与conf.SlaveMode分别初始化主节点路由与从节点路由日志中会打印 Current running mode: Master. 或 Current running mode: Slave.。2.2 上传/下载客户端直传、并行分片与限速README 提到的上传/下载能力包括客户端直传、下载限速、拖拽上传、目录上传与并行分片上传。并行分片上传分片逻辑集中在 pkg/filemanager/chunk负责大文件的分片切分与断点续传。客户端直传对于七牛、阿里云 OSS、腾讯云 COS、S3 等支持直传的存储端客户端可绕过服务端中转直接与存储服务交互服务端只负责签发凭证与回调校验service/callback/upload.go 即为上传回调处理。从机上传接口在从节点路由中routers/router.go 的initSlaveFileRouter注册了三条上传相关接口——上传分片POST upload/:sessionId、创建上传会话PUT upload、删除上传会话DELETE upload/:sessionId。下载限速从节点下载接口GET file/content/:nodeId/:src/:speed/:name的 URL 路径中直接携带speed参数配合 middleware 层实现对下载速率的控制这与 README 中下载限速的表述一致。2.3 离线下载Aria2 与 qBittorrent多节点分担README 指出可对接Aria2/qBittorrent 离线下载并支持使用多个从机节点分担下载任务。源码中对应 pkg/downloader/aria2内含完整实现的 RPC 客户端子包rpc支持通知、任务进度等与 pkg/downloader/qbittorrent。官方 Docker 镜像也默认内置了 Aria2见 Dockerfile 中安装aria2并设置环境变量CR_ENABLE_ARIA21同时暴露 6888 端口Aria2 RPC 默认端口TCP 与 UDP。2.4 在线压缩/解压缩/预览与批量打包下载README 提到的归档能力压缩、解压缩、压缩包预览、多文件打包下载对应 pkg/filemanager/workflows 下的archive.go打包下载与extract.go解压。值得注意的细节是go.mod 中引入了github.com/bodgit/sevenzip依赖说明解压流程原生支持 7z 格式而不只限于 zip/tar 等常见格式。2.5 覆盖全部存储策略的 WebDAVREADME 承诺WebDAV 协议支持覆盖全部存储策略。这一点在后端有独立模块支撑pkg/webdav 实现了完整的 WebDAV 服务端含内部 XML 序列化与解析service/setting/webdav.go 提供 WebDAV 账号/挂载配置业务逻辑routers/controllers/webdav.go 负责将 WebDAV 请求接入路由层。由于 WebDAV 建立在统一的文件系统抽象之上因此无论底层存储是本机、对象存储还是 OneDrive都可经由同一套 WebDAV 接口访问。2.6 媒体元数据提取与标签搜索README 提到提取媒体元数据通过元数据或标签搜索文件。对应实现分两层元数据提取pkg/mediameta 提供 EXIF 提取exif.go、音视频探测ffprobe.go基于 FFprobe、地理位置反查geocoding.go与音乐标签解析music.gopkg/filemanager/manager/mediameta.go 负责将提取结果写入文件元数据。搜索索引pkg/searcher 定义了索引器抽象indexer.go并提供基于 Meilisearch 的实现indexer/meilisearch.go与内置的文本抽取器extractor支持 Tika 与 Noop 两种策略。2.7 多用户、用户组与多存储策略README 声称支持多用户、用户组、多存储策略。数据模型层面ent/schema 中user.go定义用户、group.go定义用户组storagepolicy.go与policy.go定义存储策略业务层面service/admin/group.go、service/admin/user.go 与 service/admin/policy.go 分别负责用户组、用户与存储策略的后台管理。管理员可以按用户组分配不同的存储配额与策略实现多租户式的资源隔离。2.8 分享链接README 提到可创建文件、目录的分享链接可设定自动过期。对应 service/share 下的manage.go分享的创建与管理与visit.go访客访问分享的流程数据模型见 ent/schema/share.go。2.9 在线预览与在线编辑README 声称支持视频、图像、音频、ePub 在线预览以及文本、Office 文档在线编辑预览查看器逻辑集中在 pkg/filemanager/manager/viewer.go配合 pkg/thumb 的缩略图管线内置支持 FFmpeg、vips、libreoffice、libraw 等后端为图片、视频生成预览。Office 在线编辑通过WOPI协议实现pkg/wopi 提供 WOPI 服务端实现与协议类型定义middleware/wopi.go 与 routers/controllers/wopi.go 将其接入中间件与路由。2.10 前端体验与 All-in-One 打包README 提到自定义配色、黑暗模式、PWA 应用、全站单页应用SPA与国际化。这些能力属于前端工程React Redux Material-UI见 README 技术栈一节仓库中的assets目录存放前端静态资源。All-in-One 打包的实现方式是前端构建产物以go:embed方式内嵌进 Go 二进制application/statics/embed.go 与 application/statics/statics.go 负责将静态文件系统注入应用。如果需要把内嵌的静态文件释放到磁盘进行二次定制可以使用eject命令见下文命令章节。官方 Dockerfile 也在单镜像内预装了 ffmpeg、libreoffice、vips-tools、libraw-tools 等处理工具并通过环境变量默认开启缩略图与媒体元数据能力体现了开箱即用的设计。三、部署实践从快速开始到生产集群3.1 快速开始单二进制直接运行Cloudreve 以单一可执行文件分发部署门槛很低。其命令行体系基于 Cobra 构建入口在 main.go所有子命令定义在 cmd 包。运行前只需准备一个配置文件。相关的命令行参数定义于 cmd/root.go参数简写默认值说明--conf-cdata/conf.ini配置文件路径util.DataPath基于数据目录解析--use-working-dir-wfalse使用当前工作目录作为数据目录而非可执行文件所在目录启动服务的子命令是servercmd/server.go。不过更省事的是不指定任何子命令直接运行cmd/root.go 的Execute会把默认命令重定向为server即./cloudreve与./cloudreve server等价。服务启动时会读取配置文件、初始化数据库并开始监听 5212 端口该端口在 Dockerfile 与 docker-compose.yml 中均可印证。服务进程对中断信号做了优雅关闭处理监听os.Interrupt、SIGTERM、SIGHUP、SIGQUIT见 cmd/server.go 的shutdown函数适合在容器与 systemd 等环境中运行。3.2 生产部署Docker Compose 三件套仓库根目录提供了完整的 docker-compose.yml展示了一个推荐的生产部署形态Cloudreve 后端 PostgreSQL 17 Redis三个服务。几个值得注意的工程细节配置注入方式Cloudreve 的配置项支持通过环境变量覆盖命名规则为CR_CONF_分组.字段。compose 文件中用CR_CONF_Database.Typepostgres、CR_CONF_Database.Hostpostgresql等环境变量将数据库指向容器内的 PostgreSQL用CR_CONF_Redis.Serverredis:6379指向 Redis 缓存。端口映射5212Web 服务与6888TCP/UDPAria2 下载端口对外暴露。数据持久化后端数据目录/cloudreve/data通过卷backend_data持久化PostgreSQL 与 Redis 数据也各自挂载独立卷。三个服务均配置了restart: unless-stopped保证异常退出后自动拉起。镜像内的运行环境Dockerfile 设置了CR_ENABLE_ARIA21及CR_SETTING_DEFAULT_thumb_ffmpeg_enabled1、CR_SETTING_DEFAULT_thumb_vips_enabled1、CR_SETTING_DEFAULT_thumb_libreoffice_enabled1、CR_SETTING_DEFAULT_media_meta_ffprobe1、CR_SETTING_DEFAULT_thumb_libraw_enabled1等环境变量使缩略图与媒体元数据能力默认开启。3.3 主从模式多节点扩容的基础如需扩容Cloudreve 采用主从Master/Slave架构主节点负责 API 与前端服务从节点专注存储与下载任务。路由初始化时routers/router.go 的InitRouter会根据配置的System.Mode分流从节点注册独立的上传、下载与文件接口节点通信与注册逻辑位于 pkg/cluster 与 middleware/cluster.go从机任务调度见 service/node。3.4 从 v3 迁移到 v4migrate命令如果已有 Cloudreve v3 实例v4 提供了专门的迁移命令migratecmd/migrate.go用法为./cloudreve migrate -v3-conf /path/to/v3/conf.ini关键行为-v3-conf为必填参数指定 v3 配置文件路径缺失时程序直接报错退出迁移支持断点续迁进度状态保存在 v3 配置同目录下的migration_state.json若中途失败重跑同一命令即可从最后成功的步骤继续--force-reset可强制清空迁移状态、从头开始迁移逻辑本身由 application/migrator 承载其中按领域拆分了用户、文件、文件夹、分组、存储策略、分享、WebDAV、节点等迁移模块user.go、file.go、folders.go、group.go、policy.go、share.go、webdav.go、node.go等并在migrator.go中编排整体流程。3.5 文件加密主密钥管理master-key命令Cloudreve v4 对上传的文件实体提供加密支持其加密体系以主密钥 每文件密钥的分层方式实现相关实现见 pkg/filemanager/encrypt其中aes256ctr.go是 AES-256-CTR 加解密masterkey.go是主密钥保管与加解密工具。master-key命令cmd/masterkey.go提供三个子命令master-key generate生成一个 32 字节256 位随机主密钥以 base64 输出到 stdout也可用-o 文件直接写入密钥文件文件权限 0600避免密钥出现在终端历史中。master-key get读取并打印当前生效的主密钥。主密钥的存放位置可配置从代码路径可见支持设置库、环境变量CR_ENCRYPT_MASTER_KEY与密钥文件三种保管方式MasterEncryptKeyVaultTypeSetting/MasterEncryptKeyVaultTypeEnv/MasterEncryptKeyVaultTypeFile。master-key rotate-n 新密钥文件轮换主密钥。流程为用旧主密钥逐个解密所有已加密实体的文件密钥 → 用新主密钥重新加密 → 回写数据库。若密钥原本存放在设置库中命令会自动更新encrypt_master_key设置项若存放在环境变量或密钥文件中命令会打印提示要求手动替换为新密钥。注意轮换主密钥属于高危操作命令的长帮助文本明确警告请先备份数据库且新密钥必须为 32 字节的 base64 字符串否则校验失败。四、从源码构建README 提到可以从源码构建 Cloudreve。仓库本身是一个标准的 Go 模块go.mod核心依赖包括entgo.io/ent v0.13.0ent 实体框架仓库中 ent 目录下所有*_create.go、*_query.go、*_update.go等文件均为其代码生成产物github.com/gin-gonic/gin v1.11.0Web 框架数据库驱动SQLite、MySQL、PostgreSQLgo.mod 中可见对应驱动云厂商 SDK阿里云 OSS、AWS S3、华为云 OBS 等媒体与文档处理exif、heic、tiff 等图像元数据解析库bodgit/sevenzip7z 解压等。入口文件 main.go 只做两件事注册命令行参数-c、-w等并调用cmd.Execute()进入 Cobra 命令树。构建产出是一个包含全部静态资源前端已通过 application/statics/embed.go 内嵌的单体二进制Dockerfile 中COPY cloudreve ./cloudreve也印证了镜像内运行的正是一个名为cloudreve的可执行文件。若需要将内嵌静态文件释放出来自行托管或定制可使用eject命令cmd/eject.go功能描述为 Eject all embedded static files。需要说明的适用前提仓库工具链要求 Go 1.26见 go.mod 的go 1.26.0与toolchain go1.26.5构建时需准备相应的 Go 工具链完整构建命令与版本兼容细节请以官方文档为准。五、技术栈与代码架构README 的技术栈一节给出了项目两大阵营后端Go Gin ent前端React Redux Material-UI结合仓库目录结构可以进一步勾勒出后端的分层组织目录职责cmdCobra 命令树server、migrate、master-key、ejectapplication应用装配层依赖注入application/dependency、常量、v3→v4 迁移器application/migrator、静态资源routers/controllersHTTP 路由与控制器处理 Gin 请求的绑定与响应service业务服务层按领域划分user、share、explorer、admin、callback、setting 等middleware中间件鉴权auth、验证码captcha、集群cluster、会话session、WOPI 等pkg可复用的领域包文件管理filemanager、下载器downloader、WebDAV、媒体元数据、缩略图、搜索、加密、队列queue等entent 框架生成的实体与数据访问代码inventory数据访问层的封装对 ent 客户端的领域化封装并带有调试与类型定义子包这种分层使得存储驱动、文件系统抽象、业务服务、HTTP 层彼此解耦存储驱动统一实现 pkg/filemanager/driver/handler.go 定义的处理器接口上层WebDAV、分享、在线预览等只需面向统一抽象编程这正是一套 API 覆盖全部存储策略得以成立的根本原因。六、贡献与许可证Cloudreve 欢迎社区参与贡献仓库根目录提供 CONTRIBUTING.md 说明贡献流程与规范。开源许可证为GPL V3见 LICENSE这意味着你可以自由获取、修改与部署它但基于它的衍生作品同样需要以 GPL 兼容方式开源。结语从 README 出发可以看到 Cloudreve 的特性清单几乎全部能在仓库源码中找到一一对应的实现十种存储驱动、分片直传与限速、Aria2/qBittorrent 离线下载、全策略 WebDAV、元数据搜索、主从集群以及开箱即用的容器化部署。对于希望快速搭建私有云盘的个人用户docker compose up即可起步对于需要深度定制或大规模部署的团队v4 的命令行体系迁移、主密钥轮换、静态文件释放与清晰的包分层也提供了足够的扩展空间。赞分享后端对象存储【免费下载链接】cloudreve Self-hosted file management and sharing system, supports multiple storage providers项目地址https://gitcode.com/gh_mirrors/cl/cloudreve点击查看免费下载相关推荐Cloudreve 自托管文件管理系统多存储驱动、离线下载与 WebDAV 全栈解析Cloudreve 自托管文件管理系统多存储驱动、离线下载与 WebDAV 全栈解析 导读 Cloudreve 是一个采用 Go 编写的自托管文件管理与分享系后端对象存储探索云存储新境界Cloudreve——自托管文件管理系统探索云存储新境界Cloudreve——自托管文件管理系统 在这个数字化时代管理和分享文件变得越来越重要。Cloudreve是一个强大的自托管文件管理系统它后端对象存储Cloudreve自托管的多云文件管理系统Cloudreve自托管的多云文件管理系统 项目介绍 Cloudreve 是一款开源的自托管文件管理系统支持多种云存储服务。通过 Cloudreve用户可后端对象存储上一篇IceCubesApp的版本更新提醒App Store版本检查实现下一篇TechXueXi终极指南提升学习效率的10个实用技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考