杂货和家庭管理解决方案Grocy

发表于 2023-03-27 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2.3k 阅读时长 ≈ 2 分钟

Grocy 是一个基于网络的自托管杂货和家庭管理解决方案。

本文软件得到网友 AleixCox 和 逍遥客 的推荐

什么是 Grocy ？

Grocy 是一个基于网络的自托管杂货和家庭管理解决方案。

什么是 Grocy Android ?

Grocy Android 使用 Grocy 的官方 API 在手机上为您提供一个漂亮的界面，具有强大的条形码扫描和直观的批处理功能，所有这些都是您高效管理杂货所需的。

安装

在群晖上以 Docker 方式安装。

官方的 docker 分为了前、后端，而 linuxserver 的版本是单镜像的，为了省事老苏选择了后者 😂

在注册表中搜索 grocy ，选择第一个 linuxserver/grocy，版本选择 latest。

latest 对应的版本为 3.3.2

卷

在 docker 文件夹中，创建一个新文件夹 grocy，并在其中建一个子文件夹 data

文件夹	装载路径	说明
`docker/grocy/data`	`/config`	存放设置

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`9283`	`80`

默认同时暴露了 80 和 443

老苏只保留了 80

环境

可变	值
`PUID`	`<uid>` 设置为 `1000`
`PGID`	`<gid>` 设置为 `1000`
`TZ`	设置为 `Asia/Shanghai`

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 grocy 和 子目录
mkdir -p /volume2/docker/grocy/data

# 进入 grocy 目录
cd /volume2/docker/grocy

# 运行容器
docker run -d \
  --restart unless-stopped \
  --name=grocy \
  -p 9283:80 \
  -v $(pwd)/data:/config \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  linuxserver/grocy:latest

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

version: "2.1"

services:
  grocy:
    image: linuxserver/grocy:latest
    container_name: grocy
    restart: unless-stopped
    volumes:
      - ./data:/config
    ports:
      - 9283:80
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai

然后执行下面的命令

# 新建文件夹 grocy 和 子目录
mkdir -p /volume2/docker/grocy/data

# 进入 grocy 目录
cd /volume2/docker/grocy

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:9283 就能看到主界面

默认账号密码是 admin/admin

中文

在菜单中找到 User settings

Language 中找到 Chinese（china)

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

移动端

在菜单中找到 管理 API 秘钥

点 添加，生成 API 秘钥

点前面的按钮，显示为二维码

官方没有提供移动端，老苏找了一个

源代码：https://github.com/patzly/grocy-android
客户端下载：https://f-droid.org/packages/xyz.zedler.patrick.grocy/

包不大，还不到 10M

安装完成后，选择 私有服务器

手动输入显然是比较麻烦的，直接用摄像头扫网页上的二维码

扫描完成后，就可以开始使用了

所谓的 初学者模式，就是会默认显示帮助文本

iOS 端可以去 App Store 里找

RESTful API

在浏览器中输入 http://群晖IP:9283/api ，就会看到 API 接口

你可以使用 Grocy 的官方 API，开发更适合自己习惯的客户端。

参考文档

grocy/grocy: ERP beyond your fridge - grocy is a web-based self-hosted groceries & household management solution for your home
地址：https://github.com/grocy/grocy

grocy - ERP beyond your fridge
地址：https://grocy.info/

docs/chores.md at master · grocy/docs
地址：https://github.com/grocy/docs/blob/master/tutorials/chores.md

linuxserver/docker-grocy: A container for grocy - the ERP application for your kitchen https://grocy.info
地址：https://github.com/linuxserver/docker-grocy

grocy/grocy-docker: ERP beyond your fridge - now containerized - this is the docker repo of https://github.com/grocy/grocy
地址：https://github.com/grocy/grocy-docker