Hexo 云服务备份与使用 Jupyter - 写记录-所学所想所感!

本文由 Fluid 用户授权转载，版权归原作者所有。

本文作者：pxxyyz

原文地址：https://pxxyyz.com/posts/32990/、https://pxxyyz.com/posts/60533/

前言

记录hexo博客遇到的问题：

免密git
自动备份
云服务器开启Jupyter Notebook
在博客的菜单访问Jupyter（使用Nginx重定向实现url访问端口）
公式渲染引擎

云服务器备份

参考「Hexo博客部署到腾讯云服务器」^[1]后遇到了两个问题：

每次在本地部署博客时都要重复输入密码

deploy:
    type: git
    repo: root@***(服务器ip,内网外网都行):/home/git/blog.git    #仓库地址
    branch: master    #分支

备份时hexo自带的backup无效

backup:
    type: git
    repo: root@***(服务器ip,内网外网都行):/home/git/backup.git    #仓库地址
    branch: master    #分支

免密git

在这一部分参照了「使用Git+Hooks实现Hexo站点自动部署到CentOS服务器上」^[2]的配置SSH免密登陆步骤。

$ ssh-copy-id -i ~/.ssh/id_rsa.pub your_user_name@HostIP  //添加公钥
$ ssh your_user_name@HostIP //验证是否添加成功

因为部署时用的root上传，因此这里的your_user_name设置git和root两个。添加成功后ssh -v git@HostIP和ssh -v root@HostIP显示Welcome to XXX !

自动备份

这里我按照「deploy的流程在服务器设置了自动化备份」^[1]，主要思路是在服务器设置一个独立的文件夹backup，再用类似deploy的钩子blog.git，构造一个备份的钩子deploy.git将博客的备份文件上传。

获取root权限
```
$ su root
```

建立git仓库

$ cd /home/backup
$ git init --bare backup.git

修改backup.git权限
```
$ chown git:git -R backup.git
```
在 /home/hexo/backup.git 下，有一个自动生成的 hooks 文件夹，我们创建一个新的 git 钩子 post-receive，用于自动部署。
```
$ vim backup.git/hooks/post-receive
```

按 i 键进入文件的编辑模式，在该文件中添加两行代码（将下边的代码粘贴进去)，指定 Git 的工作树（源代码）和 Git 目录

#!/bin/bash 
git --work-tree=/home/backup --git-dir=/home/git/backup.git remote add origin
git --work-tree=/home/backup --git-dir=/home/git/backup.git checkout -f
# git --work-tree=/home/backup --git-dir=/home/git/backup.git checkout -b master # 创建切换分支
git --work-tree=/home/backup --git-dir=/home/git/backup.git push origin master # 提交代码至分支

按 Esc 键退出编辑模式，输入:wq 保存退出。（先输入：，然后输入wq回车）

修改文件权限，使得其可执行。

$ chmod +x /home/git/backup.git/hooks/post-receive

博客根目录_config下增加(因为服务器没有分支，默认是master，使用backup钩子)

deploy:
    type: git
    repo: root@***(服务器ip,内网外网都行):/home/git/backup.git    #仓库地址
    branch: master    #分支

备份hexo backup(使用 Hexo-Git-Backup 插件)
```
$ hexo clean
$ hexo g
$ hexo b
```

这个地方走了不少弯路，因为backup阶段每次都提示错误：

fatal: 'xxx' does not appear to be a git repository
fatal: Could not read from remote repository.

我通过搜索fatal-does-not-appear-to-be-a-git-repository找到解决思路，用Git命令自动备份。详细参见「HEXO博客实现自动备份」^[3]。

安装 shelljs 模块
```
$ npm install --save shelljs
```
编写自动备份脚本：主题目录下scripts文件夹下新建一个js文件，文件名随意取，例如update.js。

require('shelljs/global');
try {
    // hexo.on('deployAfter', function() {         //当deploy完成后执行备份
    hexo.on('backupAfter', function() {            //当backup完成后执行备份
        run();
    });
} catch (e) {
    console.log("产生了一个错误<(￣3￣)> !，错误详情为：" + e.toString());
}
function run() {
    if (!which('git')) {
        echo('Sorry, this script requires git');
        exit(1);
    } else {
        echo("======================Auto Backup Begin===========================");
        cd('XXXXXXX');    //此处修改为Hexo根目录路径
        if (exec('git add .').code !== 0) {
            echo('Error: Git add failed');
            exit(1);
        }
        if (exec('git commit -m "Form auto backup script\'s commit"').code !== 0) {
            if (exec('git remote add origin your_user_name@HostIP:/home/git/backup.git').code !== 0){       //修改访问服务器方式
                if (exec('git push origin master').code !== 0) {
                    echo('Error: Git push failed');
                    exit(1);
                }
            } else {
                echo('Error: Git commit failed');
                exit(1);
            }
        }
        if (exec('git push origin master').code !== 0) {
            echo('Error: Git push failed');
            exit(1);
        }
        echo("==================Auto Backup Complete============================")
    }
}

