本文档介绍如何使用 Goofys 挂载 Google Cloud Storage。

挂载 GCS 存储桶需要以下权限：

• storage.objects.list - 列出对象
• storage.objects.get - 读取对象
• storage.objects.create - 创建对象
• storage.objects.delete - 删除对象

Goofys 支持两种认证方式：

1. 在 Google Cloud Console 创建服务账号
2. 为服务账号分配 Storage Object Admin 角色
3. 下载 JSON 格式的密钥文件

1. 安装 Google Cloud SDK
2. 运行 gcloud auth application-default login 进行认证

---

# 设置环境变量
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

# 挂载存储桶
goofys gs://my-bucket /mnt/gcs

# 挂载带前缀的路径
goofys gs://my-bucket:prefix /mnt/gcs

# 先完成 gcloud 登录
gcloud auth application-default login

# 直接挂载（无需设置环境变量）
goofys gs://my-bucket /mnt/gcs

[mounts.gcs]
backend = "gcs"
bucket = "my-bucket"
# 可选：指定凭证文件
# credentials_file = "/path/to/key.json"

---

Q: 挂载失败，提示 permission denied？ A: 检查服务账号是否有存储桶的访问权限。

Q: 使用 gcloud 认证失败？ A: 确保已安装 Google Cloud SDK 并完成 gcloud auth application-default login。

Q: 如何确认服务账号权限？ A: 在 Google Cloud Console → IAM → 服务账号，检查角色是否包含 Storage Object Admin。

Q: 可以挂载特定前缀吗？ A: 可以，使用 gs://bucket:prefix 格式。