Rclone 进阶使用教程 - 常用命令参数详解

博主：磷雅
发布时间：2021 年 05 月 15 日
1322 次浏览
暂无评论
3899字数
分类： Linux

<h2 id="toc_0">前言</h2>
Rclone 是一个的命令行工具，支持在不同对象存储、网盘间同步、上传、下载数据。并且通过一些设置可以实现离线下载、服务器备份等非常实用的功能。本篇文章将讲解 Rclone 常用的一些命令参数。
<h2 id="toc_1">安装 Rclone</h2>
<h3 id="toc_2">Linux/macOS/BSD</h3>
官方提供了<a href="https://rclone.org/install/" target="_blank" rel="noopener">一键安装脚本</a>：
<pre class=" language-shell line-numbers"><code class=" language-shell">curl https://rclone.org/install.sh | sudo bash</code></pre>
<h3 id="toc_3">Windows</h3>
<h2 id="toc_4">Rclone 设置</h2>
<code>rclone config</code> - 进入交互式配置选项，进行添加、删除、管理网盘等操作。

<code>rclone config file</code> - 显示配置文件的路径，一般配置文件在 <code>~/.config/rclone/rclone.conf</code>

<code>rclone config show</code> - 显示配置文件信息
<h2 id="toc_5">命令语法</h2>
<pre class=" language-shell line-numbers"><code class=" language-shell"># 本地到网盘
rclone [功能选项] &lt;本地路径&gt; &lt;网盘名称:路径&gt; [参数] [参数] ...

# 网盘到本地
rclone [功能选项] &lt;网盘名称:路径&gt; &lt;本地路径&gt; [参数] [参数] ...

# 网盘到网盘
rclone [功能选项] &lt;网盘名称:路径&gt; &lt;网盘名称:路径&gt; [参数] [参数] ...</code></pre>
<h3 id="toc_6">用法示例</h3>
<pre class=" language-shell line-numbers"><code class=" language-shell">rclone move -v /Download Onedrive:/Download --transfers=1</code></pre>
<h2 id="toc_7">常用功能选项</h2>
<ul>
 	<li><code>rclone copy</code> - 复制</li>
 	<li><code>rclone move</code> - 移动，如果要在移动后删除空源目录，请加上 <code>--delete-empty-src-dirs</code> 参数</li>
 	<li><code>rclone sync</code> - 同步：将源目录同步到目标目录，只更改目标目录。</li>
 	<li><code>rclone size</code> - 查看网盘文件占用大小。</li>
 	<li><code>rclone delete</code> - 删除路径下的文件内容。</li>
 	<li><code>rclone purge</code> - 删除路径及其所有文件内容。</li>
 	<li><code>rclone mkdir</code> - 创建目录。</li>
 	<li><code>rclone rmdir</code> - 删除目录。</li>
 	<li><code>rclone rmdirs</code> - 删除指定灵境下的空目录。如果加上 <code>--leave-root</code> 参数，则不会删除根目录。</li>
 	<li><code>rclone check</code> - 检查源和目的地址数据是否匹配。</li>
 	<li><code>rclone ls</code> - 列出指定路径下的所有的文件以及文件大小和路径。</li>
 	<li><code>rclone lsl</code> - 比上面多一个显示上传时间。</li>
 	<li><code>rclone lsd</code> 列出指定路径下的目录</li>
 	<li><code>rclone lsf</code> - 列出指定路径下的目录和文件</li>
</ul>
<h2 id="toc_8">常用参数</h2>
<ul>
 	<li><code>-n</code> = <code>--dry-run</code> - 测试运行，用来查看 rclone 在实际运行中会进行哪些操作。</li>
 	<li><code>-P</code> = <code>--progress</code> - 显示实时传输进度，500mS 刷新一次，否则默认 1 分钟刷新一次。</li>
 	<li><code>--cache-chunk-size SizeSuffi</code> - 块的大小，默认5M，理论上是越大上传速度越快，同时占用内存也越多。如果设置得太大，可能会导致进程中断。</li>
 	<li><code>--cache-chunk-total-size SizeSuffix</code> - 块可以在本地磁盘上占用的总大小，默认10G。</li>
 	<li><code>--transfers=N</code> - 并行文件数，默认为4。在比较小的内存的VPS上建议调小这个参数，比如128M的小鸡上使用建议设置为1。</li>
 	<li><code>--config string</code> - 指定配置文件路径，<code>string</code>为配置文件路径。</li>
 	<li><code>--ignore-errors</code> - 跳过错误。比如 OneDrive 在传了某些特殊文件后会提示<code>Failed to copy: failed to open source object: malwareDetected: Malware detected</code>，这会导致后续的传输任务被终止掉，此时就可以加上这个参数跳过错误。但需要注意 RCLONE 的退出状态码不会为<code>0</code>。</li>
