文件传输协议 (FTP/SFTP)

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

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

• SSH 文件传输协议 (SFTP)

  SFTP 由互联网工程任务组 (IETF) 定义为 SSH 2.0 的扩展。SFTP 允许通过 SSH 进行文件传输，以便与传输层安全 (TLS) 和虚拟专用网络 (VPN) 应用程序一起使用。

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

• 基于 SSL/TLS 的文件传输协议 (FTPS)

  FTPS 允许通过标准 FTP 通信通道使用 TLS 证书进行加密的 FTP 通信。FTPS 不应与 SFTP 混淆，因为 FTPS 不通过安全外壳 (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"    \
   ...
   

   注意

   省略 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 客户端，通过 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)
   ...