第 2 章 - 安装与配置

2.1 安装方式总览

安装方式	适用平台	优点	缺点
官方脚本	Linux/macOS	自动检测、可升级	需要 curl
二进制下载	全平台	最新版本、独立运行	需手动更新
包管理器	各 Linux 发行版/macOS/Windows	自动管理依赖	版本可能滞后
Docker	全平台	环境隔离、版本固定	需要 Docker 环境
源码编译	全平台	可定制、最新开发版	需要 Go 环境

2.2 Linux 安装

2.2.1 官方安装脚本（推荐）

这是 Rclone 官方推荐的安装方式，适用于所有 Linux 发行版和 macOS：

# 一键安装脚本（下载最新稳定版）
curl https://rclone.org/install.sh | sudo bash

如果你想先查看脚本内容再执行（更安全的做法）：

# 下载脚本
curl -O https://rclone.org/install.sh

# 查看脚本内容
less install.sh

# 确认后执行
sudo bash install.sh

验证安装：

rclone version

输出示例：

rclone v1.69.0
- os/version: ubuntu 24.04 (64 bit)
- os/kernel: 6.8.0-generic
- os/type: linux
- os/arch: amd64
- go/version: go1.23.4
- linking: static

2.2.2 APT（Debian / Ubuntu）

# Debian/Ubuntu 默认仓库（版本可能较旧）
sudo apt update
sudo apt install rclone

# 如需最新版本，使用官方 APT 源
curl -fsSL https://downloads.rclone.org/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/rclone-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/rclone-archive-keyring.gpg] https://deb.rclone.org/rclone.org $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/rclone.list

sudo apt update
sudo apt install rclone

2.2.3 YUM / DNF（CentOS / RHEL / Fedora）

# Fedora
sudo dnf install rclone

# CentOS / RHEL（需要 EPEL）
sudo yum install epel-release
sudo yum install rclone

2.2.4 Snap

sudo snap install rclone

⚠️ 注意：Snap 版本的 Rclone 有沙盒限制，某些功能（如 FUSE 挂载）可能需要额外配置。

2.2.5 二进制手动安装

# 下载最新版本（以 amd64 为例）
cd /tmp
curl -O https://downloads.rclone.org/current/rclone-current-linux-amd64.zip

# 解压
unzip rclone-current-linux-amd64.zip
cd rclone-*-linux-amd64

# 复制到系统路径
sudo cp rclone /usr/local/bin/
sudo chmod +x /usr/local/bin/rclone

# 安装 man 手册（可选）
sudo mkdir -p /usr/local/share/man/man1
sudo cp rclone.1 /usr/local/share/man/man1/

2.3 macOS 安装

2.3.1 Homebrew（推荐）

brew install rclone

2.3.2 MacPorts

sudo port install rclone

2.3.3 官方安装脚本

curl https://rclone.org/install.sh | sudo bash

2.3.4 二进制下载

# 下载 macOS 版本
curl -O https://downloads.rclone.org/current/rclone-current-osx-arm64.zip

# 解压并安装
unzip rclone-current-osx-arm64.zip
cd rclone-*-osx-arm64
sudo cp rclone /usr/local/bin/

💡 提示：Apple Silicon (M1/M2/M3/M4) 使用 arm64 版本，Intel Mac 使用 amd64 版本。

2.4 Windows 安装

2.4.1 Chocolatey

choco install rclone

2.4.2 Scoop

scoop install rclone

2.4.3 Winget

winget install Rclone.Rclone

2.4.4 手动安装

访问 https://rclone.org/downloads/
下载 rclone-current-windows-amd64.zip
解压到任意目录（如 C:\rclone）
将该目录添加到系统 PATH 环境变量

# PowerShell 中添加到 PATH（当前用户）
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\rclone", "User")

2.4.5 安装为 Windows 服务

# 以管理员身份运行 PowerShell
# 安装 WinFsp（Rclone 挂载需要）
# 下载地址：https://winfsp.dev/rel/

# 安装 Rclone 为 Windows 服务（以 WebDAV 服务为例）
rclone serve webdav remote:path --addr :8080 --config C:\rclone\rclone.conf

2.5 Docker 安装

基本使用

# 拉取官方镜像
docker pull rclone/rclone

# 运行一次性命令
docker run --rm -v ~/.config/rclone:/config/rclone rclone/rclone lsd remote:

