文章	评论	标签
91	15	35

AI摘要：本文介绍了在宝塔面板上部署Cloudreve私人网盘项目的步骤，包括下载安装包、上传解压、配置网站、设置防火墙、启动守护进程及修改端口等。

Powered by AISummary.

Cloudreve简介

✨ 特征

☁️ 支持将文件存储到本地存储、远程存储、七牛云、阿里云 OSS、腾讯 COS、优朋、OneDrive、S3 兼容 API。
📤 直接传输上传/下载，支持限速。
💾 与 Aria2 集成以离线下载文件，使用多个下载节点分担负载。
📚 压缩/提取文件，批量下载文件。
💻 WebDAV 支持涵盖所有存储提供程序。
⚡拖放以上传文件或文件夹，并进行流式上传处理。
🗃️ 拖放以管理您的文件。
👩 👧 👦 具有多个组的多用户。
🔗 为具有过期日期的文件和文件夹创建共享链接。
👁️ 🗨️ 在线预览视频、图像、音频、ePub 文件;在线编辑文本、Office 文档。
🎨 自定义主题颜色、深色模式、PWA 应用程序、SPA、i18n。
🚀 All-In-One 包装，所有功能开箱即用。
🌈 ... ...

任意linux系统都可以部署，这里以debian（ubuntu）为例

下载并上传cloudreve压缩文件

Cloudreve安装下载网页

如果上面的链接无法访问，可以使用备用下载链接。我的是4.10.1版本（截止2025年11月24日的最新版本）

通过文件管理将下载的压缩包上传到服务器任意目录内并解压。
开始部署网站
点击终端进入命令行
解压后进入项目文件夹内执行：
```
sudo chmod +x cloudreve
```
```
./cloudreve
```
终端会输出类似这样：

请记住用户名密码

登录cloudreve网页

进入浏览器输入IP:5212，输入刚才记录的用户名密码，就登录成功了。

注意事项

守护进程问题

刚才我们是在命令行运行了./cloudreve命令后才登录网站的，但是命令行关闭后这个程序也关闭了，网站就登录不了了。
解决办法：
在 /etc/systemd/system/ 目录下创建一个名为 cloudreve.service 的文件。
sudo nano /etc/systemd/system/cloudreve.service
将以下内容复制进去

[Unit]
Description=Cloudreve V4
After=network.target

[Service]
Type=simple
WorkingDirectory=/www/cloudreve   #这是cloudreve二进制文件所在的目录,根据实际情况修改
ExecStart=/www/cloudreve/cloudreve  #指定`cloudreve`二进制文件
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

ctrl+x，保存并退出。
而后命令行依次执行如下命令：
sudo systemctl daemon-reload # 加载服务配置

sudo systemctl enable cloudreve.service # 启用服务在系统启动时自动运行。

sudo systemctl start cloudreve.service # 启动服务。

sudo systemctl status cloudreve.service # 检查服务状态。

如果使用自带数据库，到这一步就可以使用了。

修改端口问题

cloudreve默认监听5212端口，也可以通过修改data目录下的conf.ini文件中的 listen 选项来修改监听端口。

配置反代

nginx反代配置示例：

server {
    listen 443 ssl http2;
    server_name cloudreve.域名.top;  # 二级域名

    ssl_certificate certs/ssl证书.pem;  # ssl证书目录
    ssl_certificate_key certs/ssl证书.key;  # ssl证书目录

    client_max_body_size 500m;  # 设置最大请求体为500MB

    location / {
        proxy_pass http://内网ip: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;
    }
}

进阶使用

如果想修改其他配置请参考cloudreve官方文档，这里我简单放一个配置文件模版。

[System]
; 运行模式，可选值为 master/slave
Mode = master
; HTTP 监听端口，默认为 5212
Listen = :5212
; 是否开启 Debug 模式，默认为 false
Debug = false
; 呈递客户端 IP 时使用的 Header，默认为空。如果该 Header 由多个使用 `,` 分隔的 IP 构成，Cloudreve 会取用首个作为客户端 IP
; 对于配置反向代理的部署，可以取值为 X-Forwarded-For。但是，请注意，由于潜在的 XFF 注入问题，仅在确认可信的情况下使用
ProxyHeader =
; 进程安全退出的最长缓冲时间，默认为 0，不限制
GracePeriod = 0
; 日志级别，可选值为 debug/info/warning/error，默认为 info
LogLevel = info

; SSL 相关
[SSL]
; SSL 监听端口，默认为 443
Listen = :443
; 证书路径，默认为空
CertPath =
; 私钥路径，默认为空
KeyPath =

; 启用 Unix Socket 监听
[UnixSocket]
; Unix Socket 监听路径，默认为空
Listen = /run/cloudreve/cloudreve.sock
; 设置产生的 socket 文件的权限，默认为空
Perm = 0666

; 数据库相关，如果你只想使用内置的 SQLite 数据库，这一部分直接删去即可
[Database]
; 数据库类型，目前支持 sqlite/mysql/postgres/mariadb，默认为 sqlite
Type = sqlite
; 数据库端口，默认为 3306
Port = 3306
; 用户名，默认为空
User =
; 密码，默认为空
Password =
; 数据库地址，默认为空
Host = 127.0.0.1
; 数据库名称，默认为空
Name = cloudreve
; 连接字符集，默认为 utf8mb4
Charset = utf8mb4
; SQLite 数据库文件路径，默认为 data/cloudreve.db
DBFile = cloudreve.db
; 使用 Unix Socket 连接到数据库，默认为 false，如需开启，请在 Host 中指定 Unix Socket 路径
UnixSocket = false
; 数据库连接字符串，如果设置，其他数据库配置将忽略，但 Type 仍需设置。
; 例如：root:123456@tcp(127.0.0.1:3306)/cloudreve?charset=utf8mb4&parseTime=True&loc=Local 用于 MySQL。
DatabaseURL =

; 从机模式下的配置
[Slave]
; 通信密钥，默认为空
Secret =
; 回调请求超时时间 (s)，默认为 20
CallbackTimeout = 20
; 签名有效期 (s)，默认为 600
SignatureTTL = 600

; 跨域配置
[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false

; Redis 相关
[Redis]
; 连接类型，默认为 tcp
Network = tcp
; 服务器地址，默认为空，不启用
Server = 127.0.0.1:6379
; 密码，默认为空
Password =
; 数据库，默认为 0
DB = 0
; 用户名，默认为空
User =
; 是否使用 TLS 连接到 Redis，默认为 false
UseTLS = false
; 是否跳过 TLS 验证，默认为 false
TLSSkipVerify = false

; 从机配置应用配置覆盖
[OptionOverwrite]
; 可直接使用 `设置名称 = 值` 的格式覆盖
queue_slave_worker_num = 50

部署Cloudreve私人网盘项目

伍六