
源码系统概览
文章正文
Grocy 是一款开源的家庭库存管理系统源码,把企业进销存思路搬进厨房,食品保质期、采购计划与家务安排一站管理,被誉为冰箱之外的家庭 ERP 平台。
项目由作者 Bernd Bestel 独立维护多年,当前版本 v4.7.0,采用 MIT 许可证,最后更新 2026 年,更新日志随版本滚动发布,GitHub 社区活跃。
源码简介
系统数据完全存储在本机 SQLite 数据库,支持条码扫描入库,兼容 USB 扫码枪与手机摄像头,消耗登记自动扣减库存。
中文本地化版本对界面与提示做了完整翻译,购物清单、餐食计划、家务分工等模块开箱即用,低库存商品自动进入购物清单。
页面为纯 Web 应用,家庭小主机、NAS 甚至树莓派都能流畅运行,多用户可分工管理同一套库存。
与同类家庭库存工具对比 vs Homebox,Grocy 的进销存逻辑更完整。
| 对比维度 | Grocy | Homebox |
|---|---|---|
| 核心思路 | 进销存管理,保质期与低库存提醒 | 物品档案管理为主 |
| 条码支持 | 原生支持扫码枪与摄像头 | 需插件扩展 |
| 附加模块 | 家务、餐食计划、电池管理 | 无内置模块 |
| 许可证 | MIT 宽松协议 | AGPL-3.0 协议 |
经常忘记食材保质期、想减少家庭浪费的用户,可以把 Grocy 当作厨房里的家庭 ERP 来使用。
欢迎感兴趣的开发者到 GitHub 仓库 star 和 fork 参与贡献。
适用场景
- 家庭食品库存与保质期管理,减少过期浪费。
- 家庭日用品与清洁用品的采购计划管理。
- 室友或家人分工家务,用家务模块记录轮值。
- 小团队茶水间物资管理,扫码领用扣减库存。
技术栈与运行环境
技术栈为 PHP 8.5 以上加 SQLite 数据库,官方提供 Docker 镜像与桌面版,当前版本 v4.7.0,MIT 协议允许商用。
前端无需构建工具,部署后浏览器直接访问,数据备份只需复制 data 目录,迁移成本低。
功能亮点
- 商品入库记录数量、保质期与存放位置。
- 条码扫描入库,兼容 USB 扫码枪与手机。
- 临期食品首页醒目提示,优先消耗。
- 低库存商品自动加入购物清单。
- 家务分工、菜谱规划、电池与设备管理模块。
- 多用户支持,数据本机 SQLite 存储。
技术架构与部署指南
安装与部署提示
Docker 一条命令即可启动服务,浏览器打开页面初始化数据库,首次登录后立即修改默认管理员密码。
先建立商品库录入名称、单位与默认保质期,采购回家扫码入库,库存看板自动按保质期排序。
项目最后更新 2026 年,v4.7.0 更新日志包含库存筛选与移动端优化,建议定期备份数据目录。
截图与演示说明

上图为 Grocy 家庭库存管理系统的库存概览页,统计卡片显示商品总数、过期与临期数量。
购物清单与餐食计划页面支持按周规划菜谱,家务页面可分配任务与轮值,全部界面已汉化。
Grocy 的库存概览页还会用红黄底色区分过期与临期商品,餐食计划页按周展示菜谱排期,全部页面在手机浏览器中同样可用。
常见问题
问:Grocy 是什么软件?
Grocy 是一款开源的家庭库存管理系统,把企业进销存思路用于家庭场景,管理食品保质期、采购计划与家务安排,常被称为冰箱之外的家庭 ERP。
问:Grocy 源码怎么下载部署?
从本页下载源码包解压后,可用 Docker 一条命令启动,或部署到 PHP 8.5 以上环境,初始化数据库后即可扫码入库使用。
问:和 Homebox 对比有什么区别?
与 Homebox 对比,Grocy 的进销存逻辑更完整,原生支持条码扫描与保质期提醒,还附带家务分工与餐食计划模块。
问:Grocy 免费吗,可以商用吗?
项目采用 MIT 许可证开源,允许自由使用、修改、再分发和商用,仅需保留版权声明,无订阅费用。
安全风险提示
对 278 个 PHP 与前端文件做了高风险函数扫描,base64_decode 与 exec 命中均为图片处理等常规调用,未发现 webshell、后门或加密混淆文件。
默认管理员账号务必首次登录即改密码,部署在公网时建议反代加认证并收紧 CORS,数据库备份建议放在数据目录之外。
下载说明
本页提供 Grocy 家庭库存管理系统的完整源码打包下载,含全部 PHP 代码、语言文件与部署文档,适合家庭服务器与 NAS 部署。
压缩包为原始仓库文件,下载后解压按部署提示操作即可,后续版本可通过官方更新日志跟进。
GitHub项目开源地址:https://github.com/grocy/grocy