佈署

Hexo 提供了快速方便的一鍵佈署功能，讓您只需一個指令就能將網站佈署到伺服器上。

$ hexo deploy

在開始之前，您必須先在 _config.yml 中修改設定，一個正確的部署設定中至少要有 type 欄位，例如：

deploy:
  type: git

您可同時使用多個佈署器 (deployer)，Hexo 會依照順序執行每個佈署器。

deploy:
- type: git
  repo:
- type: heroku
  repo:

更多佈署外掛，請參照外掛清單。

Git

  1. 安裝 hexo-deployer-git。
$ npm install hexo-deployer-git --save
  1. 修改_config.yml設定(下面的註解顯示了參數的範例)。
deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]
選項描述預設
repo儲存庫（Repository）網址
branch分支名稱。gh-pages (GitHub)
coding-pages (Coding.net)
master (其他)
message自訂提交訊息Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})
token選填的 token 值用來儲存庫存取身份認證。以 $ 作為前綴從環境變數中讀取 token
  1. 上傳你的網站。執行 hexo clean && hexo deploy。
  • 你將會被提示提供目標儲存庫的使用者名稱及密碼，除非你用 token 或是 ssh 金鑰進行身份驗證。
  • hexo-deployer-git 不會儲存你的使用者名稱及密碼。使用 git-credential-cache 來暫時儲存它們。
  1. 在 Github / BitBucket / Gitlab 前往你的儲存庫設定，並將你的主要分支從 master 設為 gh-pages（或者任何你在 _config.yml 中設定的名字)。現在你的網站就是你的帳號首頁。

Heroku

安裝 hexo-deployer-heroku。

$ npm install hexo-deployer-heroku --save

修改設定。

deploy:
  type: heroku
  repo: <repository url>
  message: [message]
選項描述
repoHeroku 儲存庫網址
message自訂提交訊息 (預設是 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

Rsync

安裝 hexo-deployer-rsync。

$ npm install hexo-deployer-rsync --save

修改設定。

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

OpenShift

hexo-deployer-openshift 在 2022 時已被棄用。

安裝 hexo-deployer-openshift。

$ npm install hexo-deployer-openshift --save

修改設定。

deploy:
  type: openshift
  repo: <repository url>
  message: [message]
選項描述
repoOpenShift 儲存庫網址
message自訂提交訊息 (預設是 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})

FTPSync

安裝 hexo-deployer-ftpsync。

$ npm install hexo-deployer-ftpsync --save

修改設定。

deploy:
  type: ftpsync
  host: <host>
  user: <user>
  pass: <password>
  remote: [remote]
  port: [port]
  clear: [true|false]
  verbose: [true|false]
選項描述預設值
host遠端主機位址
user使用者名稱
pass密碼
remote遠端主機的根目錄/
port連接埠21
clear在上傳之前，移除遠端目錄中所有檔案及目錄false
verbose顯示除錯訊息false

Vercel

Vercel 是一個雲端平台讓開發者可以架設 Jamstack 網站以及網路服務，且可以快速佈署、自動調整大小 (auto scaling)，且不須監督、無須設定。他們提供全球邊緣網路、SSL 加密、資產壓縮、快取無效化等服務。

第一步：新增一個建構腳本至到你的 package.json 檔案：

{
  "scripts": {
    "build": "hexo generate"
  }
}

第二步：佈署你的 Hexo 網站至 Vercel

為了使用 Vercel for Git Integration 佈署你的 Hexo 應用程式，請確認它已推送到 Git 儲存庫中。

使用 Import Flow 輸入專案到 Vercel 中。在輸入期間，你可以找到所有有關的選項已預先為你進行設定；然而，你可以選擇更改任何選項，你可以在這裡找到選項清單。

當你的專案完成輸入之後，所有往後分支中的推送皆會產生預覽佈署，在生產環境分支所有的更動，都會呈現結果在生產環境佈署。

或者，你可以點擊下方的佈署按鈕來建立一個新專案：

Deploy Vercel

Bip

Bip 是一個商業架設服務並提供不斷線佈署，專為靜態網頁提供全球 CDN、SSL、無限頻寬等服務。提供實支實付 (pay as you go) 的方案，以一個網域為單位。

Getting started is quick and easy, as Bip provides out the box support for Hexo. This guide assumes you already have a Bip domain and Bip CLI installed.

1: Initialise your project directory

$ bip init

Follow the prompts, where you’ll be asked which domain you’d like to deploy to. Bip will detect that you’re using Hexo, and set project settings like the source file directory automatically.

2: Deploy your website

$ hexo generate —deploy && bip deploy

After a few moments, your website will be deployed.

RSS3

hexo-deployer-rss3 has been deprecated in 2023.

RSS3 是一個為 Web 3.0 時代的內容和社交網路設計的開放協議。

  1. 安裝 hexo-deployer-rss3

  2. 修改配置。

deploy: # 所有部署器的根配置塊
- type: rss3
  endpoint: https://hub.rss3.io
  privateKey: 47e18d6c386898b424025cd9db446f779ef24ad33a26c499c87bb3d9372540ba
  ipfs:
    deploy: true
    gateway: pinata
    api:
      key: d693df715d3631e489d6
      secret: ee8b74626f12b61c1a4bde3b8c331ad390567c86ba779c9b18561ee92c1cbff0
參數描述
endpoint一個 RSS3 Hub 的鏈接
privateKey您的私鑰， 64 字節
ipfs/deploy是否部署到 IPFS 上
ipfs/gatewayIPFS API 網關
ipfs/api/keyIPFS 網關相關的驗證內容
ipfs/api/secretIPFS 網關相關的驗證內容

  1. 生成靜態文件

  2. 部署

關於具體部署相關的註意事項，您可以參閱 我們的文檔 。

其他方法

Hexo 產生的所有檔案都放在 public 資料夾，您可以將它們拷貝到您喜歡的地方。