Composer客户端无法自主选节点，因其只认固定URL、不测速不探活不解析GEO-IP，所有请求均无差别发往配置域名解析出的IP，地理路由必须由Cloudflare Workers等反向代理层实现。
Composer 本身不支持多节点调度或地理路由，所谓“全球加速”必须由反向代理层实现——Cloudflare Workers 是目前最轻量、零运维的可行方案。
为什么 Composer 客户端无法自己选节点
Composer 只认一个固定 URL，比如 https://packagist.org 或你配置的镜像地址 https://composer.mirror.example.com。它不会测速、不探活、不解析 GEO-IP，所有请求都无差别发往该域名解析出的 IP。即使你在 DNS 层做了智能调度，只要 Composer 发出的 HTTP Host 和目标 URL 不变，它就完全感知不到后端有多少个机房、哪个最近。
- 执行
composer config -g repo.packagist composer https://my-worker.example.com后，所有composer install请求都会打到这个域名，后续怎么分发、缓存、回源，全靠 Workers 处理 - 本地运行
composer update --refresh只清空vendor/composer/installed.json和packages.json缓存，不影响请求发出的目标地址 - CI 构建容器、开发机、测试服务器网络环境不同，同一配置可能走完全不同的物理链路——这点最容易被忽略
Workers 镜像代理的核心实现逻辑
关键不是“转发”，而是“协议兼容 + 缓存穿透 + 路径重写”。Docker Registry V2 协议和 Composer 的 Packagist API 行为差异很大，不能简单 fetch() 就完事。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须保留原始请求的
Accept、Authorization（如私有包 token）、User-Agent等头，否则 Packagist 会返回 403 或降级响应 -
GET /packages.json这类元数据接口需设置短缓存（如Cache-Control: public, max-age=600），避免频繁触发 Worker 执行 - 对
GET /p/{vendor}/{package}/$VERSION.json这类包信息请求，要检查if-none-match并正确返回304 Not Modified，否则 Composer 会重复下载 - 实际包文件（
.zip或.tar）建议用cacheEverything()强制边缘缓存，但需确保响应头含Content-Length和Content-Type
缓存命中率低的常见原因
Workers Cache 默认只缓存 GET/HEAD 请求，且受响应头严格控制。很多开发者部署后发现“没加速”，其实是缓存根本没生效。
- 上游 Packagist 返回的响应缺少
Cache-Control，或设为no-store，导致 Workers 不缓存 —— 必须在 Worker 中手动覆写：response.headers.set('Cache-Control', 'public, max-age=3600') - 请求带了动态 query 参数（如
?t=123456），每个请求 URL 都不同，缓存 key 无法复用 —— 应在fetch()前 strip 掉无意义参数 - 使用了
env.CACHE.put()但没等异步完成就返回响应，导致缓存写入失败 —— 必须await或用Promise.all([response, cachePut]) - 免费计划下，
env.CACHE实际是共享缓存池，高并发时可能被挤出 —— 对关键元数据建议加一层 KV 存储兜底
真实部署时容易漏掉的细节
Workers 代理 Composer 镜像，看似简单，但几个小点没处理好，就会导致 composer install 卡住、报错或拉错版本。
- 必须透传
Range请求头，否则大包分块下载失败 —— Packagist 支持断点续传，Worker 要原样转发 - 对
POST /search这类非幂等请求，不能缓存，且要确保 body 正确传递（request.arrayBuffer()而非text()） - 某些私有包仓库返回 302 重定向，Worker 默认不跟随 —— 需显式设置
redirect: 'follow'并注意跨域限制 - Cloudflare 默认对非标准 MIME 类型（如
application/vnd.php.symfony-composer+json）做压缩，可能破坏 JSON 结构 —— 应禁用：response.headers.delete('content-encoding')
真正难的不是写几行 fetch()，而是让每个 Packagist 协议细节在边缘节点上严丝合缝地跑通。一旦某个 header 漏传、某个状态码没透传、某个缓存策略写错，Composer 就会静默失败或降级行为——这种问题往往只在 CI 环境里暴露，本地还测不出来。
