Cloudreve 搭建教程 – 搭建你的私有云盘

一、Cloudreve 是什么

Cloudreve 是一个开源的私有云盘系统，基于 PHP 开发。你可以把它部署在自己的服务器上，让用户上传、下载、分享文件，就像使用百度网盘一样——但数据完全由你自己掌控。

Cloudreve 的核心特点：

• 多用户支持：可以开放注册，每个用户有独立的存储空间。也可以设置用户组，限制不同用户的存储容量、下载速度。
• 多种存储策略：文件可以存在服务器本地硬盘上，也可以对接阿里云 OSS、腾讯云 COS、七牛云、又拍云、AWS S3、OneDrive 等云存储。你可以为不同用户分配不同的存储策略。
• 文件分享：生成分享链接，支持设置密码、有效期、下载次数限制。
• 在线预览：支持图片、视频、音频、文档（Office/PDF）的在线预览。
• WebDAV 支持：可以通过 WebDAV 协议挂载到电脑、手机、播放器等设备，像本地硬盘一样使用。
• 离线下载：支持 aria2 对接，实现远程下载功能。
• 界面美观：响应式设计，电脑和手机都能流畅使用。
• 完全开源免费：GitHub 仓库：https://github.com/cloudreve/Cloudreve

二、你需要准备什么

准备项	说明
一台云服务器	推荐 1 核 2G 以上。阿里云/腾讯云/华为云均可
宝塔面板（方式一）或 Docker（方式二）	选一种即可，宝塔更适合新手
一个域名（可选）	没有域名可以用服务器 IP 访问

三、部署方式一：宝塔面板部署（推荐新手）

宝塔面板提供可视化的服务器管理界面，不需要记 Linux 命令。

3.1 安装宝塔面板（如果还没装）

连接到你的云服务器（用 FinalShell 或终端），执行以下命令：

# Ubuntu / Debian 系统
wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

# CentOS 系统
yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh

安装完成后，终端会显示宝塔面板的访问地址、用户名和密码。记下这些信息。

3.2 安装 LNMP 环境

1. 浏览器访问宝塔面板，登录。
2. 首次登录会弹出“推荐安装套件”窗口。选择 LNMP（Linux + Nginx + MySQL + PHP）。
3. 版本选择：
   • Nginx：最新稳定版
   • MySQL：5.7 或 8.0
   • PHP：7.4 或 8.0（Cloudreve 要求 PHP ≥ 7.4）
4. 选择“极速安装”，点击“一键安装”。等待 10-20 分钟。

3.3 创建数据库

1. 宝塔面板 → 数据库 → 添加数据库。
2. 填写：
   • 数据库名：cloudreve
   • 用户名：cloudreve
   • 密码：设置一个复杂密码，记下来
3. 点击提交。

3.4 创建网站

1. 宝塔面板 → 网站 → 添加站点。
2. 填写：
   • 域名：填你的域名（如 pan.yourdomain.com）或服务器 IP。
   • 根目录：默认即可，记下这个路径。
   • PHP 版本：选择 PHP 7.4 或 8.0。
3. 点击提交。

3.5 下载 Cloudreve 源码

1. 打开浏览器，访问 https://github.com/cloudreve/Cloudreve/releases
2. 在最新版本的 Assets 中，下载 cloudreve_版本号.zip 文件。注意：不要下载源码版本（Source code），要下载编译好的 ZIP 包。
3. 回到宝塔面板 → 文件，进入网站的根目录。
4. 删除目录中的所有默认文件（如 index.html、.htaccess 等）。
5. 点击 上传，选择下载的 ZIP 文件。
6. 上传完成后，右键 ZIP 文件 → 解压。
7. 如果解压后文件在一个子文件夹中（如 cloudreve_3.x.x），把这些文件移动到网站根目录。

3.6 设置网站配置

1. 宝塔面板 → 网站 → 点击你的域名 → 网站目录。
2. 运行目录 选择 /public，点击保存。
3. 点击 伪静态，填入以下规则：

location / {
    if (!-e $request_filename){
        rewrite ^(.*)$ /index.php?s=$1 last; break;
    }
}

点击保存。

3.7 放行端口

去云服务商控制台 → 安全组 → 入方向规则，添加：

• 协议：TCP
• 端口：80（HTTP）和 443（HTTPS，如果需要的话）
• 来源：0.0.0.0/0

3.8 安装 Cloudreve

1. 浏览器访问你的域名或 IP（如 http://你的IP）。
2. 你会看到 Cloudreve 的安装向导页面。
3. 填写数据库信息：
   • 数据库主机：127.0.0.1
   • 数据库端口：3306
   • 数据库名称：cloudreve
   • 数据库用户名：cloudreve
   • 数据库密码：你在宝塔中设置的密码
4. 设置管理员账号（邮箱和密码）。记下这个密码。
5. 点击“安装”，等待几秒钟。
6. 安装成功！

3.9 登录后台

1. 访问 http://你的域名/admin（注意是 /admin，不是 /@manage）。
2. 用刚才设置的管理员邮箱和密码登录。

登录成功后，你就进入了 Cloudreve 的管理后台。在这里可以管理用户、设置存储策略、查看文件统计等。

四、部署方式二：Docker 部署

如果你不想用宝塔面板，Docker 是最快的部署方式。

4.1 安装 Docker

curl -fsSL https://get.docker.com | bash
sudo systemctl start docker
sudo systemctl enable docker

4.2 创建目录并启动 Cloudreve

# 创建数据目录
mkdir -p ~/cloudreve/{uploads,avatar,data}

# 启动容器
docker run -d \
  --name cloudreve \
  --restart unless-stopped \
  -p 5212:5212 \
  -v ~/cloudreve/uploads:/cloudreve/uploads \
  -v ~/cloudreve/avatar:/cloudreve/avatar \
  -v ~/cloudreve/data:/cloudreve/data \
  cloudreve/cloudreve:latest

