Satis本身不支持高可用，因其是无状态静态生成器，不监听端口、不连数据库、不处理并发请求；所谓高可用实为将生成的packages.json与dist文件通过共享存储同步至多台Nginx节点，并配置健康检查与负载均衡实现基础设施层高可用。
Satis 本身没有高可用能力，所谓“高可用”是静态产物 + 基础设施层的组合方案，不是给 satis build 加集群就能解决的。
为什么 satis build 不能直接上负载均衡
Satis 是静态生成器：它不监听端口、不连数据库、不处理并发请求，只输出 packages.json 和 dist/ 下的 ZIP 文件。你无法对 satis build 做健康检查，也无法让它自动同步状态——它压根没状态。
常见错误现象：composer install 随机失败，日志里出现 file_get_contents(): failed to open stream: Connection refused 或超时，根本原因不是 Satis 挂了，而是你只部署了一台 Nginx，且没配健康探测和故障转移。
- 所有 Web 节点必须托管完全一致的静态文件，否则
packages.json里写的distURL 会指向一个不存在的 ZIP，导致下载卡在Downloading (connecting) - 必须用共享存储（如 NFS、MinIO、S3）挂载
web/目录，不能靠 rsync 定时推——有延迟就会不一致 - 每个节点的 Nginx 必须禁用 PHP 解析，目录权限设为只读，防止被上传恶意文件
Nginx upstream 怎么配才真正扛住单点故障
前端反向代理不是加个 upstream 就完事。关键在于让 Composer 客户端感知不到后端切换，同时让 Nginx 主动剔除坏节点。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 启用
max_fails=2 fail_timeout=30s，避免瞬时抖动误判 - 用
location = /packages.json做探针：这个路径轻量、可缓存、返回快，比全量 GET/更准 - 所有节点必须返回一致的
Content-Type: application/json，否则 Composer 解析失败，但 HTTP 状态码仍是 200 - 别用
ip_hash：Composer 并发请求无 session，会导致流量倾斜，某节点过载而其他空闲
dist 包 URL 填错的三个致命细节
"archive": {"prefix-url": "https://cdn.example.com/dist/"} 这行看着简单，填错一个字符，整个私有包安装链就断掉。
-
prefix-url必须以/dist/结尾（注意末尾斜杠），否则生成的 ZIP URL 会变成https://cdn.example.comdist/xxx.zip——少了一个/，404 - 该域名必须能被 CI 构建容器、Docker 内网、GitLab Runner 等环境解析并直连，
localhost、未配/etc/hosts的短域名、或仅限浏览器访问的内网地址都不行 - CDN 或对象存储必须开启 CORS：
Access-Control-Allow-Origin: *，否则某些 GitLab CI with Docker-in-Docker 场景会因跨域拒绝下载 ZIP
客户端配置漏掉 packagist.org: false 就等于白搭
即使 Satis 仓库 100% 正常，项目里没关掉 Packagist 回退，composer require acme/internal-lib 成功了，composer update 却可能悄悄从 packagist.org 拉同名包——因为 Composer 默认合并所有源，按顺序找，但同名包只取第一个匹配版本，而官方源往往版本号更高。
- 必须在项目
composer.json顶层加"packagist.org": false，不是放在repositories里 - 私有源要放在
repositories数组第一位，顺序错了就优先走官方源 - 别信
composer config -g全局配置能覆盖项目级设置——项目composer.json里的repositories和packagist.org字段永远优先
最易被忽略的点：多节点间 packages.json 和 dist/ 文件的时间差。哪怕只有 1 秒不一致，就可能让某个构建拿到新 JSON 但旧 ZIP，报校验失败或 404。同步必须原子化，不能只同步 JSON 或只同步 ZIP。
