jialezi/cloudreve

cloudreve Docker镜像文档

镜像概述

本镜像集成了cloudreve和Aria2，用于快速搭建私有云存储服务。cloudreve是一款支持多存储后端的文件管理系统，Aria2则提供高效的下载功能。镜像默认包含必要配置，支持目录挂载以持久化数据和配置，适用于个人或小团队构建私有云存储解决方案。

核心功能与特性

• 集成组件：包含cloudreve文件管理系统和Aria2下载工具，一站式满足文件存储与下载需求
• 目录结构清晰：预设关键目录，便于数据持久化和配置管理
• 灵活配置：支持通过挂载目录自定义cloudreve配置文件和存储路径
• 即开即用：简化部署流程，启动后可通过日志获取初始管理员账号密码

默认目录结构

• Aria2配置目录：/root/.aria2
• Aria2下载目录：/home/aria2
• cloudreve主目录：/root/cloudreve
• cloudreve默认上传目录：/root/cloudreve/uploads（需挂载使用）
• cloudreve配置文件：/root/cloudreve/conf.ini（需挂载自定义配置）

使用场景

• 个人私有云存储：管理个人文件，支持上传、下载、分享
• 小团队文件协作：团队内部文件共享与管理
• 结合Aria2的下载服务：通过cloudreve管理Aria2下载任务

使用方法

基本运行

bash
docker run -idt -p 5212:5212 -p 6800:6800 --name cloudreve --restart=always jialezi/cloudreve

映射目录运行（推荐）

挂载cloudreve目录以持久化数据和配置：

bash
docker run -idt -p 5212:5212 -p 6800:6800 --name cloudreve --restart=always -v $PWD/cloudreve:/root/cloudreve jialezi/cloudreve

查看运行日志

启动后通过日志获取初始管理员账号密码及Aria2配置信息：

bash
docker logs cloudreve

日志示例（关键信息）：

[信息] Aria2 启动成功 !
...
[Info]    初始管理员账号：admin@cloudreve.org
[Info]    初始管理员密码：7BMWLJBv
...
[Info]    开始监听 :5212

配置HTTPS反向代理（Caddy示例）

1. 运行cloudreve（不暴露5212端口，仅通过反向代理访问）：

bash
docker run -idt -p 6800:6800 --name cloudreve --restart=always -v $PWD/cloudreve:/root/cloudreve jialezi/cloudreve

2. 运行Caddy自动配置HTTPS（需提前将域名解析至服务器）：

bash
docker run -d -p 80:80 -p 443:443 --link cloudreve caddy caddy reverse-proxy --to cloudreve:5212 --from https://你的域名

解决GitHub访问问题

若日志提示无法连接GitHub或下载cloudreve失败，可手动下载cloudreve程序至本地cloudreve目录，再挂载运行：

bash
# 手动准备cloudreve程序至当前目录的cloudreve文件夹
docker run -idt -p 5212:5212 -p 6800:6800 --name cloudreve --restart=always -v $PWD/cloudreve:/root/cloudreve jialezi/cloudreve

注意事项

• 确保服务器能访问GitHub，否则可能导致cloudreve初始化失败
• 首次启动后需通过docker logs cloudreve获取初始管理员账号密码
• 生产环境建议挂载/root/cloudreve目录以持久化配置和数据
• 详细配置可参考cloudreve官方文档：[***]