4.3 获取管理员密码

docker logs cloudreve

在日志中，找到类似以下内容：

Admin user name: admin@cloudreve.org
Admin password: xxxxxxxx

记下这个密码。

4.4 访问 Cloudreve

1. 浏览器访问 http://你的服务器IP:5212
2. 用 admin@cloudreve.org 和日志中显示的密码登录。
3. 登录后请立即修改管理员邮箱和密码。

别忘了在云服务商安全组中放行 5212 端口。

五、Cloudreve 基本配置和使用

5.1 修改管理员密码和邮箱

1. 登录后台 → 右上角头像 → 个人设置。
2. 修改邮箱和密码，点击保存。

5.2 配置存储策略

Cloudreve 默认把文件存在服务器本地。如果你想对接云存储（节省服务器硬盘空间），按以下步骤操作：

1. 后台 → 存储策略 → 添加存储策略。
2. 选择存储类型：
   • 本地存储：文件存在服务器硬盘上。根目录默认在 uploads 文件夹。
   • 阿里云 OSS / 腾讯云 COS / 七牛云 / 又拍云 / AWS S3：文件存在云端。
3. 填写对应的 AccessKey、SecretKey、Bucket 名称等信息，点击保存。
4. 在用户组设置中，将新建的存储策略分配给对应的用户组。

5.3 用户管理

1. 后台 → 用户 → 可以看到所有注册用户。
2. 点击某个用户，可以修改其存储容量、下载速度限制、用户组。

5.4 开启或关闭注册

1. 后台 → 参数设置 → 注册与登录。
2. 设置是否开放注册、是否需要邮箱验证、新用户默认存储容量。

5.5 上传文件测试

1. 访问首页（http://你的域名），用管理员账号或注册的账号登录。
2. 点击 上传，选择文件，上传完成后文件会出现在文件列表中。
3. 右键文件 → 分享，可以生成分享链接，支持设置密码、有效期、下载次数。

5.6 开启 WebDAV

Cloudreve 支持 WebDAV 协议，你可以把网盘挂载到电脑上，像本地磁盘一样使用。

1. 后台 → 参数设置 → WebDAV → 开启。
2. WebDAV 地址：http://你的域名/dav
3. 用户名和密码：你的 Cloudreve 登录账号密码。
4. 在 Windows 上可以用 RaiDrive 挂载，Mac 上可以在访达中连接服务器。

六、绑定域名和开启 HTTPS

6.1 添加 DNS 解析

在域名服务商处，添加一条 A 记录，指向你的服务器 IP。

6.2 配置反向代理（Docker 部署）

如果你用 Docker 部署，Cloudreve 默认监听 5212 端口。如果你不想在域名后面加端口号，可以用 Nginx 反向代理：

# 安装 Nginx
sudo apt install -y nginx

# 创建配置文件
sudo nano /etc/nginx/sites-available/cloudreve

粘贴以下内容（把 pan.yourdomain.com 换成你的域名）：

server {
    listen 80;
    server_name pan.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:5212;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# 启用配置
sudo ln -s /etc/nginx/sites-available/cloudreve /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

现在就可以用 http://pan.yourdomain.com 访问 Cloudreve 了。

6.3 申请 SSL 证书

如果你用宝塔面板：网站 → 点击域名 → SSL → Let’s Encrypt → 一键申请。

如果你手动用 Nginx：可以使用 certbot 免费申请 SSL 证书。

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d pan.yourdomain.com

七、常见问题

Q1：安装后访问首页空白或 500 错误

原因：运行目录没有设置为 /public，或者伪静态没有配置。
解决：检查宝塔中该网站的“网站目录”是否选择了 /public，以及“伪静态”是否填写了正确的规则。

Q2：上传文件失败，提示“无写入权限”

解决：在宝塔文件管理中，右键网站根目录 → 权限，设置为 755，并勾选“应用到子目录”。确保 PHP 有写入权限。

Q3：忘记管理员密码

Docker 部署：执行 docker logs cloudreve，启动日志中会显示初始管理员密码。
宝塔部署：在数据库中执行以下 SQL 重置管理员密码（需要先对密码做哈希处理，建议重装或使用 Cloudreve 的命令行工具重置）。

Q4：如何升级 Cloudreve？

• 宝塔部署：下载最新 ZIP，解压覆盖旧文件（保留 data 和 uploads 目录），重新访问首页会自动升级数据库。
• Docker 部署：docker pull cloudreve/cloudreve:latest && docker stop cloudreve && docker rm cloudreve，然后重新执行 docker run 命令。

Q5：如何对接离线下载（aria2）？

1. 在服务器上安装 aria2。
2. 在 Cloudreve 后台 → 节点管理 → 添加 aria2 节点，填写 aria2 的 RPC 地址和密钥。
3. 保存后，用户在前台点击“离线下载”，输入链接即可。

八、总结

Cloudreve 是目前最成熟的开源私有云盘系统之一。部署流程概括为：

1. 准备环境：PHP 7.4+、MySQL、Nginx（宝塔一键安装 / Docker 一行命令）。
2. 下载源码：从 GitHub Releases 下载编译好的 ZIP 包。
3. 配置网站：设置运行目录为 /public，配置伪静态。
4. 安装向导：浏览器访问，填写数据库信息和管理员账号。
5. 配置存储策略：选择文件存放位置（本地或云存储）。
6. 开始使用：上传文件、分享链接、挂载 WebDAV。

如果你需要一个功能完善、界面美观的私人网盘，Cloudreve 是非常好的选择。

项目地址：https://github.com/cloudreve/Cloudreve