这是用户在 2025-4-12 23:56 为 https://github.com/minio/minio 保存的双语快照页面,由 沉浸式翻译 提供双语支持。了解如何保存?
Skip to content
Owner avatar minio Public

MinIO is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license.
MinIO 是一个高性能的、与 S3 相容的对象存储系统,开源许可证为 GNU AGPLv3。

License

Open in github.dev Open in a new github.dev tab Open in codespace

minio/minio

Add file

Add file

Folders and files

NameName
Last commit message
Last commit date
Apr 9, 2025
Dec 2, 2024
Apr 10, 2025
Sep 12, 2024
Apr 9, 2025
Jan 3, 2025
Mar 15, 2025
Apr 10, 2025
Sep 19, 2023
May 28, 2024
Mar 30, 2025
Apr 10, 2019
Apr 3, 2025
Jun 19, 2021
Feb 12, 2022
Aug 6, 2024
Mar 13, 2025
Sep 16, 2024
Jun 3, 2021
Apr 9, 2025
Apr 9, 2025
Apr 9, 2025
Sep 10, 2021
Apr 24, 2021
Feb 12, 2025
Feb 19, 2023
Jul 17, 2022
Apr 9, 2025
Feb 12, 2022
Feb 12, 2022
Jun 19, 2021
Jan 21, 2020
Apr 2, 2025
Apr 9, 2025
Apr 1, 2025
Aug 21, 2021
Jan 3, 2025
Oct 25, 2022
Aug 11, 2023

MinIO Quickstart Guide  MinIO 快速入门指南

Slack Docker Pulls license

MinIO

MinIO is a High Performance Object Storage released under GNU Affero General Public License v3.0. It is API compatible with Amazon S3 cloud storage service. Use MinIO to build high performance infrastructure for machine learning, analytics and application data workloads.
MinIO 是一款高性能对象存储解决方案,发布在 GNU Affero 通用公共许可协议 3.0 版下。其 API 兼容性与亚马逊 S3 云存储服务。使用 MinIO 构建基于机器学习、分析和应用数据存储的工作负载高性能基础设施。

To learn more about what MinIO is doing for AI storage, go to AI storage documentation.
要了解 MinIO 在 AI 存储方面所做的工作,请访问 AI 存储文档。

This README provides quickstart instructions on running MinIO on bare metal hardware, including container-based installations. For Kubernetes environments, use the MinIO Kubernetes Operator.
此 README 提供快速入门指南,指导您在裸金属硬件上运行 MinIO,包括容器化安装。对于 Kubernetes 环境,请使用 MinIO Kubernetes 操作员。

Container Installation  容器安装

Use the following commands to run a standalone MinIO server as a container.
请按照以下命令在容器中运行独立的 MinIO 服务器。

Standalone MinIO servers are best suited for early development and evaluation. Certain features such as versioning, object locking, and bucket replication require distributed deploying MinIO with Erasure Coding.
“独立 MinIO 服务器最适合用于早期开发和评估。某些功能,如版本控制、对象锁定和桶复制,需要通过分布式部署 MinIO 结合 Erasure Coding 实现。”

For extended development and production, deploy MinIO with Erasure Coding enabled - specifically, with a minimum of 4 drives per MinIO server. See MinIO Erasure Code Overview for more complete documentation.
在扩展开发和生产中,部署 MinIO 时,请启用擦除编码功能,具体要求是每台 MinIO 服务器至少配备 4 个存储设备。请参阅 MinIO 擦除编码概览以获取更详细的文档说明。

Stable  稳定版

Run the following command to run the latest stable image of MinIO as a container using an ephemeral data volume:
请运行以下命令,使用 ephemeral 数据 volumes 运行 MinIO 的最新稳定版本容器:

podman run -p 9000:9000 -p 9001:9001 \
  quay.io/minio/minio server /data --console-address ":9001"

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
“MinIO 部署将使用默认根凭证 minioadmin:minioadmin 开始。您可以使用 MinIO 控制台进行测试,这是集成到 MinIO 服务器中的对象浏览器。在主机机器上运行的 Web 浏览器可以指向 http://127.0.0.1:9000 并使用根凭证登录。您可以使用此 Web 浏览器创建桶,上传对象,并浏览 MinIO 服务器的内容。”

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html to view MinIO SDKs for supported languages.
“此外,您还可以使用任何 S3 兼容的工具,例如 MinIO 客户端 mc 命令行工具。参见使用 MinIO 客户端 mc 命令行工具的文档获取有关使用 mc 命令行工具的更多信息。对于应用程序开发人员,请参见 https://min.io/docs/minio/linux/developers/minio-drivers.html 以查看支持的语言的 SDK。”

