greyltc/gollum

docker-gollum 镜像文档

镜像概述和主要用途

docker-gollum镜像定义了一个安装有gollum维基服务器的Docker容器。gollum是一款基于Git的维基服务器，允许用户通过网页界面创建、编辑和管理文档，所有内容均存储在Git仓库中，支持版本控制和历史记录追踪。该镜像旨在简化gollum的部署流程，提供开箱即用的维基服务环境。

核心功能和特性

• Git集成：所有维基内容存储在Git仓库中，支持提交历史查看、版本比较和回滚操作
• 网页界面：提供直观的网页编辑界面，支持多种标记语言（如Markdown、Textile等）
• 容器化部署：通过Docker容器封装，避免环境依赖问题，简化安装和配置过程
• 轻量级：镜像体积小，资源占用低，适合个人或小型团队使用

使用场景和适用范围

• 个人知识库：用于管理个人笔记、学习资料和文档，支持版本跟踪
• 团队协作：小型团队的内部文档协作平台，方便多人共同编辑和维护文档
• 项目文档：项目的技术手册、API文档或使用指南管理，结合Git实现文档版本控制

使用方法和配置说明

基本启动方式

可通过docker run命令直接启动容器，示例如下：

bash
docker run -d -p 4567:4567 -v /path/to/local/git/repo:/wiki gollum

参数说明：

• -d：后台运行容器
• -p 4567:4567：端口映射，将容器的4567端口（gollum默认端口）映射到主机的4567端口
• -v /path/to/local/git/repo:/wiki：挂载本地Git仓库目录到容器内的/wiki目录（gollum将使用此目录存储维基内容）

通过启动脚本运行

若提供了启动脚本（如run-docker-gollum.sh），可通过以下方式执行：

bash
# 赋予脚本执行权限
chmod +x run-docker-gollum.sh

# 运行脚本启动容器
./run-docker-gollum.sh

注：启动脚本通常包含预设的容器配置参数（如端口映射、数据卷挂载等），具体配置需参考脚本内部说明。

访问维基服务

容器启动后，通过浏览器访问 http://localhost:4567 即可打开gollum维基界面，开始创建和管理文档。