Rclone REST API 单传输日志文件配置失效求助

数据老陈

2026-6-12

Rclone Daemon REST API 单传输日志配置问题解答

核心问题原因

你当前使用的Rclone版本是v1.70.3，而单传输任务独立日志的功能是在v1.71.0版本才正式加入的，这是导致所有配置尝试无效的根本原因。

针对疑问的解答

Rclone以daemon模式通过REST API运行时，是否支持单传输日志？
支持，但仅在v1.71.0及以上版本提供此功能，v1.70.3无该特性。
单传输日志文件的正确参数结构是什么？
在v1.71.0+版本中，需在请求体的_config字段内使用全小写短横线格式的参数，示例如下：

{
  "srcFs": "source:/path",
  "dstFs": "dest:/path",
  "_async": true,
  "_config": {
    "log-file": "/logs/job-123.log",
    "log-level": "INFO",
    "use-json-log": true
  }
}

注意参数名是log-file，不是驼峰式的LogFile。

daemon启动时设置全局日志文件是否会阻止单传输日志生效？
不会。全局日志会继续写入--log-file指定的文件，单任务日志会额外写入你指定的独立文件，两者并行输出，互不干扰。
是否需要从daemon命令中移除--log-file？
不需要。移除后全局日志会输出到Docker容器的标准输出（可通过docker logs查看），但不影响单任务独立日志的生成。如果需要保留全局日志记录，可继续保留该参数。
有没有REST API实现单传输日志的可用示例？
以下是针对/sync/copy端点的完整请求示例（需v1.71.0+）：

const body = {
  srcFs: "source:/path",
  dstFs: "dest:/path",
  _async: true,
  _config: {
    "log-file": "/logs/job-123.log",
    "log-level": "INFO",
    "use-json-log": true
  }
};

// 发送请求
await fetch('http://localhost:5572/sync/copy', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(body)
});