文件传输协议 (FTP/SFTP)

MinIO Operator 仅支持配置 SSH 文件传输协议 (SFTP)。

启用后，MinIO 支持通过以下协议进行 FTP 访问：

• SSH 文件传输协议 (SFTP)

  互联网工程任务组 (IETF) 将 SFTP 定义为 SSH 2.0 的扩展。 SFTP 允许通过 SSH 进行文件传输，可用于 传输层安全 (TLS) 和虚拟专用网络 (VPN) 场景。

  你的 FTP 客户端必须支持 SFTP。

• 通过 SSL/TLS 的文件传输协议 (FTPS)

  FTPS 允许在标准 FTP 通信通道上使用 TLS 证书进行加密传输。 不应将 FTPS 与 SFTP 混淆，因为 FTPS 并不通过 Secure Shell (SSH) 通信。

  你的 FTP 客户端必须支持 FTPS。

• 文件传输协议 (FTP)

  不加密的文件传输。

  MinIO **不**建议使用未加密的 FTP 进行文件传输。

• MinIO Operator v5.0.7 或更高版本。

• 为服务器启用一个 SFTP 端口 (8022)。

• 一个用于 SFTP 命令的端口，以及一个端口范围，用于允许 SFTP 服务器在数据传输期间按需请求使用。

• MinIO RELEASE.2023-04-20T17-56-55Z 或更高版本。

• 为服务器启用一个 FTP 或 SFTP 端口。

• 一个用于 FTP 命令的端口，以及一个端口范围，用于允许 FTP 服务器在数据传输期间按需请求使用。

1. 为目标 Tenant 启用 SFTP：

   使用以下 Kubectl 命令编辑 Tenant YAML 配置：

   kubectl edit tenants/my-tenant -n my-tenant-ns
   

   将 my-tenant 和 my-tenant-ns 替换为目标 Tenant 和命名空间。

   在 features: 部分，将 enableSFTP 的值设置为 true：

   spec:
      configuration:
         name: my-tenant-env-configuration
      credsSecret:
         name: my-tenant-secret
      exposeServices:
         console: true
         minio: true
      features:
         enableSFTP: true
   

   Kubectl 会重启 MinIO 以应用更改。

   你也可以在 Helm chart 或 Kustomize 配置 中设置 enableSFTP，为新创建的 Tenant 启用 SFTP。

2. 如有需要，请根据本地策略为 SFTP 端口配置 ingress。

3. 验证配置

   以下 kubectl get 命令使用 yq 显示 enableSFTP 的值，以确认是否已启用 SFTP：

   kubectl get tenants/my-tenant -n my-tenant-ns -o yaml | yq '.spec.features'
   

   将 my-tenant 和 my-tenant-ns 替换为目标 Tenant 和命名空间。

   如果已启用 SFTP，输出类似如下：

   enableSFTP: true
   

4. 使用你偏好的 SFTP 客户端连接到 MinIO 部署。 你必须以其 策略 允许访问目标存储桶和对象的用户身份进行连接。

   连接到 MinIO 部署的具体方式取决于所使用的 SFTP 客户端。 请参阅该客户端的文档。

   以下示例连接到转发到本地主机系统的 MinIO Tenant SFTP 服务器，并列出名为 runner 的存储桶内容。

   > sftp -P 8022 minio@localhost
   minio@localhost's password:
   Connected to localhost.
   sftp> ls runner/
   chunkdocs  testdir
   

以下 kubectl get 命令使用 yq 显示 enableSFTP 的值，以确认是否已启用 SFTP：

kubectl get tenants/my-tenant -n my-tenant-ns -o yaml | yq '.spec.features'

将 my-tenant 和 my-tenant-ns 替换为目标 Tenant 和命名空间。

如果已启用 SFTP，输出类似如下：

enableSFTP: true