注意：

在Hexo根目录或在主题目录下的scripts文件夹js在启动时就会自动载入，因此建议放在主题目录下，避免不必要的问题，例如Blog/themes/fluid/scripts/update.js。
此backup.js是在hexo backup运行后backupAfter自动触发的，因此可以在其他仓库备份(如github和coding)后实现服务器的自动备份。
git远程仓库在服务器，所以push在服务器端的home/git/backup.git里post-receive钩子中。
由于设定了git免密设置，因此使用backup.git操作不需要重复的输入密码。

在_config.yml下设置备份配置。**注意：backup下不要有服务器的repo**，因为在scripts下backup.js已实现git push。

backup:
    type: git
    message: 'backup updata: {{now("YYYY-MM-DD HH/mm/ss")}}'
    ## theme: fluid #主题
    repo: #XXX为用户地址或IP地址
        github: git@github.com:XXX.github.io.git,backup
        coding: git@e.coding.net:XXX.git,backup
        ## hexo: root@XXX:/home/git/backup.git,master

再来一波四连😄

$ hexo clean 
$ hexo g 
$ hexo d 
$ hexo b

得到

$ hexo b
INFO  Start backup: git
The file will have its original line endings in your working directory
[master 79b18cc] backup updata: XXXX
 2 files changed, 143 insertions(+), 4 deletions(-)
Branch 'master' set up to track remote branch 'backup' from 'github'.
To github.com:XXXXXX
   89e022d..79b18cc  master -> backup
Branch 'master' set up to track remote branch 'backup' from 'coding'.
To e.coding.net:XXXXXX
   89e022d..79b18cc  master -> backup
INFO  Backup done: git
======================Auto Backup Begin===========================
On branch master
Your branch is up to date with 'coding/backup'.

nothing to commit, working tree clean
fatal: remote origin already exists.
remote: usage: git remote add [<options>] <name> <url>
remote:
remote:     -f, --fetch           fetch the remote branches
remote:     --tags                import all tags and associated objects when fetching
remote:                           or do not fetch any tag at all (--no-tags)    
remote:     -t, --track <branch>  branch(es) to track
remote:     -m, --master <branch>
remote:                           master branch
remote:     --mirror[=(push|fetch)]
remote:                           set up remote as a mirror to push to or fetch from
remote:
remote: fatal: 'origin' does not appear to be a git repository
remote: fatal: Could not read from remote repository.
remote:
remote: Please make sure you have the correct access rights
remote: and the repository exists.
remote: fatal: not a git repository (or any of the parent directories): .git    
To XXXXXX:/home/git/backup.git
   89e022d..79b18cc  master -> master
Everything up-to-date
==================Auto Backup Complete============================

服务器的文件夹/home/backup下可看到Hexo backup的备份文件，服务器端备份的文件与github或coding备份文件一致。同时，文件夹/home/hexo是hexo deploy的部署文件，通过Nginx提供 Web 服务。这就实现了服务器部署和备份的自动化操作。

Tips:如果遇到程序没有报错但文件夹上传失败时，可以手动删除Hexo根目录下的.deploy_git 文件夹，再重新部署和备份。

访问Jupyter

下面以域名pxxyyz.com为例，首先需要在服务器开启Jupyter^[4]

安装Jupyter

安装Anaconda

$ mkdir anaconda //创建目录
$ cd anaconda    //进入目录
// 在镜像站找到安装包并下载
$ wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2020.02-Linux-x86_64.sh
$ bash Anaconda3-2020.02-Linux-x86_64.sh  //安装anaconda3

生成Jupyter Notebook配置文件

$ jupyter notebook --generate-config

打开ipython并设置登入密码

ipython 
In [1]: from IPython.lib import passwd
In [2]: passwd()                         #设置Jupyter Notebook密码
Enter password: 
Verify password: 
Out[2]: ''                               #生成的密钥在配置文件有用

修改服务器配置文件

$ vim ~/.jupyter/jupyter_notebook_config.py

按 i 键进入文件的编辑模式，在该文件中添加代码，按 Esc 键退出编辑模式，输入:wq 保存退出。（先输入:，然后输入wq回车）

# 设置所有ip地址皆可访问
c.NotebookApp.ip='*' 
# 输入密码的哈希值，见Out[2]
c.NotebookApp.password = u'sha1:XXX'
# 禁止自动打开浏览器
c.NotebookApp.open_browser = False  
# 指定端口，需要在服务器安全组开发该端口
c.NotebookApp.port =8888 
# 远程访问
c.NotebookApp.allow_remote_access = True 
# 使用mathjax，可输入公式
c.NotebookApp.enable_mathjax = True

