Rclone 安装与 Google Drive 个人 API 配置笔记

一、 安装 Rclone

在 Debian 环境下，推荐使用官方的一键脚本安装最新版本，以确保功能完整。

# 安装必要的工具
sudo apt update && sudo apt install curl unzip -y

# 下载并安装 Rclone
sudo curl https://rclone.org/install.sh | sudo bash

二、 申请 Google Drive 个人凭据 (API)

使用个人凭据可以获得独立的带宽配额，避免在高频使用时触发 403 限制。

1. 创建项目

  1. 访问 Google Cloud Console。
  2. 新建一个项目，命名为 My-Rclone。

2. 启用 API

  1. 在顶部搜索栏搜索 "Google Drive API"。
  2. 点击并选择 启用 (Enable)。

3. 配置 Google Auth Platform (原 OAuth 同意屏幕)

  1. 点击左侧 Google Auth Platform 菜单。
  2. User Type: 选择 External (外部)。
  3. App Information: 填写应用名称（如 Rclone）和你的邮箱。
  4. 发布应用 (关键)：在配置页面的 "Publishing status" 部分，点击 PUBLISH APP 并确认。这能保证你的授权 Token 长期有效（不会 7 天过期）。

4. 创建 OAuth 2.0 客户端 ID

  1. 点击左侧 Credentials (凭据) 菜单。
  2. 点击 + Create Credentials (+ 创建凭据) -> OAuth client ID。
  3. Application type (应用类型): 选择 Desktop app (桌面应用)。
  4. 创建后，保存弹出的 Client ID 和 Client Secret。

三、 Rclone 配置流程

在终端输入 rclone config 开始配置：

1.如果ssh连接，需要能上外网的windows下载windows版本的rclone，命令行弹窗和命令行显示授权码

windows下载地址https://rclone.org/downloads/

需要windows系统开启代理，并在rclone窗口中执行如下添加代理，命令行才能显示授权码
set HTTP_PROXY=http://192.168.10.90:7895
set HTTPS_PROXY=http://192.168.10.90:7895

2.一般步骤

  1. n) New remote
  2. name: 输入 gdrive (或其他你喜欢的名字)
  3. Storage type: 选择 drive (通常对应数字 18 左右)
  4. client_id: 粘贴你申请的 客户端 ID
  5. client_secret: 粘贴你申请的 客户端密钥
  6. scope: 选择 1 (Full access)
  7. service_account_file: 直接回车跳过
  8. Edit advanced config: 输入 n

  9. Use auto-config?:

    • 如果是本地 Debian 桌面版，输入 y。
    • 如果是 SSH 远程服务器，输入 n。根据提示在windows中rclone命令行调用浏览器授权，授权后命令行返回授权码，将验证码贴回终端。
  10. Keep this "gdrive" remote?: 输入 y 保存。

四、 常用管理命令 (非挂载模式)

既然不挂载，我们直接通过 Rclone 指令进行文件操作。

1. 查看操作

# 列出云盘根目录下的文件夹
rclone lsd gdrive:

# 查看云盘已用空间
rclone size gdrive:

2. 上传与同步

# 拷贝本地文件到云盘 (常用)
rclone copy /home/data/test.txt gdrive:backup/ -P

# 同步文件夹 (慎用：目标端多余的文件会被删除，保持两端完全一致)
rclone sync /home/data gdrive:backup/data -P

3. 下载

# 从云盘下载文件夹到本地
rclone copy gdrive:backup/data /home/downloads/ -P

4. 优化参数建议

在执行拷贝或同步时，建议加上以下参数提高效率：

  • -P: 显示进度条、实时速度和剩余时间。
  • --drive-chunk-size 64M: 增大上传分块大小，提升大文件上传速度。
  • --transfers 4: 同时传输的文件数量（默认 4）。

五、 附录：手动下载逻辑解析

如果你需要手动下载 Rclone 二进制包，其下载链接的逻辑如下：
https://downloads.rclone.org/rclone-current-${OS}-${OS_type}.zip

  • ${OS}: 操作系统 (如 linux)。
  • ${OS_type}: 架构 (如 amd64, arm64, 386)。
  • 意义: 这种变量化写法是为了让脚本能根据不同的系统环境，自动拼接出正确的下载地址。

标签: none

添加新评论