GeekIt

Rclone命令速查

配置与远程接入、浏览统计、copy/sync、过滤限速、mount 挂载、服务化、加密压缩、校验清理与排障等 153 条命令

共 153 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 参数说明复制
rclone version查看版本,不同版本支持的后端与参数有差异
rclone config交互式配置向导,添加/编辑远程存储
rclone config file查看配置文件路径(Linux 默认 ~/.config/rclone/rclone.conf)
rclone config show打印全部配置(含密钥,注意不要泄露)
rclone config show s3查看指定远程的配置项
rclone config create s3 s3 provider=AWS access_key_id=AK secret_access_key=SK region=ap-east-1非交互式创建远程,适合脚本与容器
rclone config update s3 region=ap-southeast-1修改已有远程的参数
rclone config delete s3删除远程配置
rclone config reconnect gd:重新授权(OAuth 类存储过期时使用)
rclone listremotes列出所有已配置的远程
rclone config dump以 JSON 输出全部配置,便于备份
rclone obscure "mypassword"把明文密码转为 rclone 可用的混淆串
rclone help flags | grep bwlimit按关键字查全局参数说明
命令 / 参数说明复制
rclone config create minio s3 provider=Minio endpoint=http://10.0.0.11:9000 access_key_id=AK secret_access_key=SK接入 MinIO / S3 兼容存储
rclone config create oss s3 provider=Alibaba access_key_id=AK secret_access_key=SK endpoint=oss-cn-hangzhou.aliyuncs.com接入阿里云 OSS(S3 兼容模式)
rclone config create cos s3 provider=TencentCOS access_key_id=AK secret_access_key=SK接入腾讯云 COS
rclone config create azure azureblob account=storageaccount key=ACCOUNTKEY接入 Azure Blob
rclone config create gd drive scope=drive接入 Google Drive(会走 OAuth 授权)
rclone config create sftp sftp host=10.0.0.21 user=backup key_file=/root/.ssh/id_rsa通过 SFTP 接入服务器目录
rclone config create dav webdav url=https://dav.example.com vendor=other user=u pass=$(rclone obscure p)接入 WebDAV
rclone config create ftp ftp host=10.0.0.31 user=u pass=$(rclone obscure p)接入 FTP
rclone config create local local把本地目录也当成远程,便于统一批量操作
rclone backend features minio:查看该后端支持的能力(是否支持 hash、move 等)
rclone about minio:查看远端容量与已用空间(需后端支持)
凭据建议存放于环境变量或密钥管理服务配置文件泄露等于存储权限泄露
命令 / 参数说明复制
rclone lsd minio:列出顶层目录(类似 ls -d)
rclone ls minio:bucket/path递归列出对象与大小
rclone lsl minio:bucket/path带修改时间与大小的详细列表
rclone lsf minio:bucket/path只输出文件名,适合管道处理
rclone lsf --dirs-only --recursive minio:bucket只列目录结构
rclone lsjson minio:bucket/pathJSON 输出,便于程序解析
rclone size minio:bucket/path统计对象数量与总容量
rclone size --json minio:bucket/pathJSON 格式的容量统计
rclone tree minio:bucket --level 2树形展示目录结构
rclone ncdu minio:bucket交互式浏览并分析空间占用
rclone about gd:查看账户配额与剩余空间
rclone mkdir minio:bucket/newdir创建目录(对象存储为前缀)
rclone cat minio:bucket/file.txt输出对象内容到标准输出
命令 / 参数说明复制
rclone copy /data/logs minio:bucket/logs复制:只新增与更新,不删除目标端多余文件
rclone sync /data/site minio:bucket/site同步:目标端与源端保持一致,会删除多余文件
rclone move /data/tmp minio:bucket/tmp移动:传输成功后删除源文件
rclone copyto /data/a.txt minio:bucket/b.txt单文件复制并重命名
rclone moveto /data/a.txt minio:bucket/b.txt单文件移动并重命名
rclone copy src: dst: --dry-run只演练不实际传输,删除类操作前必做
rclone sync src: dst: -P显示实时进度与速率
rclone copy src: dst: --update仅当源端更新时才覆盖目标
rclone copy src: dst: --ignore-existing跳过目标已存在的文件
rclone sync src: dst: --backup-dir minio:bucket/backup被覆盖或删除的文件转存到备份目录
rclone sync src: dst: --track-renames识别重命名,避免重复传输(需 hash 支持)
rclone copy src: dst: --create-empty-src-dirs保留空目录结构
rclone copy src: dst: --checksum按校验和比对,比默认的时间+大小更可靠但更慢
rclone copy src: dst: --size-only只比大小,适合源端时间戳不可信的场景
rclone copy src: dst: --checksum --retries 3失败重试,弱网环境建议加大
sync 会删除目标文件,务必先 --dry-run方向写反是 rclone 最常见的事故原因
命令 / 参数说明复制
rclone copy src: dst: --exclude "*.tmp" --exclude ".git/**"排除指定模式
rclone copy src: dst: --include "*.log"只传输匹配的文件
rclone copy src: dst: --filter "+ *.jpg" --filter "- *"复杂规则用 filter,顺序敏感
rclone copy src: dst: --max-age 7d只传 7 天内修改的文件
rclone delete src: --min-size 100M只删除大于 100MB 的对象
rclone copy src: dst: --bwlimit 10M限制总带宽 10MB/s
rclone copy src: dst: --bwlimit "08:00,50M 19:00,off"按时段限速,白天限流夜间放开
rclone copy src: dst: --transfers 8 --checkers 16调整并行传输与校验数
rclone copy src: dst: --order-by size,desc按大小排序传输,优先处理大文件
rclone copy src: dst: --stats 10s --stats-one-line每 10 秒输出一行统计,便于日志观察
rclone copy src: dst: --log-file /var/log/rclone.log --log-level INFO日志落盘,定时任务必配
rclone copy src: dst: --max-transfer 100G限制单次任务传输总量,控制流量成本
rclone copy src: dst: --timeout 5m --contimeout 30s调整 IO 与连接超时
rclone copy src: dst: --fast-list用较少请求列举对象,省费用但更吃内存
命令 / 参数说明复制
rclone mount minio:bucket /mnt/bucket前台挂载对象存储
rclone mount minio:bucket /mnt/bucket --daemon后台挂载(Linux)
rclone mount minio:bucket /mnt/bucket --vfs-cache-mode writes --daemon缓存写模式,兼容大多数应用
rclone mount minio:bucket /mnt/bucket --vfs-cache-mode full --vfs-cache-max-size 20G --daemon全缓存模式,性能最好但占本地磁盘
rclone mount minio:bucket /mnt/bucket --vfs-cache-max-age 24h缓存文件最长保留时间
rclone mount minio:bucket /mnt/bucket --dir-cache-time 5m目录缓存时间,影响新文件可见延迟
rclone mount minio:bucket /mnt/bucket --vfs-read-chunk-size 64M顺序读的分块大小,大文件场景可调大
rclone mount minio:bucket /mnt/bucket --allow-other --umask 022允许其他用户访问并统一权限
rclone mount minio:bucket /mnt/bucket --read-only只读挂载,防止误写
rclone mount minio:bucket X: --network-modeWindows 映射为网络驱动器
fusermount -u /mnt/bucketLinux 卸载挂载点
rclone config create cachedb cache remote=minio:bucket通过 cache 后端包装,改善小文件性能
写入密集场景优先 vfs-cache-mode full否则会出现 rename、随机写不兼容的问题
命令 / 参数说明复制
rclone serve http minio:bucket --addr :8080把远端目录发布为 HTTP 下载站
rclone serve webdav minio:bucket --addr :8081 --user u --pass p提供 WebDAV 服务,办公客户端可直接挂载
rclone serve s3 minio:bucket --addr :8082 --auth-key AK,SK把任意后端暴露为 S3 接口(1.64+)
rclone serve ftp minio:bucket --addr :2121 --user u --pass p提供 FTP 服务
rclone serve sftp minio:bucket --addr :2022 --user u --pass p提供 SFTP 服务
rclone serve dlna minio:bucket --addr :8090提供 DLNA 媒体库
rclone serve restic minio:backup --addr :8083作为 restic 备份仓库使用
rclone serve http --read-only minio:bucket只读发布,避免被上传覆盖
服务化默认无鉴权,务必加 --user/--pass 或放在内网直接暴露公网等于公开数据
命令 / 参数说明复制
rclone config create secret crypt remote=minio:bucket/encrypted filename_encryption=standard directory_name_encryption=true password=$(rclone obscure pass) password2=$(rclone obscure salt)创建加密远程,文件名与内容一并加密
rclone copy /data secret:写入加密远程,落盘即为密文
rclone cryptcheck /data secret:校验加密远程与本地数据是否一致
rclone cryptdecode secret: encrypted-name.bin把密文文件名还原为明文名
rclone config create zstd compress remote=minio:bucket compression=zstd创建压缩远程,降低存储成本
rclone config create gz compress remote=minio:bucket compression=gzipgzip 压缩模式
rclone copy /data zstd:经压缩远程写入,读取时自动解压
加密远程密码丢失等于数据永久不可读务必离线保存 password 与 password2
压缩对已压缩格式收益有限图片、视频、zip 建议排除,避免浪费 CPU
命令 / 参数说明复制
rclone check src: dst:比对源与目标的差异(大小与哈希)
rclone check src: dst: --one-way只检查源端文件是否都存在,适合增量备份验证
rclone check src: dst: --download下载内容做真实校验,最严格也最慢
rclone md5sum minio:bucket/path输出 MD5 清单,用于跨端比对
rclone hashsum sha1 minio:bucket/path指定算法输出哈希清单
rclone dedupe minio:bucket/path交互式处理同名重复文件
rclone dedupe --dedupe-mode newest minio:bucket/path保留最新版本,自动去重
rclone delete minio:bucket/logs --min-age 30d按时间批量删除对象
rclone purge minio:bucket/old删除目录及全部内容(危险)
rclone rmdirs minio:bucket --leave-root删除空目录,保留根目录
rclone cleanup minio:bucket清空后端回收站(部分后端支持)
rclone backend cleanup minio:bucket通过 backend 命令触发清理(如 S3 分片上传残留)
删除类命令先加 --dry-run确认影响范围后再执行
命令 / 参数说明复制
rclone rcd --rc-addr :5572 --rc-user admin --rc-pass pass启动 rc 守护进程,通过 API 触发任务
rclone rc core/stats查询当前传输统计
rclone rc sync/copy srcFs=/data dstFs=minio:bucket/data通过 API 发起复制任务
rclone job list列出后台任务
rclone job status 1查看指定任务状态与错误
rclone job stop 1停止任务
rclone bisync /data minio:bucket/data --resync双向同步首次初始化(必须带 --resync)
rclone bisync /data minio:bucket/data后续增量双向同步
rclone bisync /data minio:bucket/data --check-access同步前检查访问权限,避免误删
rclone bisync --conflict-resolve newer冲突时以较新文件为准
rclone copy src: dst: --rc让普通命令也上报到 rc 服务,便于集中监控
bisync 依赖本地状态文件,不能随意清理删除状态文件需重新 --resync
命令 / 参数说明复制
--transfers 16并行传输数,小文件多时提高收益明显
--checkers 32并行校验数,过高会打满元数据请求
--multi-thread-streams 4大文件多线程下载
--multi-thread-cutoff 256M超过该大小的文件启用多线程
--s3-upload-concurrency 8 --s3-chunk-size 32MS3 分片上传并发与分片大小
--buffer-size 32M内存缓冲区,网络延迟高时可加大
--use-mmap使用 mmap 减少内存拷贝(部分场景更快)
--fast-list减少列举请求,S3 计费敏感场景优先
--check-first先完成全部检查再传输,任务更有序但启动更慢
--order-by size,desc大文件先传,缩短总完成时间
--disable-http2部分代理或网关对 HTTP/2 支持不佳时关闭
rclone ncdu minio:bucket交互分析哪些前缀最占空间
调参前先测单流带宽先确认是带宽瓶颈还是并发瓶颈,盲目加大并发反而更慢
命令 / 参数说明复制
Failed to create file system for "src:": didn't find section in config file远程名写错或未配置,先 rclone listremotes
403 Forbidden / AccessDeniedAK/SK 权限不足或桶策略限制
SignatureDoesNotMatch密钥错误、region 不匹配或系统时间偏差
401 Unauthorized凭据失效,OAuth 类远程需 rclone config reconnect
directory not found路径写错或桶不存在,注意对象存储没有真正的目录
corrupted on transfer: sizes differ传输中断或并发写入,重试并检查网络
checksum mismatch两端哈希不一致,源文件在传输中被修改或后端不支持哈希
low level retry 1/10 for error底层重试,多为网络抖动或限流,可加大 --low-level-retries
mount failed: fusermount: executable file not found缺少 fuse3,安装后重试
Transport endpoint is not connected挂载点异常,需 fusermount -u 后重新挂载
can't limit: unknown unit--bwlimit 单位写错,使用 10M、1G 或 off
quota exceeded远端容量或请求配额超限,检查 about 与云厂商配额
not copying: source and destination are the same源和目标写成了同一路径
--daemon 在 Windows 不可用Windows 使用 --network-mode 或计划任务
sync 后文件变少了方向写反或过滤规则过严,立即从 --backup-dir 恢复
速度只有几十 KB检查单文件大小、并发参数与是否被云厂商限速