1. 启动 MinIO 并启用 FTP 和/或 SFTP 端口。

   FTPS

   以下示例以启用 FTPS 的方式启动 MinIO。

   minio server http://server{1...4}/disk{1...4} \
   --ftp="address=:8021"                         \
   --ftp="passive-port-range=30000-40000"        \
   --ftp="tls-private-key=path/to/private.key"   \
   --ftp="tls-public-cert=path/to/public.crt"    \
   ...
   

   Note

   省略 tls-private-key 和 tls-public-cert 可使用 MinIO 默认 TLS 密钥进行 FTPS 连接。 更多信息请参阅 MinIO TLS 文档。

   SFTP/FTP

   minio server http://server{1...4}/disk{1...4}        \
   --ftp="address=:8021"                                \
   --ftp="passive-port-range=30000-40000"               \
   --sftp="address=:8022"                               \
   --sftp="ssh-private-key=/home/miniouser/.ssh/id_rsa" \
   ...
   

   有关使用这些标志启动 MinIO 服务的详细信息，请参阅 minio server --ftp 和 minio server --sftp。 若要通过 TLS (FTPS) 连接到 FTP 端口，除非使用 MinIO 默认 TLS 密钥，否则还需要传入 tls-private-key 和 tls-public-cert 键值。

   命令输出应类似如下：

   MinIO FTP Server listening on :8021
   MinIO SFTP Server listening on :8022
   

2. 使用你偏好的 FTP 客户端连接到 MinIO 部署。 你必须使用其 策略 允许访问目标存储桶和对象的用户身份进行连接。

   连接到 MinIO 部署的具体方式取决于所使用的 FTP 客户端。 请参阅该客户端的文档。

   若要通过 TLS 或 SSH 连接，必须使用支持相应协议的客户端。

3. 连接到 MinIO

   SFTP/FTP

   以下示例连接到 SFTP 服务器，并列出名为 runner 的存储桶内容。

   > sftp -P 8022 minio@localhost
   minio@localhost's password:
   Connected to localhost.
   sftp> ls runner/
   chunkdocs  testdir
   

   FTPS

   以下示例使用 Linux 的 FTP CLI client，通过 minio 凭证连接到 MinIO 服务器，并列出名为 runner 的存储桶内容。

   > ftp localhost -P 8021
   Connected to localhost.
   220 Welcome to MinIO FTP Server
   Name (localhost:user): minio
   331 User name ok, password required
   Password:
   230 Password ok, continue
   Remote system type is UNIX.
   Using binary mode to transfer files.
   ftp> ls runner/
   229 Entering Extended Passive Mode (|||39155|)
   150 Opening ASCII mode data connection for file list
   drwxrwxrwx 1 nobody nobody            0 Jan  1 00:00 chunkdocs/
   drwxrwxrwx 1 nobody nobody            0 Jan  1 00:00 testdir/
   ...
   

4. 下载对象

   SFTP/FTP

   本示例先列出存储桶中的条目，然后下载该存储桶中的内容。

   > sftp -P 8022 minio@localhost
   minio@localhost's password:
   Connected to localhost.
   sftp> ls runner/
   chunkdocs  testdir
   sftp> get runner/chunkdocs/metadata metadata
   Fetching /runner/chunkdocs/metadata to metadata
   metadata                               100%  226    16.6KB/s   00:00
   sftp>
   

   FTPS

   本示例先列出存储桶中的条目，然后下载该存储桶中的内容。

   > ftp localhost -P 8021
   Connected to localhost.
   220 Welcome to MinIO FTP Server
   Name (localhost:user): minio
   331 User name ok, password required
   Password:
   230 Password ok, continue
   Remote system type is UNIX.
   Using binary mode to transfer files.ftp> ls runner/chunkdocs/metadata
   229 Entering Extended Passive Mode (|||44269|)
   150 Opening ASCII mode data connection for file list
   -rwxrwxrwx 1 nobody nobody           45 Apr  1 06:13 chunkdocs/metadata
   226 Closing data connection, sent 75 bytes
   ftp> get
   (remote-file) runner/chunkdocs/metadata
   (local-file) test
   local: test remote: runner/chunkdocs/metadata
   229 Entering Extended Passive Mode (|||37785|)
   150 Data transfer starting 45 bytes
      45        3.58 KiB/s
   226 Closing data connection, sent 45 bytes
   45 bytes received in 00:00 (3.55 KiB/s)
   ...