garywiz/docker-grav

Grav Flat-File CMS Docker镜像

镜像概述

Grav是一款快速、简洁、灵活的Web平台，本Docker镜像预安装了Grav及其管理插件，并配置了Nginx服务器，可快速启动并使用Grav CMS。镜像体积轻量，支持持久化存储、环境变量配置、SSL证书管理等功能，便于升级和维护。

核心功能

• 轻量高效：体积约100MB，包含预配置的Nginx服务器和完整Grav安装（含管理插件）；
• 持久化存储：支持挂载外部存储目录，分离容器与数据，便于镜像升级；
• 灵活配置：通过环境变量自定义日志、管理员账号等设置，无需重新构建镜像；
• SSL支持：自动生成自签名SSL证书，或支持自定义合法证书；

使用场景

• 个人博客或小型网站的快速部署；
• 开发测试环境中快速搭建Grav CMS；
• 需要灵活配置和易于维护的CMS解决方案；

配置说明

快速启动

直接从Docker Hub拉取镜像并运行：

bash
docker pull docker.xuanyuan.run/garywiz/docker-grav
docker run -d -p 8080:8080 docker.xuanyuan.run/garywiz/docker-grav

访问http://localhost:8080即可使用，默认管理员账号为admin，密码ChangeMe。

使用Launcher脚本

提取Launcher脚本并启用持久化存储：

bash
docker run -i --rm docker.xuanyuan.run/garywiz/docker-grav --task get-launcher | sh
mkdir docker-grav-storage
./run-docker-grav.sh -d

持久化数据将存储在docker-grav-storage目录中。

自定义Grav

交互式运行容器，使用grav和gpm命令进行自定义操作：

bash
./run-docker-grav.sh
# 在容器内执行命令（示例）
gpm install theme-quark  # 安装主题

持久化存储配置

挂载外部目录到容器/apps/var，并匹配用户权限：

bash
docker run -d -v /persist/gravsite:/apps/var docker.xuanyuan.run/garywiz/docker-grav --create-user anyuser:/apps/var

日志配置

通过环境变量CONFIG_LOGGING设置日志方式：

• stdout（默认）：日志输出到标准输出；
• file：日志保存到var/log/syslog.log；
• syslog:hostname：发送到指定syslog服务器；

自定义SSL证书

1. 运行容器初始化持久化存储目录；
2. 将自定义PEM格式证书重命名为ssl-cert-<hostname>.crt和ssl-cert-<hostname>.key，替换certs目录下的文件；
3. 重启容器即可生效；

已知问题

• 容器内未安装邮件服务，忘记密码等功能无法使用；
• 部分Grav插件未经过测试；
• 持久化存储时，新安装的插件存储在外部目录，管理插件随容器升级；

许可证

本镜像基于Apache License 2.0授权，详情见http://www.apache.org/licenses/LICENSE-2.0%E3%80%82