Grocy是一款基于Web的自托管家庭库存与家务管理系统，被誉为"家庭资源规划系统"。这款开源工具能帮助您高效管理家庭库存、购物清单、菜谱和日常家务，让家庭管理变得简单有序。本文将为您详细介绍Grocy的核心功能、安装方法和常见问题解决方案。
项目地址: https://gitcode.com/GitHub_Trending/gr/grocy ✨ 为什么选择Grocy家庭管理方案？
Grocy提供了一套完整的家庭管理解决方案，让您告别混乱的纸质清单和分散的Excel表格。通过智能的库存跟踪、自动化的购物清单管理和直观的界面设计，Grocy真正实现了数字化家庭管理的梦想。
库存管理界面
🛒 核心功能模块详解
库存管理 - 实时跟踪食品和日用品库存，设置保质期提醒，避免浪费 购物清单 - 智能生成购物清单，根据库存自动推荐需要购买的商品 菜谱管理 - 创建个人菜谱库，根据现有食材推荐可制作的菜肴 家务计划 - 安排和跟踪日常家务任务，确保家庭事务井井有条
🚀 快速安装部署指南
Docker一键部署（推荐）
docker run -d --name=grocy \
-p 9283:80 \
-v /path/to/grocy/data:/config \
linuxserver/grocy:latest
传统安装方法
- 克隆项目仓库：
git clone https://gitcode.com/GitHub_Trending/gr/grocy - 复制配置文件：
cp config-dist.php data/config.php - 配置Web服务器指向
public目录 - 设置
data目录为可写权限 - 访问网站并使用默认账户登录（用户名：admin，密码：admin）
🔧 常见问题及解决方案
问题1：无法访问安装页面
解决方案：检查Web服务器配置，确保根目录指向public文件夹，同时确认data目录具有写入权限。
问题2：数据库迁移失败
解决方案：查看更新脚本确保使用正确的迁移流程，或手动执行migrations目录中的SQL文件。
问题3：条形码扫描功能无法使用
解决方案：确保使用HTTPS协议访问，因为浏览器安全限制要求摄像头功能必须在安全连接下使用。
问题4：自定义CSS/JS不生效
解决方案：在data目录下创建custom_js.html或custom_css.html文件。
📱 移动端使用技巧
Grocy支持PWA（渐进式Web应用），您可以将它安装到手机主屏幕，获得类似原生应用的体验。在支持PWA的浏览器中访问您的Grocy实例，浏览器会自动提示"添加到主屏幕"。
🎯 高级功能配置
REST API集成
Grocy提供完整的REST API，您可以通过API控制器实现自动化操作，如批量导入商品信息或与智能家居系统集成。
条形码外部查询
通过配置条形码查询插件，您可以实现商品信息的自动获取，大大简化库存录入工作。
💡 实用小贴士
- 日期快捷输入：在日期字段中输入"0517"会自动转换为当前年份的5月17日
- 键盘快捷键：带有粗体字母的按钮都可以通过键盘快捷键操作
- 批量操作：利用通用实体API实现数据的批量处理
家务管理界面
🔄 系统维护与更新
定期使用更新脚本进行系统升级，该脚本会自动备份当前配置并应用最新更新。建议每月检查一次新版本发布情况。
📊 数据备份策略
Grocy的所有配置和数据都存储在data目录中，定期备份此目录即可确保数据安全。更新时只需保留data目录，覆盖其他文件即可完成升级。
通过本文的介绍，相信您已经对Grocy有了全面的了解。这款强大的家庭管理工具将帮助您建立有序的家庭生活，让管理家务变得轻松愉快！🎉
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
