mc

pgsty/mc Docker Image

社区维护的MinIO Client(mc)分支,提供与S3兼容的对象存储管理功能,支持文件系统和云存储操作,可替代ls、cp等传统Unix命令。

下载次数: 0状态:社区镜像维护者:pgsty仓库类型:镜像最近更新:
下载命令
点击查看

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 forCanonical location
Project overview and navigationSilo Website (中文)
mcli installation methods and downloadsDownload & Install (中文)
Client and administration command referencemcli reference and mcli admin reference (中文)
Project news, release notes, and security notesBlog, including releases and security
Versioned archives, packages, checksums, and sourcehttps://github.com/pgsty/mc/releases
Bug reports and feature discussionshttps://github.com/pgsty/mc/issues
Vulnerability reportingSecurity Policy
License, attribution, and trademark informationhttps://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/mc module path, ~/.mc configuration, and familiar command behavior;
  • S3 Signature V2/V4 access and common MinIO/Silo administration workflows;
  • RELEASE.YYYY-MM-DDTHH-MM-SSZ tags and the mc container entrypoint;
  • the mc name for source builds, while standalone archives and Linux packages use mcli; 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.

ArtifactLocation
Sourcehttps://github.com/pgsty/mc
Standalone archiveshttps://github.com/pgsty/mc/releases, providing mcli for Linux, macOS, and Windows on amd64 and arm64
Linux packagesRPM, DEB, and APK for x86_64/aarch64, also distributed through the Pigsty repository
Container imagehttps://hub.docker.com/r/pgsty/mc, multi-arch for linux/amd64 and linux/arm64, with mc as the entrypoint
Silo bundlehttps://hub.docker.com/r/pgsty/minio includes the client as mcli with an mc compatibility alias
DocumentationClient 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

CommandPurpose
aliasConfigure credentials and endpoints
ls, tree, stat, duInspect buckets, objects, and local files
mb, rbCreate or remove buckets
cp, get, put, mv, rmTransfer and manage objects
mirror, diff, findSynchronize, compare, and search data
anonymous, shareManage anonymous access and temporary URLs
version, retention, legalhold, ilmManage data-protection policies
replicateConfigure bucket replication
adminOperate 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:

EssaySubject
MinIO Is DeadChanges to the upstream project and distribution model
MinIO Is Dead, Long Live MinIOEstablishing the server and client release pipeline
Two months into maintaining a MinIO forkInitial 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.

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 mc 镜像标签

docker pull docker.xuanyuan.run/pgsty/mc:<标签>

DockerHub 原生拉取命令

docker pull pgsty/mc:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告