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/path | JSON 输出,便于程序解析 | |
rclone size minio:bucket/path | 统计对象数量与总容量 | |
rclone size --json minio:bucket/path | JSON 格式的容量统计 | |
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-mode | Windows 映射为网络驱动器 | |
fusermount -u /mnt/bucket | Linux 卸载挂载点 | |
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=gzip | gzip 压缩模式 | |
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 32M | S3 分片上传并发与分片大小 | |
--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 / AccessDenied | AK/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,避免夜间备份把专线打满
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 协议发布、数据校验与空间清理,以及存储与运维工程师日常使用和面试复习。