NOTE: To deploy MinIO on with persistent storage, you must map local persistent directories from the host OS to the container using the podman -v option. For example, -v /mnt/data:/data maps the host OS drive at /mnt/data to /data on the container.
“注意:要将 MinIO 部署到带有持久化存储的环境中,您必须从主机操作系统映射本地持久化目录到容器中使用 podman -v 选项。例如, -v /mnt/data:/data 将主机 OS 驱动器映射到 /mnt/data/data 在容器中。”

macOS

Use the following commands to run a standalone MinIO server on macOS.
请按照以下命令在 macOS 上运行一个独立的 MinIO 服务器。

Standalone MinIO servers are best suited for early development and evaluation. Certain features such as versioning, object locking, and bucket replication require distributed deploying MinIO with Erasure Coding.
独立 MinIO 服务器最适合用于早期开发和评估。某些功能,如版本控制、对象锁定和桶复制,需要通过分布式部署 MinIO 结合 Erasure Coding 来实现。

For extended development and production, deploy MinIO with Erasure Coding enabled - specifically, with a minimum of 4 drives per MinIO server. See MinIO Erasure Code Overview for more complete documentation.
为扩展开发和生产,部署带有 Erasure Coding 启用的 MinIO,具体来说,每台 MinIO 服务器最少需要 4 块硬盘。参见 MinIO Erasure Code Overview 以获取更详细的文档。

Homebrew (recommended)  Homebrew(推荐使用)

Run the following command to install the latest stable MinIO package using Homebrew. Replace /data with the path to the drive or directory in which you want MinIO to store data.
运行以下命令安装最新稳定的 MinIO 包。请将 /data 替换为你要的数据存储在 MinIO 中的驱动或目录路径。

brew install minio/stable/minio
minio server /data

NOTE: If you previously installed minio using brew install minio then it is recommended that you reinstall minio from minio/stable/minio official repo instead.
注意:如果你之前通过 brew install minio 安装了 minio,那么建议你从 minio/stable/minio 官方仓库重新安装 minio。

brew uninstall minio
brew install minio/stable/minio

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded web-based object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
MinIO 部署开始使用默认的根凭证 minioadmin:minioadmin 。你可以通过 MinIO 控制台进行测试... MinIO 控制台是一个集成到 MinIO 服务器中的嵌入式 Web 对象浏览器。在主机机器上打开浏览器,访问 http://127.0.0.1:9000,并使用根凭证进行登录。你可以使用浏览器创建桶、上传对象以及浏览 MinIO 服务器的内容。

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html/ to view MinIO SDKs for supported languages.
此外,你还可以通过任何 S3 兼容工具(例如 MinIO 客户端 mc 命令行工具)进行连接。参见 mc 使用 MinIO 客户端 mc 命令行工具的更多信息。对于应用程序开发人员,请参见 https://min.io/docs/minio/linux/developers/minio-drivers.html/,以查看支持的语言的 SDK。

Binary Download  二进制下载

Use the following command to download and run a standalone MinIO server on macOS. Replace /data with the path to the drive or directory in which you want MinIO to store data.
请使用以下命令在 macOS 上下载并运行一个独立的 MinIO 服务器。替换 /data 为你要在其中存储数据的硬盘或目录路径。

wget https://dl.min.io/server/minio/release/darwin-amd64/minio
chmod +x minio
./minio server /data

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded web-based object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
MinIO 部署使用默认根凭证 minioadmin:minioadmin 开始。你可以通过 MinIO 控制台进行测试,这是一个集成到 MinIO 服务器中的嵌入式 Web 对象浏览器。在主机机器上运行一个 Web 浏览器,访问 http://127.0.0.1:9000,并使用根凭证登录。你可以使用 Browser 创建桶,上传对象,并浏览 MinIO 服务器的内容。

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html to view MinIO SDKs for supported languages.
你还可以通过任何 S3 兼容的工具进行连接,例如 MinIO 客户端 mc 命令行工具。参见使用 MinIO 客户端 mc 了解如何使用 mc 命令行工具。对于应用开发人员,请参见 https://min.io/docs/minio/linux/developers/minio-drivers.html 以查看支持的语言的 SDK。

