文章目录
1 前言
作为有梦想的,有追求的程序员,有一个自己的个人博客简直就是必须品。你可以选择wordpress这种平台,直接使用,在任何地方只要有网络就能写博客。还可以选择hexo这种静态博客,但是发文章就没有那么随心所欲了,要在你部署的电脑上写才行。
本人之前使用的是hexo+github pages这种方式搭建博客,简单方便,感兴趣的同学可以看我之前写的这篇文章:Hexo+github pages搭建个人独立网站,绑定域名全教程
由于github是在国外的,访问速度确实慢了一些,体验有些不好。正巧上学的时候用学生优惠价格购买了几年阿里云轻量服务器,闲着也是闲着,就用来部署hexo好了,加快访问速度。
因为我是先部署了github pages,所以git安装、NodeJs安装等等都已经实现了,还没安装的有需要可以看我上面那个教程链接。
在部署的过程中,看了网上很多教程,大多是抄来抄去的,看了很多篇照着做也没有成功过,所以这篇博文是综合网上很多篇博文,加上自己的探索写出来的。网上普遍没有贴图片,看着头大,为了照顾纯小白,我这里贴上图片,一步一步来,保姆级教程。
2 环境介绍
我本地电脑安装的是win10(64)位。
服务器使用的是阿里云轻量服务器,配置是:
1核、2GB内存,系统盘 40GB SSD云盘
操作系统是CentOS 7.3。
3 本地环境部署
这部分在我之前写的Hexo+github pages搭建个人独立网站,绑定域名全教程这里也有,为了方便我直接拿过来这边了。
3.1 安装nodejs
因为Hexo需要nodejs环境,因此需要先下载安装Nodejs。点击NodeJs官网,下载最新版本。
下载好一直next,选择一个文件夹位置在一直next即可完成,这个步骤很简单,就不放图了。
3.2 安装git
点击git官网,下载安装包。
点击next,选择文件夹位置,然后一直next到底就行了,选择默认配置就好,默认配置会将环境变量配置好的,不需要搞得花里胡哨的。安装好后鼠标右击应该有下图这两个选项了,出现就代表安装成功了。
4 使用Hexo
4.1 安装Hexo
上面环境搭建好之后,在桌面点击鼠标右键,点击 “Git Bash Here” ,输入以下两条命令。
$ npm install -g hexo-cli
提示:输入的时候不要输入 $ 了,因为命令行本来就已经有了。下载需要几分钟,请耐心等待一下。
可以在复制之后在git窗选择 Shift+Insert 粘贴。有一些警告WARN是不影响使用的,放心。
4.2 初始化Hexo
安装好Hexo之后,新建一个文件夹,如 E:\HEXO ,然后在该文件夹内鼠标右击,选择 “Git Bash Here” ,输入以下命令。
$ hexo init
稍等片刻即可完成,如图:
文件结构如图所示:
scaffolds是模版文件夹,当你新建文章时,Hexo 会根据 scaffold 来建立文件。
source文件夹是存放用户资源的地方。
themes是主题文件夹,Hexo 会根据主题来生成静态页面,待会我们会更换成比较流行的nexT主题。
然后再输入命令行进行本地调试,即可看到初始效果啦~
$ hexo s –debug
访问http://localhost:4000/即可看到效果:
4.3 更换主题为NexT
上面虽然本地可以调试成功了,但是默认的主题实在不是特别好看。你可以选择去官网选择自己喜欢的主题,官网主题链接https://hexo.io/themes/
本篇教程选择的是当前流行的NexT主题,这个主题是我感觉用过的最好的一个了。
4.4 下载NexT主题
进入刚刚你创建的文件夹的themes里,比如我的 E:\HEXO\themes ,鼠标右击选择“Git Bash Here”输入以下两条命令中的一个:(这两个是一样的,只是有同学反应第一条命令不行,第二条就可以。)
$ git clone git@github.com:iissnan/hexo-theme-next.git
$ git clone https://github.com/iissnan/hexo-theme-next
此时 themes 文件夹便多了一个next主题的文件夹。
4.5 修改配置
打开 E:\HEXO (你的hexo根目录)下的 _config.yml 配置文件
找到下面这段代码
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: landscape
将langscape替换成hexo-theme-next
theme: hexo-theme-next
重新在项目根目录下进行本地部署调试
$ hexo s --debug
即可看到效果:
5 配置SSH密钥
为了使本地可以跟远程的github建立联系,需要在本地配置SSH密钥,这样我们就可以在本地直接提交代码到GitHub上或者远端git仓库。
如果你是第一次配置SSH,则配置一下git的username 和 email
$ git config --global user.name "你要设置的名字"
$ git config --global user.email "你要设置的邮箱"
之后生成SSH密钥:
$ ssh-keygen -t rsa -C "你刚刚设置的邮箱"
如果不需要设置密码的话,连续三个回车就好了。在这之后会得到两个文件: id_rsa 和 id_rsa.pub
找到id_rsa.pub文件,用记事本打开,复制其内容。路径: C:\Users\J(你的用户名).ssh
6 服务器部署
注意:服务器是 centOS 7.3
阿里云截图如下:
点击右上角的”远程连接”。
输入以下命令,切换到root账号
sudo su root
6.1 git配置
1、安装git
在刚刚的黑框里输入,然后回车:
yum install git
等待一下就安装好了。中途会出现
Is this ok [y/d/N]:
输入 : y 回车即可
此时git已经安装成功。
2、创建git账户
在命令框输入(下面不做重复提示了)
adduser git
3、添加git账户权限
chmod 740 /etc/sudoers
vim /etc/sudoers
输入上面的命令,回车之后,进入编辑界面。
这里要先点击 “i” 键,进入编辑模式,然后找到一下内容的地方:
## Allow root to run any commands anywhere
root ALL=(ALL) ALL
添加以下内容:
git ALL=(ALL) ALL
然后按 “Esc” 键,此时最底下的—INSERT—消失,再输入 “:wq”,即保存退出。
4、改回权限
chmod 400 /etc/sudoers
5、设置git账户密码
sudo passwd git
输入两次密码就设置成功了。注意,linux下输入密码是不显示**的,你直接输入,输完回车就行了。
6、切换至git用户,创建 ~/.ssh 文件夹和 ~/.ssh/authorized_keys 文件,并赋予相应的权限
su git
mkdir ~/.ssh
vim ~/.ssh/authorized_keys
按”i”进入编辑模式,将我们在win10中生成的id_rsa.pub文件中的公钥复制到authorized_keys中,按”esc”,然后按”:wq”,保存退出。
接着,输入一下命令,赋予权限
chmod 600 /home/git/.ssh/authorized_keys
chmod 700 /home/git/.ssh
在本地Git终端中测试是否能免密登录git,其中SERVER为填写自己的云主机IP,执行输入yes后输入你之前配置的git密码,无报错就说明好了。
在电脑本地桌面,右键”Git Bash Here”,输入一下命令,其中SERVER填写自己的云主机ip,执行输入yes后不用密码说明配置成功了。
ssh -v git@SERVER
如果你之前配置过git,可能你会出现以下这种错误。
可以看到
Offending ECDSA key in /c/Users/jonty/.ssh/known_hosts:2
是.ssh/known_hosts 这个文件第二行出现冲突了。只要用笔记本打开,将这个文件的第二行删掉即可。
重新执行刚刚的命令
sh -v git@你的服务器ip
这说明已经连接成功了。
6.2 创建仓库目录及相关配置
1、创建目录
在var目录下创建repo作为Git仓库目录,返回服务端命令行切换到root账户,然后输入:
mkdir /var/repo
赋予权限:
chown -R git:git /var/repo
chmod -R 755 /var/repo
接下来创建hexo目录作为网站根目录,并赋予权限:
mkdir /var/hexo
chown -R git:git /var/hexo
chmod -R 755 /var/hexo
接下来创建一个空白的git仓库
cd /var/repo
git init --bare hexo.git
创建一个新的 Git 钩子,用于自动部署.
在 /var/repo/hexo.git 下,有一个自动生成的 hooks 文件夹。我们需要在里边新建一个新的钩子文件 post-receive。
vim /var/repo/hexo.git/hooks/post-receive
进入编辑模式,然后将下面那两行代码粘贴进去,保存退出。
#!/bin/bash
git --work-tree=/var/hexo --git-dir=/var/repo/hexo.git checkout -f
修改权限:
chown -R git:git /var/repo/hexo.git/hooks/post-receive
chmod +x /var/repo/hexo.git/hooks/post-receive
到这里Git仓库已经搭建完毕了。
7 配置Nginx
为了部署和维护,我们使用宝塔面板来一键部署Nginx
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && bash install.sh
中途输入”y”回车等待一会就好了。在执行结果最后会出现地址,用户名,密码等。
复制这个地址打开,输入账号密码即可进入宝塔面板。
注意:这里也有可能你进不去面板页面,是因为你的服务器没有开8888这个端口(具体看你的宝塔面板连接的端口),去阿里云轻量服务器控制台中的“安全”->“防火墙”,右上角的”添加规则”,添加相应的端口即可。看下面的第二张图。
另外如果忘记了宝塔用户名密码,可以去你服务器终端输入:
cd /www/server/panel && python tools.py panel testpasswd
注:也可以输入:
bt default
下图为宝塔解决方案,链接忘记Linux 3.X/4.x/5.x/6.x 宝塔面板密码的解决方案
进入面板之后,会提示叫你修改端口,点击”立即修改”,可以看到”面板端口”这时候是8888,自己选一个值,然后先去服务器防火墙上开放这个端口,跟刚刚的”添加规则”操作一样。
再回到宝塔面板页面将”面板端口”的值修改成你刚刚开放的端口值。
然后需要用新端口,重新进入宝塔面板,就是将原有的链接”:”后面的值改成你的端口即可。
在宝塔面板,进入软件商店,输入”Nginx”,然后搜索,安装免费的那个。
等待部署完成。
部署完成之后,点击网站,添加站点,填写你的域名,没有的话写你的服务器ip地址。其他的不要改。
填写完之后提交,然后点击”设置”
点击”配置文件”
server
{
listen 80;
# server_name填写你自己的域名,没有的话填ip
server_name hjxlog.com;
index index.php index.html index.htm default.php default.htm default.html;
# 这里root填写自己的网站根目录,修改为/var/hexo
root /var/hexo;
保存,然后选择“设置”-“网站目录”,将网站目录修改成以下,保存。
/var/hexo
回到服务器终端,重启宝塔服务,使之生效。
service bt restart
8 修改hexo配置
进入本地电脑hexo博客的根目录,编辑站点配置文件 _config.yml,找到deploy,修改成以下
deploy:
type: git
#repo改为repo: git@你的域名:/var/repo/hexo.git
repo: git@hjxlog.com:/var/repo/hexo.git
branch: master
最后在本地电脑hexo博客的根目录右击,Git Bash Here,输入以下命令部署
hexo clean
hexo d -g
这时候可能出现权限问题,导致部署到git失败。
在服务器终端输入以下命令即可:
chown -R git:git /var/repo/
chown -R git:git /var/hexo/
最后再hexo d -g部署,应该就可以看到部署成功了。
自此,已经将博客从GitHub pages搬到阿里云服务器了。
9 将网站添加https访问
去阿里云申请一个免费的SSL证书,好像要备案,有点忘记了,很快就申请下来了。
进入宝塔面板,”网站”,”设置”,”SSL,”其他证书”
将你申请的证书.key以及.pem内容,粘贴进去然后保存即可。
10 持续更新
2020-03-15 根据评论和邮件反馈遇到的常见问题更新
根据有同学遇到上图这种情况,如果提示
Could not resolve hostname ***.com: Name or service not known
Please make sure you have the correct access rights
那么看一下自己的域名是否实名验证成功了,如果已验证。可以ping一下域名看能不能ping得通,有可能是你没有把域名解析到服务器ip地址上了。
另外,Mac OS可能在配置方面和Windows不太一样。具体问题要具体分析,具体解决了。
11 总结
在部署网站的时候,由于之前对Linux没有经验,网络上看到几篇博客,还是没能部署成功,有些博客比如命令中的单词拼写错误,或者前后不衔接,导致部署一直有问题。
还好在部署的同时去网上学一些Linux基本命令,学到了进入编辑模式,编辑完怎么退出等等。之前看了一篇博客,可能作者默认大家都会了,结果我卡在这里了一下。
总的来说,部署还是比较简单的,第一次没成功的同学不要轻易放弃,多去网上找找答案,努力解决问题,加油!
如果因为看我的博客,在部署过程当中出现任何问题,请私信我或者邮箱联系我,帮助大家一起解决问题。
本文作者: Huang Jianxian
本文链接: https://hjxlog.com/posts/20191130a1.html
版权声明: 本文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
---------------
如何觉得文章内容不错,欢迎点击一下广告,支持一下咕咕😍😍😍
原创文章,作者:Roy,如若转载,请注明出处:https://iwanlab.com/hexo-building/