启动Jupyter

$ nohup jupyter notebook --allow-root & 
# nohup避免关闭终端则终止了Jupyter 程序的运行，--allow-root允许root权限，& 将程序放入后台运行

打开端口步骤：本实例安全组->配置规则->入方向->手动添加

| 授权策略 | 优先级 | 协议类型 | 端口范围 | 授权对象 | | :------: | :----: | :--------: | :------------: | :----------: | | 允许 | 100 | 自定义 TCP | 目的:8888/8888 | 源:0.0.0.0/0 |

浏览器访问Jupyter notebook(移动端或桌面端)，并输入刚才配置的密码即可使用

http://HostIP:8888
http://域名:8888

注意：

第二种方式需要域名解析到服务器公网IP，域名等价于公网IP
https://HostIP:8888访问出错，https://域名:8888同理

anaconda换源，分别测试一下下载速度和稳定性，自行选择最优的

# 添加清华源
$ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
$ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
$ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge 
$ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
$ conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2/

# 添加上交源
$ conda config --add channels https://mirrors.sjtug.sjtu.edu.cn/anaconda/pkgs/main/ 
$ conda config --add channels https://mirrors.sjtug.sjtu.edu.cn/anaconda/pkgs/free/
$ conda config --add channels https://mirrors.sjtug.sjtu.edu.cn/anaconda/cloud/conda-forge/ 

# 添加中科大源
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main/
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free/
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/msys2/
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/bioconda/
$ conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/menpo/

# 设置搜索时显示通道地址 有资源显示源地址
$ conda config --set show_channel_urls yes

# 换回默认源(重置用)
$ conda config --remove-key channels

可以在Jupyter notebook的工作目录中上传或下载.ipynb文件，当然别的文件也可以。

Nginx 重定向

希望在我的博客中添加一个菜单按钮直接访问我的Jupyter notebook。然而菜单链接是通过url_for自动生成的，如添加link: ':8888'，生成的是pxxyyz.com/:8888/，而不是pxxyyz.com:8888。当然，可以设置链接为link: 'pxxyyz.com:8888'，直接且简单，但这不能学到一些有趣的东西！

下面通过特点子页面来访问域名的指定端口，即通过pxxyyz.com/jupyter访问pxxyyz.com:8888

在此之前上传了SSL证书并配置HTTPS^[5]
修改服务器配置文件

$ vim /etc/nginx/nginx.conf

