首次启动时,Cloudreve 会在同级目录下创建名为conf.ini
的配置文件,你可以修改此文件进行一些参数的配置,保存后需要重新启动 Cloudreve 生效。
你也可以在启动时加入-c
参数指定配置文件路径:
./cloudreve -c /path/to/conf.ini
一个完整的配置文件示例如下:
[System]; 运行模式Mode = master; 监听端口Listen = :5000; 是否开启 DebugDebug = false; Session 密钥, 一般在首次启动时自动生成SessionSecret = 23333; Hash 加盐, 一般在首次启动时自动生成HashIDSalt = something really hard to guss; SSL 相关[SSL]; SSL 监听端口Listen = :443; 证书路径CertPath = C:\Users\i\Documents\fullchain.pem; 私钥路径KeyPath = C:\Users\i\Documents\privkey.pem; 启用 Unix Socket 监听[UnixSocket]Listen = /run/cloudreve/cloudreve.sock; 数据库相关,如果你只想使用内置的 SQLite数据库,这一部分直接删去即可[Database]; 数据库类型,目前支持 sqlite | mysqlType = mysql; MySQL 端口Port = 3306; 用户名User = root; 密码Password = root; 数据库地址Host = 127.0.0.1; 数据库名称Name = v3; 数据表前缀TablePrefix = cd_; SQLite 数据库文件路径DBFile = cloudreve.db; 从机模式下的配置[Slave]; 通信密钥Secret = 1234567891234567123456789123456712345678912345671234567891234567; 回调请求超时时间 (s)CallbackTimeout = 20; 签名有效期SignatureTTL = 60; 跨域配置[CORS]AllowOrigins = *AllowMethods = OPTIONS,GET,POSTAllowHeaders = *AllowCredentials = false; Redis 相关[Redis]Server = 127.0.0.1:6379Password =DB = 0; 从机模式缩略图[Thumbnail]MaxWidth = 400MaxHeight = 300FileSuffix = ._thumb
默认情况下,Cloudreve 会使用内置的 SQLite 数据库,并在同级目录创建数据库文件cloudreve.db
,如果您想要使用 MySQL,请在配置文件中加入以下内容,并重启 Cloudreve。注意,Cloudreve 只支持大于或等于 5.7 版本的 MySQL 。
[Database]; 数据库类型,目前支持 sqlite | mysqlType = mysql; MySQL 端口Port = 3306; 用户名User = root; 密码Password = root; 数据库地址Host = 127.0.0.1; 数据库名称Name = v3; 数据表前缀TablePrefix = cd
更换数据库配置后,Cloudreve 会重新初始化数据库,原有的数据将会丢失。
你可以在配置文件中加入 Redis 相关设置:
[Redis]Server = 127.0.0.1:6379Password = your passwordDB = 0
请为 Cloudreve 指定未被其他业务使用的 DB,以避免冲突。
重启 Cloudreve 后,可注意控制台输出,确定 Cloudreve 是否成功连接 Redis 服务器。使用 Redis 后,以下内容将被 Redis 接管:
用户会话(重启Cloudreve后不会再丢失登录会话)
数据表高频记录查询缓存(如存储策略、设置项)
回调会话
OneDrive 凭证
如果您正在使用 Web 服务器反向代理 Cloudreve,推荐您在 Web 服务器中配置 SSL,本小节所阐述的启用方式只针对使用 Cloudreve 内置 Web 服务器的情境下有效。
在配置配置文件中加入:
[SSL]Listen = :443CertPath = C:\Users\i\Documents\fullchain.pemKeyPath = C:\Users\i\Documents\privkey.pem
其中 CertPath
和KeyPath
分别为 SSL 证书和私钥路径。保存后重启 Cloudreve 生效。