5154

Good Luck To You!

centos gollum 搭建

环境准备

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

centos gollum 搭建

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

centos gollum 搭建

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 无需认证,建议通过防火墙限制访问:

centos 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 命令创建用户密码文件。

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。

«    2026年1月    »
1234
567891011
12131415161718
19202122232425
262728293031
控制面板
您好,欢迎到访网站!
  查看权限
网站分类
搜索
最新留言
    文章归档
    网站收藏
    友情链接

    Powered By Z-BlogPHP 1.7.3

    Copyright Your WebSite.Some Rights Reserved.