📁 部署Cloudreve私人网盘指南
Cloudreve 快速搭建公私兼备的网盘系统指南
Cloudreve 简介
Cloudreve 可以让您快速搭建起公私兼备的网盘系统。它在底层支持不同的云存储平台，用户在实际使用时无须关心物理存储方式。你可以使用 Cloudreve 搭建个人用网盘、文件分享系统，亦或是针对大小团体的公有云系统。
创建目录结构
请确保运行之前创建配置文件：
1
2
3
mkdir -vp ~/opt/cloudreve/{uploads,avatar} \
&& touch ~/opt/cloudreve/conf.ini \
&& touch ~/opt/cloudreve/cloudreve.db
获取 Cloudreve
你可以在 GitHub Release 页面获取已经构建打包完成的主程序。其中每个版本都提供了常见系统架构下可用的主程序，命名规则为 cloudreve_版本号_操作系统_CPU架构.tar.gz。比如，普通 64 位 Linux 系统上部署 3.8.3 版本，则应该下载 cloudreve_3.8.3_linux_amd64.tar.gz。
例如:
1
2
cd ~/opt/cloudreve
wget https://github.com/cloudreve/Cloudreve/releases/download/3.8.3/cloudreve_3.8.3_linux_amd64.tar.gz
配置 Cloudreve
以下是 ~/opt/cloudreve/conf.ini 配置文件的示例内容：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
[System]
; 运行模式
Mode = master
; 监听端口
; Listen = :5212
; 是否开启 Debug
Debug = false
; Session 密钥, 一般在首次启动时自动生成
; SessionSecret = 23333
; Hash 加盐, 一般在首次启动时自动生成
; HashIDSalt = something really hard to guess
; 呈递客户端 IP 时使用的 Header
ProxyHeader = X-Forwarded-For
; SSL 相关
; [SSL]
; SSL 监听端口
; Listen = :443
; 证书路径
; CertPath = /path/to/cert.pem
; 私钥路径
; KeyPath = /path/to/privkey.pem
; Unix Socket 监听
[UnixSocket]
Listen = ~/opt/cloudreve/cloudreve.sock
Perm = 0666
; 数据库相关
; [Database]
; Type = mysql
; Port = 3306
; User = root
; Password = root
; Host = 127.0.0.1
; Name = cloudreve
; TablePrefix = cd_
; Charset = utf8mb4
; DBFile = cloudreve.db
; GracePeriod = 30
; UnixSocket = false
; 从机模式下的配置
[Slave]
Secret = 6845ae34e59945d64ea9490265ca5e8f79a07a7f86e3dd58bfeb58e3eb75cf478eb8a35ced243711a7947724923
CallbackTimeout = 20
SignatureTTL = 60
; 跨域配置
[CORS]
AllowOrigins = *
AllowMethods = OPTIONS,GET,POST
AllowHeaders = *
AllowCredentials = false
SameSite = Default
Secure = false
; Redis 配置
; [Redis]
; Server = 127.0.0.1:6379
; Password =
; DB = 0
; 从机配置覆盖
[OptionOverwrite]
max_worker_num = 50
注意：请根据实际情况修改配置文件中的路径和参数。特别是 [Database] 部分，如果您使用外部数据库，请确保填写正确的数据库连接信息。
启动 Cloudreve
Linux
在 Linux 下，直接解压并执行主程序即可：
1
2
3
4
5
6
7
8
# 解压获取到的主程序
tar -zxvf cloudreve_3.8.3_linux_amd64.tar.gz
# 赋予执行权限
chmod +x ./cloudreve
# 启动 Cloudreve
./cloudreve
Cloudreve 默认会监听 5212 端口。你可以在浏览器中访问 http://服务器IP:5212 进入 Cloudreve。
进程守护
Systemd
编辑配置文件：
1
vim /usr/lib/systemd/system/cloudreve.service
将下文 PATH_TO_CLOUDREVE 更换为程序所在目录：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
[Unit]
Description=Cloudreve
Documentation=https://docs.cloudreve.org
After=network.target
After=mysqld.service
Wants=network.target
[Service]
User=你的名字
WorkingDirectory=~/opt/cloudreve
ExecStart=~/opt/cloudreve/cloudreve
Restart=on-abnormal
RestartSec=5s
KillMode=mixed
StandardOutput=null
StandardError=syslog
[Install]
WantedBy=multi-user.target
注意：请根据实际情况修改配置文件中的路径和参数。特别是 [User] 部分。
更新配置：
1
sudo systemctl daemon-reload
启动服务：
1
sudo systemctl start cloudreve
设置开机启动：
1
sudo systemctl enable cloudreve
管理命令：
1
2
3
4
5
6
7
8
9
10
11
# 启动服务
sudo systemctl start cloudreve
# 停止服务
sudo systemctl stop cloudreve
# 重启服务
sudo systemctl restart cloudreve
# 查看状态
sudo systemctl status cloudreve
WebDAV
WebDAV 是一种基于 HTTP 协议的文件传输协议，如今有许多第三方文件管理器、视频播放器等产品都支持通过 WebDAV 协议访问 Cloudreve 中的文件，你可以借此实现跨平台的文件共享与同步。
要使用 WebDAV，请先前往后台管理面板为对应用户组开启 WebDAV 使用权限。WebDAV 所使用的账号与 Cloudreve 账号并不互通，需要单独创建。前往前台导航左侧 - WebDAV - 创建新账号创建供 WebDAV 使用的账号信息。创建完成后系统会为此账号自动生成密码，使用 WebDAV 时请使用注册邮箱作为账号名，密码则为上述系统所生成的密码。
创建 WebDAV 账号时，你可以为此账号指定相对根目录，此账号只能通过 WebDAV 访问所指定相对根目录下的目录及文件。对于捐助版，用户还可以为不同目录挂载不同的存储策略，在 WebDAV 下上传新文件时会优先使用为目录挂载的存储策略。
使用 Windows 资源管理器(不推荐)
在“此电脑”空白处右键，选择“添加一个网络位置”：
输入站点 WebDAV 连接地址，一般格式为 https://您的域名/dav，填写完成后输入您的 Cloudreve 账号和系统生成的账号密码即可。
已知问题：重启后无法访问已添加的 WebDAV 挂载，需要重新输入账号密码。这是由于 Windows 不再支持 BasicAuth 下存储 WebDAV 账号及密码信息。Cloudreve 会在后续版本中更换 WebDAV 验证方式以改善此问题。
希望这份指南能帮助你成功部署自己的私人网盘系统。