运维常用组合

新手自检rclone version → rclone config → rclone listremotes → rclone lsd remote: → rclone about remote:
首次备份rclone copy --dry-run → rclone copy -P → rclone check --one-way → 配置定时任务与日志
迁移上云rclone config create → rclone size 评估容量 → rclone copy --transfers 16 -P → rclone check 校验
挂载共享rclone mount --vfs-cache-mode full --vfs-cache-max-size 20G --allow-other --daemon → df -h 验证 → fusermount -u 卸载
加密存储rclone obscure 生成密码 → config create crypt → copy 到 crypt: → cryptcheck 校验 → cryptdecode 查文件名
清理空间rclone ncdu 分析 → rclone delete --min-age 30d → rclone rmdirs → rclone cleanup 清空回收站

常见问题排查

1. copy 与 sync 差一个删除

sync 会让目标端与源端完全一致(含删除),方向写反就是事故,先 --dry-run

2. 远程名就是配置节

命令里的 src: 对应 rclone.conf 的 section,冒号不能少

3. 对象存储没有真目录

目录只是前缀,rmdir 只删空前缀,空间统计用 size 而不是 du

4. 挂载模式先看写需求

只读用默认,少量写用 vfs-cache-mode writes,重写用 full 并准备本地缓存盘

5. 校验强度按场景选

