Hexo 提供了快速方便的一键部署功能,让您只需一条命令就能将网站部署到服务器上。

  1. $ hexo deploy

在开始之前,您必须先在 _config.yml 中修改参数,一个正确的部署配置中至少要有 type 参数,例如:

  1. deploy:
    type: git

您可同时使用多个 deployer,Hexo 会依照顺序执行每个 deployer。

  1. deploy:
    - type: git
    repo:
    - type: heroku
    repo:
缩进

YAML依靠缩进来确定元素间的从属关系。因此,请确保每个deployer的缩进长度相同,并且使用空格缩进。

Git

安装 hexo-deployer-git

  1. $ npm install hexo-deployer-git --save

修改配置。

  1. deploy:
    type: git
    repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
    branch: [branch] #published
    message: [message]
参数描述
repo库(Repository)地址
branch分支名称。如果不指定,则默认值为 master
message自定义提交信息 (默认为 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

生成站点文件并推送至远程库。执行 hexo clean && hexo deploy 命令(如果您并未全局安装 Hexo Cli,则需要执行 ./node_modules/.bin/hexo clean && ./node_modules/.bin/hexo deploy

登入 Github/BitBucket/Gitlab,请在库设置(Repository Settings)中将默认分支设置为_config.yml配置中的分支名称。稍等片刻,您的站点就会显示在您的Github Pages中。

这一切是如何发生的?

当执行 hexo deploy 时,Hexo 会将 public 目录中的文件和目录推送至 _config.yml 中指定的远端仓库和分支中,并且完全覆盖该分支下的已有内容。

For 使用 Git 管理站点目录的用户

由于 Hexo 的部署默认使用分支 master,所以如果你同时正在使用 Git 管理你的站点目录,你应当注意你的部署分支应当不同于写作分支。
一个好的实践是将站点目录和 Pages 分别存放在两个不同的 Git 仓库中,可以有效避免相互覆盖。
Hexo 在部署你的站点生成的文件时并不会更新你的站点目录。因此你应该手动提交并推送你的写作分支。

此外,如果您的 Github Pages 需要使用 CNAME 文件自定义域名,请将 CNAME 文件置于 source 目录下,只有这样 hexo deploy 才能将 CNAME 文件一并推送至部署分支。

Heroku

安装 hexo-deployer-heroku

  1. $ npm install hexo-deployer-heroku --save

修改配置。

  1. deploy:
    type: heroku
    repo: <repository url>
    message: [message]
参数描述
repoHeroku 库(Repository)地址
message自定提交信息 (默认为 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

Netlify

Netlify 是一个提供网络托管的综合平台。它集持续集成(CI)CDN 自定义域名 HTTPS 持续部署(CD)等诸多功能于一身。您可以通过以下两种方式将Hexo站点部署到Netlify。

首先,也是最通用的方式,就是使用Netlify提供的网页端用户界面。前往新建一个网站页面,选择需要关联的 Github/BitBucket/Gitlab 库,然后遵循网站提示。

另一种方式是使用Netlify提供的命令行客户端工具 Node based CLI 管理和部署您的站点。

此外,您还可以在项目的README中增加一个 部署至Netlify按钮,这样其他用户在fork或clone了您的项目之后可以方便快捷地一键部署。

Rsync

安装 hexo-deployer-rsync

  1. $ npm install hexo-deployer-rsync --save

修改配置。

  1. deploy:
    type: rsync
    host: <host>
    user: <user>
    root: <root>
    port: [port]
    delete: [true|false]
    verbose: [true|false]
    ignore_errors: [true|false]
参数描述默认值
host远程主机的地址
user使用者名称
root远程主机的根目录
port端口22
delete删除远程主机上的旧文件true
verbose显示调试信息true
ignore_errors忽略错误false
rsync部署模块的工作方式

需要注意的是,要求您提供的实际上是一个能通过SSH登陆远程主机的Linux用户。Hexo会自动处理关于rsync使用的一切操作。因此,您需要在远程主机上为您的Hexo站点建立一个用户,并允许其通过SSH登陆。不过,这里的port,的确是指rsync监听的端口,请确保防火墙打开了该端口。

OpenShift

安装 hexo-deployer-openshift

  1. $ npm install hexo-deployer-openshift --save

修改配置。

  1. deploy:
    type: openshift
    repo: <repository url>
    message: [message]
参数描述
repoOpenShift 库(Repository)地址
message自定提交信息 (默认为 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

FTPSync

安装 hexo-deployer-ftpsync

  1. $ npm install hexo-deployer-ftpsync --save

修改配置。

  1. deploy:
    type: ftpsync
    host: <host>
    user: <user>
    pass: <password>
    remote: [remote]
    port: [port]
    ignore: [ignore]
    connections: [connections]
    verbose: [true|false]
参数描述默认值
host远程主机的地址
user使用者名称
pass密码
remote远程主机的根目录/
port端口21
ignore忽略的文件或目录
connections使用的连接数1
verbose显示调试信息false
FTP部署可能出现的问题

您可能需要预先通过其他方式将所有文件上传到远程主机中。否则初次使用ftpsync插件就可能出现报错。另外,由于FTP协议的特征,它每传送一个文件就需要一次握手,相对速度较慢。

SFTP

安装 hexo-deployer-sftp

  1. $ npm install hexo-deployer-sftp --save

修改配置。

  1. deploy:
    type: sftp
    host: <host>
    user: <user>
    pass: <password>
    remotePath: [remote path]
    port: [port]
    privateKey: [path/to/privateKey]
    passphrase: [passphrase]
    agent: [path/to/agent/socket]
参数描述默认值
host远程主机的地址
user使用者名称
pass密码
remotePath远程主机的根目录/
port端口22
privateKeyssh私钥的目录地址
passphrase(可省略)ssh私钥的密码短语
agentssh套接字的目录地址$SSH_AUTH_SOCK

其他方法

Hexo 生成的所有文件都放在 public 文件夹中,您可以将它们复制到您喜欢的地方。