文件传输协议（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证书进行加密通信。 请注意不要将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. 为所需租户启用 SFTP：

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

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

   替换my-tenant和my-tenant-ns使用所需的租户和命名空间。

   在features:section，设置值为enableSFTP to true:

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

   Kubectl 重启 MinIO 以应用更改。

   您也可以设置enableSFTP在你Helm chart or Kustomize 配置为新创建的租户启用 SFTP。

2. 如有需要，请根据本地策略配置SFTP端口的入口规则。

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使用所需的租户和命名空间。

   如果启用了 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使用所需的租户和命名空间。

如果启用了 SFTP，输出将类似于以下内容：

enableSFTP: true

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

   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 server --ftp和minio server --sftp有关使用这些标志启动 MinIO 服务的详细信息。 要连接到启用 TLS 的 FTP 端口（FTPS），请传递tls-private-key和tls-public-cert键和值也是如此，除非使用 MinIO 默认的 TLS 密钥。

   该命令的输出应返回一个类似于以下内容的响应：

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

2. 使用您偏好的FTP客户端连接到MinIO部署。 您必须以具有相应权限的用户身份进行连接。策略允许访问所需的存储桶和对象。

   连接到 MinIO 部署的具体方法取决于您使用的 FTP 客户端。 请参考您客户端的相关文档。

   要通过TLS连接或通过SSH连接，您必须使用支持所需协议的客户端。

3. 连接到 MinIO

   SFTP/FTP

   以下示例连接到SFTP服务器，并列出名为 bucket 的内容runner.

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

   FTPS

   以下使用 Linux 使用FTP CLI 客户端连接到 MinIO 服务器minio列出名为 [bucket_name] 的存储桶内容所需的凭据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)
   ...