需用Satis构建静态镜像并严格配置三项——require-all为true、archive块完整、repositories中每个私有包单独声明type；全局镜像必须设为repo.packagist且含type和https结尾斜杠，项目级repositories也须注册同名内网源。
不能直接“同步 Packagist 官方镜像”——你真正需要的是一个可被 Composer 正确识别的、支持语义化版本查询的 HTTP 服务，而不是 rsync 或 git clone 一堆文件。
为什么 path 协议在局域网里完全无效
很多人在 composer.json 里写 {"type": "path", "url": "./packages/*"}，以为把 ZIP 放进共享目录就能用。实际它只在当前机器本地文件系统生效：
- 该配置不启动任何 HTTP 服务，其他机器无法通过
http://访问 -
file://协议在 Docker、CI 构建机、不同用户权限下基本不可用 - 不生成
packages.json元数据，composer require monolog/monolog会直接报Could not find package - 删掉本地目录，整个依赖树就崩，毫无容错和复用能力
必须用 Satis 构建静态镜像，且三个字段缺一不可
Satis 是唯一轻量、稳定、真正可用的局域网方案。它生成纯静态文件（packages.json + dist/*.zip），扔到 Nginx 就能被所有机器访问。但以下三处配置漏掉任意一个，composer install 就会拉不到 zip 包或找不到版本：
-
"require-all": true——否则只同步composer.json里显式require的包，私有仓库里的其他 tag、dev 分支、历史版本全丢 -
"archive"块必须完整：{"directory": "dist", "format": "zip", "skip-dev": true}——缺这个，CI 构建时只能走git clone，而内网往往禁用 git 协议 -
"repositories"必须是对象数组，每个私有包要单独声明类型：{"type": "vcs", "url": "https://gitlab.internal/internal-sdk"}——写成字符串 URL 或漏掉type，Satis 构建时直接跳过该仓库
全局镜像必须设为 repo.packagist 且含 type 和 https 结尾斜杠
项目级 repositories 也须注册同名内网源。运行 composer config -g repo.packagist，输出必须是类似：
{"type":"composer","url":"https://packagist.internal/"}
注意几个关键点：
- 键名必须是
repo.packagist（不是repos.packagist或packagist.org） -
type字段不能丢，否则 Composer 静默 fallback 回官方源 -
url必须带https://和末尾斜杠；http://在新版 Composer 默认被拒绝，除非加--allow-http - 如果输出为空或报错，说明全局配置根本没写入；常见原因是 PHP 禁用了
proc_open或putenv，需检查php.ini并重启 PHP 服务
最常被忽略的一点：即使 Satis 已跑通，若项目 composer.json 中存在 repositories 字段，它会**完全屏蔽**全局镜像配置——此时必须在项目级显式声明同名内网源，并确保 "packagist" 作为 key、"type": "composer" 存在、URL 以 / 结尾，否则 Composer 仍静默回退到 packagist.org。