# 运行带挂载的命令
docker run --rm \
  -v /data:/data:shared \
  -v ~/.config/rclone:/config/rclone \
  rclone/rclone \
  sync /data s3:my-bucket/

创建持久化容器

# 创建用于 rclone 配置的 volume
docker volume create rclone-config

# 运行配置向导
docker run -it --rm \
  -v rclone-config:/config/rclone \
  rclone/rclone \
  config

📌 Docker 的详细使用将在第 11 章中深入讲解。

2.6 源码编译

适用于需要最新开发版或自定义构建的场景：

# 需要 Go 1.22+ 环境
# 安装 Go：https://go.dev/doc/install

# 克隆源码
git clone https://github.com/rclone/rclone.git
cd rclone

# 编译
go build

# 安装
sudo cp rclone /usr/local/bin/

2.7 初始配置

2.7.1 交互式配置向导

Rclone 提供了友好的交互式配置工具：

rclone config

交互过程示例：

Current remotes:

e) Edit existing remote
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> n

Enter name for new remote.
name> myremote

Option Storage.
Type of storage to configure.
Choose a number from below, or type in your own value.
...
XX / Amazon S3 Compliant Storage Providers
   \ (s3)
...
Storage> s3

Option provider.
Choose your S3 provider.
...
provider> AWS

Option env_auth.
...
1 / Enter AWS credentials in the next step.
   \ (false)
...
env_auth> 1

Option access_key_id.
...
access_key_id> AKIAIOSFODNN7EXAMPLE

Option secret_access_key.
...
secret_access_key> wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Option region.
...
region> us-east-1

Edit advanced config?
y) Yes
n) No
n> n

Configuration complete.

2.7.2 配置文件位置

平台	默认路径
Linux / macOS	`~/.config/rclone/rclone.conf`
Windows	`%APPDATA%\rclone\rclone.conf`
环境变量指定	`RCLONE_CONFIG=/path/to/rclone.conf`

2.7.3 配置文件格式

Rclone 的配置文件是标准 INI 格式：

[myremote]
type = s3
provider = AWS
access_key_id = AKIAIOSFODNN7EXAMPLE
secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
region = us-east-1

[gdrive]
type = drive
client_id = xxx.apps.googleusercontent.com
client_secret = xxx
token = {"access_token":"xxx","token_type":"Bearer","refresh_token":"xxx","expiry":"2024-01-01T00:00:00Z"}

[sftp-server]
type = sftp
host = 192.168.1.100
user = admin
port = 22
key_file = ~/.ssh/id_rsa

2.7.4 环境变量配置

所有配置项都可以通过环境变量覆盖，命名规则为 RCLONE_CONFIG_<NAME>_<KEY>：

# 设置配置文件路径
export RCLONE_CONFIG=/opt/rclone/rclone.conf

# 设置远程存储凭据（无需写入配置文件）
export RCLONE_CONFIG_MYREMOTE_TYPE=s3
export RCLONE_CONFIG_MYREMOTE_PROVIDER=AWS
export RCLONE_CONFIG_MYREMOTE_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export RCLONE_CONFIG_MYREMOTE_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

# 使用配置密码加密
export RCLONE_CONFIG_PASS=mysecretpassword

2.7.5 远程配置管理

# 列出所有已配置的远程存储
rclone listremotes

# 列出远程存储的详细信息
rclone config show

# 导出配置
rclone config file

# 手动编辑配置文件
rclone config edit

# 删除某个远程存储
rclone config delete myremote

2.8 Shell 自动补全

Rclone 内置了 Shell 自动补全脚本生成器，支持 Bash、Zsh、Fish 和 PowerShell。

Bash 补全

# 生成补全脚本
rclone completion bash > /etc/bash_completion.d/rclone

# 当前 Shell 立即生效
source /etc/bash_completion.d/rclone

# 或添加到 ~/.bashrc
echo 'source /etc/bash_completion.d/rclone' >> ~/.bashrc

Zsh 补全

# 生成补全脚本
rclone completion zsh > "${fpath[1]}/_rclone"

# 重新加载补全系统
exec zsh

或者使用 Oh My Zsh：

# 将补全脚本放到自定义目录
mkdir -p ~/.oh-my-zsh/custom/plugins/rclone
rclone completion zsh > ~/.oh-my-zsh/custom/plugins/rclone/_rclone

# 在 ~/.zshrc 的 plugins 中添加 rclone
# plugins=(... rclone)

