Cloudreve
论坛
GitHub
搜索文档…
简体中文
欢迎
起步
快速开始
配置文件
构建
使用
存储策略
WebDAV
离线下载
自定义前端
捐助版相关
维护
数据库脚本
升级
由
GitBook
提供支持
配置文件
配置文件
首次启动时,Cloudreve 会在同级目录下创建名为
conf.ini
的配置文件,你可以修改此文件进行一些参数的配置,保存后需要重新启动 Cloudreve 生效。
你也可以在启动时加入
-c
参数指定配置文件路径:
1
./cloudreve -c /path/to/conf.ini
Copied!
一个完整的配置文件示例如下:
conf.ini
1
[
System
]
2
; 运行模式
3
Mode
=
master
4
; 监听端口
5
Listen
=
:5000
6
; 是否开启 Debug
7
Debug
=
false
8
; Session 密钥, 一般在首次启动时自动生成
9
SessionSecret
=
23333
10
; Hash 加盐, 一般在首次启动时自动生成
11
HashIDSalt
=
something really hard to guss
12
13
; SSL 相关
14
[
SSL
]
15
; SSL 监听端口
16
Listen
=
:443
17
; 证书路径
18
CertPath
=
C:\Users\i\Documents\fullchain.pem
19
; 私钥路径
20
KeyPath
=
C:\Users\i\Documents\privkey.pem
21
22
; 启用 Unix Socket 监听
23
[
UnixSocket
]
24
Listen
=
/run/cloudreve/cloudreve.sock
25
26
; 数据库相关,如果你只想使用内置的 SQLite数据库,这一部分直接删去即可
27
[
Database
]
28
; 数据库类型,目前支持 sqlite/mysql/mssql/postgres
29
Type
=
mysql
30
; MySQL 端口
31
Port
=
3306
32
; 用户名
33
User
=
root
34
; 密码
35
Password
=
root
36
; 数据库地址
37
Host
=
127.0.0.1
38
; 数据库名称
39
Name
=
v3
40
; 数据表前缀
41
TablePrefix
=
cd_
42
; 字符集
43
Charset
=
utf8
44
; SQLite 数据库文件路径
45
DBFile
=
cloudreve.db
46
47
; 从机模式下的配置
48
[
Slave
]
49
; 通信密钥
50
Secret
=
1234567891234567123456789123456712345678912345671234567891234567
51
; 回调请求超时时间 (s)
52
CallbackTimeout
=
20
53
; 签名有效期
54
SignatureTTL
=
60
55
56
; 跨域配置
57
[
CORS
]
58
AllowOrigins
=
*
59
AllowMethods
=
OPTIONS,GET,POST
60
AllowHeaders
=
*
61
AllowCredentials
=
false
62
63
; Redis 相关
64
[
Redis
]
65
Server
=
127.0.0.1:6379
66
Password
=
67
DB
=
0
68
69
; 从机配置覆盖
70
[
OptionOverwrite
]
71
; 可直接使用 `设置名称 = 值` 的格式覆盖
72
max_worker_num
=
50
Copied!
配置案例
使用 MySQL
默认情况下,Cloudreve 会使用内置的 SQLite 数据库,并在同级目录创建数据库文件
cloudreve.db
,如果您想要使用 MySQL,请在配置文件中加入以下内容,并重启 Cloudreve。注意,Cloudreve 只支持大于或等于 5.7 版本的 MySQL 。
1
[
Database
]
2
; 数据库类型,目前支持 sqlite/mysql/mssql/postgres
3
Type
=
mysql
4
; MySQL 端口
5
Port
=
3306
6
; 用户名
7
User
=
root
8
; 密码
9
Password
=
root
10
; 数据库地址
11
Host
=
127.0.0.1
12
; 数据库名称
13
Name
=
v3
14
; 数据表前缀
15
TablePrefix
=
cd
16
; 字符集
17
Charset
=
utf8
Copied!
更换数据库配置后,Cloudreve 会重新初始化数据库,原有的数据将会丢失。
使用 Redis
你可以在配置文件中加入 Redis 相关设置:
1
[
Redis
]
2
Server
=
127.0.0.1:6379
3
Password
=
your password
4
DB
=
0
Copied!
请为 Cloudreve 指定未被其他业务使用的 DB,以避免冲突。
重启 Cloudreve 后,可注意控制台输出,确定 Cloudreve 是否成功连接 Redis 服务器。使用 Redis 后,以下内容将被 Redis 接管:
用户会话(重启Cloudreve后不会再丢失登录会话)
数据表高频记录查询缓存(如存储策略、设置项)
回调会话
OneDrive 凭证
启用 HTTPS
如果您正在使用 Web 服务器反向代理 Cloudreve,推荐您在 Web 服务器中配置 SSL,本小节所阐述的启用方式只针对使用 Cloudreve 内置 Web 服务器的情境下有效。
在配置配置文件中加入:
1
[
SSL
]
2
Listen
=
:443
3
CertPath
=
C:\Users\i\Documents\fullchain.pem
4
KeyPath
=
C:\Users\i\Documents\privkey.pem
Copied!
其中
CertPath
和
KeyPath
分别为 SSL 证书和私钥路径。保存后重启 Cloudreve 生效。
覆盖从机节点的配置项
Cloudreve 的某些配置项时存储测在数据库中的,但是从机机点并不会连接数据库,你可以在配置文件中覆盖响应的配置项。
比如,从机节点作为存储端运行时,你可以通过下面的配置设定从机生成的缩略图规格:
1
[
OptionOverwrite
]
2
thumb_width
=
400
3
thumb_height
=
300
4
thumb_file_suffix
=
._thumb
5
thumb_max_task_count
=
-1
6
thumb_encode_method
=
jpg
7
thumb_gc_after_gen
=
0
8
thumb_encode_quality
=
85
Copied!
如果从机端作为离线下载节点使用,你可以通过下面的配置覆盖默认的重试、超时参数,以避免默认的数值过于保守导致文件转存失败:
1
[
OptionOverwrite
]
2
; 任务队列最多并行执行的任务数
3
max_worker_num
=
50
4
; 任务队列中转任务传输时,最大并行协程数
5
max_parallel_transfer
=
10
6
; 中转分片上传失败后重试的最大次数
7
chunk_retries
=
10
Copied!
起步 - 以前
快速开始
下一个 - 起步
构建
最近更新
29d ago
复制链接
在 GitHub 上编辑
内容
配置文件
配置案例
使用 MySQL
使用 Redis
启用 HTTPS
覆盖从机节点的配置项