GNU/Linux  Linux 发行版 GNU

Use the following command to run a standalone MinIO server on Linux hosts running 64-bit Intel/AMD architectures. Replace /data with the path to the drive or directory in which you want MinIO to store data.
使用以下命令在 64 位 Intel/AMD 架构 Linux 主机上运行一个独立的 MinIO 服务器。替换 /data 为你要将 MinIO 数据存储在驱动器或目录中的路径。

wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio
./minio server /data

The following table lists supported architectures. Replace the wget URL with the architecture for your Linux host.
以下表格列出了支持的架构。请将 wget URL 替换为您的 Linux 主机的架构。

Architecture  架构 URL
64-bit Intel/AMD  “64 位 Intel/AMD” https://dl.min.io/server/minio/release/linux-amd64/minio
64-bit ARM  64 位 ARM https://dl.min.io/server/minio/release/linux-arm64/minio
64-bit PowerPC LE (ppc64le)
“64 位 PowerPC LE(ppc64le)”
https://dl.min.io/server/minio/release/linux-ppc64le/minio

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded web-based object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
“MinIO 部署使用默认的根凭证开始 minioadmin:minioadmin 。您可以通过 MinIO 控制台进行测试@1#,这是一个集成到 MinIO 服务器中的嵌入式 Web 对象浏览器。在主机机器上运行的 Web 浏览器可以指向 http://127.0.0.1:9000 并使用根凭证进行登录@2#。您可以使用此 Web 浏览器创建桶,上传对象,并浏览 MinIO 服务器的内容。”

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html to view MinIO SDKs for supported languages.
“您还可以通过任何与 S3 兼容的工具进行连接,例如 MinIO 客户端 mc 的命令行工具。有关如何使用 mc 命令行工具,请参阅 mc 的文档。对于应用开发人员,请参阅 https://min.io/docs/minio/linux/developers/minio-drivers.html 以查看支持的语言的 SDK 视图。”

NOTE: Standalone MinIO servers are best suited for early development and evaluation. Certain features such as versioning, object locking, and bucket replication require distributed deploying MinIO with Erasure Coding.
注意:独立的 MinIO 服务器最适合早期的开发和评估。某些功能,如版本控制、对象锁定和桶复制,需要通过分布式部署 MinIO 并结合 Erasure Coding 来实现。

For extended development and production, deploy MinIO with Erasure Coding enabled - specifically, with a minimum of 4 drives per MinIO server. See MinIO Erasure Code Overview for more complete documentation.
在扩展开发和生产中,部署带有纠删码功能的 MinIO,特别是每台 MinIO 服务器最少配备 4 块存储驱动器。参考 MinIO 纠删码概述获取更完整的文档。

Microsoft Windows  微软 Windows

To run MinIO on 64-bit Windows hosts, download the MinIO executable from the following URL:
要在 64 位 Windows 主机上运行 MinIO,请从以下 URL 下载 MinIO 执行文件:

https://dl.min.io/server/minio/release/windows-amd64/minio.exe

Use the following command to run a standalone MinIO server on the Windows host. Replace D:\ with the path to the drive or directory in which you want MinIO to store data. You must change the terminal or powershell directory to the location of the minio.exe executable, or add the path to that directory to the system $PATH:
请使用以下命令在 Windows 主机上运行一个独立的 MinIO 服务器。请将 D:\ 替换为存储数据的驱动器或目录路径。您必须将终端或 PowerShell 环境指向 minio.exe 执行文件的路径,或将其路径添加到系统 $PATH 中。

minio.exe server D:\

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded web-based object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
“MinIO 部署将使用默认的根凭证 minioadmin:minioadmin 。您可以通过 MinIO 控制台 @1# 进行测试,这是一个集成到 MinIO 服务器中的嵌入式 Web 对象浏览器。在主机机器上运行的 Web 浏览器可以指向 http://127.0.0.1:9000,并使用根凭证进行登录。您可以通过浏览器创建桶,上传对象,并浏览 MinIO 服务器的内容。”

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html to view MinIO SDKs for supported languages.
“除了使用 S3 兼容的工具外,您还可以通过 MinIO 客户端 mc 的命令行工具进行连接。有关如何使用 mc 命令行工具,请参阅 mc 文档。对于应用开发人员,请访问 https://min.io/docs/minio/linux/developers/minio-drivers.html,以查看支持的语言的 SDK。”

