
BYR-Navi:可部署在GitHub Pages的网站导航程序 - Docker
BYR-Navi是一个开源、轻量使用Fomantic UI Web框架构建的网站导航程序,样式也非常美观,而且支持从N个站点直接搜索,我们既可以部署在自己的服务器上,又可以部署在GitHub Pages,后者无需服务器。
预览
项目地址:https://github.com/BYR-Navi/BYR-Navi
安装
1、安装Ruby
1 |
|
导入期间出现使用No dirmngr
报错的话,使用apt install dirmngr
然后重新导入即可。
2、安装Jekyll
1 |
|
3、安装BYR-Navi
1 |
|
如果第一步提示bash: git: command not found
可以先使用命令:
1 |
|
然后修改配置文件_config.yml
,对照原信息,自行修改导航标题,关键词等描述,更深层次的修改可参考官方文档→传送门。 再进入_data
文件夹,新增/修改大致导航网站链接,可参考上面的演示地址修改,最后还一个就是统计配置文件analytics.yml
,这个需要我们额外安装Matomo
,安装和配置可以提前看文章后面。 都修改完成后,启动:
1 |
|
此时就可以使用ip:8989
访问程序了。 如果CentOS
系统打不开的话,可能还需要开启8989端口
,使用命令:
1 |
|
如果还是无法访问。则需要去服务商控制台安全组那里开放下端口。 这里除了可以使用命令行启动,也可以直接将生成的_site
文件夹丢到网站根目录访问。 如果要修改导航相关页面的信息显示的话,也可以在_site
文件夹中修改。
安装Matomo
官方网站:https://matomo.org 使用Docker镜像进行安装。Docker地址:https://github.com/crazy-max/docker-matomo
1、安装Docker
1 |
|
2、拉取镜像
1 |
|
安装完成后打开ip:8080
即可访问。如果访问不了的话,可以查看上面的教程,开放端口即可。 然后这里需要注意的是Database Server
需要填上你的ip
地址,而且数据库端口,比如3306
需要防火墙放行,不然会连接不上。 安装到最后一步的时候,如果你填的ip
地址,那么可能进入不了,可以编辑/root/matomo/data/config/config.ini.php
,修改trusted_hosts[]
参数为你的访问地址。 最后配置该导航的话,需要修改配置文件_data/analytics.yml
,大致参数如下:
1 |
|
参数获取大致路径如下:
- site_id
在后台添加一个网站统计,就可以直接看到网站id - 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。
我们先去根目录下使用命令:
1 |
|
这里会要你命名密匙名称(这里建议使用默认名称),然后连续按几次Enter
,这时候会在/root/.ssh
文件夹生成2
个ssh
密钥,然后我们查看公钥id_rsa.pub
。
1 |
|
查看后,再复制下公钥,然后打开GitHub
官网,进入https://github.com/settings/ssh/new, Title
随便填,然后Key
填入刚刚复制的密匙,最后点击Add SSH Key
添加即可。
2、建立仓库
我们需要先访问https://github.com/new, 新建一个仓库用来存放BYR-Navi
站点文件,名称填你的用户名.github.io
,仓库别加密,不然到时候就访问不到了。
3、推送到GitHub
1 |
|
推送的时候可能会提示The authenticity of host 'github.com' can't be established.
信息,直进yes
即可。 然后推送完就可以看到仓库的推送文件了。
接下来访问https://你的用户名.github.io
就可以进入导航网站了。