开源软件推荐第二期：一款开源的 页导航程序

这是 阿良的孤岛 推荐的第2款开源软件

一款开源的 页导航程序

大家好，我是技术宅阿良，今天推荐一个小工具/源码，装满你的收藏夹，每天分享一个小技巧，让你轻松节省开发效率，实现不加班不熬夜不掉头发，是我的目标！你是不是厌倦了每天手动输入域名，又没有足够专业好用的导航站，要么就是铺满广告、要么就是信息太杂，何不尝试自己写一个自己专属的导航呢，解放下自己的收藏夹，从现在开始。

平台简介

今天推荐一款开源 站导航程序，使用了Fomantic UI Web框架构建的 站导航程序，样式也非常美观，而且支持从N个站点直接搜索，既可以部署在自己的服务器上，又可以部署在GitHub Pages，后者无需服务器，有需求的可以搭建个玩玩。

开源协议

使用 MIT 开源许可协议

链接地址

北邮人导航github地址

运行效果

演示地址

https://byr-navi.com

快速开始

1、安装Ruby

1.1导入密钥

1.2安装稳定版

1.3载入RVM环境

1.4安装Ruby 2.6.3

1.5设置为默认版本

注：导入期间出现使用No dirmngr 错的话，使用apt install dirmngr，然后重新导入即可。

2、安装Jekyll

3、安装BYR-Navi

3.1拉取源码

3.2安装依赖

如果第一步提示-bash: git: command not found，可以先使用命令：

然后修改配置文件_config.yml，对照原信息，自行修改导航标题，关键词等描述，更深层次的修改可参考官方文档→传送门。

再进入_data文件夹，新增/修改大致导航 站链接，可参考上面的演示地址修改，最后还一个就是统计配置文件analytics.yml，这个需要我们额外安装Matomo，安装和配置可以提前看文章后面。

都修改完成后，启动：#运行端口为4000，自行修改

此时就可以使用ip:4000访问程序了。

如果CentOS系统打不开的话，可能还需要开启8989端口，使用命令：

像阿里云等服务器，还需要去安全组那里开放下端口

这里除了可以使用命令行启动，也可以直接将生成的_site文件夹丢到 站根目录访问

如果要修改导航相关页面的信息显示的话，也可以在_site文件夹中修改

4、安装Matomo

官方 站

这个安装教程有点复杂，这里就直接找了个配置比较简单的Docker镜像进行安装

Docker地址

5、安装Docker

5.1、拉取Matomo镜像

5.2、拉取Mysql镜像

记得修改数据库信息，如果你服务器已经安装过Mysql数据库，可以跳过该步骤

安装完成后打开ip:8080即可访问。

最后配置该导航的话，需要修改配置文件_data/analytics.yml，大致参数如下：

#url为matomo站点，domain为导航站，site_id为matomo站点统计站id，token为matomo站点的token

参数获取大致路径如下：

site_id

在后台添加一个 站统计，就可以直接看到 站id

token

该参数可以在Settings里获取API Authentication Token最后可能会出现跨域问题，导致配置统计后不生效，可以在通用设置中设置跨域资源共享(CROS)白名单域名，将导航站点添加进去即可。

5.3、部署到GitHub Pages

这里部署到GitHub Pages的好处就是不需要服务器，但国内访问的话，有点影响体验，这个就自行选择了。

首先你肯定需要一个Github账 ，没有的可以去注册一个，地址：https://github.com，有了账 就继续看。

5.4、配置Git SSH密钥

由于本地Git仓库和GitHub仓库之间的传输是通过SSH加密的，所以必须要让github仓库认证你SSH key，在操作之前，需要先在服务器上生成SSH key。

我们先去根目录下使用命令：

这里会要你命名密匙名称(这里建议使用默认名称)，然后连续按几次Enter，这时候会在/root/.ssh文件夹生成2个ssh密钥，然后我们查看公钥id_rsa.pub。

查看后，再复制下公钥，然后打开Github官 ，进入https://github.com/settings/ssh/new，Title随便填，然后Key填入刚刚复制的密匙，最后点击Add SSH Key添加即可。

5.5、建立仓库

我们需要先访问https://github.com/new，新建一个仓库用来存放BYR-Navi站点文件，名称填你的用户名.github.io，仓库别加密，不然到时候就访问不到了。

5.6、推送到Github

推送的时候可能会提示The authenticity of host ‘github.com’ can’t be established.信息，直进yes即可。然后推送完就可以看到仓库的推送文件了。

接下来访问https://你的用户名.github.io就可以进入导航 站了。

5.7、绑定域名

有的可能不习惯用github的域名，这里可以绑定自己的域名。先解析域名的CNAME记录到你的https://你的用户名.github.io域名。如果你想用Https访问，可以使用CloudFlare解析域名，并开启CDN强制Http转Https。请输入图片描述然后访问你的博客Git项目地址，点击Create new file新建文件，命名CNAME，内容写上你的域名，不要http等。请输入图片描述这时候就可以通过自己的域名访问导航站了，最后该程序定制啥的很灵活，想深度修改的话可以看下官方文档

学习部署更多开源项目

点击小程序立即 名，仅剩96个名额

（内容的价值取决于您的行动，实践出真知）