自建github pages
# 自建 Github Pages
在自己的服务器上实现 Github Pages 功能。
环境:ubuntu18.04,步骤如下:
- 搭建 Git 服务器,参考:搭建 Git 服务器 (opens new window)
- 配置 nginx;
- 关键配置;
# 配置 nginx
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install nginx
cd /etc/nginx
# 备份nginx配置文件
sudo cp nginx.conf nginx.conf.bk
sudo vim nginx.conf
1
2
3
4
5
6
7
2
3
4
5
6
7
# 删除所有内容,将以下内容写入nginx.conf
#user username;
worker_processes auto;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;
events {
worker_connections 1024;
# multi_accept on;
}
http {
include mime.types;
default_type application/octet-stream;
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
keepalive_timeout 65;
server {
listen 80;
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /$1.html last;
break;
}
root /blog-site/www;
}
}
}
# /blog-site/www目录将是网站的根目录
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 创建网站的根目录,需和nginx配置文件中的一致
sudo mkdir -p /blog-site/www
# 重启nginx
sudo nginx -s reload
# 此时nginx将自动解析/blog-site/www/目录下的静态网站资源,我们最总会将jekyll生成的文件放到这里。
1
2
3
4
5
2
3
4
5
# 关键配置
自建 Github Pages 要实现本地推送到服务器,服务器解析推送内容,网站更新。对于推送,通过前面将服务器搭建作为一个 Git 服务器,就能够做到。 服务器解析推送内容,需要用到Git 钩子 (opens new window)这一功能实现,但有一些要注意的地方。
首先需要修改post-receive
这个钩子脚本。具体内容如下:
#!/bin/bash
unset GIT_DIR
GIT_REPO=/yourname/blog-site.git
TMP_GIT_CLONE=/home/git/tmp/blog-site
PUBLIC_WWW=/blog-site/www
git clone $GIT_REPO $TMP_GIT_CLONE
cd $TMP_GIT_CLONE
bundle install
bundle exec jekyll build -s $TMP_GIT_CLONE -d $PUBLIC_WWW -q
rm -rf $TMP_GIT_CLONE
exit
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
当从本地推送到远程仓库时,就会执行这个钩子脚本,但有一点很关键,执行这个脚本时,用户是git
,那么就需要考虑权限问题。总的来说就是git
用户读写的权限问题。
首先暂时允许git
用户能够 shell 登录,以便我们切换用户。
sudo vim /etc/passwd
修改关于git用户内容如下:
# git:x:1000:1000::/home/git:/bin/bash
su git # 切换到git用户
mkdir /home/git/tmp # 创建临时目录
1
2
3
4
5
2
3
4
5
使用git
用户去安装配置jekyll
,但在安装之前,需要将 git 添加到 sudo 用户组中。
su root # 切换到root用户
usermod -a -G sudo git # 将git添加到sudo用户组
passwd git # 设置用户密码
su git # 切换到git用户
sudo apt-get install ruby
gem install bundler jeykll
1
2
3
4
5
6
2
3
4
5
6
将git
用户添加到$PUBLIC_WWW
目录的用户组中,最好将为$PUBLIC_WWW
目录创建单独的用户和组,比如www
。
sudo chown www:www /blog-site/www
sudo usermod -a -G www git # 将git添加到www用户组
sudo chmod 755 /blog-site/www #给予git用户读写权限
1
2
3
2
3
到此结束!
上次更新: 2022/06/17, 07:22:19