第23章 Cloudreve从属节点配置与管理指南

从属节点 ​ 你可以在其他服务器上以从属模式运行 Cloudreve。主节点可与从属节点通信，向其分发任务，或将它们用作文件存储节点。 配置新节点 ​ 前往管理面板的节点管理页面，点击新建节点，弹窗中会显示从属节点的配置文件。 在你希望用作从属节点的服务器上，创建新的配置文件 conf.ini，并粘贴弹窗中的内容。你可以按需调整监听端口等设置。 bash # 创建目录 mkdir ~/cloudreve_slave cd ~/cloudreve_slave

# 为配置文件创建数据目录 mkdir ~/cloudreve_slave/data

# 创建配置文件 nano ~/cloudreve_slave/conf.ini 将主节点同版本的 Cloudreve 可执行文件复制到 ~/cloudreve_slave，然后启动： bash ./cloudreve 提示 也可以使用 -c 参数指定配置文件路径： bash ./cloudreve -c data/conf.ini 返回管理面板的新建节点表单，填写节点名称和地址，并测试节点通信。如果通信测试失败，可以先保存节点，再根据常见问题排查。 可选 参考使用进程守护程序部署 Cloudreve 章节，以进程守护方式部署从属节点。 可选 参考配置反向代理章节，为从属节点配置反向代理。 启用节点功能 ​ 添加节点后，你可以前往节点设置页面，为该节点启用各项功能。 解压缩/创建压缩包 ​ 启用后，在线压缩或解压任务将分配至该节点执行。文件的下载、处理和传输均在该节点上进行。 创建压缩包时，节点需要将文件压缩至临时目录，然后进行传输。所需存储空间等于压缩包的大小。 解压缩时： 对于 zip 格式压缩包，需先将完整压缩包下载到临时目录，再开始解压。所需存储空间等于压缩包大小。 对于其他格式压缩包，整个解压过程不会将文件写入磁盘。 远程下载 ​ 请参阅远程下载。 存储文件 ​ 请参阅从属存储。 负载均衡 ​ 若用户在创建任务时未明确选择节点且存在多个可用节点，Cloudreve 将采用加权轮询策略选择节点。你可以在节点设置 -> 负载均衡权重中设置权重值。例如：若节点 A 权重为 3，节点 B 权重为 2，则在每 5 个任务请求中，节点 A 会被选中 3 次，节点 B 会被选中 2 次。 常见问题 ​ 节点通信失败 连接节点失败：Post "xxx": connect: xxx 检查输入的节点 URL 是否正确，以及防火墙是否放行了所用端口。 若错误信息以 status code: xxx 结尾，说明输入的节点地址指向的不是 Cloudreve 从属节点，而是其他 Web 服务，或 WAF 防火墙拦截了请求。 节点通信失败 已成功连接从属节点，但从属节点返回：{具体错误} 这表示主节点能连接到从属节点，但从属节点返回了错误。请根据错误信息末尾的 {具体错误} 进行排查。 若以 invalid sign 结尾，表示从属节点签名验证失败。请检查： 从属节点配置文件中 [Slave] 下的 Secret 配置，与管理面板中该节点的 从属密钥 是否一致。若不一致，使其统一后重启从属节点。 从属节点与主节点之间是否存在较大时间差。若有，请同步时间。 若以 Master: 4.x.x., Slave: 4.x.x. 结尾，表示主从节点 Cloudreve 版本不一致。请将主从节点 Cloudreve 改为相同版本。 若以 but slave returns: Get "xxx/api/v4/site/ping" 或 but slave returns: invalid character '<' looking for beginning of value 结尾，表示从属节点无法与主节点通信。请检查： 主节点 设置 -> 基础 -> 站点 URL 中的 主站点 URL 是否正确。从属节点需要能访问该地址。 检查从属节点与主节点之间的网络通信是否存在防火墙拦截。 从属节点上任务执行失败或部分失败 导致失败的原因可能有很多。你可以通过查看从属节点日志找到具体原因。首先，在主 Cloudreve 管理面板中定位失败任务，然后使用该任务的 Request ID 在从属节点上搜索相关日志。常见原因包括：任务超时、网络波动等。 从属节点任务队列的默认配置如下： 配置项 值 工作线程 15 最大执行时间 86400 秒 退避因子 4 最大退避时间 3600 秒 重试延迟 5 秒 最大重试次数 5 若认为默认配置导致任务失败，请参阅 从属节点配置覆盖 章节修改配置。