gentics/mesh

Gentics Mesh 服务器 Docker 镜像文档

1. 镜像概述和主要用途

1.1 关于 Gentics Mesh

Gentics Mesh 是一款开源的 API 优先内容管理系统（CMS），具备多语言支持、内容版本控制及细粒度的角色权限管理等核心能力，旨在通过 API 驱动的方式灵活管理和交付内容。

1.2 镜像用途

本 Docker 镜像为 Gentics Mesh 服务器的官方容器化部署包，用于简化 Gentics Mesh 服务的部署流程，支持在容器环境中快速启动和运行 Gentics Mesh 服务实例。

2. 核心功能和特性

• API 优先架构：以 RESTful API 为核心交互方式，支持与各类应用系统灵活集成
• 多语言支持：原生支持多语言内容管理，满足国际化业务需求
• 内容版本控制：提供完整的内容版本追踪与回溯能力，保障内容变更可管理
• 角色权限管理：内置细粒度的角色与权限系统，控制用户对内容和功能的访问范围
• 开源免费：基于开源许可协议发布，支持自由使用、修改和二次开发

3. 使用场景和适用范围

3.1 适用场景

• 开发环境：用于本地或团队开发，快速搭建 Gentics Mesh 服务进行功能验证和集成测试
• 生产环境：可作为生产级部署载体，配合持久化存储和资源配置，提供稳定的 CMS 服务

3.2 注意事项

Gentics Mesh 另有 gentics/mesh-demo 镜像（含基础演示内容），该镜像仅适用于测试目的；本服务器镜像（gentics/mesh）不含演示数据，适用于正式开发或生产环境部署。

4. 使用方法和配置说明

4.1 典型部署命令（Docker Run）

通过以下命令可快速启动 Gentics Mesh 服务，并实现数据持久化：

bash
docker run -v mesh-graphdb:/graphdb -v mesh-uploads:/uploads -p 8080:8080 docker.xuanyuan.run/gentics/mesh

参数说明：

• -v mesh-graphdb:/graphdb：挂载卷 mesh-graphdb 至容器内 /graphdb 目录，用于持久化存储图数据库数据（Gentics Mesh 底层依赖图数据库）
• -v mesh-uploads:/uploads：挂载卷 mesh-uploads 至容器内 /uploads 目录，用于持久化存储上传的媒体文件
• -p 8080:8080：端口映射，将容器内 8080 端口（默认服务端口）映射至主机 8080 端口，外部可通过 http://主机IP:8080 访问服务

4.2 Docker Compose 部署

Gentics Mesh 官方提供了 Docker Compose 配置示例，可参考 https://github.com/gentics/mesh-compose 获取完整配置文件及部署指南。

4.3 数据持久化

Gentics Mesh 服务运行过程中需持久化的数据主要包括图数据库数据（/graphdb）和上传文件（/uploads），建议通过 Docker 卷（Volume）或绑定挂载（Bind Mount）方式确保数据在容器重启或重建后不丢失。

5. 镜像维护与文档参考

5.1 镜像维护方

本镜像由 Gentics Software 官方维护和更新。

5.2 官方文档

完整的使用指南和配置说明可查阅 Gentics Mesh 官方文档站点。