Satis本身不支持高可用因其是静态生成器，无运行时服务；但可通过将生成的静态文件同步至多台Web节点+Nginx负载均衡与健康检查实现基础设施层高可用。
为什么 Satis 本身不支持高可用，但能搭出高可用？
Satis 是静态生成器，不是运行时服务，它不提供 API、不连数据库、不处理并发请求——所以“Satis 高可用”本质是**静态产物 + 基础设施层的高可用**。你无法给 satis build 加集群，但可以把生成的 packages.json、dist/ 文件同步到多个 Web 节点，再用 Nginx 做负载均衡和健康检查。
常见错误现象：composer install 随机失败，日志里出现 file_get_contents(): failed to open stream: Connection refused 或超时，往往是因为只部署了单台 Nginx，且没配缓存或健康探测，一宕就全挂。
- 必须把
web/（或public/）目录挂载到共享存储（如 NFS、MinIO、S3），否则多节点间文件不一致，packages.json和实际 ZIP 包 URL 对不上 - 所有 Web 节点的 Nginx 必须禁用 PHP 解析，目录权限设为只读，防止被上传恶意文件
- 前端反向代理（如 Nginx
upstream）要启用max_fails=2 fail_timeout=30s，并用location = /packages.json做快速健康探针
dist 包托管路径怎么配才不翻车？
"archive": {"prefix-url": "https://cdn.example.com/dist/"} 这个字段看着简单，但填错会导致所有私有包 composer install 时卡在 Downloading (connecting...)，因为 Composer 会直接 GET 这个 URL 下的 ZIP，而不会走你的 Satis 域名。
关键约束：
-
prefix-url必须以/dist/结尾（注意斜杠），否则生成的dist.url会拼错，比如变成https://cdn.example.comdist/xxx.zip - 该域名必须可公开访问（即使内网，也要确保 CI 机器、Docker 构建容器能解析并连通），不能是
localhost或未配置 hosts 的短域名 - CDN 或对象存储需开启 CORS，响应头含
Access-Control-Allow-Origin: *，否则某些 CI 环境（如 GitLab Runner with Docker-in-Docker）会因跨域拒绝下载 - 别用 GitHub Pages 托管 dist 包——它不支持自定义 MIME 类型，ZIP 下载可能被识别成
text/plain，触发 Composer 校验失败
如何让团队安全地用上私有仓库，又不污染公共源？
最常踩的坑是：在项目 composer.json 里写 "repositories": [{"type": "composer", "url": "https://satis.internal/packages.json"}]，却不关掉 Packagist 回退——结果 composer require company/internal-lib 成功了，但某天 composer update 却悄悄从 packagist.org 拉了个同名但被废弃的公共包，覆盖了内部版本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法是显式禁用默认源：
- 在项目
composer.json中加："repositories": [{"type": "composer", "url": "https://satis.internal/packages.json"}, {"packagist.org": false}] - CI 环境统一设环境变量：
COMPOSER_REPO_PACKAGIST=https://satis.internal/packages.json，避免本地开发误配 - 敏感包（如密钥管理 SDK）在 Satis 配置中加
"private": true，并在composer.json里用"abandoned": "company/legacy-auth"标记废弃包，防止被意外 require - 所有私有包的
composer.json必须声明"type": "library"和明确的"license"，否则 Satis 生成的元数据可能缺失字段，导致composer show报错
CI 自动构建时，为什么 satis build 总是慢或内存溢出？
当私有仓库接入 50+ 个 Git 仓库、含大量 dev 分支或历史 tag 时，php bin/satis build 默认行为会扫描全部版本、下载全部 composer.json、尝试解析全部依赖树——这极易触发 PHP 内存限制或超时。
提速关键在 satis.json 的精准裁剪：
- 设
"require-all": false，改用"require": {"company/core": "dev-main", "company/api-client": "^2.1"}显式列出需要发布的包及版本约束 - 加
"only-best-candidates": true，跳过同一包的多个 patch 版本（如1.0.0,1.0.1,1.0.2只留1.0.2） - 归档格式切为
"format": "tar"（比 zip 快 3–5 倍），并关掉"checksum": false（校验由 CDN 或对象存储做更可靠） - CI 脚本开头强制调大限制：
php -d memory_limit=3G -d max_execution_time=3600 bin/satis build satis.json public/
真正难搞的不是构建慢，而是构建结果不可重现：如果 satis.json 里引用了 "type": "vcs" 的 SSH 地址，但 CI runner 没配好 SSH agent forwarding 或密钥权限，build 就会静默跳过那个仓库——建议所有 VCS 仓库改用 HTTPS + Personal Access Token，并把 token 存进 CI secrets，URL 写成 https://token:x-oauth-basic@gitlab.example.com/company/lib.git。
