Skip to content
forked from celaraze/cat

☕ 咖啡壶是一个免费、开源、高效且漂亮的运维资产管理平台。软硬件资产管理、归属/使用者追溯、盘点以及可靠的服务器状态管理面板。基于优雅的Laravel框架和DcatAdmin开发。

License

Notifications You must be signed in to change notification settings

githublusong/chemex

 
 

Repository files navigation

演示地址(账密都是:admin) | 用户交流群(QQ)

Gitee Star 趋势

Stargazers over time

贡献者

Giteye chart

鸣谢

没有它们就没有 咖啡壶(Chemex):

JetBrains 提供优秀的IDE。

Laravel ,优雅的 PHP Web 框架。

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

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

简介

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

特点

使用先进的 Web 框架进行开发。

简洁优雅的使用体验。

灵活可配置的自定义字段。

高性能 Web 服务解决方案(Octane)。

环境要求

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

PHP 8+ ,仅支持 PHP8。

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

ext-zip 扩展。

ext-json 扩展。

ext-fileinfo 扩展。

ext-ldap 扩展。

ext-bcmath 扩展。

ext-mysqli 扩展。

ext-xml 扩展。

ext-xmlrpc 扩展。

以上扩展安装过程注意版本必须与 PHP 版本一致。

部署

高性能

高性能模式使用了 Laravel Octane 实现,不仅大大提升 I/O 性能,同时也一定程度上简化了部署过程。

1:为你的计算机安装 PHP8 环境,参考:PHP官方

2:为你的计算机安装 MySQL 或者 mariadb

3:在你想要的目录中,执行 git clone https://gitee.com/celaraze/chemex.git 完成下载。

4:在项目根目录中,复制 .env.example 文件为一份新的,并重命名为 .env

5:根据 .env 文件中注释的指引进行配置。

6:在项目根目录中,执行 php artisan octane:start --server=roadrunner --host=0.0.0.0 --rpc-port=6001 --port=80 启动服务器。

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

注意:此部署方式默认无后台运行模式,也就是说命令行关闭后,服务器也会关闭。在生产环境中,我们推荐使用 supervisor 管理守护进程。通过宝塔面板安装的服务器环境,也可以安装其 supervisor管理器 插件进行启动。

经典 Nginx & PHP-fpm

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

1:为你的计算机安装 PHP8 环境,参考:PHP官方

2:为你的计算机安装 MySQL 或者 mariadb

3:在你想要的目录中,执行 git clone https://gitee.com/celaraze/chemex.git 完成下载。

4:在项目根目录中,复制 .env.example 文件为一份新的,并重命名为 .env

5:根据 .env 文件中注释的指引进行配置。

6:你可能使用的web服务器为 nginx 以及 apache,无论怎样,应用的起始路径在 /public 目录,请确保指向正确,同时程序的根目录权限应该调整为:拥有者和你的 Web 服务器运行用户一致,例如 www 用户,且根目录权限为 755/storage 目录设置为 777 权限。

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

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

OVF

此部署方式版本暂停在 3.0.1,近期将会恢复更新

考虑到部署复杂性,我们也提供了基于 Ubuntu 20.04 Server 制作的 OVF 包。OVF 支持 VMware ESXi 6.5+ 或 VMware Workstation 14.x+ 或 VMware Fusion 10.x+。

下载地址:https://pan.baidu.com/s/1AuTv5UMxzzMkTdP9Ca5J_A,提取码:8mok

OVF 中包含以下组件:Nginx MySQL PHP7.4,网络通过 NAT 实现。

此 OVF 中的 chemex 版本为支持 PHP7.4 的版本,但 chemex 从 3.0.4 开始将仅支持 PHP8.0 。

Ubuntu 账密:chemex/chemex

Web 程序主目录:/var/www/html

MySQL 账密:chemex/chemex

部署完成后,LNMP 服务会自启,先查看此虚拟机 IP,然后在其它主机直接通过 IP 访问 Web 服务即可。

版本更新

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

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

注意,如果提示 permission denied 错误,需要通过 sudo 身份执行。

反馈问题

请随时牢记,这是一个开源项目,作者有自己的生活、自己的工作,QQ群建立的目的是提供一个场所供用户们互相交流,作者不会提供1对1的服务。

最好的反馈方式即是在本代码仓库中提交 Issue,我们在空余时间检查并解决。

截图

咖啡壶没有满足我的需求,我想要咖啡壶成为我想要的样子

咖啡壶是开源的,程序本体及其衍生工具的源码都在你的手中,你可以自行修改成为你想要的样子。

Fork 本仓库,修改代码,成为你的。

开源协议

咖啡壶(Chemex)遵循 GPL3.0 开源协议。

About

☕ 咖啡壶是一个免费、开源、高效且漂亮的运维资产管理平台。软硬件资产管理、归属/使用者追溯、盘点以及可靠的服务器状态管理面板。基于优雅的Laravel框架和DcatAdmin开发。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 97.5%
  • Blade 2.3%
  • Shell 0.2%