Fish 补全

rclone completion fish > ~/.config/fish/completions/rclone.fish

PowerShell 补全

rclone completion powershell | Out-String | Invoke-Expression

添加到 PowerShell Profile 永久生效：

# 添加到 Profile
rclone completion powershell >> $PROFILE

2.9 配置密码保护

Rclone 支持对配置文件进行加密保护，防止凭据泄露：

# 设置配置密码
rclone config
# 选择 s) Set configuration password

# 或通过环境变量设置
export RCLONE_CONFIG_PASS=mysecretpassword

使用加密配置后，~/.config/rclone/rclone.conf 中的敏感信息会被加密：

RCLONE_ENCRYPT_V1
-----BEGIN RCLONE ENCRYPTED DATA-----
...
-----END RCLONE ENCRYPTED DATA-----

⚠️ 警告：如果忘记密码，配置将无法恢复。请务必使用密码管理器妥善保存。

2.10 验证安装与配置

基本验证

# 查看版本
rclone version

# 查看所有远程存储
rclone listremotes

# 测试远程连接
rclone lsd myremote:

# 查看配置文件路径
rclone config file

完整功能验证

# 创建测试目录
mkdir -p /tmp/rclone-test
echo "Hello Rclone" > /tmp/rclone-test/test.txt

# 上传测试
rclone copy /tmp/rclone-test/ myremote:test-bucket/rclone-test/ --progress

# 下载测试
rclone copy myremote:test-bucket/rclone-test/ /tmp/rclone-test-download/ --progress

# 对比校验
rclone check /tmp/rclone-test/ myremote:test-bucket/rclone-test/

# 清理
rm -rf /tmp/rclone-test /tmp/rclone-test-download
rclone purge myremote:test-bucket/rclone-test/

2.11 升级 Rclone

使用官方脚本升级

curl https://rclone.org/install.sh | sudo bash

使用包管理器升级

# APT
sudo apt update && sudo apt upgrade rclone

# Homebrew
brew upgrade rclone

# Snap
sudo snap refresh rclone

手动升级

# 停止所有 rclone 进程
pkill rclone

# 下载新版本
curl -O https://downloads.rclone.org/current/rclone-current-linux-amd64.zip
unzip rclone-current-linux-amd64.zip
cd rclone-*-linux-amd64

# 替换旧版本
sudo cp rclone /usr/local/bin/

# 验证
rclone version

注意事项

⚠️ 版本兼容性
Rclone 配置文件在不同版本之间通常是向后兼容的
但某些高级功能可能需要特定最低版本
建议保持使用最新稳定版

⚠️ Snap 版本限制
Snap 沙盒环境可能限制某些功能
FUSE 挂载需要 --classic 权限
建议使用官方脚本或二进制安装

💡 多版本共存
可以在不同路径安装不同版本的 Rclone
使用 which rclone 确认当前使用的是哪个版本
使用完整路径指定版本：/opt/rclone-v1.65/rclone version

扩展阅读

上一章：← 第 1 章 - Rclone 概述 下一章：第 3 章 - 远程存储配置 →

强曰为道

第 2 章 - 安装与配置

第 2 章 - 安装与配置

2.1 安装方式总览

2.2 Linux 安装

2.2.1 官方安装脚本（推荐）

2.2.2 APT（Debian / Ubuntu）

2.2.3 YUM / DNF（CentOS / RHEL / Fedora）

2.2.4 Snap

2.2.5 二进制手动安装

2.3 macOS 安装

2.3.1 Homebrew（推荐）

2.3.2 MacPorts

2.3.3 官方安装脚本

2.3.4 二进制下载

2.4 Windows 安装

2.4.1 Chocolatey

2.4.2 Scoop

2.4.3 Winget

2.4.4 手动安装

2.4.5 安装为 Windows 服务

2.5 Docker 安装

基本使用

创建持久化容器

2.6 源码编译

2.7 初始配置

2.7.1 交互式配置向导

2.7.2 配置文件位置

2.7.3 配置文件格式

2.7.4 环境变量配置

2.7.5 远程配置管理

2.8 Shell 自动补全

Bash 补全

Zsh 补全

Fish 补全

PowerShell 补全

2.9 配置密码保护

2.10 验证安装与配置

基本验证

完整功能验证

2.11 升级 Rclone

使用官方脚本升级

使用包管理器升级

手动升级

注意事项

扩展阅读