BYR-Navi：一个开源、美观且可以部署在GitHub Pages的网站导航程序

博主： Rat's
发布时间：2019 年 11 月 21 日
61148 次浏览
39 条评论
5523 字数
分类：建站知识

说明：BYR-Navi是一个开源、轻量使用Fomantic UI Web框架构建的网站导航程序，样式也非常美观，而且支持从N个站点直接搜索，我们既可以部署在自己的服务器上，又可以部署在GitHub Pages，后者无需服务器，这里水个稍微完整点的教程，有需求的可以搭建个玩玩。

截图

请输入图片描述

安装

演示地址：https://byr-navi.com

Github地址：https://github.com/BYR-Navi/BYR-Navi

1、安装Ruby

#导入密钥
gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
#安装稳定版
curl -sSL https://get.rvm.io | bash -s stable
#载入RVM环境
source /etc/profile.d/rvm.sh
#安装Ruby 2.6.3
rvm install ruby 2.6.3
#设置为默认版本
rvm use 2.6.3 --default

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

2、安装Jekyll

gem install jekyll

3、安装BYR-Navi

#拉取源码
git clone https://github.com/BYR-Navi/BYR-Navi
#安装依赖
cd BYR-Navi
bundle i

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

#CentOS
yum -y install git
#Debian、Ubuntu
apt install git -y

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

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

都修改完成后，启动：

#运行端口为8989，自行修改
bundle exec jekyll serve -H 0.0.0.0 -P 8989 --detach

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

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

#CentOS 6
iptables -I INPUT -p tcp --dport 8989 -j ACCEPT
service iptables save
service iptables restart

#CentOS 7
firewall-cmd --zone=public --add-port=8989/tcp --permanent
firewall-cmd --reload

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

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

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

安装Matomo

官方网站：https://matomo.org

这个安装教程博主很久前水过，不过是手动的，有点复杂，这里就直接找了个配置比较简单的Docker镜像进行安装。

Docker地址：https://github.com/crazy-max/docker-matomo

1、安装Docker

#CentOS 6
rpm -iUvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
yum update -y
yum -y install docker-io
service docker start
chkconfig docker on

#CentOS 7、Debian、Ubuntu
curl -sSL https://get.docker.com/ | sh
systemctl start docker
systemctl enable docker

2、拉取镜像

#拉取Matomo镜像
docker run --restart=always -d --name matomo \
-p 8000:8000 \
-v ~/matomo/data:/data \
crazymax/matomo

#拉取Mysql镜像，记得修改数据库信息，如果你服务器已经安装过Mysql数据库，可以跳过该步骤
docker run --restart=always --name mysqlmatomo -d \
-p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=matomo123 \
-e MYSQL_DATABASE=matomo \
-e MYSQL_USER=matomo \
-e MYSQL_PASSWORD=matomo123 \
-v ~/matomo/mysql:/var/lib/mysql \
mysql:5.6

安装完成后打开ip:8080即可访问。如果访问不了的话，可以查看上面的教程，开放端口即可。

然后这里需要注意的是Database Server需要填上你的ip地址，而且数据库端口，比如3306需要防火墙放行，不然会连接不上。

安装到最后一步的时候，如果你填的ip地址，那么可能进入不了，可以编辑/root/matomo/data/config/config.ini.php ，修改trusted_hosts[]参数为你的访问地址。

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

#url为matomo站点，domain为导航站，site_id为matomo站点统计站id，token为matomo站点的token
matomo:
  url: http://matomo.moerats.com/
  domains:
  - "http://byr.moerats.com"
  site_id: 2
  token: 297bd600834c2a5a70293c47a

参数获取大致路径如下：

1、site_id
在后台添加一个网站统计，就可以直接看到网站id
2、token
该参数可以在Settings里获取API Authentication Token

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

部署到GitHub Pages

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

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

1、配置Git SSH密钥

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

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

cd ~
ssh-keygen -t rsa

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

cat ~/.ssh/id_rsa.pub

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

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

3、推送到Github

#进入源码的_site文件夹
cd /root/BYR-Navi/_site
#初始化你的github仓库
git init
#关联到远程github仓库，后面为仓库SSH地址，新建仓库后会返回给你该地址
git remote add origin git@github.com:iiiiiii1/iiiiiii1.github.io.git
#把目录下所有文件更改状况提交到暂存区，包括增，删，改。
git add -A
#提交更改的说明，说明随意了，这里为push
git commit -m "push"
#开始推送到Github
git push -u origin master

