MinIO不能直接作为Composer镜像源，因其仅支持S3协议，不提供Packagist所需的动态元数据生成、版本约束解析、CORS与目录索引等能力；必须通过satis构建静态JSON和ZIP包并全量同步至MinIO，同时配置其为网站托管模式、开放匿名读取权限及正确处理HTTP头。
MinIO 不能直接作为 Composer 的镜像源后端——Composer 本身不支持对象存储协议（如 S3 API）作为包仓库，它只认 packagist.org 协议或自建的 composer/satis / composer/registry 服务。想用 MinIO 存包，必须在中间加一层适配层。
为什么不能直接把 vendor/ 或 .tar.gz 丢进 MinIO 就当镜像源
Composer 客户端在执行 composer install 或 composer update 时，会向指定的 repositories 地址发起 HTTP GET 请求，要求返回符合 Packagist JSON Schema 的元数据（如 packages.json、provider-xxx.json），并按固定路径规则拉取 ZIP 包（例如 /p/monolog/monolog/1.23.0.0.zip）。MinIO 虽然能托管这些文件，但缺三样关键能力：
- 不提供动态生成或聚合
packages.json的逻辑 - 不支持 Packagist 的 provider 查询、版本约束解析、dist 文件重定向等语义
- 默认不启用 CORS 和目录索引，客户端无法遍历或发现资源
可行方案：用 satis + MinIO 实现「静态镜像源」
satis 是官方推荐的私有镜像构建工具，它会拉取 Packagist 上指定包的元数据和 dist ZIP，生成静态 JSON 文件集，并把 ZIP 包推送到指定存储。MinIO 在这里只充当「静态文件托管后端」，不参与业务逻辑。
关键操作步骤：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在构建机上安装
composer/satis：composer create-project composer/satis --stability=stable - 编写
satis.json，明确指定要镜像的包名和版本约束，例如："require":{"monolog/monolog":"^2.0"} - 配置
archive输出为 ZIP，并设置homepage为你的 MinIO bucket 访问地址（如https://minio.example.com/my-mirror） - 运行
php bin/satis build satis.json ./build生成静态站点 - 用
awscli或mc工具将./build全量同步到 MinIO bucket：mc cp -r ./build/ myminio/my-mirror/ - 确保 MinIO bucket 开启了
public-read权限，并配置好反向代理（如 Nginx）处理Accept: application/json请求头与缓存头
MinIO 配置必须调整的几处细节
否则 satis 生成的链接会 403、404 或被浏览器拦截：
- 必须禁用 MinIO 的默认签名 URL 机制——satis 生成的是纯路径链接，不带
X-Amz-Signature参数，所以 bucket policy 要显式允许s3:GetObject对所有*key 的匿名读取 - 必须开启 bucket 的网站托管模式（
mc website命令），否则packages.json等无后缀文件会被拒绝服务（MinIO 默认不识别 MIME 类型） - 如果走 HTTPS 反代，Nginx 需透传
Accept头，并添加add_header Access-Control-Allow-Origin "*";，否则前端 JS 加载失败 - 不要用
mc mirror增量同步——satis 每次 build 会重写整个packages.json，必须全量覆盖，否则旧版本引用残留导致解析错乱
替代思路：用 minio + nginx + php-fpm 模拟 Packagist 接口（不推荐）
有人尝试用 PHP 脚本读 MinIO 列表、拼 JSON、代理 ZIP 下载，但很快会暴露问题：
- Provider 文件需按哈希分片（如
provider-2020-01.json），手动维护极难 - 不支持
composer require foo/bar:dev-main这类分支解析 - 没有包依赖图谱缓存，每次请求都要 listObjectsV2，延迟高且易触发 MinIO 限流
- 无法处理
composer.lock中的dist.shasum校验，因为 satis 生成的 ZIP 名含 hash，而 MinIO 存的是原始名
真正落地的团队基本都退回 satis + MinIO 静态托管这条路。复杂点在于 satis 构建周期长、占用磁盘大，容易被忽略的是：MinIO 的 ETag 不等于 ZIP 的 MD5（MinIO 对 multipart upload 返回的是 multipart ETag），所以不要拿 ETag 去校验 dist.shasum 字段——得用 mc stat 查 x-amz-meta-md5 自定义头，或者干脆让 satis 用 archive.format: zip 并关闭压缩校验。
