如何通过Satis或Private Packagist搭建公司内部的Composer镜像？

推荐小团队用Satis（轻量免费、需自维护），中大型企业选Private Packagist私有部署版（功能全、权限细、支持实时同步与生命周期管理）。

直接用 Satis 或 Private Packagist 搭建公司内部 Composer 镜像，核心是让私有包能被 composer install 正常拉取，同时兼顾安全、可控和可维护性。Satis 轻量免费但需自行托管维护；Private Packagist 功能完整、支持 Web UI 和细粒度权限，但为商业服务（也提供私有部署版）。

用 Satis 快速搭建静态镜像

Satis 是一个静态生成器，它扫描你指定的 Git 仓库（如 GitHub、GitLab、私有 Gitee），生成符合 Composer Repository 协议的 packages.json 和压缩包归档，整个结果可直接用 Nginx/Apache 托管。

• 安装 Satis：composer create-project composer/satis --stability=stable
• 编写 satis.json，例如：

  {
    "name": "acme/internal-packages",
    "homepage": "https://packages.acme.com",
    "repositories": [
      { "type": "vcs", "url": "https://git.acme.com/php/logger" },
      { "type": "vcs", "url": "https://git.acme.com/php/utils" }
    ],
    "require-all": true,
    "archive": {
      "directory": "dist",
      "format": "tar",
      "skip-dev": true
    }
  }

  登录后复制

• 运行构建：php bin/satis build satis.json web/，输出到 web/ 目录
• 用 Web 服务器托管 web/（确保 packages.json 可通过 https://packages.acme.com/packages.json 访问）
• 在项目 composer.json 中添加：

  "repositories": [
        { "type": "composer", "url": "https://packages.acme.com" }
      ]

  登录后复制

Private Packagist：开箱即用的企业级方案

Private Packagist 提供两种部署方式：SaaS（托管在他们云上）或 On-Premise（Docker 容器私有部署）。后者适合对数据合规和网络隔离要求高的企业。

标签： php redis js git json docker composer apache github nginx ss