从谷歌云存储下载文件的完整指南
gcloud auth login
使用
gsutil cp
命令下载文件,
gsutil cp gs://bucket-name/folder/file.txt ./local-directory/
- 批量下载:添加
-r
参数以递归下载整个目录:gsutil cp -r gs://bucket-name/folder/ ./local-directory/
通过客户端库(编程实现)
开发者可通过谷歌云提供的客户端库(Python、Java等)集成下载功能,以下以Python为例:
-
安装依赖库
pip install google-cloud-storage
-
编写代码
from google.cloud import storage # 初始化客户端 client = storage.Client() # 获取存储桶和文件对象 bucket = client.get_bucket("bucket-name") blob = bucket.blob("folder/file.txt") # 下载到本地 blob.download_to_filename("local-file.txt")
- 服务账号授权:需提前设置环境变量
GOOGLE_APPLICATION_CREDENTIALS
指向密钥文件。
- 服务账号授权:需提前设置环境变量
常见问题与解决
- 权限不足导致下载失败
- 检查账号是否拥有
storage.objects.get
权限。 - 若使用服务账号,确认密钥未过期。
- 检查账号是否拥有
- 文件路径错误
确认存储桶名称和文件路径区分大小写。
- 网络问题
- 使用
gsutil -m cp
启用多线程加速下载。
- 使用
安全建议
- 私有文件建议通过预签名URL临时授权访问,避免长期暴露。
- 定期轮换服务账号密钥,降低安全风险。
引用说明
- 谷歌云存储官方文档:https://cloud.google.com/storage/docs
- 客户端库安装指南:https://cloud.google.com/python/docs/reference/storage/latest