社区维护的MinIO Client(mc)分支,提供与S3兼容的对象存储管理功能,支持文件系统和云存储操作,可替代ls、cp等传统Unix命令。
mcli
A conservatively maintained MinIO Client fork Versioned client builds and compatible administration tooling for Silo, Pigsty, and S3-compatible object storage.
Website · Documentation · Download · Blog · https://github.com/pgsty/mc/releases · Security · https://github.com/pgsty/mc/blob/master/README_zh_CN.md
Important
pgsty/mc is an independent, community-maintained fork of the open-source https://github.com/minio/mc, published by Pigsty. It is not affiliated with, endorsed by, or sponsored by MinIO, Inc. “MinIO” is used only to identify the upstream project and compatibility lineage.
Overview
pgsty/mc maintains one downstream release line based on the archived upstream MinIO Client branch at https://github.com/minio/mc/commit/77f82e18b5401a65958f1619df6ebb994634bd88. It provides maintained client builds after the upstream repository was archived.
This fork exists so Silo and Pigsty deployments have a compatible CLI that can be built, patched, tested, and released through the same maintained supply chain. It also remains a general-purpose client for filesystems and Amazon S3-compatible object stores.
The official project portal is silo.pgsty.com. It brings the client reference, downloads, release and security notes, and project legal information together. English is served at the site root; Chinese is available under /zh/.
Find the Right Resource
| Looking for | Canonical location |
|---|---|
| Project overview and navigation | Silo Website (中文) |
mcli installation methods and downloads | Download & Install (中文) |
| Client and administration command reference | mcli reference and mcli admin reference (中文) |
| Project news, release notes, and security notes | Blog, including releases and security |
| Versioned archives, packages, checksums, and source | https://github.com/pgsty/mc/releases |
| Bug reports and feature discussions | https://github.com/pgsty/mc/issues |
| Vulnerability reporting | Security Policy |
| License, attribution, and trademark information | https://github.com/pgsty/mc/blob/master/LICENSE, https://github.com/pgsty/mc/blob/master/NOTICE, https://github.com/pgsty/mc/blob/master/CREDITS, and the portal's License, Attribution, and Trademark pages |
Maintenance Policy
The active master release line covers:
- build, toolchain, and dependency maintenance;
- applicable security fixes and sensitive-output hardening;
- focused fixes for reproducible defects and Silo interoperability;
- versioned archives, Linux packages, checksums, and multi-architecture images;
- release automation, documentation, and Pigsty integration.
Changes are kept narrow and tested where practical. Maintenance is best effort; no response, remediation, or release schedule is guaranteed.
Out of scope
- a separate client roadmap, new object-storage protocol, or speculative commands;
- broad rewrites or changes that materially expand the downstream delta;
- historical releases or multiple support branches;
- commercial support, SLAs, 24×7 coverage, or SUBNET services;
- guaranteed compatibility with every S3 implementation or future proprietary MinIO API.
Compatibility
This fork aims to preserve:
- the
github.com/minio/mcmodule path,~/.mcconfiguration, and familiar command behavior; - S3 Signature V2/V4 access and common MinIO/Silo administration workflows;
RELEASE.YYYY-MM-DDTHH-MM-SSZtags and themccontainer entrypoint;- the
mcname for source builds, while standalone archives and Linux packages usemcli; the Silo image provides both names.
The mc update command is intentionally disabled. Upgrade through the Pigsty package repository or https://github.com/pgsty/mc/releases.
Compatibility is a goal, not a guarantee. Server-specific administration commands may vary across versions. Pin releases, review the release notes, keep a rollback path, and test the client against the target service before production use.
Downloads and Release Artifacts
Use Download & Install to choose a client installation method. GitHub Releases remains the source for versioned archives, packages, checksums, and source archives.
| Artifact | Location |
|---|---|
| Source | https://github.com/pgsty/mc |
| Standalone archives | https://github.com/pgsty/mc/releases, providing mcli for Linux, macOS, and Windows on amd64 and arm64 |
| Linux packages | RPM, DEB, and APK for x86_64/aarch64, also distributed through the Pigsty repository |
| Container image | https://hub.docker.com/r/pgsty/mc, multi-arch for linux/amd64 and linux/arm64, with mc as the entrypoint |
| Silo bundle | https://hub.docker.com/r/pgsty/minio includes the client as mcli with an mc compatibility alias |
| Documentation | Client command reference and administration command reference |
Quick Start
Standalone archives and Linux packages expose the command as 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
The container retains the familiar mc entrypoint:
docker run --rm pgsty/mc:latest --version docker run --rm pgsty/mc:latest ls play
Warning
For production, pin a release instead of latest, verify checksums, use TLS and least-privilege credentials, and test destructive commands against non-production data first.
Build from source:
git clone https://github.com/pgsty/mc.git cd mc make build ./mc --version
Common Commands
| Command | Purpose |
|---|---|
alias | Configure credentials and endpoints |
ls, tree, stat, du | Inspect buckets, objects, and local files |
mb, rb | Create or remove buckets |
cp, get, put, mv, rm | Transfer and manage objects |
mirror, diff, find | Synchronize, compare, and search data |
anonymous, share | Manage anonymous access and temporary URLs |
version, retention, legalhold, ilm | Manage data-protection policies |
replicate | Configure bucket replication |
admin | Operate compatible MinIO/Silo servers |
Run mcli --help, mcli <command> --help, or consult the client reference for the complete command set.
Contributing
Useful contributions include security and dependency updates, reproducible bug fixes, interoperability tests, release automation, packaging, and documentation.
Issues and pull requests should include the affected client and server versions, reproduction steps, impact, expected behavior, tests, and compatibility notes. Discuss large changes in an issue first.
Background
The upstream https://github.com/minio/mc repository was archived after its final 2025 development line. Pigsty maintains this fork because Silo needs a reproducible companion client release channel rather than depending on an archived upstream project.
The broader upstream changes, alternatives ***ed, and early fork maintenance record are documented below:
| Essay | Subject |
|---|---|
| MinIO Is Dead | Changes to the upstream project and distribution model |
| MinIO Is Dead, Long Live MinIO | Establishing the server and client release pipeline |
| Two months into maintaining a MinIO fork | Initial security and maintenance work |
License, Attribution, and Trademark
The client source is distributed under the https://github.com/pgsty/mc/blob/master/LICENSE. This fork derives from https://github.com/minio/mc: https://github.com/pgsty/mc/blob/master/NOTICE retains the upstream product notice, https://github.com/pgsty/mc/blob/master/CREDITS records licenses and notices for included third-party components, and the Git history records downstream modifications.
MinIO is a trademark of MinIO, Inc. The name is used here only to identify the upstream project and compatibility lineage. Pigsty, Silo, pgsty/mc, and mcli are independent community efforts and are not affiliated with, endorsed by, or sponsored by MinIO, Inc.
The portal separately publishes the project license summary, documentation attribution, and trademark notice.
pgsty 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务