satis不适合分布式镜像同步，因其生成静态索引、依赖全量重建、不支持增量更新、并发任务或跨节点协调；而packagist-mirror基于redis队列与多worker设计，支持自动同步、水平扩展及状态跟踪。
为什么 Satis 不适合分布式镜像同步
Satis 生成的是静态索引，所有包元数据和 ZIP 归档都靠 php bin/satis build 一次性拉取并写入文件系统。它不依赖 Redis，也不支持并发任务或增量更新——改一个包的 composer.json，必须全量重跑，无法监听上游变更、无法分片处理、无法跨节点协调。如果你需要“自动同步 packagist.org 全量包 + 支持多机水平扩展”，Satis 从架构上就不匹配。
packagist-mirror 要求的 Redis 配置细节
阿里云开源的 packagist-mirror 是 Go 实现的代理型镜像服务，Redis 不是用来缓存元数据的，而是作为任务队列和状态存储：新包发现、ZIP 下载、索引刷新都发到 Redis List（如 queue:sync），Worker 进程从队列取任务并更新 status:package:monolog/monolog 这类 Hash 字段。配置时必须注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
REDIS_ADDR必须可被所有 Worker 节点直连（不能是127.0.0.1） -
REDIS_DB建议固定为0，避免多个环境混用 DB 导致队列错乱 -
REDIS_PASSWORD若为空，packagist-mirror启动会报错，不能省略（即使 Redis 本身没设密） - Redis 内存需 ≥4GB，否则大量并发 ZIP 下载时
zset排序和hash状态写入会触发 OOM
如何部署多 Worker 节点分担同步压力
单个 packagist-mirror 进程只能消费一个队列，要水平扩展，得启动多个 Worker 实例，共用同一套 Redis 和 OSS 配置。关键实操点：
- 每个 Worker 必须用不同
--name启动，例如./packagist-mirror --name=worker-1，否则日志和指标会冲突 - OSS 的
OSS_BUCKET必须全局唯一，所有 Worker 往同一个 Bucket 写 ZIP，但路径按dist/{vendor}/{package}/{version}/自动隔离，无竞态 - 不要手动往
queue:syncpush 包名——它只接受 JSON 格式任务，且必须含name和version字段；正确做法是调用curl -X POST http://localhost:8080/api/v1/sync -d '{"name":"monolog/monolog","version":"^3.0"}' - Worker 日志里出现
processed 127 tasks, failed 0才算真正接入队列，只看进程存活不等于在工作
同步延迟与失败任务的手动干预
packagist.org 上新包平均 5–10 分钟同步到阿里云镜像，但 packagist-mirror 默认每 30 分钟轮询一次 upstream，且 GitHub API 限流（GITHUB_TOKEN 必须带 public_repo 权限）会导致部分包卡在 status:package:xxx 的 state 字段为 pending 超过 2 小时。此时需：
- 查失败任务：
redis-cli lrange queue:failed 0 -1，里面是 JSON 格式的原始错误堆栈 - 重试单个包：
redis-cli lpush queue:sync '{"name":"laravel/framework","version":"11.x-dev"}' - 清空积压队列（慎用）：
redis-cli del queue:sync，但必须先停所有 Worker，否则边删边进 - 别依赖
DATA_URL设成https://mirrors.aliyun.com/composer/——那是给下游用户用的，同步源必须设https://packagist.org/，否则永远拿不到最新包
redis-cli hgetall status:worker:worker-1 查 last_heartbeat 时间戳，超过 5 分钟没更新，就得重启对应实例——这点文档几乎不提，但线上稳定性全靠它。
