笔记-gdown使用

原创已于 2025-05-12 11:49:37 修改 · 1.2k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#笔记 #chrome #前端 #人工智能 #linux

于 2025-05-12 11:49:36 首次发布

gdown 是一个基于 Python 的命令行工具，它可以方便地从 Google Drive 下载公开分享的文件和文件夹。它尤其适合在服务器环境或者没有图形界面的情况下使用。

1. 安装 gdown

你可以通过 pip 来安装 gdown：

pip install gdown

如果遇到权限问题，可以尝试用户级安装：

pip install --user gdown

或者，如果确实需要全局安装且有管理员权限（在 AutoDL 上一般不需要 sudo，但如果是在你自己的 Linux 系统上可能需要）：

sudo pip install gdown

安装完成后，你可以通过运行 gdown --version 来验证是否安装成功。

2. 下载单个文件

gdown 可以通过多种方式识别并下载单个文件：

使用文件的 Google Drive ID:

这是最直接的方式。文件的 ID 是其在 Google Drive 链接中的一部分。

例如，如果一个文件的分享链接是 https://drive.google.com/file/d/THIS_IS_THE_FILE_ID/view?usp=sharing，那么 THIS_IS_THE_FILE_ID 就是文件ID。
```
gdown --id THIS_IS_THE_FILE_ID
```
或者简单地：
```
gdown THIS_IS_THE_FILE_ID
```
使用文件的分享链接:

你可以直接把 Google Drive 的分享链接给 gdown。
```
gdown 'https://drive.google.com/file/d/THIS_IS_THE_FILE_ID/view?usp=sharing'
```
或者另一种常见的链接格式：
```
gdown 'https://drive.google.com/uc?id=THIS_IS_THE_FILE_ID'
```
注意： 当链接中包含特殊字符（如 &）时，最好用单引号 ' ' 将链接括起来，以防止 shell 错误解析。
指定输出文件名:

默认情况下，gdown 会尝试使用 Google Drive 上的原始文件名。你也可以使用 -O (大写O) 或 --output 参数来指定下载后保存的文件名或路径：
```
gdown --id THIS_IS_THE_FILE_ID -O my_downloaded_file.zip
gdown 'https://drive.google.com/uc?id=THIS_IS_THE_FILE_ID' --output /path/to/save/another_file.txt
```
处理需要确认的大文件:

当下载非常大的文件时，Google Drive 可能会显示一个警告页面，提示“Google Drive 无法扫描此文件是否包含病毒”，需要用户确认才能下载。gdown 通常会自动尝试处理这种情况。如果遇到问题，可以尝试添加 --fuzzy 选项，它有时能帮助解析这类页面的下载链接。
静默模式:

如果你不希望 gdown 输出下载进度等信息，可以使用 --quiet 参数：
```
gdown --id THIS_IS_THE_FILE_ID --quiet
```

3. 下载文件夹

gdown 也支持下载整个文件夹。当下载文件夹时，gdown 通常会将文件夹内的所有内容压缩成一个 .zip 文件，然后下载这个 .zip 文件。下载完成后，你需要手动解压。

使用文件夹的分享链接或 ID: 你需要使用 --folder 标志来告诉 gdown 你正在下载的是一个文件夹。文件夹的分享链接通常是这样的格式：https://drive.google.com/drive/folders/THIS_IS_THE_FOLDER_ID?usp=sharing Bash
或者只使用文件夹的 ID：
```
gdown --id THIS_IS_THE_FOLDER_ID --folder -O downloaded_folder.zip
```
或者更简洁的：
```
gdown --folder THIS_IS_THE_FOLDER_ID -O folder_content.zip
```
重要：
- 必须使用 --folder 参数来下载文件夹。
- 下载文件夹时，强烈建议使用 -O 或 --output 来指定输出的 .zip 文件名，否则 gdown 可能会使用一个默认的或基于文件夹ID的名称。
- 下载完成后，你需要使用 unzip 命令来解压文件：
```
unzip my_folder_archive.zip -d ./destination_folder_name
```

4. 重要注意事项和技巧

文件/文件夹权限： gdown 主要适用于下载设置为“任何知道链接的人都可以查看/下载”的公开分享的文件和文件夹。如果文件或文件夹是私有的，或者权限设置非常严格，gdown 可能无法下载。
Google Drive 的限制：
- 对于非常大的文件或文件夹（尤其是包含大量小文件或者总大小达到几十GB甚至TB级别），Google Drive 可能会有一些下载限制（如每日下载流量、单个连接的限制等）。gdown 本身可能也会因为超时或Google的临时限制而失败。
- 对于非常大的文件夹，Google Drive 的在线压缩过程也可能需要较长时间，甚至可能失败。
网络稳定性： 下载速度和成功率也取决于你的服务器与 Google Drive 服务器之间的网络连接质量。
--fuzzy 选项： 如果标准的 ID 或链接无法工作，可以尝试添加 --fuzzy 选项。它使用一种更宽松的模式来查找下载链接，有时能解决一些问题。 Bash
```
gdown --id THIS_IS_THE_FILE_ID --fuzzy
```
--continue 或 -c (不推荐直接依赖)： 理论上 gdown 支持断点续传，但其可靠性可能不如 rclone 这样的专业工具。
查看帮助： 你随时可以通过 gdown --help 查看所有可用的命令和选项。

总结：

下载单个文件：

gdown <FILE_ID_OR_LINK> -O <OUTPUT_FILENAME>

下载文件夹 (会打包成zip)：

gdown --folder <FOLDER_ID_OR_LINK> -O <OUTPUT_ZIP_FILENAME>
unzip <OUTPUT_ZIP_FILENAME>