--checksum 最可靠但慢,弱网或大文件可用 --size-only 加抽查

6. 定时任务必配日志与限速

--log-file 加 --bwlimit,避免夜间备份把专线打满

共 153 条 Rclone 命令 · 示例中的远程名 minio、桶名与挂载点请替换为实际环境

关于Rclone命令速查

在线 Rclone 命令速查手册,按安装与配置、远程存储接入、浏览与容量查询、复制与同步、过滤限速与调度、挂载、服务化、加密与压缩、校验去重与清理、后台任务与 bisync、性能调优、常见报错与排查等 12 类场景整理 150+ 条常用命令与参数,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 rclone version/config/config file/show/create/update/delete/reconnect/listremotes/dump 与 --config 指定配置、obscure 混淆密码、config create 对接 s3 provider=AWS|Minio|Alibaba|TencentCOS 与 azureblob 与 drive 与 sftp 与 webdav 与 ftp 与 local 与 backend features/about、lsd/ls/lsl/lsf/lsjson/size/tree/ncdu/mkdir/rmdir/cat、copy/sync/move/copyto/moveto 与 --dry-run/-P/--update/--ignore-existing/--backup-dir/--track-renames/--create-empty-src-dirs/--checksum/--size-only/--retries、--exclude/--include/--filter/--max-age/--min-size/--max-size/--bwlimit 时段限速/--transfers/--checkers/--order-by/--stats/--log-file/--max-transfer/--timeout/--fast-list、mount 的 --vfs-cache-mode off|writes|full 与 --vfs-cache-max-size/--vfs-cache-max-age/--dir-cache-time/--vfs-read-chunk-size/--allow-other/--daemon/--read-only/--network-mode 与 fusermount -u、serve http|webdav|s3|ftp|sftp|dlna|restic 与 --addr/--user/--pass/--auth-key、crypt 远程与 cryptcheck/cryptdecode、compress 后端、check 的 --one-way/--download 与 md5sum/hashsum/dedupe/delete/purge/rmdirs/cleanup/backend cleanup、rcd 与 rc/core-stats/sync-copy 与 job list|status|stop、bisync 的 --resync/--check-access/--conflict-resolve、--multi-thread-streams/--s3-upload-concurrency/--buffer-size/--use-mmap/--check-first/--disable-http2,以及 didn't find section in config file、403 Forbidden、SignatureDoesNotMatch、corrupted on transfer、checksum mismatch、fusermount not found、Transport endpoint is not connected、quota exceeded 等报错排查。适用于 Rclone 多云对象存储同步、服务器与对象存储之间迁移、定时增量备份、对象存储挂载为本地盘、跨云复制与加密传输、WebDAV/S3 协议发布、数据校验与空间清理,以及存储与运维工程师日常使用和面试复习。

