如何在本地搭建一个极简的Composer仓库服务器_使用Satis或Toran Proxy进行快速本地镜像

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。

执行后会在当前目录生成 satis 文件夹，包含所有运行所需文件。

步骤二：配置 satis.json

在 satis 目录下创建或修改 satis.json，定义你要镜像的包：

关键字段说明：

• repositories：列出你要抓取的源，可以是 Git 地址或其它 Composer 源
• require-all：自动包含 packagist.org 上所有公开包（谨慎使用，可改为 require 列表限定）
• archive：启用归档功能，将包打包成 tar 放入 dist 目录，加快客户端安装速度

如果只同步特定包，建议使用 require 明确列出：

步骤三：生成静态仓库

运行 build 命令生成文件：

Otter.ai

一个自动的会议记录和笔记工具，会议内容生成和实时转录

91

查看详情

这会把生成的 index.html 和 packages.json 输出到 web/ 目录，同时下载并归档指定包到 web/dist/。

步骤四：配置 Web 服务器

以 Nginx 为例，配置虚拟主机指向 web/ 目录：

重启 Nginx 后，访问 http://satis.local 应能看到仓库首页。

步骤五：在项目中使用本地仓库

在你的 PHP 项目 composer.json 中添加仓库配置：

执行 composer install 时，Composer 会优先从本地仓库拉取信息和包文件，显著提升安装速度。

Toran Proxy 简要说明（已归档）

Toran Proxy 曾是带缓存和 Web 界面的代理方案，支持同步 Packagist 并管理私有包，但它已于 2018 年停止维护。虽然仍可运行，但不推荐用于新项目。Satis 加反向代理（如 Nginx 缓存）已能满足大多数本地镜像需求。

基本上就这些。Satis 虽然功能朴素，但足够稳定高效，适合快速搭建一个可靠的本地 Composer 源。定期通过 cron 自动运行 build 命令，还能实现增量更新。

以上就是如何在本地搭建一个极简的Composer仓库服务器_使用Satis或Toran Proxy进行快速本地镜像的详细内容，更多请关注php中文网其它相关文章！