配置对来源的访问权限：文件系统

如需从本地或私有云文件系统（例如符合 POSIX 标准的文件系统、NFS 或 SMB）传输数据，您必须在能够通过网络访问源文件的机器上安装并配置 Storage Transfer Service 代理。

前提条件

在配置转移作业之前，请确保您已设置以下各项：

• 用户权限：确保您的用户账号或用户代管式服务账号有权配置转移作业和代理池。请参阅所需的用户权限。
• 基于代理的项目级权限：确保您已为服务代理和转移代理账号配置了所需的项目级角色。请参阅基于代理的项目级权限。
• 目标位置权限：根据转移目标位置，配置所需的接收器权限：
  • 对于向 Cloud Storage 的转移作业，请参阅配置对接收器的访问权限：Cloud Storage。
  • 如需转移到其他文件系统，请参阅配置对接收器的访问权限：文件系统。

本地文件系统权限

转移代理在宿主机上的 Docker 或 Podman 容器内运行。如需让代理能够读取您的文件，请执行以下操作：

1. 操作系统用户权限：确保运行容器的操作系统用户对您计划传输的所有文件和目录具有读取（以及对目录的执行）权限。

2. 装载目录：安装代理时，使用 --mount-directories 标志（或 Docker 中的 -v 标志）装载要复制到容器中的目录：

   gcloud transfer agents install --pool=AGENT_POOL_NAME \
     --mount-directories=/path/to/source/dir
   

   注意：如果同一代理池中的多个代理在不同的物理机器上运行，则它们必须对完全相同的路径具有统一的网络访问权限（例如共享 NFS 装载）。如果某个代理无法访问分配给它的路径，则转移作业会失败。

如需限制代理可以查看的主机目录，请参阅限制代理目录访问权限。

性能和优化

• 为了在从大型文件系统传输数据时最大限度地提高吞吐量，请在源代理池中安装多个代理（建议至少安装 3 个）。请参阅转移代理的最佳实践。
• 对于大于 1 GB 的文件，请考虑启用分段上传。

后续步骤

• 了解如何安装转移代理。
• 了解如何创建代理池。
• 了解如何配置对接收器的访问权限：Cloud Storage。
• 了解如何配置对接收器的访问权限：文件系统。