Cloudreve 安装部署详细教程

# 备份
mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup

# 下载新的 CentOS-Base.repo 到 /etc/yum.repos.d/

## CentOS 6
curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-6.repo

## CentOS 7
curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo

## CentOS 8
curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-8.repo

# 生成缓存
yum makecache

# 替换
sed -i -e '/mirrors.cloud.aliyuncs.com/d' -e '/mirrors.aliyuncs.com/d' /etc/yum.repos.d/CentOS-Base.repo

依赖更新

通常，预置的服务器镜像的依赖软件都较为老旧，为此我们要对其更新

yum -y update

通常第一次依赖更新所需的时间较长，请耐心等待

简单的 SSH 安全

系统预置的SSH通常没有较为完善的安全配置，因此我们容易被扫描到并被攻击。为此我们需要做些事以使我们的服务器不受侵害

使用密码登录较容易被暴力破解，因此我推荐你使用密钥登录

《CentOS 设置 ssh 密钥登录》

而后，我们还需要做一些基本的配置

# 备份
cp /etc/ssh/sshd_config /etc/ssh/sshd_config.backup

# 打开SSH配置文件
vi /etc/ssh/sshd_config

进行以下配置

# 去除注释
LogLevel INFO

# 去除注释并修改内容
MaxAuthTries 3
MaxSessions 5

# 添加
Protocol 2

# 如果使用密钥登陆则去除注释
PubkeyAuthentication yes

# 如果仅使用密钥登陆则修改
PasswordAuthentication no

# 去除注释并修改内容
ClientAliveInterval 600
ClientAliveCountMax 3

然后重启sshd服务

重启sshd服务之前请务必确保有一个已连接的SSH以防止服务器失联！

systemctl restart sshd

然后重新连接，查看是否成功，不成功则恢复备份

方法一：纯 Cloudreve 环境

优劣

优点：较为简单，所需时间少，适合私有云盘部署
优点：轻量，对于极低配置的服务器较为友好
缺点：可扩展性差，日志查询困难
缺点：完全无防护，可能一打就死
缺点：数据库可操作性低，数据量不宜过大
缺点：一台服务器只能运行一个web程序（即当前的Cloudreve）

通常个人私有云可以使用以下方式部署

操作

首先我们需要获取cloudreve源程序文件。你可以前往GitHub下载后自行上传至服务器或使用wget获取

GitHub

cloudreve/Cloudreve

下载

yum -y install wget
 && wget https://github.com/cloudreve/Cloudreve/releases/download/3.5.2/cloudreve_3.5.2_linux_amd64.tar.gz -O /cloudreve/cloudreve.tar.gz

解压

cd /cloudreve
tar -zxvf cloudreve.tar.gz
rm -f cloudreve.tar.gz

初始化

chmod +x cloudreve
chown root:root cloudreve
./cloudreve

请务必记住Cloudreve初次运行生成的账号密码！

记住后，按 Ctrl+C 退出程序

配置

vi conf.ini

你可以前往 Cloudreve 官方文档获取全部有关Cloudreve配置文件的信息，或使用本文提供的简易配置

[System]
Mode = master
Listen = :80
Debug = false
SessionSecret = 23333
HashIDSalt = something really hard to guss

