Grocy 容器

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

标签与变体

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

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

使用说明

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

快速启动

# 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 数据目录

# 运行 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 服务 }

```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:

Podman systemd 服务示例（Quadlet）

在 127.0.0.1:8080 运行 Grocy，以 grocy 用户身份，绑定挂载 /data 卷。

# 创建 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