推送的时候可能会提示The authenticity of host 'github.com' can't be established.信息，直进yes即可。

然后推送完就可以看到仓库的推送文件了。
请输入图片描述

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

4、绑定域名
有的可能不习惯用github的域名，这里可以绑定自己的域名。

先解析域名的CNAME记录到你的https://你的用户名.github.io域名。如果你想用Https访问，可以使用CloudFlare解析域名，并开启CDN强制Http转Https。
请输入图片描述
然后访问你的博客Git项目地址，点击Create new file新建文件，命名CNAME，内容写上你的域名，不要http等。

这时候就可以通过自己的域名访问导航站了，最后该程序定制啥的很灵活，想深度修改的话可以看下官方文档→传送门。

版权声明：本文为原创文章，版权归 Rat's Blog 所有，转载请注明出处！
本文链接：https://www.moerats.com/archives/1004/
如教程需要更新，或者相关链接出现404，可以在文章下面评论留言。

Vultr新用户注册送100美元/16个机房按小时计费，支持支付宝，【点击查看】。

最后修改：2019 年 11 月 21 日 08 : 06 PM

发表评论取消回复

评论 *

私密评论

名称 *

邮箱 *

地址

39 条评论

aaa
February 26th, 2023 at 02:31 am

大佬能不能出一个宝塔搭建的教程

回复
sss
August 8th, 2021 at 09:48 pm

宝塔怎么安装呀

回复
xy
December 27th, 2020 at 11:22 am

root@VM-8-11-ubuntu:/BYR-Navi# bundle exec jekyll serve -H ’ip‘ -P 4000
Configuration file: /BYR-Navi/_config.yml
Source: /BYR-Navi Destination: /BYR-Navi/_site
Incremental build: disabled. Enable with --incremental
Generating... done in 0.117 seconds.
Auto-regeneration: enabled for '/BYR-Navi'
------------------------------------------------ Jekyll 4.2.0 Please append `--trace` to the `serve` command for any additional information or backtrace. ------------------------------------------------
Traceback (most recent call last):
39: from /root/gems/bin/bundle:23:in `<main>' 38: from /root/gems/bin/bundle:23:in `load' 37: from /root/gems/gems/bundler-2.2.3/exe/bundle:37:in `<top (required)>' 36: from /root/gems/gems/bundler-2.2.3/lib/bundler/friendly_errors.rb:130:in `with_friendly_errors' 35: from /root/gems/gems/bundler-2.2.3/exe/bundle:49:in `block in <top (required)>' 34: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli.rb:24:in `start' 33: from /root/gems/gems/bundler-2.2.3/lib/bundler/vendor/thor/lib/thor/base.rb:485:in `start' 32: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli.rb:30:in `dispatch' 31: from /root/gems/gems/bundler-2.2.3/lib/bundler/vendor/thor/lib/thor.rb:392:in `dispatch' 30: from /root/gems/gems/bundler-2.2.3/lib/bundler/vendor/thor/lib/thor/invocation.rb:127:in `invoke_command' 29: from /root/gems/gems/bundler-2.2.3/lib/bundler/vendor/thor/lib/thor/command.rb:27:in `run' 28: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli.rb:497:in `exec' 27: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli/exec.rb:28:in `run' 26: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli/exec.rb:63:in `kernel_load' 25: from /root/gems/gems/bundler-2.2.3/lib/bundler/cli/exec.rb:63:in `load' 24: from /root/gems/bin/jekyll:23:in `<top (required)>' 23: from /root/gems/bin/jekyll:23:in `load' 22: from /root/gems/gems/jekyll-4.2.0/exe/jekyll:15:in `<top (required)>' 21: from /root/gems/gems/mercenary-0.4.0/lib/mercenary.rb:21:in `program' 20: from /root/gems/gems/mercenary-0.4.0/lib/mercenary/program.rb:44:in `go' 19: from /root/gems/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `execute' 18: from /root/gems/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `each' 17: from /root/gems/gems/mercenary-0.4.0/lib/mercenary/command.rb:221:in `block in execute' 16: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:86:in `block (2 levels) in init_with_program' 15: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/command.rb:91:in `process_with_graceful_fail' 14: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/command.rb:91:in `each' 13: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/command.rb:91:in `block in process_with_graceful_fail' 12: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:102:in `process' 11: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:215:in `start_up_webrick' 10: from /root/gems/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:215:in `new' 9: from /usr/lib/ruby/2.7.0/webrick/httpserver.rb:47:in `initialize' 8: from /usr/lib/ruby/2.7.0/webrick/server.rb:108:in `initialize' 7: from /usr/lib/ruby/2.7.0/webrick/server.rb:127:in `listen' 6: from /usr/lib/ruby/2.7.0/webrick/utils.rb:65:in `create_listeners' 5: from /usr/lib/ruby/2.7.0/socket.rb:763:in `tcp_server_sockets' 4: from /usr/lib/ruby/2.7.0/socket.rb:227:in `foreach' 3: from /usr/lib/ruby/2.7.0/socket.rb:227:in `each' 2: from /usr/lib/ruby/2.7.0/socket.rb:765:in `block in tcp_server_sockets' 1: from /usr/lib/ruby/2.7.0/socket.rb:201:in `listen'
总是错误。。。。怎么解决啊

