buddy/repman

Repman

镜像概述

Repman 是由 Buddy CI/CD 团队开发的免费开源项目，允许您在防火墙后添加和管理私有 PHP Composer 依赖。作为自托管解决方案，它为组织提供了安全管理私有 PHP 包的能力，同时通过内置 CDN/代理加速公共依赖下载。

核心功能和特性

• 简单设置：通过 Composer PHP 和访问令牌轻松完成配置
• 私有包管理：在组织内部集中管理私有 PHP 包
• 安全防护：防止私有包被从 Packagist 意外移除
• 使用洞察：监控和控制组织内使用的包情况
• 多类型支持：兼容 Git、SVN、PEAR、目录路径及工件类型的包
• 加速下载：内置 CDN/代理功能，可将 Packagist 依赖下载速度提升高达 80%
• 开源许可：所有源代码在 https://github.com/repman-io/repman 上以 MIT 许可证发布
• 云版本可选：同时提供 云托管版本

使用场景和适用范围

• 企业或团队需要在内部网络中安全管理私有 PHP 包
• 希望避免依赖外部公共仓库，确保关键依赖的可用性
• 需要加速 PHP 项目依赖下载，提升开发效率
• 需监控和控制组织内 Composer 包使用情况的场景

使用方法和配置说明

安装方式

Repman 提供多种安装方式，推荐通过 Docker 快速部署：

Docker 安装

参考官方 Docker 安装文档，基本步骤如下：

1. 克隆 Repman 仓库：

   bash
   git clone https://github.com/repman-io/repman.git
   cd repman
   

2. 使用 Docker Compose 启动服务：

   bash
   docker-compose up -d
   

3. 完成初始化配置：

   bash
   docker-compose exec app bin/console repman:install
   

Ansible 安装

对于更复杂的部署需求，可使用官方提供的 Ansible 剧本 进行自动化部署。

配置与使用

1. 访问 Repman 管理界面（默认地址：http://localhost:80）
2. 创建管理员账户并生成访问令牌
3. 在 Composer 配置中添加 Repman 仓库：

   json
   {
       "repositories": [
           {
               "type": "composer",
               "url": "https://your-repman-instance.com"
           }
       ]
   }
   

4. 使用生成的访问令牌进行身份验证，开始管理私有包

学习资源

• 官方文档：Repman 文档
• 教程：如何使用 Repman 从 GitHub 分发私有包