mcli

Silo 命令行客户端 —— 由 PIGSTY 维护的 MinIO 兼容客户端分支

官网 · 文档 · 下载 · 版本说明 · 兼容性 · 安全策略 · English

概述

pgsty/mc 维护一条基于上游 MinIO Client 最后一个提交 77f82e18 的下游版本线。在上游仓库归档后，本分支让客户端与 Silo 对象存储服务器共用同一条受维护的供应链完成构建、修补、测试和发布，同时仍是面向文件系统与 Amazon S3 兼容对象存储的通用客户端。

本分支遵循一条原则：改名的是发行产物与分发渠道，不是你使用的工具。 独立归档包与 Linux 软件包以 mcli 命名，而命令、参数、配置与协议行为与上游保持一致。完整的差异清单随版本更新，见兼容性说明。

项目统一门户为 silo.pgsty.com，集中提供命令参考、下载安装、版本与安全动态，以及项目法律信息。

按需求选择入口

需求	权威入口
项目概览与全站导航	Silo 官网
mcli 安装方式与软件下载	下载与安装
客户端与管理命令参考	mcli 命令参考 · mcli admin 命令参考
本客户端的版本说明	mcli 版本说明
与上游 mc 的差异	mcli 兼容性说明
项目动态与安全通告	博客 · 版本发布与安全通告
带版本的归档包、软件包、校验和与源码	GitHub Releases
缺陷报告与功能讨论	GitHub Issues
私密漏洞报告	安全策略
许可证、署名与商标信息	LICENSE · NOTICE · CREDITS · 门户的许可证、署名归属与商标政策页面

相关项目

仓库	说明
pgsty/silo	Silo 对象存储服务器 —— 本客户端配套的 S3 兼容 MinIO fork
pgsty/mc	本仓库 —— Silo 客户端，以 mcli 发行、保留 mc 命令名
pgsty/silo-console	Silo 服务器的 Web 管理控制台
pgsty/silo-pkg	为 Silo 系 fork 维护的共享 Go 包
pgsty/pigsty	Pigsty —— 内置 Silo 作为对象存储的 PostgreSQL 发行版

维护政策

活跃的 main 版本线覆盖：

• 构建、工具链与依赖项维护；
• 适用的安全修复与敏感输出加固；
• 针对可复现缺陷与 Silo 互操作问题的范围明确的修复；
• 带版本的归档包、Linux 软件包、校验和与多架构镜像；
• 发布自动化、文档与 Pigsty 集成。

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

范围之外

• 独立客户端路线图、新对象存储协议或假设性的新命令；
• 大规模重写或显著扩大下游差异的改动；
• 历史版本或多条支持分支；
• 商业支持、SLA、7×24 服务或 SUBNET 服务；
• 对所有 S3 实现或 MinIO 未来私有 API 的兼容保证。

治理

本客户端与 Silo 服务器在同一套发布流程下共同维护：提交必须签署 DCO、Pull Request 必须通过全部必需 CI 检查（本项目由单人维护，不存在可强制执行的独立人工评审）、以签名且不可变的 RELEASE.YYYY-MM-DDTHH-MM-SSZ 标签发布带校验和的产物。每个版本都会在门户发布版本说明；安全问题遵循安全策略处理。上游版权、许可证与第三方声明完整保留于 LICENSE、NOTICE 与 CREDITS。

兼容策略

本分支尽量保留：

• github.com/minio/mc module path、~/.mc 配置与用户熟悉的命令行为；
• S3 Signature V2/V4 访问方式，以及常用 MinIO/Silo 管理流程；
• RELEASE.YYYY-MM-DDTHH-MM-SSZ 标签与容器的 mc 入口；
• 源码构建使用 mc，独立归档包与 Linux 软件包使用 mcli；Silo 镜像同时提供两个命令名。

所有连往 MinIO 运营服务的通道 —— 更新源、SUBNET、遥测与预置的 play 别名 —— 均已切断；受影响的命令为脚本兼容而保留，并以稳定错误退出。其中 mc update 已被有意禁用：请通过 Pigsty 软件仓库 或 GitHub Releases 升级。

兼容是目标，而非保证。服务端专用管理命令可能随版本变化。请锁定版本、阅读版本说明与兼容性说明、保留回滚路径，并在生产使用前针对目标服务完成测试。

下载与发行产物

请先在下载与安装页面选择合适的客户端安装方式；GitHub Releases 仍是带版本归档包、软件包、校验和与源码归档的获取位置。

产物	位置
源码	github.com/pgsty/mc
独立归档包	GitHub Releases，提供 Linux、macOS、Windows 的 amd64 与 arm64 版本，命令名为 mcli
Linux 软件包	面向 x86_64/aarch64 的 RPM、DEB 与 APK，同时通过 Pigsty 软件仓库 分发
容器镜像	pgsty/mc，支持 linux/amd64 与 linux/arm64 多架构清单，以 mc 作为入口
Silo 内置客户端	pgsty/silo 以 mcli 提供本客户端，并保留 mc 兼容别名

快速开始

独立归档包与 Linux 软件包使用 mcli 命令：

mcli alias set local http://127.0.0.1:9000 ACCESS_KEY SECRET_KEY
mcli mb local/demo
mcli cp README.md local/demo/
mcli ls local/demo

容器保留用户熟悉的 mc 入口：

docker run --rm pgsty/mc:latest --version
docker run --rm pgsty/mc:latest alias ls

从源码构建：

git clone https://github.com/pgsty/mc.git
cd mc
make build
./mc --version

常用命令

命令	用途
alias	配置凭据与服务端点
ls、tree、stat、du	检查存储桶、对象与本地文件
mb、rb	创建或删除存储桶
cp、get、put、mv、rm	传输与管理对象
mirror、diff、find	同步、比较与搜索数据
anonymous、share	管理匿名访问与临时 URL
version、retention、legalhold、ilm	管理数据保护策略
replicate	配置存储桶复制
admin	运维兼容的 MinIO/Silo 服务端

运行 mcli --help、mcli <command> --help，或查阅客户端命令参考了解完整命令集。

参与贡献

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

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

本项目不要求签署 CLA：贡献按项目许可证（AGPL-3.0-or-later，inbound=outbound）接收，贡献者保留自己的版权。每个提交都必须按照 DCO 签署（git commit -s），详见 CONTRIBUTING.md。

背景

上游 minio/mc 仓库在 2025 年最后一条开发线后归档。Pigsty 维护此分支，是因为 Silo 需要可复现的配套客户端发布渠道，而不能继续依赖已经归档的上游项目。

相关上游变化、替代方案评估与早期分支维护记录见以下文章：

文章	主题
MinIO已死	上游项目与发行模式的变化
MinIO已死，谁能接盘？	可选替代方案评估
MinIO 已死，MinIO 复生	建立服务端与客户端发行流水线
续命 MinIO：承诺兑现	初期安全与维护工作

许可证、署名与商标

客户端源码依据 GNU Affero 通用公共许可证第 3 版或任何后续版本分发。本分支衍生自 minio/mc：NOTICE 保留上游产品声明，CREDITS 记录所含第三方组件的许可证与声明，Git 历史记录下游修改。

MinIO 是 MinIO, Inc. 的商标；本文仅为标识上游项目与兼容谱系而使用该名称。Pigsty、Silo、pgsty/mc 与 mcli 均为独立社区项目，与 MinIO, Inc. 不存在隶属、背书或赞助关系。

门户另行发布项目的许可证摘要、文档署名归属与商标声明。