回复
1. Rat's博主
  December 29th, 2020 at 12:10 pm
  
  @xy
  这个看不出来，多看看github项目和谷歌尝试解决下。
  
  回复
seele
December 5th, 2020 at 03:48 pm

大佬，修改了下搜索链接后
提示
Jekyll 4.1.1 Please append --trace to the serve command
for any additional information or backtrace.
怎么解啊

回复
OSCAR
September 28th, 2020 at 11:19 am

你好郁闷小白看不懂安装教程怎么办，买虚拟主机能安装么，谢谢回复

回复
1. Rat's博主
  September 29th, 2020 at 03:56 pm
  
  @OSCAR
  可以本地构建，然后放到虚拟主机上
  
  回复
Masha
April 27th, 2020 at 10:24 am

博主问个小白之小白的问题，可以在搭建好博客的同时，向你一样在左边栏留一个这个导航的标签跳转吗。

回复
1. Rat's博主
  April 28th, 2020 at 12:02 am
  
  @Masha
  一切皆有可能
  
  回复
画星星高手
March 8th, 2020 at 10:22 am

点赞哈哈哈~

回复
枭灵酱
January 17th, 2020 at 05:03 pm

你好，宝塔貌似无法直接安装，想求一下教程!~

回复
1. Rat's博主
  January 19th, 2020 at 12:44 pm
  
  @枭灵酱
  宝塔哪个步骤出了问题？感觉应该与宝塔没啥冲突
  
  回复
牛牛
December 14th, 2019 at 01:31 pm

博主好厉害呀

回复
mo666
November 29th, 2019 at 11:08 pm

能不能使用寶塔面板直接用自己的域名部署？

回复
1. Rat's博主
  November 30th, 2019 at 12:26 am
  
  @mo666
  可以
  
  回复
  1. haha
    December 9th, 2019 at 02:25 am
    
    @Rat's
    求教宝塔搭建的教程
    
    回复
    
    Jaben
    December 4th, 2020 at 02:14 pm
    
    @haha
    _site文件放到网站网站根目录跟整个文件部署到服务器有啥区别么？
    
    回复
    
    Rat's博主
    December 7th, 2020 at 07:25 pm
    
    @Jaben
    site是构建后的静态文件，直接用的话，不好修改其它配置啥的
    
    回复
    
    Rat's博主
    December 10th, 2019 at 01:00 am
    
    @haha
    宝塔可以直接这么安装。
    
    回复

BYR-Navi：一个开源、美观且可以部署在GitHub Pages的网站导航程序

截图

安装

安装Matomo

部署到GitHub Pages

发表评论取消回复

39 条评论

CTList：一个可以绑定多个天翼云网盘的目录列表程序，支持视频播放

博客将不定期赠送DigitalOcean $50优惠码

VPS上传文件到OneDrive网盘脚本，可配合Aria2实现自动上传

免费申请一年期限的AlphaSSL泛域名证书

Aria2+Rclone+DirectoryLister+Aria2Ng一键安装脚本 for Debian

轻量级论坛Carbon Forum搭建教程

Ghost博客一键安装脚本，使用Caddy作为反向代理，并自动签发SSL证书

使用UnblockNeteaseMusic播放网易云音乐客户端无版权歌曲

LNMP中一些隐藏的安装脚本及目录详解

SmartPing：一个服务器Ping值监测工具，带报警功能

截图

安装

安装Matomo

部署到GitHub Pages

发表评论 取消回复

39 条评论

发表评论取消回复