MENU

从厨房到储物间:Grocy 家庭的智能物资管理助手

• September 5, 2025 • Read: 28 • 编码👨🏻‍💻

Grocy 介绍

image-20250508193259107

Grocy 是一款自助式杂货和家庭管理解决方案,可用于记录物品信息并根据个性化需求进行管理。此外,它还支持手机端的条形码扫描功能,方便您清理家庭杂物,避免使用过期物品。Grocy 支持各种客户端,包括 iOS、Android、Windows,并且还提供 智能家居 软件 Home Assistant 插件支持。

🚢 项目地址

🚀Grocy 特征

  • 🧾家庭综合管理功能:支持购物清单、家庭用品库存、日常任务及食谱管理,覆盖家庭生活的多个方面,提升组织效率。
  • 条码扫描与批处理:内置强大的条形码扫描功能,结合批量处理操作,简化库存更新流程,提高管理效率。
  • 📱移动端便捷操作:提供移动端应用( Android,IOS)通过官方 API 实现与网页端的无缝同步,支持随时随地管理家庭事务。
  • 🍔 减少食物浪费:通过精确跟踪食品库存和有效期,帮助用户合理规划使用,降低浪费概率。
  • 🌐时间与精力节省:自动化的清单生成和库存提醒功能,减少人工记录的时间消耗,简化日常琐事管理。
  • 🧹界面直观易用:提供简洁美观的网页界面和桌面端应用(如 Desktop 💻 电脑端),操作流畅易上手,适合长期使用。
  • 🔑开源与自托管: 采用开源模式,用户可以自行部署并托管数据,保证隐私安全,同时具备高度灵活性。

🛠️ 部署 Grocy 服务端

👻 先决条件/要求

  • 最低 512MB RAM(推荐 1GB+)
  • 具备 docker,docker-compose 环境

🐳 使用 Docker Compose 部署

services:
  grocy:
    #image: lscr.io/linuxserver/grocy:latest
    image: docker.cnb.cool/srebro/docker-images-chrom/grocy  ##使用 CNB 镜像加速
    container_name: grocy
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - ./config:/config
    ports:
      - 9283:80
    restart: unless-stopped

部署完成后,通过浏览器访问 http://< 你的服务器 IP 或域名 >:9283 即可使用 Grocy。

Grocy Docker 默认的账户密码都是 admin/ admin

image-20250508194412466

  • 设置语言为中文,点击右上角的菜单,然后选择「User settings」,接着在语言选项中选择中文。

image-20250508194439206

  • 点 OK 之后,界面就是简体中文了

image-20250508194353039

image-20250508194544163

📱 移动端

下载 APP

支持安卓和苹果移动端设备,WIN 电脑桌面版本

image-20250508220148261

1746712921257_d

image-20250508200216552

服务端配置 API 密钥

如果你想在移动设备上扫描物品的条形码,需要在服务端配置 API 密钥。点击右上角的菜单,选择「管理 API 秘钥」,然后点击「添加」和「生成 API 秘钥」。

image-20250508195235492

image-20250508195257922

image-20250508195313001

🍎 苹果 ios 移动端 演示

  • 登录 APP,修改语言为中文

1746714017386_d

  • 设置私人服务器配置

    1746714268682_d

🍑 功能截图

  • 库存总览

image-20250508223442534

  • 购物清单

image-20250508223421754

  • 菜谱

image-20250508223403085

  • 饮食计划

image-20250508223459333

  • 家务总览

image-20250508223514279

  • 家中电器设备

image-20250508223533015

🧭 使用 Nginx 反向代理

#Grocy
  server {
        listen       443 ssl;
        server_name  grocy.srebro.cn;  ##替换成自己的域名
        error_page  404              /404/404.html;
        charset utf-8;

        ssl_certificate /home/application/nginx/cert/srebro.cn.pem; 
        ssl_certificate_key /home/application/nginx/cert/srebro.cn.key;
        ssl_session_cache    shared:SSL:1m;
        ssl_ciphers  HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers  on;

    location / {
    proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header x-wiz-real-ip $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://localhost:9283;
        }
}

🎁 获取 Grocy

Archives Tip
QR Code for this page
Tipping QR Code