核心能力

  • 涵盖 rclone version/config/config file/show/create/update/delete/reconnect/listremotes/dump 与 --config 指定配置、obscure 混淆密码、config create 对接 s3 provider=AWS|Minio|Alibaba|TencentCOS 与 azureblob 与 drive 与 sftp 与 webdav 与 ftp 与 local 与 backend features/about、lsd/ls/lsl/lsf/lsjson/size/tree/ncdu/mkdir/rmdir/cat、copy/sync/move/copyto/moveto 与 --dry-run/-P/--update/--ignore-existing/--backup-dir/--track-renames/--create-empty-src-dirs/--checksum/--size-only/--retries、--exclude/--include/--filter/--max-age/--min-size/--max-size/--bwlimit 时段限速/--transfers/--checkers/--order-by/--stats/--log-file/--max-transfer/--timeout/--fast-list、mount 的 --vfs-cache-mode off|writes|full 与 --vfs-cache-max-size/--vfs-cache-max-age/--dir-cache-time/--vfs-read-chunk-size/--allow-other/--daemon/--read-only/--network-mode 与 fusermount -u、serve http|webdav|s3|ftp|sftp|dlna|restic 与 --addr/--user/--pass/--auth-key、crypt 远程与 cryptcheck/cryptdecode、compress 后端、check 的 --one-way/--download 与 md5sum/hashsum/dedupe/delete/purge/rmdirs/cleanup/backend cleanup、rcd 与 rc/core-stats/sync-copy 与 job list|status|stop、bisync 的 --resync/--check-access/--conflict-resolve、--multi-thread-streams/--s3-upload-concurrency/--buffer-size/--use-mmap/--check-first/--disable-http2,以及 didn't find section in config file、403 Forbidden、SignatureDoesNotMatch、corrupted on transfer、checksum mismatch、fusermount not found、Transport endpoint is not connected、quota exceeded 等报错排查

