如何在本地局域网缓存Composer包？搭建Satis镜像服务器！-composer-PHP中文网

satis不是局域网实时缓存服务器，而是静态快照分发工具，需web服务器托管packages.json和zip文件，不代理请求、不自动同步，仅支持手动构建与离线分发。

如何在本地局域网缓存composer包？搭建satis镜像服务器！

“本地局域网缓存”不等于“Satis 镜像服务器”

你没法用 Satis 实现真正的局域网实时缓存——它不代理请求、不监听端口、不自动同步 packagist.org。所谓“Satis 镜像服务器”，其实是把一堆静态文件（packages.json + dist/*.zip）扔到局域网某台机器的 Web 服务下，供其他机器通过 HTTP 访问。本质是“快照分发”，不是“动态缓存”。

如果目标是让团队所有开发机、CI 机器在没外网时也能 composer install，那 Satis 是可行路径；但如果想做到“第一次拉过某个包，下次自动走本地缓存”，Satis 做不到——它不会拦截 composer require foo/bar 并去 upstream 拉取再存一份。

真正支持透明代理/缓存的方案：阿里云 packagist-mirror、JFrog Artifactory、Nexus Repository（需配 Composer proxy repository）
Satis 只适合：已知要哪些包 + 哪些版本 + 能接受手动触发更新
别在 composer.json 里写 {"type":"path","url":"./packages/*"} —— 这根本不是局域网共享，只是本机软链接，其他机器访问不了

satis build 后为什么其他机器访问 packages.json 404？

绝大多数 404 不是网络不通，而是 Web 服务器没对齐 Satis 的输出结构。Satis 生成的是纯静态文件，不带任何路由逻辑，路径必须严丝合缝。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

output-dir 在 satis.json 里写的是 /var/www/satis，但 Nginx 的 root 指向的是 /var/www/html → 请求 https://satis.internal/packages.json 实际落到 /var/www/html/packages.json，当然 404
Nginx/Apache 没配置 application/json MIME 类型 → 返回 text/plain，Composer 解析失败，报 invalid repository type
URL 少了末尾斜杠："url": "https://satis.internal" 会导致 Composer 拼成 https://satis.internal/packages.json（正确应为 https://satis.internal//packages.json），而 Web 服务器通常会 301 重定向或直接 404
没把 packages.json 设为默认索引文件，访问根路径 https://satis.internal/ 时服务器去找 index.html，但 Satis 默认不生成这个文件

客户端 composer.json 怎么写才让局域网机器生效？

必须改项目级 composer.json，全局配置（composer config -g）在 CI 或 Docker 构建中常失效，且无法按项目差异化控制。

repositories 必须是顶层字段，不能嵌套在 require 或其他字段里
写法必须是：
```
{"type": "composer", "url": "https://satis.internal/"}
```
——注意 url 末尾的 /，缺一不可
务必加 "packagist.org": false，否则同名包（比如 monolog/monolog）仍会从官方源拉，覆盖你本地的版本
私有源要放在 repositories 数组第一位，Composer 按顺序查找，找到就停，不会合并
删掉 vendor/ 和 composer.lock，再跑 composer install，否则旧 lock 文件可能还记着 packagist.org 的 URL

离线环境用 file:// 协议行不行？

可以，但只适用于单机临时验证，不适合局域网部署。因为 file:// 协议不走 HTTP，很多 Composer 功能（如压缩包校验、HTTP 头判断）会降级或失效。

正确用法：
```
"url": "file:///mnt/nas/satis/"
```
（Linux/macOS，三个斜杠，绝对路径）
Windows 下路径要转义：
```
"url": "file://C:/satis/"
```
（两个斜杠，盘符后跟斜杠）
问题：ZIP 包里的 autoload 信息可能解析异常；composer update 会跳过某些校验；CI 工具（如 GitLab Runner）通常禁用 file:// 协议
真要局域网可用，老老实实用 Nginx 托管，哪怕只是内网 IP + 自签名证书

最容易被忽略的点：Satis 生成的 ZIP 包路径是硬编码在 packages.json 里的，比如 "dist": {"url": "https://satis.internal/dist/acme-utils/1.2.3-zip-hash.zip"}。如果你改了 Nginx 的 root 或用了子路径，这些 URL 全都失效，composer install --prefer-dist 会退回到 clone Git，而 Git 仓库在内网很可能根本不可达。