[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false

其中 SessionSecret 和 HashIDSalt 字段会自动生成，无需更改。

如果你要启用 SSL 的话，请在conf.ini的后边添加以下内容

[SSL]
Listen = :443
CertPath = /path/to/fullchain.pem
KeyPath = /path/to/private.key

请务必将 CertPath 和 KeyPath 修改为自己的SSL证书、私钥的位置。SSL证书签发可前往 freessl.cn ，不过我更推荐购买更加正规安全的SSL证书

防火墙配置

你可以查看这篇文章获取更多有关CentOS Firewalld的信息

https://www.ahdark.blog/som/552.shtml

在此环境，你只需要输入以下命令

# 开放端口
firewall-cmd --zone=public --add-port=80/tcp --permanent
firewall-cmd --zone=public --add-port=443/tcp --permanent

# 重载
firewall-cmd --reload

进程守护

由于使用GIN，Cloudreve的正常访问必须保证程序的运行

我个人推荐使用Systemd进行进程守护

# 编辑配置文件
vim /usr/lib/systemd/system/cloudreve.service

编辑内容如下

[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/cloudreve
ExecStart=/cloudreve/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

StandardOutput=null
StandardError=syslog

[Install]
WantedBy=multi-user.target

# 更新配置
systemctl daemon-reload

# 启动服务
systemctl start cloudreve

# 设置开机启动
systemctl enable cloudreve

随后你就可以通过以下方式启动、重启、关闭Cloudreve服务

# 启动服务
systemctl start cloudreve

# 停止服务
systemctl stop cloudreve

# 重启服务
systemctl restart cloudreve

# 查看状态
systemctl status cloudreve

解析（可选）

前往DNS，将对应域名解析至你的ip，即可正常访问服务

当然你也可以选择纯ip，但我并不推荐

搭配CDN一定是更好的选择，但你需要进一步了解CDN配置，而且这一方法并不适合搭配CDN使用

虚拟机部署成功

方法二：脚本 Nginx+MySQL+Redis + Cloudreve

此示例使用 Oneinstack 脚本，我也同样鼓励你使用LNMP等脚本。

我更建议你将MySQL、Redis从Cloudreve服务器上分离以实现更高的负载能力和稳定性。

优劣

优点：稳定，可用于超十万用户的生产环境（实测可行）
优点：数据库负载能力强
优点：Session不易丢失，用户体验好
优点：日志可实时查询，可扩展性高
缺点：数据库内存溢出可能使全盘皆崩
缺点：依靠单服务器性能，难以实现负载均衡
缺点：部署时间较长

操作

基本 Web 环境部署

请自行参照 Oneinstack 安装方法进行安装

MySQL版本需要选择5.7及以上，推荐编译安装（消耗时间较长），请务必选择安装 Redis Server

新建 vhost

请前往 https://oneinstack.com/install/ 获取详细信息

此图并非Cloudreve配置图，截取自Oneinstack官网

取自 https://oneinstack.com/install/

请不要开启防盗链、伪静态！

请记得将SSL证书换为自己申请的合规的证书！

下载 & 解压

进入vhost目录下，在本文示例为 /data/wwwroot/172.16.89.213

cd /data/wwwroot/172.16.89.213

通过wget下载cloudreve（同上文）

# 下载
yum -y install wget && wget https://github.com/cloudreve/Cloudreve/releases/download/3.5.2/cloudreve_3.5.2_linux_amd64.tar.gz -O cloudreve.tar.gz

# 解压
tar -zxvf cloudreve.tar.gz && rm -f cloudreve.tar.gz

配置 MySQL

在上文安装MySQL的时候Oneinstack会让你自己输入mysql密码，现在你要通过密码登录

例如：我的MySQL Root账户密码为123456

mysql -uroot -p123456

而后新建数据库和账户，请自行替换密码

CREATE DATABASE Cloudreve;
CREATE USER cloudreve@127.0.0.1 IDENTIFIED BY 'examplepassword';
GRANT ALL ON Cloudreve.* TO cloudreve@127.0.0.1;
exit;

初始化

chmod 777 cloudreve
chown root:root cloudreve
./cloudreve

此时Cloudreve程序会进行初始化并生成初始账密，但你并不需要记住它

随后编辑conf.ini

vi conf.ini

[System]
Mode = master
Listen = :5212
Debug = false
SessionSecret = 23333
HashIDSalt = something really hard to guss

[Database]
Type = mysql
Port = 3306
User = cloudreve
Password = examplepassword
Host = 127.0.0.1
Name = Cloudreve
TablePrefix = cr_
Charset = utf8

[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false

[Redis]
Server = 127.0.0.1:6379
Password =
DB = 0

由于Redis Server已包含在安装过程中，且默认无密码，直接使用即可。需要注意的是不要对外网开放Redis即可

重新运行程序进行数据表生成

./cloudreve

此时请记住管理员账密，但不急着登录

配置进程守护

由于使用GIN，Cloudreve的正常访问必须保证程序的运行

我个人推荐使用Systemd进行进程守护

# 编辑配置文件
vim /usr/lib/systemd/system/cloudreve.service

编辑内容如下

[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target

[Service]
WorkingDirectory=/data/wwwroot/172.16.89.213
ExecStart=/data/wwwroot/172.16.89.213/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed

StandardOutput=null
StandardError=syslog

[Install]
WantedBy=multi-user.target

随后更新配置

# 更新配置
systemctl daemon-reload

# 启动服务
systemctl start cloudreve

# 设置开机启动
systemctl enable cloudreve

随后你就可以通过以下方式启动、重启、关闭Cloudreve服务

# 启动服务
systemctl start cloudreve

# 停止服务
systemctl stop cloudreve

# 重启服务
systemctl restart cloudreve

# 查看状态
systemctl status cloudreve

配置 Nginx 反代

首先编辑Nginx vhost对应配置文件

vi /usr/local/nginx/conf/vhost/127.0.0.1.conf

upstream cloudreve {
  server 127.0.0.1:5212;
}
server {
  listen 80;
  listen [::]:80;
  listen 443 ssl http2;
  listen [::]:443 ssl http2;
  ssl_certificate /usr/local/nginx/conf/ssl/172.16.89.213.crt;
  ssl_certificate_key /usr/local/nginx/conf/ssl/172.16.89.213.key;
  ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
  ssl_ciphers TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256:TLS13-AES-128-CCM-8-SHA256:TLS13-AES-128-CCM-SHA256:EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
  ssl_prefer_server_ciphers on;
  ssl_session_timeout 10m;
  ssl_session_cache builtin:1000 shared:SSL:10m;
  ssl_buffer_size 1400;
  add_header Strict-Transport-Security max-age=15768000;
  ssl_stapling on;
  ssl_stapling_verify on;
  server_name 172.16.89.213;
  access_log /data/wwwlogs/172.16.89.213_nginx.log combined;

  location / {
    proxy_pass http://cloudreve;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_redirect off;
  }

  location ~ /(\.user\.ini\.ht\.git\.svn\.projectLICENSEREADME\.md) {
    deny all;
  }
  location /.well-known {
    allow all;
  }
}

从理论上是可以实现多个 Cloudreve 后端负载均衡的，只需在 upstream {} 中加入更多 server 即可，前提是 server 及对应端口必须可用且所有 Cloudreve 必须共享 Redis 和数据库。

随后重载Nginx

systemctl reload nginx

而后确认Cloudreve正常运行

Cloudreve 状态

Pro需要对.sock文件进行权限修正

chmod 777 /run/cloudreve.sock

而后按指定域名访问即可进入Cloudreve

访问成功

方法三：宝塔 LNM+Cloudreve

优劣

缺点：安全难以保障（个人极度不信任宝塔，尤其是删库事件以后）
优点：维护便捷
优点：备份机制完善
优点：可扩展性高
优点：适合新手

操作

环境安装

安装宝塔，可参照 https://www.bt.cn/bbs/thread-19376-1-1.html

前往【软件商店】下载安装以下软件

Nginx 1.18 或更高
MySQL 5.7 或更高（至少5.7，否则 Cloudreve 无法运行！）
Redis
Supervisor 管理器

新建网站

请务必选择 utf8mb4

请不要使用PHP

前往 github.com/cloudreve/Cloudreve/releases 下载 amd_64 安装包并上传至服务器目录下

初始化

在Cloudreve目录下打开【终端】

chmod 777 cloudreve
chown root:root cloudreve
./cloudreve

此时Cloudreve程序会进行初始化并生成初始账密，但你并不需要记住它

随后编辑conf.ini

[System]
Mode = master
Listen = :5212
Debug = false
SessionSecret = 23333
HashIDSalt = something really hard to guss

[Database]
Type = mysql
Port = 3306
User = 172_16_35_223
Password = 6Lf56Kf5cjEKNZGj
Host = 127.0.0.1
Name = 172_16_35_223
TablePrefix = cr_
Charset = utf8mb4

[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false

[Redis]
Server = 127.0.0.1:6379
Password =
DB = 0

由于Redis Server已包含在安装过程中，且默认无密码，直接使用即可。需要注意的是不要对外网开放Redis即可

请记得将数据库信息改为正确信息

重新运行程序进行数据表生成

./cloudreve

此时请记住管理员账密，但不急着登录

Supervisor

如图填写即可

有日志即为正常

Nginx 反代

添加反向代理配置

如图，即可

方法四：容器化运行

在 Cloudreve 3.5 发布后，Aaron 在官方文档页面更新了 Docker 部署教程，同时在Docker Hub发布了Cloudreve Image，部署变得简单了许多，因此我在 2021.04.27 完善了此方法。

2022.10.02 补充：为方便容器部署，我向 Cloudreve 提交了通过环境变量配置应用程序的 Pull Request （cloudreve/Cloudreve#1475）。待其审阅完毕合并主分支后，我将撰写详细的应用方法。

优劣

缺点：容器对于新手通常难以理解
缺点：Docker 对于服务器性能有些许损耗
优点：企业级架构，便于运营
优点：并发无上限，可以多服务器负载运行
优点：单节点故障不影响整体 SLA ，系统秒级恢复
优点：安全性高

Docker 操作

创建目录结构

请确保运行之前：

手动创建 conf.ini 空文件或者符合 Cloudreve 配置文件规范的 conf.ini, 并将 <path_to_your_config> 替换为该路径
手动创建 cloudreve.db 空文件, 并将 <path_to_your_db> 替换为该路径
手动创建 uploads 文件夹, 并将 <path_to_your_uploads> 替换为该路径
手动创建 avatar 文件夹，并将 <path_to_your_avatar> 替换为该路径

或者，直接使用以下命令创建：

mkdir -vp cloudreve/{uploads,avatar} \
    && touch cloudreve/conf.ini \
    && touch cloudreve/cloudreve.db

运行

docker run -d \
    -p 5212:5212 \
    --mount type=bind,source=<path_to_your_config>,target=/cloudreve/conf.ini \
    --mount type=bind,source=<path_to_your_db>,target=/cloudreve/cloudreve.db \
    -v <path_to_your_uploads>:/cloudreve/uploads \
    -v <path_to_your_avatar>:/cloudreve/avatar \
    cloudreve/cloudreve:latest

Docker Compose 操作

创建目录结构

mkdir -vp /cloudreve/{uploads,avatar} \
&& touch /cloudreve/conf.ini \
&& touch /cloudreve/cloudreve.db \
&& mkdir -p /aria2/config \
&& mkdir -p /data/aria2 \
&& chmod -R 777 /data/aria2

创建 docker-compose

请注意修改 yml 文件中的 <your_aria_rpc_token>

vi docker-compose.yml

version: "3.8"
services:
  cloudreve:
    container_name: cloudreve
    image: cloudreve/cloudreve:latest
    restart: unless-stopped
    ports:
      - "5212:5212"
    volumes:
      - temp_data:/data
      - /cloudreve/uploads:/cloudreve/uploads
      - /cloudreve/conf.ini:/cloudreve/conf.ini
      - /cloudreve/cloudreve.db:/cloudreve/cloudreve.db
      - /cloudreve/avatar:/cloudreve/avatar
    depends_on:
      - aria2
  aria2:
    container_name: aria2
    image: p3terx/aria2-pro
    restart: unless-stopped
    environment:
      - RPC_SECRET=<your_aria_rpc_token>
      - RPC_PORT=6800
    volumes:
      - /aria2/config:/config
      - temp_data:/data
volumes:
  temp_data:
    driver: local
    driver_opts:
      type: none
      device: /data
      o: bind

运行

docker-compose up -d

Cloudreve 安装部署详细教程

Comments

Send Comments