Files
minio/README_ZH.md
T
Wesley Schwengle d495d30d57 docs: point documentation links to silo.pigsty.io (#41)
Replace upstream docs.min.io references with the SILO documentation domain and remove the upstream community path prefix.

Co-authored-by: waterkip <6317502+waterkip@users.noreply.github.com>
2026-07-21 12:14:10 +08:00

6.5 KiB
Raw Blame History

Silo

Silo

审慎维护的 MinIO 社区分支
为现有部署提供安全维护、带版本的发行产物与持续运维支持。

English · 文档 · 版本发布 · 容器镜像 · 安全策略

GitHub Release Docker Pulls Go Version License

Important

Silo 是由 Pigsty 独立维护、从 pgsty/minio 发布的开源 MinIO 社区分支。本项目与 MinIO, Inc. 不存在隶属、背书或赞助关系;文中使用 “MinIO” 仅用于说明上游项目及兼容谱系。

概述

Silo 维护一条基于 MinIO RELEASE.2025-12-03T12-00-00Z 的下游版本线,为上游停止社区发行后仍在运行 MinIO 兼容部署的用户提供持续构建与发行产物。

Pigsty 使用本分支提供对象存储,包括 PostgreSQL 备份存储。

维护政策

活跃版本线的维护范围包括:

  • 构建与依赖项维护;
  • 适用的安全修复与公告;
  • 针对可复现缺陷的范围明确的修复;
  • 带版本的二进制、软件包、校验和与多架构镜像;
  • Web Console、客户端、文档与 Pigsty 集成。

改动保持克制,并在可行时提供测试。所有维护均为尽力而为,不承诺固定的响应、修复或发布时间。

范围之外

  • 独立产品路线图、新存储引擎或假设性的 S3 新特性;
  • 大规模重写或显著扩大下游差异的改动;
  • 历史版本或多条支持分支;
  • 商业支持、SLA、7×24 服务或 SUBNET 服务;
  • 部署设计、访问控制、监控、备份与恢复。

兼容策略

Silo 尽量保留:

  • minio 可执行文件与 github.com/minio/minio module path
  • MinIO 兼容的 S3 API、配置、环境变量与命令行约定;
  • RELEASE.YYYY-MM-DDTHH-MM-SSZ 标签、容器入口与常见部署方式。

兼容是目标,而非保证。安全修复可能改变行为。每个版本都应视为下游升级:锁定版本,阅读版本说明安全公告,保留回滚路径,并在生产使用前完成测试。

发行产物

产物 位置
源码 github.com/pgsty/minio
容器镜像 pgsty/minio,支持 linux/amd64linux/arm64 多架构清单
服务端二进制 GitHub Releases,覆盖 Linux、macOS、Windows 的 amd64arm64
Linux 软件包 RPM、DEB、APK,并通过 Pigsty 软件仓库 分发
客户端 pgsty/mc,容器内以 mcli 提供,并保留 mc 兼容别名
管理控制台 社区维护的 georgmangold/console,嵌入服务端构建
文档 中文英文pgsty/minio-docs
安全记录 SECURITY.mdVULNERABILITY_REPORT.md本分支安全公告

快速开始

本地体验:

mkdir -p data

export MINIO_ROOT_USER=minioadmin
export MINIO_ROOT_PASSWORD=change-me-long-password

docker run -d --name silo \
  -p 9000:9000 \
  -p 9001:9001 \
  -e MINIO_ROOT_USER \
  -e MINIO_ROOT_PASSWORD \
  -v "$PWD/data:/data" \
  pgsty/minio:latest server /data --console-address ":9001"

管理控制台位于 http://localhost:9001S3 API 位于 http://localhost:9000

镜像内置兼容客户端 mcli

docker exec silo mcli alias set local http://127.0.0.1:9000 \
  "$MINIO_ROOT_USER" "$MINIO_ROOT_PASSWORD"
docker exec silo mcli mb local/demo
docker exec silo mcli ls local

Warning

生产环境应锁定版本,使用独立凭据与 TLS,配置监控,保留独立备份,并验证恢复流程。

从源码构建服务端:

go build -o minio .
./minio --version

部署:Silo 中文文档 · Pigsty MinIO 模块

安全

安全修复面向活跃的 master 分支,并记录在安全公告中。请按照 SECURITY.mdVULNERABILITY_REPORT.md 私密报告漏洞;同时影响上游 MinIO 的问题也应向上游报告。

参与贡献

欢迎安全与依赖项更新、可复现缺陷修复、测试、发布自动化、打包与文档改进。

Issue 与 Pull Request 应说明受影响版本、复现步骤、影响、预期行为、测试与兼容性说明。大型改动请先提交 Issue 讨论。

背景

本项目源于上游社区发行与维护模式的变化。维护者对相关变化的分析、替代方案评估与早期维护记录见以下文章:

文章 主题
MinIO已死 上游项目与发行模式的变化
MinIO已死,谁能接盘? 可选替代方案评估
MinIO 已死,MinIO 复生 建立分支及其发行流水线
续命 MinIO:承诺兑现 初期安全与维护工作

许可证与商标

服务端继续采用 GNU Affero General Public License v3.0 发布。上游作者与署名信息见 CREDITS

MinIO 是 MinIO, Inc. 的商标。Silo、Pigsty 与 pgsty/minio 均为独立社区项目,与 MinIO, Inc. 不存在隶属或背书关系。