说明:BYR-Navi
是一个开源、轻量使用Fomantic UI Web
框架构建的网站导航程序,样式也非常美观,而且支持从N
个站点直接搜索,我们既可以部署在自己的服务器上,又可以部署在GitHub Pages
,后者无需服务器,这里水个稍微完整点的教程,有需求的可以搭建个玩玩。
1、安装Ruby
导入期间出现使用No dirmngr
报错的话,使用apt install dirmngr
,然后重新导入即可。
2、安装Jekyll
3、安装BYR-Navi
如果第一步提示-bash: git: command not found
,可以先使用命令:
再进入_data
文件夹,新增/修改大致导航网站链接,可参考上面的演示地址修改,最后还一个就是统计配置文件analytics.yml
,这个需要我们额外安装Matomo
,安装和配置可以提前看文章后面。
都修改完成后,启动:
此时就可以使用ip:8989
访问程序了。
如果CentOS
系统打不开的话,可能还需要开启8989
端口,使用命令:
像阿里云等服务器,还需要去安全组那里开放下端口。
这里除了可以使用命令行启动,也可以直接将生成的_site
文件夹丢到网站根目录访问。
如果要修改导航相关页面的信息显示的话,也可以在_site
文件夹中修改。
这个安装教程博主很久前水过,不过是手动的,有点复杂,这里就直接找了个配置比较简单的Docker
镜像进行安装。
1、安装Docker
2、拉取镜像
安装完成后打开ip:8080
即可访问。如果访问不了的话,可以查看上面的教程,开放端口即可。
然后这里需要注意的是Database Server
需要填上你的ip
地址,而且数据库端口,比如3306
需要防火墙放行,不然会连接不上。
安装到最后一步的时候,如果你填的ip地址,那么可能进入不了,可以编辑/root/matomo/data/config/config.ini.php
,修改trusted_hosts[]
参数为你的访问地址。
最后配置该导航的话,需要修改配置文件_data/analytics.yml
,大致参数如下:
参数获取大致路径如下:
最后可能会出现跨域问题,导致配置统计后不生效,可以在通用设置中设置跨域资源共享(CROS
)白名单域名,将导航站点添加进去即可。
这里部署到GitHub Pages
的好处就是不需要服务器,但国内访问的话,有点影响体验,这个就自行选择了。
1、配置Git SSH密钥
我们先去根目录下使用命令:
这里会要你命名密匙名称(这里建议使用默认名称),然后连续按几次Enter
,这时候会在/root/.ssh
文件夹生成2
个ssh
密钥,然后我们查看公钥id_rsa.pub
。
2、建立仓库 我们需要先访问https://github.com/new,新建一个仓库用来存放BYR-Navi
站点文件,名称填你的用户名.github.io
,仓库别加密,不然到时候就访问不到了。
3、推送到Github
推送的时候可能会提示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
等。