私有Packagist异地灾备必须采用「元数据中心化 + 分发边缘化」架构，即以Artifactory或Nexus Repository 3为唯一元数据写入点，两地Nginx仅作只读代理与缓存，禁用Satis多实例同步；备份需打包整个web/目录并验证结构完整性；回滚时须确保URL结尾斜杠、仓库类型为composer、清除本地Composer缓存。
私有Packagist异地灾备不能靠Satis多实例同步
直接部署多个Satis节点并用Nginx轮询，会导致元数据不一致、packages.json损坏、客户端解析失败——Satis本质是单机快照生成器，没有分布式协调能力。异地灾备必须放弃“多台Satis自动同步”这种思路。
常见错误现象：
-
satis build在A地跑完，B地节点仍用旧packages.json，Composer拉取时出现版本错乱或404 - 两地同时构建，
packages.json文件内容不同，客户端缓存命中不同节点后install结果不一致 - dist包URL拼接错误（如少斜杠），导致
https://pkgs-bj.example.compackages.json（404）
真正可行的异地灾备架构，核心是「元数据中心化 + 分发边缘化」：
- 用Artifactory或Nexus Repository 3作为唯一元数据写入点，所有
git tag发布都只推送到这一个中心 - 两地各部署一套Nginx + 只读缓存层，配置
proxy_cache缓存packages.json和provider-*.json，TTL设为300s - 两地Nginx upstream指向同一中心仓库，但启用
proxy_next_upstream error timeout http_500实现故障自动切换 - Git Hook（pre-receive）统一校验tag格式，拒绝
v1.2等非法格式，从源头避免元数据污染
packages.json备份必须包含完整路径与时间戳
只备份web/packages.json文件本身没用——它依赖同目录下provider-*.json、includes/*及dist包URL路径结构。一旦缺失任意一层，composer install会卡在“Resolving dependencies”不动。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 每次
satis build后，用tar -czf satis-backup-$(date +%Y%m%d-%H%M).tar.gz web/打包整个web/目录 - 备份包里必须含
index.html（用于HTTP服务健康检查）和.htaccess（若用Apache） - 记录构建时的
satis.json哈希值：sha256sum satis.json > satis.json.sha256，回滚时比对是否匹配 - 验证备份可用性：临时起一个Python HTTP server（
python3 -m http.server 8000 --directory web/），然后curl http://localhost:8000/packages.json | jq .name确认能解析
回滚时最容易被忽略的三个断点
元数据恢复成功 ≠ Composer能正常拉包。以下三点漏掉任一，都会导致静默失败：
-
repositoriesURL必须以/结尾，例如https://pkgs-sh.example.com/；写成https://pkgs-sh.example.com会让Composer拼出https://pkgs-sh.example.compackages.json（404） - Artifactory/Nexus的Composer仓库类型必须是
composer，不是generic或npm——只有composertype才生成标准packages.json结构 - 回滚后必须清掉
~/.composer/cache/repo/下对应路径的缓存，否则Composer仍按旧索引解析，composer update找不到新tag
最稳妥的清理方式：rm -rf ~/.composer/cache/repo/https---pkgs-sh.example.com（注意把/替换成---）
异地元数据一致性靠HTTP头+ETag，不是定时rsync
不要用rsync -avz定期同步web/目录——文件系统级同步无法保证packages.json与provider-*.json原子性更新，极易出现中间态损坏。
正确做法是让两地Nginx都代理到同一个中心仓库，并依赖HTTP协议保障一致性：
- 中心仓库返回
ETag和Last-Modified头，Nginxproxy_cache自动识别变更 - 两地Nginx配置相同
proxy_cache_key "$scheme$request_method$host$request_uri"，确保缓存键一致 - 中心仓库升级时，先停写、等两地缓存自然过期（300s）、再重启写入，避免窗口期不一致
如果非得离线传输，用curl -sS https://pkgs-center.example.com/packages.json -o packages.json.tmp && mv packages.json.tmp packages.json这类原子替换，而不是覆盖写入。