NOTE: Standalone MinIO servers are best suited for early development and evaluation. Certain features such as versioning, object locking, and bucket replication require distributed deploying MinIO with Erasure Coding.
注意:独立 MinIO 服务器最适合早期开发和评估。某些功能,如版本控制、对象锁定和桶复制,需要使用分布式 MinIO 与 Erasure Coding 部署。

For extended development and production, deploy MinIO with Erasure Coding enabled - specifically, with a minimum of 4 drives per MinIO server. See MinIO Erasure Code Overview for more complete documentation.
为了扩展开发和投入生产,请启用 MinIO 中的 Erasure Coding -具体来说,每台 MinIO 服务器最少需要 4 个磁盘。有关更详细的文档,请参阅 MinIO Erasure Code Overview。

Install from Source  从源安装

Use the following commands to compile and run a standalone MinIO server from source. Source installation is only intended for developers and advanced users. If you do not have a working Golang environment, please follow How to install Golang. Minimum version required is go1.24
请使用以下命令编译和运行一个基于源的独立 MinIO 服务器。独立安装仅适用于开发人员和经验丰富的用户。如果您没有运行良好的 Go 语言环境,请参阅如何安装 Go。最低版本要求是 go1.24。

go install github.com/minio/minio@latest

The MinIO deployment starts using default root credentials minioadmin:minioadmin. You can test the deployment using the MinIO Console, an embedded web-based object browser built into MinIO Server. Point a web browser running on the host machine to http://127.0.0.1:9000 and log in with the root credentials. You can use the Browser to create buckets, upload objects, and browse the contents of the MinIO server.
MinIO 部署开始使用默认的根凭证 minioadmin:minioadmin 。你可以通过 MinIO 控制台进行测试,MinIO 控制台是一个集成在 MinIO 服务器中的嵌入式 Web 对象浏览器。将运行在主机上的 Web 浏览器指向 http://127.0.0.1:9000,并使用根凭证登录。你可以使用浏览器创建桶、上传对象和浏览 MinIO 服务器的内容。

You can also connect using any S3-compatible tool, such as the MinIO Client mc commandline tool. See Test using MinIO Client mc for more information on using the mc commandline tool. For application developers, see https://min.io/docs/minio/linux/developers/minio-drivers.html to view MinIO SDKs for supported languages.
“此外,您还可以通过任何 S3 兼容的工具连接,例如 MinIO 客户端 mc 命令行工具。请参阅使用 MinIO 客户端 mc 文档获取有关使用 mc 命令行工具的更多信息。对于应用程序开发人员,请访问 https://min.io/docs/minio/linux/developers/minio-drivers.html 以查看支持语言的 MinIO SDK。”

NOTE: Standalone MinIO servers are best suited for early development and evaluation. Certain features such as versioning, object locking, and bucket replication require distributed deploying MinIO with Erasure Coding.
“注意:独立 MinIO 服务器最适合用于早期开发和评估。某些功能,如版本控制、对象锁定和分复制,需要 MinIO 与 Erasure Coding 分布式部署。”

For extended development and production, deploy MinIO with Erasure Coding enabled - specifically, with a minimum of 4 drives per MinIO server. See MinIO Erasure Code Overview for more complete documentation.
“为了扩展开发和投入生产,启用 MinIO 的 Erasure Coding 功能——具体来说,每台 MinIO 服务器最少需要 4 块存储设备。请参阅 MinIO Erasure Code Overview 获取更详细的文档。”

MinIO strongly recommends against using compiled-from-source MinIO servers for production environments.
“MinIO 强烈不推荐在生产环境中使用从源编译的 MinIO 服务器。”

Deployment Recommendations
部署建议

Allow port access for Firewalls
允许多个防火墙端口访问

By default MinIO uses the port 9000 to listen for incoming connections. If your platform blocks the port by default, you may need to enable access to the port.
默认情况下,MinIO 使用端口 9000 监听 incoming 连接。如果您的平台默认情况下阻止了该端口,您可能需要启用对该端口的访问权限。

ufw

For hosts with ufw enabled (Debian based distros), you can use ufw command to allow traffic to specific ports. Use below command to allow access to port 9000
对于启用 `ufw` 的主机(基于 Debian 的发行版),您可以通过 ` ufw ` 命令允许特定端口的流量。请使用以下命令来允许访问端口 9000。

