OpenSource-Hub
G

gollum

14.3k stars·开发工具·已提供 SHA-256 校验码,下载后可自行核对文件完整性

一个基于 Git 的简单 Wiki 系统,用文本文件管理页面,自带网页编辑和版本控制。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

把 Wiki 直接存进 Git 仓库,本地编辑,自动版本管理。

核心功能

  • 基于 Git:所有页面都是 Git 仓库中的文本文件,天然拥有版本历史、回滚和分支管理
  • 多种标记语言:支持 Markdown、RDoc、AsciiDoc、MediaWiki、Textile 等十余种格式
  • 兼容 GitHub/GitLab:可直接克隆远程 Wiki 仓库,离线编辑后推送同步
  • 内置网页编辑器:无需额外工具,浏览器即可创建和编辑页面
  • 高级功能:支持 Mermaid/PlantUML 图表、数学公式、BibTeX 引用、CriticMarkup 注释、宏、重定向和 RSS 订阅

避坑指南

  • Windows 上必须使用 JRuby,普通 Ruby 无法运行;安装前请确保 Git 已配置;部分标记语言渲染器(如 AsciiDoc、MediaWiki)需要额外安装对应的 gem 或依赖;默认监听 4567 端口,注意防火墙设置;首次使用建议阅读官方 Wiki 了解配置选项。

适用场景

  • 团队内部知识库:配合 Git 服务器(如 GitLab、GitHub)搭建私有 Wiki
  • 个人笔记系统:用 Git 管理笔记,随时回溯和同步
  • 项目文档:将技术文档、API 说明以 Wiki 形式托管在 Git 仓库中
  • 离线文档编辑:克隆远程 Wiki 到本地,在没有网络的环境下编辑和预览

详细介绍

Gollum 是一个基于 Git 的轻量级 Wiki 系统。它不使用数据库,而是将所有页面作为纯文本或标记文件存储在 Git 仓库中。你可以用自己喜欢的编辑器或内置网页界面编辑页面,每次修改都会自动进行版本管理。Gollum 支持 Markdown、RDoc、AsciiDoc、Creole、MediaWiki、Org、Pod、ReStructuredText、Textile 等多种标记语言。它兼容 GitHub 和 GitLab 的 Wiki,因此你可以克隆远程 Wiki 仓库、本地编辑后再推送。高级功能包括 Mermaid/PlantUML 图表、BibTeX 引用、CriticMarkup 注释、数学公式(KaTeX/MathJax)、宏、重定向和 RSS 订阅。Gollum 在类 Unix 系统和 Windows(通过 JRuby)上均可运行,支持作为 Ruby Gem、Docker 容器或 Java WAR 文件部署。

常见问题与排障 (1)

故障排除
为什么Gollum会将我代码块中的尖括号渲染为宏,如何修复?

Gollum 可能会误解包含尖括号的内联代码块(例如 <address>[;<options>])为 Gollum 宏。要避免此问题,请将代码块放在单独的行中,使用独立行上的三个反引号:


[<device>][=<mac-address>]:<address>[;<options>]

这样可以阻止 Gollum 将内容解析为宏。如果使用 Docker 镜像,则无需更改 gem;这是一种格式解决方法。

来源 Issue #2173

标签

wikigitmarkdowndocumentationversion-controlruby

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤 1:确保已安装 Ruby(推荐 2.5+)或 Docker/Java(选择一种方式)

4

步骤 2:安装 Gollum:gem install gollum(Ruby 方式)或 docker pull gollumwiki/gollum

5

步骤 3:进入一个已初始化的 Git 仓库目录,运行 gollum .

安装指引
  1. 步骤 1:确保已安装 Ruby(推荐 2.5+)或 Docker/Java(选择一种方式)
  2. 步骤 2:安装 Gollum:gem install gollum(Ruby 方式)或 docker pull gollumwiki/gollum
  3. 步骤 3:进入一个已初始化的 Git 仓库目录,运行 gollum .
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

若通过 Gem 安装,执行 gem uninstall gollum;若通过 Docker,执行 docker rmi gollumwiki/gollum,并删除相关容器;若通过 WAR 包,删除 jar 文件即可。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议MIT
最后更新2026-06-26 07:15:15
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

1 FAQ

相似推荐