Satis可快速搭建轻量级本地Composer镜像服务器，通过PHP和Nginx部署，生成静态文件供内网共享，支持私有包与归档加速，适合中小型团队使用。
在企业内网或开发团队中，为了提升依赖下载速度、避免外部网络中断影响构建流程，或者出于安全合规考虑，搭建一个本地的 Composer 仓库镜像非常实用。Satis 和 Toran Proxy 是两种常见方案，前者轻量静态，后者功能更全但已停止维护。下面介绍如何用 Satis 快速搭建一个极简本地 Composer 镜像服务器。
选择 Satis：轻量、静态、易于部署
Satis 是官方推荐的“静态包列表生成器”，它会根据配置抓取指定的 Composer 包，并生成一个可被 Composer 客户端识别的 packages.json 文件，配合 Web 服务器即可对外提供服务。
核心优势：
- 部署简单，仅需 PHP 环境和 Web 服务（如 Nginx）
- 生成静态文件，适合 CDN 或内网共享
- 支持私有包和 GitHub 私有仓库（通过 OAuth Token）
- 资源占用低，适合小到中型团队使用
步骤一：安装 Satis
确保系统已安装 PHP 和 Composer。
composer create-project composer/satis --no-interaction执行后会在当前目录生成 satis 文件夹，包含所有运行所需文件。
步骤二：配置 satis.json
在 satis 目录下创建或修改 satis.json，定义你要镜像的包：
{ "name": "My Private Composer Repository", "homepage": "http://satis.local", "repositories": [ { "type": "vcs", "url": "https://github.com/your-company/your-private-lib" }, { "type": "composer", "url": "https://packagist.org" } ], "require-all": true, "archive": { "directory": "dist", "format": "tar", "skip-dev": true } }关键字段说明：
- repositories：列出你要抓取的源，可以是 Git 地址或其它 Composer 源
- require-all：自动包含 packagist.org 上所有公开包（谨慎使用，可改为 require 列表限定）
- archive：启用归档功能，将包打包成 tar 放入 dist 目录，加快客户端安装速度
如果只同步特定包，建议使用 require 明确列出：
步骤三：生成静态仓库
运行 build 命令生成文件：
php bin/satis build satis.json web/这会把生成的 index.html 和 packages.json 输出到 web/ 目录，同时下载并归档指定包到 web/dist/。
步骤四：配置 Web 服务器
以 Nginx 为例，配置虚拟主机指向 web/ 目录：
server { listen 80; server_name satis.local; root /path/to/satis/web; index index.html; location / { try_files $uri $uri/ =404; } }重启 Nginx 后，访问 http://satis.local 应能看到仓库首页。
步骤五：在项目中使用本地仓库
在你的 PHP 项目 composer.json 中添加仓库配置：
{ "repositories": [ { "type": "composer", "url": "http://satis.local" } ], "require": { "monolog/monolog": "^2.0" } }执行 composer install 时，Composer 会优先从本地仓库拉取信息和包文件，显著提升安装速度。
Toran Proxy 简要说明（已归档）
Toran Proxy 曾是带缓存和 Web 界面的代理方案，支持同步 Packagist 并管理私有包，但它已于 2018 年停止维护。虽然仍可运行，但不推荐用于新项目。Satis 加反向代理（如 Nginx 缓存）已能满足大多数本地镜像需求。
基本上就这些。Satis 虽然功能朴素，但足够稳定高效，适合快速搭建一个可靠的本地 Composer 源。定期通过 cron 自动运行 build 命令，还能实现增量更新。
