# chemex **Repository Path**: jsonkaka/chemex ## Basic Information - **Project Name**: chemex - **Description**: ☕ 咖啡壶是开源、高颜值的IT资产管理平台。资产管理、归属、追溯、盘点以及轻量的服务器状态面板。支持导出导入、LDAP、自定义字段等。基于优雅的Laravel框架和DcatAdmin开发。 - **Primary Language**: PHP - **License**: GPL-3.0 - **Default Branch**: main - **Homepage**: http://chemex.it/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 922 - **Created**: 2021-03-25 - **Last Updated**: 2021-03-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
官方网站 | 演示地址(账密都是:admin) | 官方QQ群
苏州通润驱动设备股份有限公司
昆山龙灯瑞迪制药有限公司
昆山华恒焊接股份有限公司
昆山鑫泰利精密组件股份有限公司
广州群主互联网有限公司
苏州春秋电子科技股份有限公司
江苏杰峰物流有限公司
常熟道达江海物流有限公司
## 简介 咖啡壶(Chemex)是一个轻量的、现代设计风格的 ICT 资产管理系统。得益于 [Laravel](https://laravel.com/) 框架以及 [Dcat Admin](https://dcatadmin.com) 开发平台,使其具备了优雅、简洁的优秀体验。 咖啡壶(Chemex) 是完全免费且开源的,任何人都可以无限制的修改代码以及部署服务,这对于很多想要对ICT资产做信息化管理的中小型企业来说,是一个很好的选择:低廉的成本换回的是高效的管理方案,同时又有健康的生态提供支持。。 ## 特点 经典的 LNMP 环境即可运行。 使用先进的 Web 框架进行开发。 简洁优雅的使用体验。 灵活的可配置自定义字段。 ### 版本 咖啡壶(Chemex)将会以咖啡豆品种作为 `major` 版本的命名,例如 `1.x` 版本称为 `肯亚(Kenya)`,旨在为 ICT 运维人员提供管理能力的同时,普及咖啡知识,静下心喝一杯属于当前版本的冲煮咖啡。 |major|版本名|发布| |----|----|----| |1.x|肯亚(Kenya)|✔| |2.x|耶加雪菲(Yirgacheffe)|✔| |3.x|瑰夏(Gesha)|最新滚动版本| ## 环境要求 `git`,用于管理版本,部署和升级必要工具。 `PHP 7.4 +` ,已经支持 PHP8 ,建议使用 PHP8。 `MySQL 8 +`,数据库引擎,理论上 `MariaDB 10.2 +` 兼容支持。 `ext-zip` 扩展,注意和 PHP 版本相同。 `ext-json` 扩展,注意和 PHP 版本相同。 `ext-fileinfo` 扩展,注意和 PHP 版本相同。 `ext-ldap` 扩展,注意和 PHP 版本相同。 `ext-bcmath` 扩展,注意和 PHP 版本相同。 ## 部署 ### OVF 考虑到部署复杂性,我们也提供了基于 Ubuntu 20.04 Server 制作的 OVF 包。OVF 支持 VMware ESXi 6.5+ 或 VMware Workstation 14.x+ 或 VMware Fusion 10.x+。 下载地址:[https://pan.baidu.com/s/1V4WIuO4TUvJj4NLjRxPRug](https://pan.baidu.com/s/1V4WIuO4TUvJj4NLjRxPRug),提取码:`qvzj`。 OVF 中包含以下组件:Nginx MariaDB PHP7.4,网络通过 NAT 实现。 Ubuntu 账密:chemex/chemex Web 程序主目录:/var/www/html/chemex MariaDB 账密:chemex/chemex 部署完成后,LNMP 服务会自启,先查看此虚拟机 IP,然后在其它主机直接通过 IP 访问 Web 服务即可。 ### 手动 生产环境下为遵守安全策略,非常建议在服务器本地进行部署,暂时不提供相关线上初始化安装的功能。因此,虽然前期部署的步骤较多,但已经为大家自动化处理了很大部分的流程,只需要跟着下面的命令一步步执行,一般是不会有部署问题的。 1:为你的计算机安装 `git`,Windows 环境请安装 [Git for Windows](https://git-scm.com/download/win) ,Linux 环境一般都会自带,如果没有就执行 `yum install git` 或者 `apt install git` 命令来安装即可。 2:为你的计算机安装 `PHP` 环境,参考:[PHP官方](https://www.php.net/downloads) 。 3:为你的计算机安装 `mariaDB`。 4:创建一个数据库,命名任意,但记得之后填写配置时需要对应正确,并且数据库字符集为 `utf8-general-ci`。 5:在你想要的目录中,执行 `git clone https://gitee.com/celaraze/chemex.git` 完成下载。 6:在项目根目录中,复制 `.env.example` 文件为一份新的,并重命名为 `.env`。 7:在 `.env` 中配置数据库信息。 8:进入项目根目录,执行 `php artisan chemex:install` 进行安装。 9:你可能使用的web服务器为 `nginx` 以及 `apache`,无论怎样,应用的起始路径在 `/public` 目录,请确保指向正确,同时程序的根目录权限应该调整为:拥有者和你的 Web 服务器运行用户一致,例如 www 用户,且根目录权限为 `755`。`/storage` 目录设置为 `777` 权限。 10:修改web服务器的伪静态规则为:`try_files $uri $uri/ /index.php?$args;`。 11:此时可以通过访问 `http://your_domain` 来使用 咖啡壶。管理员账号密码为:`admin / admin`。 12:最后,根据需要对是否使用线上更新继续配置。 ## 更新 ### 线上 部署完成后需要将 PHP 的 `exec()` 函数从禁用列表中移除,使其生效。之后即可使用线上更新,操作步骤为 设置 - 版本信息 - 升级。 ### 手动,通过Git Pull方式 随时随地保持更新可以在项目根目录中执行 `sudo git fetch --all && git reset --hard origin/main && git pull` 命令,将会同步分支的最新修改内容。 接着,执行 `php artisan chemex:update` 来进行升级。 > 如果从2.0升级到3.0,需要额外执行 `php artisan chemex:refresh-user`。 ## 截图     ## 咖啡壶没有满足我的需求,我想要咖啡壶成为我想要的样子 咖啡壶是开源的,程序本体及其衍生工具的源码都在你的手中,你可以自行修改成为你想要的样子。 `Fork` 本仓库,修改代码,成为你的。 ## 开源协议 咖啡壶(Chemex)遵循 [GPL3.0](https://www.gnu.org/licenses/gpl-3.0.html) 开源协议。