环境准备
在开始搭建 Gollum 之前,需要确保系统已安装必要的依赖包,Gollum 是基于 Ruby 的 Wiki 引擎,依赖 Ruby 环境,同时需要 Git 来管理版本控制,更新系统软件包:

sudo yum update -y
安装 Git 和 Ruby 环境:
sudo yum install -y git ruby ruby-devel rubygems
安装 Ruby 依赖时,建议使用 RVM(Ruby Version Manager)来管理 Ruby 版本,避免系统自带 Ruby 版本冲突,安装 RVM:
\curl -sSL https://get.rvm.io | bash -s stable source ~/.rvm/scripts/rvm rvm install ruby-2.7.0 # 安装指定版本 Ruby rvm use ruby-2.7.0 --default
安装 Gollum
安装完成后,通过 RubyGems 安装 Gollum:
gem install gollum
若安装过程中提示缺少依赖(如 libicu-devel),可执行:
sudo yum install -y libicu-devel
安装成功后,验证 Gollum 是否可用:
gollum --version
创建并启动 Wiki
在指定目录创建 Wiki 仓库,/home/wiki:

mkdir /home/wiki && cd /home/wiki git init gollum --config-file /etc/gollum/config.rb --port 8080
默认情况下,Gollum 监听 0.0.0:8080,可通过浏览器访问 http://服务器IP:8080 查看 Wiki 界面。
配置 Gollum(可选)
Gollum 支持通过配置文件自定义行为,创建配置文件 /etc/gollum/config.rb:
set :wiki_title, "My Wiki" set :mathjax, true set :pygments, true
配置文件中可启用 MathJax 公式渲染、代码高亮等功能,重启 Gollum 使配置生效:
pkill -f gollum gollum --config-file /etc/gollum/config.rb --port 8080
部署为系统服务
为方便管理,可将 Gollum 设置为 systemd 服务,创建服务文件 /etc/systemd/system/gollum.service:
[Unit] Description=Gollum Wiki Server After=network.target [Service] Type=simple User=git WorkingDirectory=/home/wiki ExecStart=/usr/local/bin/gollum --config-file /etc/gollum/config.rb --port 8080 Restart=always [Install] WantedBy=multi-user.target
启用并启动服务:
sudo systemctl enable gollum sudo systemctl start gollum
安全与维护
默认情况下,Gollum 无需认证,建议通过防火墙限制访问:

sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --reload
定期备份 Wiki 仓库:
cd /home/wiki git add . git commit -m "定期备份"
FAQs
Gollum 支持哪些 Markdown 扩展?
Gollum 默认支持 GitHub Flavored Markdown(GFM),包括表格、任务列表、自动链接等,可通过配置文件启用数学公式(MathJax)或代码高亮(Pygments)等扩展。
如何为 Gollum 添加用户认证?
Gollum 本身不提供认证功能,但可通过反向代理(如 Nginx)结合 HTTP Basic Auth 或 LDAP 实现,在 Nginx 配置中添加:
location / {
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/.htpasswd;
proxy_pass http://localhost:8080;
}
然后使用 htpasswd 命令创建用户密码文件。