</ul>
<h2 id="toc_9">日志</h2>
rclone 有 4 个级别的日志记录，<code>ERROR</code>，<code>NOTICE</code>，<code>INFO</code> 和 <code>DEBUG</code>。默认情况下，rclone 将生成 <code>ERROR</code> 和 <code>NOTICE</code> 级别消息。
<ul>
 	<li><code>-q</code> - rclone将仅生成 <code>ERROR</code> 消息。</li>
 	<li><code>-v</code> - rclone将生成 <code>ERROR</code>，<code>NOTICE</code> 和 <code>INFO</code> 消息，推荐此项。</li>
 	<li><code>-vv</code> - rclone 将生成 <code>ERROR</code>，<code>NOTICE</code>，<code>INFO</code>和 <code>DEBUG</code> 消息。</li>
 	<li><code>--log-level LEVEL</code> - 标志控制日志级别。</li>
</ul>
<h3 id="toc_10">输出日志到文件</h3>
使用 <code>--log-file=FILE</code> 选项，rclone 会将 <code>Error</code>，<code>Info</code> 和 <code>Debug</code> 消息以及标准错误重定向到 <code>FILE</code>，这里的 <code>FILE</code> 是你指定的日志文件路径。

另一种方法是使用系统的指向命令，比如：
<pre class=" language-shell line-numbers"><code class=" language-shell">rclone sync -v Onedrive:/DRIVEX Gdrive:/DRIVEX &gt; "~/DRIVEX.log" 2&gt;&amp;1</code></pre>
<h2 id="toc_11">文件过滤</h2>
<code>--exclude</code> - 排除文件或目录。

<code>--include</code> - 包含文件或目录。

<code>--filter</code> - 文件过滤规则，相当于上面两个选项的其它使用方式。包含规则以 <code>+</code> 开头，排除规则以 <code>-</code> 开头。
<h3 id="toc_12">文件类型过滤</h3>
比如 <code>--exclude "*.bak"</code>、<code>--filter "- *.bak"</code>，排除所有 <code>bak</code> 文件。也可以写作。

比如 <code>--include "*.{png,jpg}"</code>、<code>--filter "+ *.{png,jpg}"</code>，包含所有 <code>png</code> 和 <code>jpg</code> 文件，排除其他文件。

<code>--delete-excluded</code> 删除排除的文件。需配合过滤参数使用，否则无效。
<h3 id="toc_13">目录过滤</h3>
目录过滤需要在目录名称后面加上 <code>/</code>，否则会被当做文件进行匹配。以 <code>/</code> 开头只会匹配根目录（指定目录下），否则匹配所目录。这同样适用于文件。

<code>--exclude ".git/"</code> 排除所有目录下的<code>.git</code> 目录。

<code>--exclude "/.git/"</code> 只排除根目录下的<code>.git</code> 目录。

<code>--exclude "{Video,Software}/"</code> 排除所有目录下的 <code>Video</code> 和 <code>Software</code> 目录。

<code>--exclude "/{Video,Software}/"</code> 只排除根目录下的 <code>Video</code> 和 <code>Software</code> 目录。

<code>--include "/{Video,Software}/**"</code> 仅包含根目录下的 <code>Video</code> 和 <code>Software</code> 目录的所有内容。
<h3 id="toc_14">文件大小过滤</h3>
默认大小单位为 <code>kBytes</code> ，但可以使用 <code>k</code> ，<code>M</code> 或 <code>G</code> 后缀。

<code>--min-size</code> 过滤小于指定大小的文件。比如 <code>--min-size 50</code> 表示不会传输小于 50k 的文件。

<code>--max-size</code> 过滤大于指定大小的文件。比如 <code>--max-size 1G</code> 表示不会传输大于 1G 的文件。
<blockquote>TIPS: 博主在实际使用中发现大小过滤两个选项不能同时使用。</blockquote>
<h3 id="toc_15">过滤规则文件</h3>
<code>--filter-from &lt;规则文件&gt;</code> 从文件添加包含 / 排除规则。比如 <code>--filter-from filter-file.txt</code>。

