bbx0/grocy

Grocy 容器

基于 PHP 官方 Docker 镜像 构建的 Grocy 发行版，是 Grocy 社区的用户贡献项目。

标签与变体

最新的 Grocy 版本 通过 GitHub 工作流 持续构建并发布为共享标签。:latest 标签对应当前版本，版本更新日志可查看 Grocy 发布页。

容器镜像支持多平台构建：linux/amd64 和 linux/arm64。已停止维护的标签会尽力构建，但最终将被移除。

使用说明

容器需挂载 /data 卷，Grocy 服务暴露在 8080 端口。默认登录账号 admin:admin，请务必修改密码！

快速启动

yaml
# compose.yaml
# 用法：
#  - docker compose up
#  - docker-compose run --no-TTY --rm app
name: grocy
services:
  app:
    image: bbx0/grocy
    read_only: true
    ports:
      - "127.0.0.1:8080:8080"  # 访问 [***]    environment:
      - GROCY_CURRENCY=EUR    # 设置货币为欧元
    volumes:
      - ./data:/data          # Grocy 数据目录

bash
# 运行 Grocy 实例（8080 端口，/data 卷，货币设为欧元）
docker run --rm --read-only --publish 8080:8080 -e GROCY_CURRENCY=EUR -v ./data:/data bbx0/grocy

# 运行临时演示实例（8080 端口）
docker run --rm --read-only --publish 8080:8080 -e GROCY_MODE=demo bbx0/grocy

配置方式

通过环境变量配置，前缀为 GROCY_。具体可配置项参考 config-dist.php，例如 GROCY_CURRENCY=EUR 设置货币为欧元。建议通过反向代理处理 SSL 和 HTTP 配置。

Caddy 反向代理示例

以下示例使用 Caddy 作为反向代理，通过自签名证书、10MB 上传大小限制，将 Grocy 暴露在 `[] Caddyfile [] { request_body { max_size 10MB # 上传文件大小限制 } encode zstd gzip # 启用压缩 reverse_proxy h2c://app:8080 # 反向代理到 Grocy 服务 } __CODE_TOKEN_2__yml

compose.yml

name: grocy services: app: image: bbx0/grocy read_only: true volumes: - grocy_data:/data environment: - GROCY_CURRENCY=EUR reverse-proxy: image: caddy:2 ports: - "8443:443" volumes: - ./Caddyfile:/etc/caddy/Caddyfile - caddy_data:/data volumes: grocy_data: caddy_data: __CODE_TOKEN_3__bash

创建 grocy 用户并允许后台运行服务

sudo useradd -m grocy sudo loginctl enable-linger grocy

登录 grocy 用户

sudo machinectl shell grocy@.host

切换到 grocy 用户后执行

mkdir -p ~/.config/containers/systemd mkdir -p ~/data

创建容器配置文件

cat >.config/containers/systemd/grocy.container <<-'EOF' [Unit] Description=Grocy

[Container] Image=ghcr.io/bbx0/grocy AutoUpdate=registry LogDriver=journald ReadOnly=true

PublishPort=127.0.0.1:8080:8080/tcp Volume=%h/data:/data

Environment=GROCY_CURRENCY=EUR

[Install] WantedBy=default.target EOF

生成 systemd 服务并启动 Grocy

systemctl --user daemon-reload systemctl --user start grocy.service