如何搭建自己的 composer 私有仓库 (Satis/Private Packagist)？

搭建私有Composer仓库可选Satis或Private Packagist：Satis为自建轻量方案，适合中小团队，通过配置satis.json生成静态页面并部署Web服务即可；Private Packagist为企业级托管方案，免运维，支持权限管理与自动同步，适合大型团队。

想在团队或企业内部统一管理 PHP 包，又不想把代码公开到 Packagist.org？搭建一个私有 Composer 仓库是最佳选择。Satis 和 Private Packagist 是两种主流方案，下面分别介绍如何快速搭建。

Satis：自建轻量级私有仓库

Satis 是官方推荐的静态包仓库生成工具，适合中小型团队，部署简单，依赖少。

1. 安装 Satis
通过 Composer 全局安装 Satis：

composer global require composer/satis

确保全局 Composer bin 目录在系统 PATH 中，以便直接运行 satis 命令。

2. 配置 satis.json
创建项目目录并编写配置文件：

{
    "name": "My Private Package Repository",
    "homepage": "https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2",
    "repositories": [
        { "type": "vcs", "url": "https://github.com/your-company/package-a" },
        { "type": "vcs", "url": "https://gitlab.com/your-company/package-b" }
    ],
    "require-all": true
}

• repositories 列出所有需要收录的私有 Git 仓库。
• require-all 自动包含所有分支和标签（也可用 require 指定具体版本）。

3. 生成静态页面
运行命令生成 build 文件：

satis build satis.json public/

这会在 public/ 目录下生成 index.html 和 packages.json 等文件。

4. 部署 Web 服务
将 public/ 目录交给 Nginx 或 Apache 托管，确保可通过 HTTPS 访问（如 https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2）。

5. 在项目中使用
在需要使用的项目 composer.json 中添加仓库：

"repositories": [
    {
        "type": "composer",
        "url": "https://www.php.cn/link/3fc6ae40bfc04ae4123761055e639bc2"
    }
],
"require": {
    "your-company/package-a": "^1.0"
}

运行 composer install 即可从私有源拉取包。

Chatbase

从你的知识库中构建一个AI聊天机器人

69

查看详情

建议结合 CI/CD 工具（如 GitHub Actions）自动重建 Satis 页面，当私有包更新时触发同步。

Private Packagist：企业级托管方案

如果你希望省去运维成本，Private Packagist 是功能完整的商业解决方案，支持权限控制、Webhook 自动同步、审计日志等。

1. 注册账号
访问 https://www.php.cn/link/1fd1df658a0a3d7f385185db7c9c5029 注册企业账号，提供私有 Git 服务（GitHub、GitLab、Bitbucket 等）集成。

2. 添加私有仓库
在控制台中添加你的私有包仓库 URL，Private Packagist 会自动读取 composer.json 并索引版本。

3. 配置认证
系统提供专用令牌（Token），在本地或服务器上设置 Composer 认证：

composer config --global http-basic.packagist.example.com your-token

4. 使用私有源
只要包名匹配，Composer 会自动从 Private Packagist 下载，无需额外声明仓库（若开启“自动发现”功能）。

适合大型团队或需要精细权限管理的场景，支持 SSO、组织结构同步、多区域镜像等功能。

安全与维护建议

无论使用哪种方式，注意以下几点：

• 私有仓库必须启用 HTTPS，防止凭证泄露
• 限制 Git 仓库访问权限，仅允许必要人员推送
• 定期备份 Satis 配置或 Private Packagist 账户信息
• 使用 SSH 或个人访问令牌（PAT）克隆私有包，避免密码硬编码

基本上就这些。Satis 适合自控环境的小团队，Private Packagist 更适合追求稳定与效率的企业。选哪个，看你的运维能力和预算。

以上就是如何搭建自己的 composer 私有仓库 (Satis/Private Packagist)？的详细内容，更多请关注php中文网其它相关文章！