咖啡壶（Chemex）官方网站 | Demo 演示站点 |

鸣谢

没有它们就没有 咖啡壶（Chemex）：

JetBrains 提供优秀的IDE。

Laravel ，优雅的 PHP Web 框架。

Dcat Admin ，高颜值、高效率的后台开发框架。

Dr. Peter Schlumbohm，感谢发明了 Chemex 冲煮咖啡。

简介

加入用户微信群请添加微信号 Celaraze，并且备注 Chemex 用户，无备注将不会通过。

咖啡壶（Chemex）是一个轻量的、现代设计风格的 ICT 资产管理系统。得益于 Laravel 框架以及 Dcat Admin 开发平台，使其具备了优雅、简洁的优秀体验。 咖啡壶（Chemex） 是完全免费且开源的，任何人都可以无限制的修改代码以及部署服务，这对于很多想要对ICT资产做信息化管理的中小型企业来说，是一个很好的选择：低廉的成本换回的是高效的管理方案，同时又有健康的生态提供支持。

1.x 版本升级到 2.x 版本请参考：1.x升级2.x的操作方式 。

特点

涵盖 IT 资产管理的基本功能需求，项目主导者有八年多运维管理经验。

社区响应速度快，提出 Issue 后都会及时回复。

尽可能的操作简化，能一步解决的，绝不会设计第二步。

UI设计来自多个优秀开源项目，例如：Bootstrap、AdminLTE、Apex Charts等。

版本号命名

咖啡壶（Chemex）将会以咖啡豆品种作为 major 版本的命名，例如 1.x 版本称为 肯亚（Kenya），旨在为 ICT 运维人员提供管理能力的同时，普及咖啡知识，静下心喝一杯属于当前版本的冲煮咖啡。

环境要求

git，用于管理版本，部署和升级必要工具。

PHP 7.3 +

MariaDB 10.2 +，数据库引擎，理论上 MySQL 5.6+ 兼容支持。

ext-zip 扩展，注意和 PHP 版本相同。

ext-json 扩展，注意和 PHP 版本相同。

ext-fileinfo 扩展，注意和 PHP 版本相同。

部署

Git部署

注意：使用过程中，必须避免直接修改数据库数据，Laravel 拥有强大的 Eloquent ORM 模型层，Chemex 中的所有逻辑交互都由模型关联完成，直接修改数据库数据将会导致未知的错误。应用脱离数据库直接交互是现在最流行的做法。

视频部署演示教程：https://www.bilibili.com/video/BV1uK4y1j7pw/

生产环境下为遵守安全策略，非常建议在服务器本地进行部署，暂时不提供相关线上初始化安装的功能。因此，虽然前期部署的步骤较多，但已经为大家自动化处理了很大部分的流程，只需要跟着下面的命令一步步执行，一般是不会有部署问题的。

1：为你的计算机安装 git，Windows 环境请安装这个，Linux 环境一般都会自带，如果没有就执行 yum/apt 命令来安装即可。

2：为你的计算机安装 PHP 环境，参考：PHP官方 。

3：为你的计算机安装 mariaDB。

4：创建一个数据库，命名任意，但记得之后填写配置时需要对应正确，并且数据库字符集为 utf8-general-ci。

5：在你想要的目录中，执行 git clone https://gitee.com/celaraze/Chemex.git 完成下载。

6：在项目根目录中，复制 .env.example 文件为一份新的，并重命名为 .env。

7：在 .env 中配置数据库信息以及 APP_URL 信息。

8：进入项目根目录，执行 php artisan chemex:install 进行安装。

9：你可能使用的web服务器为 nginx 以及 apache，无论怎样，应用的起始路径在 /public 目录，请确保指向正确。

10：修改web服务器的伪静态规则为：try_files $uri $uri/ /index.php?$args;。

11：此时可以通过访问 http://your_domain 来使用 咖啡壶（Chemex）。管理员账号密码为：admin / admin。

OVF 部署

1：下载 OVF 镜像：https://pan.baidu.com/s/16mc-q0pGtzwjOR4SqAoBuA ，提取码 95m4。

2: OVF 镜像的 LNMP 环境使用了 AppNode 面板，部署完后需要更新下 AppNode 的面板授权关系和 Chemex 站点域名。

3：面板地址：http://your-ip:8888 ，用户名和密码都是 Chemex。

4：具体使用方法可以参考 AppNode 官方说明：https://www.appnode.com/ 。

5：为什么不用 宝塔面板 ：因为宝塔在部署完成后必须要绑定手机号码才能继续使用，我无法将自己的手机号码绑定到面板中去再通过 OVF 镜像分发给你们。

6：访问 http://your-ip/admin 来访问咖啡壶（Chemex），用户名密码都是 admin。

更新（通过Git Pull方式）

随时随地保持更新可以在项目根目录中执行 sudo git reset --hard && git pull --force 命令，将会同步分支的最新修改内容。

接着，执行 php artisan chemex:update 来进行升级。

注意：只有 main 分支才是适用于生产环境的分支。

享受使用吧。

截图

参与贡献

Fork 本仓库，修改代码，提交 Pull Request。

开源协议

咖啡壶（Chemex）遵循 GPL3.0 开源协议。