适用场景

适用于 Rclone 多云对象存储同步、服务器与对象存储之间迁移、定时增量备份、对象存储挂载为本地盘、跨云复制与加密传输、WebDAV/S3 协议发布、数据校验与空间清理,以及存储与运维工程师日常使用和面试复习。Rclone命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Rclone命令速查是免费的吗?需要注册或安装吗?
Rclone命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Rclone命令速查支持哪些功能?
涵盖 rclone version/config/config file/show/create/update/delete/reconnect/listremotes/dump 与 --config 指定配置、obscure 混淆密码、config create 对接 s3 provider=AWS|Minio|Alibaba|TencentCOS 与 azureblob 与 drive 与 sftp 与 webdav 与 ftp 与 local 与 backend features/about、lsd/ls/lsl/lsf/lsjson/size/tree/ncdu/mkdir/rmdir/cat、copy/sync/move/copyto/moveto 与 --dry-run/-P/--update/--ignore-existing/--backup-dir/--track-renames/--create-empty-src-dirs/--checksum/--size-only/--retries、--exclude/--include/--filter/--max-age/--min-size/--max-size/--bwlimit 时段限速/--transfers/--checkers/--order-by/--stats/--log-file/--max-transfer/--timeout/--fast-list、mount 的 --vfs-cache-mode off|writes|full 与 --vfs-cache-max-size/--vfs-cache-max-age/--dir-cache-time/--vfs-read-chunk-size/--allow-other/--daemon/--read-only/--network-mode 与 fusermount -u、serve http|webdav|s3|ftp|sftp|dlna|restic 与 --addr/--user/--pass/--auth-key、crypt 远程与 cryptcheck/cryptdecode、compress 后端、check 的 --one-way/--download 与 md5sum/hashsum/dedupe/delete/purge/rmdirs/cleanup/backend cleanup、rcd 与 rc/core-stats/sync-copy 与 job list|status|stop、bisync 的 --resync/--check-access/--conflict-resolve、--multi-thread-streams/--s3-upload-concurrency/--buffer-size/--use-mmap/--check-first/--disable-http2,以及 didn't find section in config file、403 Forbidden、SignatureDoesNotMatch、corrupted on transfer、checksum mismatch、fusermount not found、Transport endpoint is not connected、quota exceeded 等报错排查。
Rclone命令速查适合哪些场景使用?
适用于 Rclone 多云对象存储同步、服务器与对象存储之间迁移、定时增量备份、对象存储挂载为本地盘、跨云复制与加密传输、WebDAV/S3 协议发布、数据校验与空间清理,以及存储与运维工程师日常使用和面试复习。