# Chemex
**Repository Path**: coder1493/Chemex
## Basic Information
- **Project Name**: Chemex
- **Description**: ☕ 咖啡壶是一个免费、开源、高效且漂亮的IT运维管理平台。资产管理、归属/使用者追溯、盘点以及可靠的服务器状态管理面板。基于优雅的Laravel框架和DcatAdmin开发。
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: http://chemex.it/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 919
- **Created**: 2021-01-09
- **Last Updated**: 2021-01-09
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
咖啡壶（Chemex）官方网站 |
Demo 演示站点 |
## 鸣谢
没有它们就没有 咖啡壶（Chemex）：
`JetBrains` 提供优秀的IDE。
[Laravel](https://laravel.com/) ，优雅的 PHP Web 框架。
[Dcat Admin](https://dcatadmin.com) ，高颜值、高效率的后台开发框架。
`Dr. Peter Schlumbohm`，感谢发明了 Chemex 冲煮咖啡。
## 这些优秀的企业正在使用咖啡壶解决方案
苏州通润驱动设备股份有限公司
昆山龙灯瑞迪制药有限公司
昆山华恒焊接股份有限公司
昆山鑫泰利精密组件股份有限公司
广州群主互联网有限公司
苏州春秋电子科技股份有限公司
江苏杰峰物流有限公司
常熟道达江海物流有限公司
## 简介
加入用户微信群请添加微信号 `Celaraze`，并且备注 Chemex 用户，无备注将不会通过，有问题可以在群内反馈讨论，非紧急也请不要@我，多次影响我作息会被请出，恕不私聊。
但请时刻记住，这是一个开源项目，作者没有义务对每个需求进行开发或者是对每个用户的问题进行解答，我希望它成为一个标准化的开源产品，而不是按照每个人的想法去加各种多样的定制功能，因此每个提交的需求我都会慎重考虑是否适用。
毫不例外，我更希望你能多动手来对咖啡壶贡献，而不是多抱怨。
咖啡壶（Chemex）是一个轻量的、现代设计风格的 ICT 资产管理系统。得益于 [Laravel](https://laravel.com/) 框架以及 [Dcat Admin](https://dcatadmin.com)
开发平台，使其具备了优雅、简洁的优秀体验。 咖啡壶（Chemex）
是完全免费且开源的，任何人都可以无限制的修改代码以及部署服务，这对于很多想要对ICT资产做信息化管理的中小型企业来说，是一个很好的选择：低廉的成本换回的是高效的管理方案，同时又有健康的生态提供支持。
`1.x` 版本升级到 `2.x`
版本请参考：[1.x升级2.x的操作方式](https://gitee.com/celaraze/Chemex/wikis/1.x%E5%8D%87%E7%BA%A72.x%E7%9A%84%E6%93%8D%E4%BD%9C%E6%96%B9%E5%BC%8F)
。
## 特点
涵盖 IT 资产管理的基本功能需求，项目主导者有八年多运维管理经验。
社区响应速度快，提出 Issue 后都会及时回复。
尽可能的操作简化，能一步解决的，绝不会设计第二步。
UI设计来自多个优秀开源项目，例如：Bootstrap、AdminLTE、Apex Charts等。
### 版本号命名
咖啡壶（Chemex）将会以咖啡豆品种作为 `major` 版本的命名，例如 `1.x` 版本称为 `肯亚（Kenya）`，旨在为 ICT 运维人员提供管理能力的同时，普及咖啡知识，静下心喝一杯属于当前版本的冲煮咖啡。
|major|版本名|发布|
|----|----|----|
|1.x|肯亚（Kenya）|✔|
|2.x|耶加雪菲（Yirgacheffe）|➖|
## 环境要求
`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官方](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` 中配置数据库信息以及 `APP_URL` 信息。
8：进入项目根目录，执行 `php artisan chemex:install` 进行安装。
9：你可能使用的web服务器为 `nginx` 以及 `apache`，无论怎样，应用的起始路径在 `/public` 目录，请确保指向正确，同时程序的根目录权限应该调整为：拥有者和你的 Web
服务器运行用户一致，且根目录权限为 `755`。
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](https://pan.baidu.com/s/16mc-q0pGtzwjOR4SqAoBuA)
，提取码 `95m4`。
2: Linux 的 root 用户名和密码都是 `root` ， OVF 镜像的 LNMP 环境使用了 `AppNode` 面板，部署完后需要更新下 `AppNode` 的面板授权关系和 Chemex 站点域名。
3：面板地址：http://your-ip:8888 ，用户名和密码都是 `admin`，数据库 root 用户的密码是 `chemex`。
4：具体使用方法可以参考 `AppNode` 官方说明：[https://www.appnode.com/](https://www.appnode.com/) 。
5：为什么不用 `宝塔面板` ：因为宝塔在部署完成后必须要绑定手机号码才能继续使用，我无法将自己的手机号码绑定到面板中去再通过 OVF 镜像分发给你们。
6：访问 `http://your-ip` 来访问咖啡壶（Chemex），用户名密码都是 `admin`。
## 更新（通过Git Pull方式）
随时随地保持更新可以在项目根目录中执行 `sudo git reset --hard && git pull --force` 命令，将会同步分支的最新修改内容。
接着，执行 `php artisan chemex:update` 来进行升级。
注意：只有 `main` 分支才是适用于生产环境的分支。
享受使用吧。
## 截图
## 咖啡壶没有满足我的需求，我想要咖啡壶成为我想要的样子
咖啡壶是开源的，程序本体及其衍生工具的源码都在你的手中，你可以自行修改成为你想要的样子。
`Fork` 本仓库，修改代码，成为你的。
## 开源协议
咖啡壶（Chemex）遵循 [GPL3.0](https://www.gnu.org/licenses/gpl-3.0.html) 开源协议。