第5章 使用 Supervisor 部署 Cloudreve 进程管理指南
使用进程管理器部署 Cloudreve 在此部署模式下，Cloudreve 将直接运行在服务器上，并由进程监管工具（如 Supervisor）进行管理。
配置进程管理器 请从以下两种方法（Supervisor 或 Systemd）中任选其一。
使用 Supervisor 部署 安装 Supervisor： ```bash sudo apt-get install supervisor ```
初始化 Supervisor 配置： ```bash # 生成全局配置文件 sudo echo_supervisord_conf > /etc/supervisor/supervisord.conf
# 打开全局配置文件 sudo nano /etc/supervisor/supervisord.conf ```
去除文件底部 `[include]` 部分的注释符号 `;`，并添加新的配置文件包含路径： ```ini [include] files = /etc/supervisor/conf.d/*.conf ```
创建 Cloudreve 应用配置文件的目录，并创建、打开该配置文件： ```bash sudo mkdir -p /etc/supervisor/conf sudo vim /etc/supervisor/conf/cloudreve.conf ```
根据你的需求填写以下内容并保存： ```ini [program:cloudreve] directory=/home/cloudreve ; Cloudreve 主程序所在目录 command=/home/cloudreve/cloudreve ; Cloudreve 主程序路径 autostart=true ; 是否自动启动 autorestart=true ; 是否自动重启 stderr_logfile=/var/log/cloudreve.err ; 错误日志文件路径 stdout_logfile=/var/log/cloudreve.log ; 日志文件路径 environment= CODENATION_ENV=prod, CR_LICENSE_KEY=your_authorization_key ; 专业版授权密钥，社区版可忽略此项 ```
启动 Supervisor 服务及 Cloudreve 应用： ```bash # 通过全局配置文件启动 supervisor supervisord -c /etc/supervisor/supervisord.conf
# 启动 Cloudreve sudo supervisorctl start cloudreve
# 停止 Cloudreve sudo supervisorctl stop cloudreve
# 检查 Cloudreve 状态 sudo supervisorctl status cloudreve ```
使用 Systemd 部署 为 Cloudreve 创建 Systemd 服务文件： ```bash sudo vim /etc/systemd/system/cloudreve.service ```
根据你的需求填写以下内容并保存。其中 `PATH_TO_CLOUDREVE` 是 Cloudreve 主程序所在目录，`ExecStart` 是 Cloudreve 主程序的路径。 ```ini [Unit] Description=Cloudreve Documentation=https://docs.cloudreve.org After=network.target After=mysqld.service Wants=network.target
[Service] WorkingDirectory=/PATH_TO_CLOUDREVE ExecStart=/PATH_TO_CLOUDREVE/cloudreve Restart=on-abnormal RestartSec=5s KillMode=mixed
# 专业版授权密钥 Environment="CR_LICENSE_KEY=your_authorization_key"
# 日志输出 StandardOutput=/var/log/cloudreve.log StandardError=syslog
[Install] WantedBy=multi-user.target ```
通过 Systemd 启动 Cloudreve： ```bash sudo systemctl daemon-reload sudo systemctl enable cloudreve sudo systemctl start cloudreve ```
日后管理 Cloudreve： ```bash # 停止 Cloudreve sudo systemctl stop cloudreve
# 启动 Cloudreve sudo systemctl start cloudreve
# 重启 Cloudreve sudo systemctl restart cloudreve
# 检查 Cloudreve 状态 sudo systemctl status cloudreve ```
配置数据库 Cloudreve 首次成功启动后，会在主程序目录下的 `data/conf.ini` 中生成一个默认配置文件。请向该文件中添加数据库配置： ```ini [System] Mode = master Listen = :5212
[Database] Type = mysql Port = 3306 User = cloudreve Password = cloudreve Host = 127.0.0.1 Name = cloudreve ```
可用的配置项如下： | 设置名称 | 描述 | | :--- | :--- | | Type | 数据库类型，支持 postgres、mysql、sqlite | | Host | 数据库地址 | | Port | 数据库端口 | | User | 数据库用户名 | | Password | 数据库密码 | | Name | 数据库名称 | | DBFile | 可选，SQLite 数据库文件路径 | | UnixSocket | 可选，true 或 false，是否使用 Unix Socket 连接数据库 | | DatabaseURL | 可选，数据库连接字符串，若设置此项，其他数据库配置将被忽略 |
修改配置文件后，需要重启 Cloudreve。
配置 Redis Cloudreve 首次成功启动后，会在主程序目录下的 `data/conf.ini` 中生成一个默认配置文件。请向该文件中添加 Redis 配置： ```ini [System] Mode = master Listen = :5212
[Redis] Server = 127.0.0.1:6379 Password = your_redis_password DB = 0 ```
可用的配置项如下： | 设置名称 | 描述 | | :--- | :--- | | Server | Redis 地址 | | Password | 连接密码 | | DB | 数据库编号，默认为 0 | | Network | 网络类型，默认为 tcp，选项包括 tcp、tcp4（仅 IPv4）、tcp6（仅 IPv6）、udp、udp4（仅 IPv4）、udp6（仅 IPv6）、ip、ip4（仅 IPv4）、ip6（仅 IPv6）、unix、unixgram、unixpacket | | User | Redis ACL 用户名 | | UseTLS | 可选，是否使用 TLS 连接 Redis，默认为 false | | TLSSkipVerify | 可选，是否跳过 TLS 验证，默认为 false |
修改配置文件后，需要重启 Cloudreve。
后续步骤 Cloudreve 默认监听 5212 端口。你可以在浏览器中访问 `http://localhost:5212` 来访问 Cloudreve。请注册一个账户；第一个注册的账户将被设置为管理员。
至此，Cloudreve 已成功启动并监听 5212 端口。请继续访问“后续步骤”页面以完成部署。