按 i 键进入文件的编辑模式，在该文件找到server，修改代码，按 Esc 键退出编辑模式，输入:wq 保存退出。（先输入:，然后输入wq回车）

  server {
      listen       443 ssl;# 80 default_server;
      # listen       [::]:80 default_server;
      server_name  pxxyyz.com;
      root         /home/hexo;
      # ssl on; # 老版本指令
      ssl_certificate /etc/nginx/conf/XXXXbundle.crt;
      ssl_certificate_key /etc/nginx/conf/XXXX.key;
      ssl_session_timeout 5m;
      ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
      ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4!DHE;
      ssl_prefer_server_ciphers on;

      # Load configuration files for the default server block.
      include /etc/nginx/default.d/*.conf;

      location / {
      }

# http://pxxyyz.com/jupyter/ to http://pxxyyz.com:8888
      location ~ /jupyter/?$ {
        return 302 http://pxxyyz.com:8888;
      }
      
      error_page 404 /404.html;
          location = /40x.html {
      }

      error_page 500 502 503 504 /50x.html;
          location = /50x.html {
      }
  }
  server { #把http的域名请求转成https
      listen 80;
      server_name pxxyyz.com;
      return 301 https://$host$request_uri;
  }

重启nginx 并检查配置

$ service nginx restart
# systemctl restart nginx.service
$ nginx -t

# 得到结果是
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

当然，一开始不是这么做的，错误的方法也贴出来，避免入坑

server {
    listen 80;
    server_name pxxyyz.com;
    location /jupyter {
          proxy_pass http://pxxyyz.com:8888/tree?
     }
  }

分析
- 用proxy_pass得到的重定向是https://pxxyyz.com/jupyter
- 对应的服务器访问的是https://HostIP:8888
- 正确的Jupyter notebook访问地址却是http://HostIP:8888
- 因此问题出在http的域名强制转成https
- 解决方法：遇到指定链接用return 302返回http从而得到正确的结果^[6]
- 结果：
  - https://pxxyyz.com/jupyter、http://pxxyyz.com/jupyter、http://pxxyyz.com:8888和http://HostIP:8888均能打开Jupyter notebook
  - 但IP的SSL证书不免费！https+port的组合访问会出错。

补充

数学公式

在此补充一下之前公式不显示的问题。虽然Fluid主题支持LaTeX 数学公式，但是需要手动操作，而且我按照教程开启本功能mathjax没有成功，即公式在网页里并没有被渲染和转换。通过网上查找，发现解决这类问题的思路主要是换渲染引擎^[7]，例如pandoc、mathjax、katex。我目前使用mathjax，操作如下：

卸载默认引擎，并安装这个新的渲染引擎

$ npm uninstall hexo-renderer-marked --save 
$ npm install hexo-renderer-kramed --save

修改/node_modules/hexo-renderer-kramed/lib/renderer.js

// Change inline math rule
function formatText(text) {
// Fit kramed's rule: $$ + \1 + $$
// 直接返回text
// return text.replace(/`\$(.*?)\$`/g, '$$$$$1$$$$');
return text;
}

修改hexo的渲染源码/node_modules/kramed/lib/rules/inline.js

// 去掉`\\`的额外转义，第11行，将其修改为
// escape: /^\\([\\`*{}\[\]()# +\-.!_>])/, 
escape: /^\\([`*{}\[\]()# +\-.!_>])/,
// 将em标签对应的符号中，去掉`_`，第20行，将其修改为
// em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,    
em: /^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,

停止使用 hexo-math，安装 hexo-renderer-mathjax

$ npm uninstall hexo-math --save
// 不知道是不是必要的
$ npm install hexo-renderer-mathjax --save

更新 Mathjax 的 CDN 链接，打开/node_modules/hexo-renderer-mathjax/mathjax.html，把script更改为：

// <script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML"></script> 
// 网上推荐的上面这个，但我使用失败了，推荐下面这个，亲测可行
<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

按照Fluid的快速开始，需要修改主题配置，打开/source/_data/fluid_config.yml 文件

post:
  math:  
    enable: true  
    specific: false   
    engine: mathjax

在根目录下修改_config.yml，添加
```
mathjax: true
```
在Front-matter中打开MathJax
```
---
  mathjax: true
---
```

显示数学公式

# 不空行会出bug
$$\Sigma({n} ; {p})=\left\{\left(\zeta_{1}, \ldots, \zeta_{r}\right) \in \mathbb{C}^{n_{1}} \times \cdots \times \mathbb{C}^{n_{r}}: \sum_{k=1}^{r}\left\|{\zeta}_{k}\right\|^{2 p_{k}} < 1\right\}$$

$$\Sigma({n} ; {p})=\left{\left(\zeta_{1}, \ldots, \zeta_{r}\right) \in \mathbb{C}^{n_{1}} \times \cdots \times \mathbb{C}^{n_{r}}: \sum_{k=1}^{r}\left|{\zeta}{k}\right|^{2 p{k}} < 1\right}$$

因为hexo-renderer-kramed 和hexo-renderer-marked均不支持emoji 功能，使用:smile: :blush: :smiley: :smirk:在Typora可以正常显示表情，在网页上显示的是:smile: :blush: :smiley: :smirk:，因此，可以直接复制emoji表情😄😊😃😏。

经过**强哥**提醒，需要额外使用插件hexo-filter-github-emojis来支持hexo 的 emoji 。

$ npm install hexo-filter-github-emojis --save

在根目录下_config.yml添加配置

githubEmojis:
  enable: true
  className: github-emoji
  inject: true
  styles:
  customEmojis:

正文markdown用如下格式使用 emoji

# 不空行会出bug
{% raw %}{% github_emoji emoji %}{% endraw %}

正如上面所说，Hexo 默认情况下 :emoji: 不能正确显示表情，如:tada:，而该插件通过 {%github_emoji tada%}(github_emoji tada) 即可显示这个 emoji ，其他调用格式可以看 hexo-filter-github-emojis 的官方文档。

一键三连

前面提到的在根目录下使用Git Bash Here输入下面指令有些繁琐。

$ hexo clean && hexo g && hexo d && hexo b

现在用.bat文件简化，可以分别保存。其中第四行的地址为根目录。

:: 一键预览
@echo on
D:
cd D:\github\Hexo-Blog
hexo clean && hexo g && hexo s

:: 一键部署
@echo on
D:
cd D:\github\Hexo-Blog
hexo clean && hexo g && hexo d

:: 一键部署+备份
@echo on
D:
cd D:\github\Hexo-Blog
hexo clean && hexo g && hexo d && hexo b

一键预览的窗口支持实时修改实时显示，即文档修改保存后，刷新可得修改后的预览页面。如果做到ssh免密登入，部署与备份也能一键完成。

免密会带来安全隐患，部署和备份文件最好设置为

私密

参考

实用技巧

部署 Hexo 花里胡哨用户经验

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议，转载请注明出处！

在 Fluid 主题首页上加入一言上一篇

常见静态网站托管平台使用及多节点部署方案下一篇