**《Rclone 最优配置参数》**,适合 **WebDAV 网盘同步场景**
一、核心推荐参数组合(适合稳定传输)
rclone sync /local/path remote:path \
-P \
--checksum \
--transfers=2 \
--checkers=4 \
--retries=5 \
--retries-sleep=10s \
--timeout=2m \
--low-level-retries=10 \
--log-level=ERROR \
--log-file=/var/log/rclone_sync.log📘 参数详解(推荐配置)
| 参数 | 含义 | 推荐值/说明 |
|---|---|---|
-P | 显示进度 | 必开,显示传输进度条 |
--checksum | 用哈希校验一致性 | ⚠️ WebDAV 部分实现可能不支持,但推荐启用尝试 |
--transfers | 并行文件传输数 | ✅ 2~4(避免同时传输多个大文件) |
--checkers | 并发文件校验数 | 默认 8,可调低防止封锁 |
--retries | 总失败重试次数 | ✅ 5(默认 3) |
--retries-sleep | 每次重试间隔 | ✅10s(避免网盘吞吐限制) |
--timeout | 单文件最大允许时间 | 默认1m,建议设为 2m 以上 |
--low-level-retries | 底层协议级重试次数 | ✅ 增加至 10 |
--log-level=ERROR | 日志等级 | 错误即可,避免刷屏 |
--log-file=/path/to.log | 日志路径 | 建议指定独立日志文件 |
二、针对 WebDAV 服务的专属建议
- ⚠️ WebDAV 元数据延迟导致“大小不一致”错误
- 一些服务上传完文件但未立即刷新文件大小,导致
rclone认为“corrupted on transfer” - ✅ 保持
--retries+--checksum,Attempt 2/3 succeeded就是生效的表现
- 🧪 文件上传不完整的防御手段
- 加延时:在生成大文件后
sleep 2再传 - 降低并发:
--transfers=1对低质量 WebDAV 更有效
三、rclone 任务自动化封装建议(实用封装模板)
#!/bin/bash
SRC="/data/backup"
DST="alist:/移动云盘/Rclone/站点备份"
LOG="/var/log/rclone_sync.log"
rclone sync "$SRC" "$DST" \
-P \
--checksum \
--transfers=2 \
--checkers=4 \
--retries=5 \
--retries-sleep=10s \
--timeout=2m \
--low-level-retries=10 \
--log-level=ERROR \
--log-file="$LOG"
if [ $? -eq 0 ]; then
echo "[OK] 同步成功: $SRC → $DST" >> "$LOG"
else
echo "❌ 同步失败: $SRC → $DST" >> "$LOG"
fi附:稳定同步建议总结
| 建议 | 理由 |
|---|---|
| 每次同步前先 sleep 1~2 秒 | 保证本地文件写入完毕 |
| 控制并发连接数 | 防止网盘封锁、避免文件出错 |
| 日志独立保存 | 便于排查、邮件汇总更清晰 |
若频繁失败考虑改为copy | sync 会删除远程文件,copy 更保险 |
可加入--no-traverse | 提高文件夹已知结构下的同步效率 |








