Cloudreve 安装与使用指南：
参考： 官方文档
官方介绍：Cloudreve 可以让您快速搭建起公私兼备的网盘系统。Cloudreve 在底层支持不同的云存储平台，用户在实际使用时无须关心物理存储方式。你可以使用 Cloudreve 搭建个人用网盘、文件分享系统，亦或是针对大小团体的公有云系统

---

一、安装前准备

1. 环境要求：

   • CPU：1核+（推荐2核）
   • 内存：512MB+（推荐1GB）
   • 存储：根据文件存储需求
   • 系统：Linux/Windows/macOS（服务器推荐 Linux）
   • 依赖：MySQL 5.7+ / PostgreSQL / SQLite（轻量级可选）

2. 下载最新版：

   # 从 GitHub 下载（替换最新版本号）
   wget https://github.com/cloudreve/Cloudreve/releases/download/3.8.3/cloudreve_3.8.3_linux_amd64.tar.gz
   tar -zxvf cloudreve_*.tar.gz
   chmod +x ./cloudreve
   

---

二、安装步骤

Linux 系统

1. 启动初始化：

   ./cloudreve
   

   • 首次运行会生成管理员账号密码（记录控制台输出）。
   • 配置文件 conf.ini 自动生成（默认使用 SQLite）。

2. 配置 MySQL（可选）：
   修改 conf.ini：

   [Database]
   DBType = mysql
   DSN = 用户名:密码@tcp(127.0.0.1:3306)/数据库名?charset=utf8mb4&parseTime=True&loc=Local
   

3. 设置开机自启：

   # 创建 systemd 服务文件
   sudo vim /etc/systemd/system/cloudreve.service
   

   添加以下内容：

   [Unit]
   Description=Cloudreve
   After=network.target
   
   [Service]
   User=root
   ExecStart=/path/to/cloudreve
   Restart=always
   
   [Install]
   WantedBy=multi-user.target
   

   启用服务：

   sudo systemctl enable cloudreve
   sudo systemctl start cloudreve
   

---

Windows 系统

1. 解压下载的压缩包（如 cloudreve_windows_amd64.zip）。
2. 双击运行 cloudreve.exe。
3. 记录控制台输出的管理员密码。
4. 访问 http://localhost:5212 登录。

---

Docker 部署

docker run -d \
  --name cloudreve \
  -p 5212:5212 \
  -v /path/to/uploads:/cloudreve/uploads \
  -v /path/to/conf:/cloudreve/conf \
  -v /path/to/db:/cloudreve/db \
  cloudreve/cloudreve:latest

注：首次启动后需进入容器查看初始密码：docker logs cloudreve

---

三、基础配置

1. 登录管理后台
   访问 http://服务器IP:5212 → 使用初始账号登录。

2. 配置存储策略

   • 进入 管理面板 → 存储策略
   • 添加本地/OSS/COS/S3等存储方式（示例本地存储）：
     • 存储路径：/data/cloudreve/uploads
     • 访问域名：http://your-domain.com/uploads

3. 创建用户组

   • 用户组 → 新建组 → 设置存储空间、文件大小限制、速度限制等。

4. 添加用户

   • 用户 → 新建用户 → 分配用户组。

---

四、常用功能

功能	路径	说明
文件管理	控制台 → 文件	拖拽上传/创建文件夹/分享文件
分享链接	文件 → 分享	生成密码/有效期限制的分享链接
WebDAV 挂载	用户 → WebDAV 管理	生成地址用于 RaiDrive/rclone 等
离线下载	转存 → 离线下载	支持 BT/磁力链/HTTP 下载任务

---

五、反向代理（Nginx）

server {
    listen 80;
    server_name your-domain.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;
    }
}

重启 Nginx：sudo systemctl reload nginx

---

六、升级版本

1. 停止运行中的 Cloudreve：

   systemctl stop cloudreve
   

2. 备份旧版程序和 conf.ini、cloudreve.db。
3. 下载新版并替换二进制文件。
4. 重新启动：

   systemctl start cloudreve
   

---

七、常见问题

• 无法上传大文件：检查 Nginx client_max_body_size 和 Cloudreve 用户组限制。
• 存储策略权限错误：确保 /uploads 目录权限为 755 且属主为运行用户。
• 忘记密码：重新初始化数据库或通过命令行重置：

  ./cloudreve --reset-password 新密码
  

---

八、高级功能

• 自定义主题：替换 statics 目录下的前端文件。
• API 开发：通过 官方文档 调用 RESTful API。
• 集群部署：使用 Redis 配置会话共享（需企业版）。

完整文档：Cloudreve Docs
GitHub 仓库：cloudreve/cloudreve