ufw allow 9000

Below command enables all incoming traffic to ports ranging from 9000 to 9010.
以下命令允许所有来自 9000 到 9010 的端口的所有 incoming 交通。

ufw allow 9000:9010/tcp

firewall-cmd

For hosts with firewall-cmd enabled (CentOS), you can use firewall-cmd command to allow traffic to specific ports. Use below commands to allow access to port 9000
对于启用 `firewall-cmd` 的主机(如 CentOS),您可以通过 ` firewall-cmd ` 命令允许特定端口的流量。请使用以下命令允许访问端口 9000。

firewall-cmd --get-active-zones

This command gets the active zone(s). Now, apply port rules to the relevant zones returned above. For example if the zone is public, use
此命令获取当前的活跃虚拟机。现在,请根据上述返回的虚拟机应用端口规则。例如,如果虚拟机是 public ,请使用

firewall-cmd --zone=public --add-port=9000/tcp --permanent

Note that permanent makes sure the rules are persistent across firewall start, restart or reload. Finally reload the firewall for changes to take effect.
请注意, permanent 确保了规则在防火墙启动、重启或重新加载时保持持久。最后重新加载防火墙以使更改生效。

firewall-cmd --reload

iptables

For hosts with iptables enabled (RHEL, CentOS, etc), you can use iptables command to enable all traffic coming to specific ports. Use below command to allow access to port 9000
对于使用 iptables 启用的主机(如 RHEL、CentOS 等),您可以通过 iptables 命令启用所有进入特定端口的流量。使用以下命令允许访问端口 9000

iptables -A INPUT -p tcp --dport 9000 -j ACCEPT
service iptables restart

Below command enables all incoming traffic to ports ranging from 9000 to 9010.
以下命令启用所有从 9000 到 9010 的端口的入站流量。

iptables -A INPUT -p tcp --dport 9000:9010 -j ACCEPT
service iptables restart

Test MinIO Connectivity  测试 MinIO 连接性

Test using MinIO Console  使用 MinIO 控制台进行测试

MinIO Server comes with an embedded web based object browser. Point your web browser to http://127.0.0.1:9000 to ensure your server has started successfully.
MinIO 服务器内置了一个嵌入式 Web 对象浏览器。将浏览器指向 http://127.0.0.1:9000,以确保服务器已成功启动。

NOTE: MinIO runs console on random port by default, if you wish to choose a specific port use --console-address to pick a specific interface and port.
注意:MinIO 会默认在随机端口上运行控制台。如果你希望选择特定的端口,请使用 --console-address 来选择特定的接口和端口。

Things to consider  需要考虑的因素

MinIO redirects browser access requests to the configured server port (i.e. 127.0.0.1:9000) to the configured Console port. MinIO uses the hostname or IP address specified in the request when building the redirect URL. The URL and port must be accessible by the client for the redirection to work.
MinIO 将浏览器的访问请求重定向到配置的服务器端口(即 127.0.0.1:9000 )以实现控制台端口的重定向。MinIO 在构建重定向 URL 时会使用请求中的主机名或 IP 地址。只有当 URL 和端口对客户端来说是可达的时,重定向才能正常工作。

For deployments behind a load balancer, proxy, or ingress rule where the MinIO host IP address or port is not public, use the MINIO_BROWSER_REDIRECT_URL environment variable to specify the external hostname for the redirect. The LB/Proxy must have rules for directing traffic to the Console port specifically.
对于部署在负载均衡器、代理或入口规则后,MinIO 主机的 IP 地址或端口不是公有地址的情况,使用 MINIO_BROWSER_REDIRECT_URL 环境变量指定外部主机以实现重定向。负载均衡器/代理必须为专门指向控制台端口的流量设置规则。

For example, consider a MinIO deployment behind a proxy https://minio.example.net, https://console.minio.example.net with rules for forwarding traffic on port :9000 and :9001 to MinIO and the MinIO Console respectively on the internal network. Set MINIO_BROWSER_REDIRECT_URL to https://console.minio.example.net to ensure the browser receives a valid reachable URL.
例如,考虑一个 MinIO 部署,其后端配置了一个代理服务器 https://minio.example.nethttps://console.minio.example.net ,并设置了转发规则,将端口:9000 和:9001 的流量分别转发到 MinIO 和 MinIO 控制台的内部网络上。将 MINIO_BROWSER_REDIRECT_URL 设置为 https://console.minio.example.net ,以确保浏览器能够访问到有效的可达 URL。