过滤规则文件示例：
<pre class=" language-none line-numbers"><code class=" language-none">- secret*.jpg
+ *.jpg
+ *.png
+ file2.avi
- /dir/Trash/**
+ /dir/**
- *</code></pre>
这里只举例比较常用和简单的一些过滤用法，更复杂和高端的用法可以查看<a href="https://p3terx.com/go/aHR0cHM6Ly9yY2xvbmUub3JnL2ZpbHRlcmluZy8" target="_blank" rel="noopener">官方文档</a>。
<h2 id="toc_16">环境变量</h2>
rclone 中的每个选项都可以通过环境变量设置。环境变量的名称可以通过<a href="https://p3terx.com/go/aHR0cHM6Ly9yY2xvbmUub3JnL2ZsYWdzLw" target="_blank" rel="noopener">长选项名称</a>进行转换，删除 <code>--</code> 前缀，更改 <code>-</code> 为<code>_</code>，大写并添加前缀 <code>RCLONE_</code>。环境变量的优先级会低于命令行选项，即通过命令行追加相应的选项时会覆盖环境变量设定的值。

比如设置最小上传大小 <code>--min-size 50</code>，使用环境变量是 <code>RCLONE_MIN_SIZE=50</code>。当环境变量设置后，在命令行中使用 <code>--min-size 100</code>，那么此时环境变量的值就会被覆盖。
<h3 id="toc_17">常用环境变量</h3>
<ul>
 	<li><code>RCLONE_CONFIG</code> - 自定义配置文件路径</li>
 	<li><code>RCLONE_CONFIG_PASS</code> - 若 rclone 进行了加密设置，把此环境变量设置为密码，可自动解密配置文件。</li>
 	<li><code>RCLONE_RETRIES</code> - 上传失败重试次数，默认 3 次</li>
 	<li><code>RCLONE_RETRIES_SLEEP</code> - 上传失败重试等待时间，默认禁用，单位<code>s</code>、<code>m</code>、<code>h</code>分别代表秒、分钟、小时。</li>
 	<li><code>CLONE_TRANSFERS</code> - 并行上传文件数。</li>
 	<li><code>RCLONE_CACHE_CHUNK_SIZE</code> - 块的大小，默认5M，理论上是越大上传速度越快，同时占用内存也越多。如果设置得太大，可能会导致进程中断。</li>
 	<li><code>RCLONE_CACHE_CHUNK_TOTAL_SIZE</code> - 块可以在本地磁盘上占用的总大小，默认10G。</li>
 	<li><code>RCLONE_IGNORE_ERRORS=true</code> - 跳过错误。</li>
</ul>
<h2 id="toc_18">参考资料</h2>
<a href="https://rclone.org/" target="_blank" rel="noopener">Rclone 官方文档</a>

最后修改：2024 年 02 月 21 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

Rclone 进阶使用教程 - 常用命令参数详解

磷雅 • 2021 年 05 月 15 日

<code>rclone config file</code> - 显示配置文件的路径，一般配置文件在 <code>~/.config/rclone/rclone.conf</code>

<code>--include</code> - 包含文件或目录。

<code>--exclude ".git/"</code> 排除所有目录下的<code>.git</code> 目录。

<code>--exclude "/.git/"</code> 只排除根目录下的<code>.git</code> 目录。

<code>--exclude "{Video,Software}/"</code> 排除所有目录下的 <code>Video</code> 和 <code>Software</code> 目录。

<code>--exclude "/{Video,Software}/"</code> 只排除根目录下的 <code>Video</code> 和 <code>Software</code> 目录。

<code>--min-size</code> 过滤小于指定大小的文件。比如 <code>--min-size 50</code> 表示不会传输小于 50k 的文件。

Rclone 进阶使用教程 - 常用命令参数详解

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

分享一个5欧元无需实名的荷兰ESIM开通教程（实测可用）

基于Plex + Rclone+ Onedrive 打造家用流媒体中心

分享一个自改的哪吒探针Custom主题

VLESS总被识别？Docker下的NaiveProxy 搭建教程+客户端选择使用及配置

Multi-EasyGost一键脚本国内外通用版-用于部署Gost转发，Sock5等代理服务器

可用在Windows 64位的naiveproxy服务端

国内服务器Tailscale自建DERP教程，无需备案或域名

流媒体NetFlix解锁检测脚本-NETFLIX-VERIFY

GIT.BETA.GS整合的一键DD重装脚本

无需下载软件，用KMS方式激活Windows

Rclone 进阶使用教程 - 常用命令参数详解

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Rclone 进阶使用教程 - 常用命令参数详解

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款