PHPackages                             piplin/piplin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps &amp; Deployment](/categories/devops)
4. /
5. piplin/piplin

ActiveProject[DevOps &amp; Deployment](/categories/devops)

piplin/piplin
=============

Piplin is a self-hosted continuous integration and deployment system, intended to automatically build, test, and deploy your project over the web.

v1.0.2(8y ago)1.0k64191[16 issues](https://github.com/Piplin/Piplin/issues)MITPHPPHP &gt;=7.0.0

Since Sep 8Pushed 5y ago60 watchersCompare

[ Source](https://github.com/Piplin/Piplin)[ Packagist](https://packagist.org/packages/piplin/piplin)[ Docs](http://piplin.com/)[ RSS](/packages/piplin-piplin/feed)WikiDiscussions 1.0 Synced 1mo ago

READMEChangelog (10)Dependencies (30)Versions (31)Used By (0)

Piplin - [![Composer Cache](https://camo.githubusercontent.com/572ce8934c4b25771bdaed4c928fe3389a9c4db82576f93864fd2d16b4083cd4/68747470733a2f2f736869656c642e776974682e736f6369616c2f63632f6769746875622f5069706c696e2f5069706c696e2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/laravel/framework)
==================================================================================================================================================================================================================================================================================================================================================

[](#piplin---)

[![StyleCI](https://camo.githubusercontent.com/4409d191ffff992435fe71253ee0025feb0ccc174e95e519312f5a6ec1a1971d/68747470733a2f2f7374796c6563692e696f2f7265706f732f36373630393239322f736869656c64)](https://styleci.io/repos/67609292/)[![Build Status](https://camo.githubusercontent.com/8d0945645975e6cd87a0cb9f0d67c47f17baec49dd6ab62765befdc06fb6ef0f/68747470733a2f2f7472617669732d63692e6f72672f5069706c696e2f5069706c696e2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Piplin/Piplin)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Piplin(灵感来自于"pipeline"，读作/ˈpɪpˌlɪn/ 或 /ˈpaɪpˌlaɪn/)是一款免费、开源的持续集成与部署系统，适用于软件的自动化构建、测试和部署相关的各种应用场景。

[![Screenshot](https://camo.githubusercontent.com/c06a4c2941ae305f83f9046dc35db5943a5063cabc33bf78e133adf7a0970d3e/687474703a2f2f7069706c696e2e636f6d2f696d672f73637265656e73686f742e706e673f7631)](https://camo.githubusercontent.com/c06a4c2941ae305f83f9046dc35db5943a5063cabc33bf78e133adf7a0970d3e/687474703a2f2f7069706c696e2e636f6d2f696d672f73637265656e73686f742e706e673f7631)

Piplin能做什么？
-----------

[](#piplin能做什么)

- 支持PHP、Python、JAVA、Ruby等项目的构建、测试与发布
- 可与Gitlab、Github、Gogs、Gitee(Oschina)等代码托管平台进行集成
- 可灵活配置自定义构建和部署步骤
- 支持自定义构建物规则，对构建物创建发布版本并部署
- 支持项目的多环境部署(可自行建立开发、测试、预发布和生产等多个环境)
- 支持联动部署，比如：开发环境部署成功后可自动触发测试环境启动部署
- 服务管理支持机柜功能，机柜可与多个部署环境绑定
- 支持项目克隆功能
- 项目支持多成员
- 通过Websocket实现项目部署状态的实时跟踪
- 支持钉钉机器人、Slack、邮件和自定义Webhook的服务集成

Piplin原理示意图
-----------

[](#piplin原理示意图)

### 总体

[](#总体)

[![Principle](https://camo.githubusercontent.com/ecf8cf7efbb0f80657b76b69611d0e6022a49e10d42920d39f6297766f1e62f4/687474703a2f2f7069706c696e2e636f6d2f696d672f7072696e6369706c652e706e673f7632)](https://camo.githubusercontent.com/ecf8cf7efbb0f80657b76b69611d0e6022a49e10d42920d39f6297766f1e62f4/687474703a2f2f7069706c696e2e636f6d2f696d672f7072696e6369706c652e706e673f7632)

### 步骤命令

[](#步骤命令)

[![Commands](https://camo.githubusercontent.com/9262b0670f9c12a4745a7a7a7e4d3ab8c51251d18d5b58c201056d1f4ef73bcf/687474703a2f2f7069706c696e2e636f6d2f73637265656e73686f74732f636f6d6d616e64732e706e673f7631)](https://camo.githubusercontent.com/9262b0670f9c12a4745a7a7a7e4d3ab8c51251d18d5b58c201056d1f4ef73bcf/687474703a2f2f7069706c696e2e636f6d2f73637265656e73686f74732f636f6d6d616e64732e706e673f7631)

安装环境要求
------

[](#安装环境要求)

Piplin目前只支持类Unix操作系统(如: Linux, Freebsd, Mac OS等)，为了能运行Piplin，您还需要安装一些基础软件。

- Web服务器: **Nginx**, **Apache** (with mod\_rewrite)，or **Lighttpd**
- [PHP](http://www.php.net) 7.0+
- 数据库: 推荐使用[MySQL](https://www.mysql.com) 或 [PostgreSQL](http://www.postgresql.org)。 [SQLite](https://www.sqlite.org)也可运行。
- [Composer](https://getcomposer.org)
- [Redis](http://redis.io)
- [Node.js](https://nodejs.org/)
- [队列系统](http://laravel.com/docs/5.5/queues), 推荐使用[Beanstalkd](http://kr.github.io/beanstalkd/)或Redis。
- [Supservisord](http://www.supervisord.org/), Piplin使用Supervisord进行后台进程管理。
- [Rsync](https://rsync.samba.org/) 如无特殊情况，一般系统都会自带rsync
- 缓存服务: 推荐使用Memcached, 更多的缓存方案选择请看 [caching server](http://laravel.com/docs/5.5/cache).

> Docker安装，请访问我们的[Piplin Docker](https://github.com/Piplin/Docker)项目。

安装手册
----

[](#安装手册)

### 全新安装

[](#全新安装)

#### 一. 克隆代码

[](#一-克隆代码)

假设我们把Piplin安装在 /var/www 目录下

```
$ cd /var/www
$ git clone https://github.com/Piplin/Piplin.git piplin
```

#### 二. 安装依赖包

[](#二-安装依赖包)

```
$ cd piplin
$ make
```

> 安装过程如出现卡顿，请尝试更换npm镜像: `npm config set registry http://registry.npm.taobao.org/`

#### 三. 安装Piplin

[](#三-安装piplin)

```
$ make install
```

> Piplin安装器会进入一个交互式控制台，请根据提示进行相关参数设置。

#### 四. 请将Web服务器的根目录指向 `public/`, 请参考 [examples/](/examples) 下的相关配置文件，里面包含 Apache和Nginx的配置范例.

[](#四-请将web服务器的根目录指向-public-请参考-examples-下的相关配置文件里面包含-apache和nginx的配置范例)

> 注意: `examples/` 提供的仅仅是范例，并不能保证直接拷贝就能使用，需要根据实际情况进行相关配置调整。

#### 五. 配置supervisord

[](#五-配置supervisord)

Piplin使用`supervisord`进行后台进程管理。该配置范例请查看[examples/supervisor.conf](examples/supervisor.conf)。 一般supervisord的主配置文件在 `/etc/supervisor/supervisord.conf` ，其大致内容：

```
[unix_http_server]
file=/var/run/supervisor.sock   ; (the path to the socket file)
chmod=0700                       ; sockef file mode (default 0700)

......

[include]
files = /etc/supervisor/conf.d/*.conf

```

##### 配置步骤如下：

[](#配置步骤如下)

1). 拷贝 examples/supervisor.conf

```
$ cp examples/supervisor.conf /etc/supervisor/conf.d/piplin.conf
$ vi /etc/supervisor/conf.d/piplin.conf
```

> 请根据实际情况修改相关参数设置，尤其注意路径相关的参数。

2). 重启supervisord

```
$ /etc/init.d/supervisord restart 或 service supervisord restart
```

3). 检查supervisord服务是否正常

```
$ supervisorctl
```

如果返回如下信息，代表服务正常:

```
piplin:queue_0                   RUNNING   pid 26981, uptime 2 days, 15:30:59
piplin:queue_1                   RUNNING   pid 26980, uptime 2 days, 15:30:59
piplin:queue_2                   RUNNING   pid 26979, uptime 2 days, 15:30:59
piplin-broadcast                 RUNNING   pid 26987, uptime 2 days, 15:30:59
piplin-socketio                  RUNNING   pid 26978, uptime 2 days, 15:30:59
supervisor>

```

六. 访问Piplin

恭喜！您已完成Piplin的安装。请通过浏览器访问安装过程中设置的应用网址。

> 如果安装完成之后修改了.env里的配置信息，要记得执行`php artisan config:cache`使其立即生效。

七. 设置计划任务

计划任务相关的设置请看 [examples/crontab](examples/crontab).

> Piplin的数据备份、项目Git仓库自动镜像等工作依赖于计划任务去实现。

### 升级

[](#升级)

一. 获取最新代码

```
$ git fetch --all
$ git checkout v1.0.2
```

二. 升级

```
$ make update
```

系统演示
----

[](#系统演示)

体验Piplin, 请访问 [Piplin](http://piplin.com):

- **用户名:** piplin 或 `piplin@piplin.com`
- **密码:** `piplin`

> 注意：系统每5分钟会自动重置一次密码，该账号没有权限访问管理功能.

帮助文档
----

[](#帮助文档)

更多文档请访问  或 。

开发相关
----

[](#开发相关)

Piplin代码里已经自带编译后的前端静态资源，如果你不想修改前端样式，可直接忽略本环节。

工具集：

- Node.js
- Webpack

```
npm install
npm run prod
```

鸣谢
--

[](#鸣谢)

- [Laravel](http://laravel.com)
- [Bootstrap](https://github.com/twbs/bootstrap)
- [AdminLTE](https://github.com/almasaeed2010/AdminLTE)
- [Envoy](https://laravel.com/docs/5.5/envoy)
- [Forge](https://forge.laravel.com/)
- [Deployer](https://github.com/REBELinBLUE/deployer)
- [socket.io](https://github.com/socketio/socket.io)
- [ionicons](http://ionicons.com/)

软件授权协议
------

[](#软件授权协议)

Piplin is licensed under [The MIT License (MIT)](LICENSE). Piplin is based on [Deployer](https://github.com/REBELinBLUE/deployer).

###  Health Score

41

—

FairBetter than 88% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community30

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 97.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~38 days

Recently: every ~147 days

Total

28

Last Release

2487d ago

Major Versions

0.4.5 → v1.0.0-beta12017-12-03

PHP version history (3 changes)0.1.3PHP &gt;=5.5.9

0.1.4PHP &gt;=5.6.4

0.2.0PHP &gt;=7.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0fdd0758a044ec4e5341270f094a553266245bf63e5a13e74a429363ad486b6?d=identicon)[phecho](/maintainers/phecho)

---

Top Contributors

[![lianguan](https://avatars.githubusercontent.com/u/15666864?v=4)](https://github.com/lianguan "lianguan (544 commits)")[![greenkeeper[bot]](https://avatars.githubusercontent.com/in/505?v=4)](https://github.com/greenkeeper[bot] "greenkeeper[bot] (4 commits)")[![imtms](https://avatars.githubusercontent.com/u/8328620?v=4)](https://github.com/imtms "imtms (2 commits)")[![leo108](https://avatars.githubusercontent.com/u/1551716?v=4)](https://github.com/leo108 "leo108 (1 commits)")[![ryun](https://avatars.githubusercontent.com/u/227672?v=4)](https://github.com/ryun "ryun (1 commits)")[![sandy1890](https://avatars.githubusercontent.com/u/5370615?v=4)](https://github.com/sandy1890 "sandy1890 (1 commits)")[![sheaven79](https://avatars.githubusercontent.com/u/4695067?v=4)](https://github.com/sheaven79 "sheaven79 (1 commits)")[![wtracyliu](https://avatars.githubusercontent.com/u/817779?v=4)](https://github.com/wtracyliu "wtracyliu (1 commits)")[![ade951](https://avatars.githubusercontent.com/u/3275972?v=4)](https://github.com/ade951 "ade951 (1 commits)")[![xuqihua](https://avatars.githubusercontent.com/u/661011?v=4)](https://github.com/xuqihua "xuqihua (1 commits)")[![bbashy](https://avatars.githubusercontent.com/u/1149200?v=4)](https://github.com/bbashy "bbashy (1 commits)")[![houbaron](https://avatars.githubusercontent.com/u/15180122?v=4)](https://github.com/houbaron "houbaron (1 commits)")

---

Tags

continuous-deliverycontinuous-deploymentcontinuous-integrationdevopslaravelphppiplincontinuous integrationcipiplin

###  Code Quality

TestsCodeception

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/piplin-piplin/health.svg)

```
[![Health](https://phpackages.com/badges/piplin-piplin/health.svg)](https://phpackages.com/packages/piplin-piplin)
```

###  Alternatives

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.4M207](/packages/backpack-crud)[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[slimkit/plus

The Plus(ThinkSNS+) is a powerful, easy-to-develop social system built with Laravel.

2.2k2.4k](/packages/slimkit-plus)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
