这是一个基于Docker官方PHP镜像构建的Grocy应用发行版本,Grocy作为一款开源的家庭管理工具,主要用于高效管理家庭库存、购物清单、膳食计划及资产等日常事务,而依托Docker官方PHP镜像则能确保应用部署的便捷性、环境隔离性与跨平台兼容性,帮助用户快速搭建稳定的家庭管理系统,满足个性化的家庭生活管理需求。
Grocy 容器
[ ] [ ]
基于 [PHP 官方 Docker 镜像] 构建的 [Grocy] 发行版,是 Grocy 社区的用户贡献项目。
标签与变体
最新的 [Grocy 版本] 通过 [GitHub 工作流] 持续构建并发布为共享标签。:latest 标签对应当前版本,版本更新日志可查看 [Grocy 发布页] 。
| 标签 | 说明 |
|---|---|
| [ghcr.io/bbx0/grocy:latest] [ghcr.io/bbx0/grocy:4.5] | 当前版本 |
| [ghcr.io/bbx0/grocy:4.4] | 已停止维护,请升级 |
| [ghcr.io/bbx0/grocy:4.3] | 已停止维护,请升级 |
容器镜像支持多平台构建: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: docker.xuanyuan.run/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 docker.xuanyuan.run/bbx0/grocy # 运行临时演示实例(8080 端口) docker run --rm --read-only --publish 8080:8080 -e GROCY_MODE=demo docker.xuanyuan.run/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
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务