Dashboard  数据面板 Creating a bucket  创建桶
Dashboard Dashboard

Test using MinIO Client mc
测试使用 MinIO 客户端 mc

mc provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage services. Follow the MinIO Client Quickstart Guide for further instructions.
mc 提供了 UNIX 命令(如 ls、cat、cp、mirror、diff 等)的现代替代方案。它支持文件系统和 Amazon S3 相容的云存储服务。请参考 MinIO 客户端快速入门指南获取进一步的指示。

Upgrading MinIO  升级 MinIO

Upgrades require zero downtime in MinIO, all upgrades are non-disruptive, all transactions on MinIO are atomic. So upgrading all the servers simultaneously is the recommended way to upgrade MinIO.
MinIO 的升级不需要停机,所有升级操作都是非破坏性的,MinIO 上的所有交易都是原子性的。因此,同时升级所有服务器是升级 MinIO 的推荐方式。

NOTE: requires internet access to update directly from https://dl.min.io, optionally you can host any mirrors at https://my-artifactory.example.com/minio/
注意:直接从 https://dl.min.io 更新需要网络访问权限,如果需要,您也可以在 https://my-artifactory.example.com/minio/ 上托管任何镜像。

  • For deployments that installed the MinIO server binary by hand, use mc admin update
    对于通过手动安装 MinIO 服务器二进制进行部署的情况,使用 mc admin update
mc admin update <minio alias, e.g., myminio>
  • For deployments without external internet access (e.g. airgapped environments), download the binary from https://dl.min.io and replace the existing MinIO binary let's say for example /opt/bin/minio, apply executable permissions chmod +x /opt/bin/minio and proceed to perform mc admin service restart alias/.
    对于无需外部互联网访问的部署(例如空中隔离环境),从 https://dl.min.io 下载二进制文件,并将现有的 MinIO 二进制替换为例如 /opt/bin/minio ,应用执行权限 chmod +x /opt/bin/minio ,然后执行 mc admin service restart alias/

  • For installations using Systemd MinIO service, upgrade via RPM/DEB packages parallelly on all servers or replace the binary lets say /opt/bin/minio on all nodes, apply executable permissions chmod +x /opt/bin/minio and process to perform mc admin service restart alias/.
    对于使用 Systemd MinIO 服务的安装,可以在所有服务器上并行升级使用 RPM/DEB 包,或者在所有节点上替换二进制,例如 /opt/bin/minio 。应用执行权限 chmod +x /opt/bin/minio ,并进行 mc admin service restart alias/ 操作。

Upgrade Checklist  升级清单

  • Test all upgrades in a lower environment (DEV, QA, UAT) before applying to production. Performing blind upgrades in production environments carries significant risk.
    在应用到生产环境之前,请在 DEV、QA 或 UAT 环境中测试所有升级。在生产环境中进行盲目升级存在重大风险。
  • Read the release notes for MinIO before performing any upgrade, there is no forced requirement to upgrade to latest release upon every release. Some release may not be relevant to your setup, avoid upgrading production environments unnecessarily.
    在进行任何升级之前,请阅读 MinIO 的发布说明。并非每升级都强制要求升级到最新版本。有些版本可能与您的配置无关,因此无需对生产环境进行不必要的升级。
  • If you plan to use mc admin update, MinIO process must have write access to the parent directory where the binary is present on the host system.
    如果计划使用 mc admin update ,MinIO 过程必须具备对二进制所在目录进行写入权限。
  • mc admin update is not supported and should be avoided in kubernetes/container environments, please upgrade containers by upgrading relevant container images.
    mc admin update 不支持且应避免在 Kubernetes/容器环境中使用,请通过升级相关容器图像来升级容器。
  • We do not recommend upgrading one MinIO server at a time, the product is designed to support parallel upgrades please follow our recommended guidelines.
    我们不推荐一次性升级单个 MinIO 服务器,该产品旨在支持并行升级,请遵循我们的推荐指南。

Explore Further  深入探索

Contribute to MinIO Project
参与 MinIO 项目贡献

Please follow MinIO Contributor's Guide
请按照《MinIO 贡献者指南》进行操作

License  许可类型

set 限制解除
Repository search results