以下內容為使用Halo搭建一個個人博客系統。
本教程使用的項目倉庫地址：https://github.com/halo-dev/halo
注意：頭條閱讀觀感不佳，建議去我的博客中看：
http://toptech.top/archives/1
1.Halo簡介
· Halo 是一款現代化的個人獨立博客系統，給習慣寫博客的同學多一個選擇。
· Halo [ˈheɪloʊ]，意為光環。當然，你也可以當成拼音讀(哈嘍)。
· 輕快，簡潔，功能強大，使用 Java 開發的博客系統。
2.Linux服務器安裝
本教程以Centos7為例，配置並運行 Halo，其他 Linux 發行版大同小異。
2.1.寫在前面
· 具備一定的 Linux 基礎。
· 如需域名綁定，請先保證已經正確解析 IP，以及確認服務器是否需要備案。
· 如需使用 IP 訪問，請先確保 Halo 的運行端口已經打開，除非你使用 80 端口運行 Halo。
· 如 3 所述，如果你使用了類似 寶塔面板 之類的 Linux 管理面板，可能還需要在面板裡設置端口。
· 不要想當然，請嚴格按照文檔的流程操作。
2.2.服務器配置
更新軟件包請確保服務器的軟件包已經是最新的。
sudo yum update -y
3.安裝 Java 運行環境
若已經存在 Java 運行環境的可略過這一步。
3.1.安裝 OpenJRE
# 安裝 OpenJREsudo yum install java-1.8.0-openjdk -y
3.2.檢測是否安裝成功
java -version
當然，這只是其中一種比較簡單的安裝方式，你也可以用其他方式，並不是強制要求使用這種方式安裝。
4.安裝 Halo
4.1.下載配置文件
考慮到部分用戶的需要，可能需要自定義比如端口等設置項，我們提供了公共的配置文件，並且該配置文件是完全獨立於安裝包的。當然，你也可以使用安裝包內的默認配置文件，但是安裝包內的配置文件是不可修改的。請注意：配置文件的路徑為 ~/.halo/application.yaml
4.2.下載配置文件到 ~/.halo 目錄
curl -o ~/.halo/application.yaml --create-dirs http://halo.ryanc.cc/config/application-template.yaml
修改配置文件完成上一步操作，我們就可以自己配置 Halo 的運行端口，以及數據庫相關的配置了。
4.3.使用 Vim 工具修改配置文件
vim ~/.halo/application.yaml
打開之後我們可以看到
server: port: 8090 # Response data gzip. compression: enabled: falsespring: datasource: # H2 database configuration. driver-class-name: org.h2.Driver url: jdbc:h2:file:~/.halo/db/halo username: admin password: 123456 # MySQL database configuration.# driver-class-name: com.mysql.cj.jdbc.Driver# url: jdbc:mysql://127.0.0.1:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true# username: root# password: 123456 # H2 database console configuration. h2: console: settings: web-allow-others: false path: /h2-console enabled: falsehalo: # Your admin client path is https://your-domain/{admin-path} admin-path: admin # memory or level cache: memory
這裡我就不進行修改了，有興趣的可以改改。
注意 使用 MySQL 之前，必須要先新建一個 halodb 數據庫，MySQL 版本需 5.7 以上。create database halodb character set utf8mb4 collate utf8mb4_bin;
4.4.運行 Halo
Halo 的整個應用程序只有一個 Jar 包，且不包含用戶的任何配置，它放在任何目錄都是可行的。需要注意的是，Halo 的整個額外文件全部存放在 ~/.halo目錄下，包括 application.yaml（用戶配置文件），template/themes（主題目錄），upload（附件上傳目錄），halo.db.mv（數據庫文件）。一定要保證 ~/.halo的存在，你博客的所有資料可都存在裡面。所以你完全不需要擔心安裝包的安危，它僅僅是個服務而已。
# 下載最新的 Halo 安裝包，{{version}} 為版本號，不帶 vwget http://halo.ryanc.cc/release/halo-{{version}}.jar -O halo-latest.jar# 或者wget http://halo.ryanc.cc/release/halo-latest.jar -O halo-latest.jar# 或者，{{version}} 為版本號，不帶 vwget https://halo.nova.moe/release/halo-{{version}}.jar -O halo-latest.jar# 備用地址（建議海外服務器使用）wget https://github.com/halo-dev/halo/releases/download/v1.2.0/halo-1.2.0.jar -O halo-latest.jar# 啟動測試java -jar halo-latest.jar
如看到以下日誌輸出，則代表啟動成功.
run.halo.app.listener.StartedListener : Halo started at http://127.0.0.1:8090run.halo.app.listener.StartedListener : Halo admin started at http://127.0.0.1:8090/admin
4.5.進階配置
上面我們已經完成了 Halo 的整個配置和安裝過程，接下來我們對其進行更完善的配置，比如：需要開機自啟？，更簡單的啟動方式？
實現以上功能我們只需要新增一個配置文件即可，也就是使用 Systemd來完成這些工作。
# 下載 Halo 官方的 halo.service 模板sudo curl -o /etc/systemd/system/halo.service --create-dirs http://halo.ryanc.cc/config/halo.service
下載完成之後，我們還需要對其進行修改。
sudo vim /etc/systemd/system/halo.service
打開之後我們可以看到
[Unit]Description=Halo ServiceDocumentation=https://halo.runAfter=network-online.targetWants=network-online.target[Service]Type=simpleExecStart=/usr/bin/java -server -Xms256m -Xmx256m -jar YOUR_JAR_PATHExecStop=/bin/kill -s QUIT $MAINPIDRestart=alwaysStandOutput=syslogStandError=inherit[Install]WantedBy=multi-user.target
參數：
· -Xms256m：為 JVM 啟動時分配的內存，請按照服務器的內存做適當調整，512 M 內存的服務器推薦設置為 128，1G 內存的服務器推薦設置為 256，默認為 256。
· -Xmx256m：為 JVM 運行過程中分配的最大內存，配置同上。
· YOURJARPATH：Halo 安裝包的絕對路徑，例如 /www/wwwroot/halo-latest.jar。
提示
· 如果你不是按照上面的方法安裝的 JDK，請確保/usr/bin/java是正確無誤的。
· systemd 中的所有路徑均要寫為絕對路徑，另外，~ 在 systemd 中也是無法被識別的，所以你不能寫成類似 ~/halo-latest.jar 這種路徑。
· 如何檢驗是否修改正確：把 ExecStart中的命令拿出來執行一遍。
# 修改 service 文件之後需要刷新 Systemdsudo systemctl daemon-reload# 使 Halo 開機自啟sudo systemctl enable halo# 啟動 Halosudo service halo start# 重啟 Halosudo service halo restart# 停止 Halosudo service halo stop# 查看 Halo 的運行狀態sudo service halo status
以上內容同項目文檔，原文檔地址：https://halo.run/archives/install-with-linux
4.6.進入Halo
輸入以下網址進入：
http://ip地址:8090/ #這裡的端口使用的是默認的
第一次進入可以看到下面的界面
填好信息後點擊安裝即可
安裝成功後登錄
4.7.安裝成功
網站主頁的默認主題是這種，可以修改。
5.修改博客主題
主題倉庫地址：https://halo.run/s/themes
5.1.主題倉庫
5.2.選擇主題
選擇一個你喜歡的點擊詳情。接著找到主題Github地址，點擊進入
接著複製主題地址
5.3.修改主題
在網站後臺中進入主題界面，界面右下角有添加主題按鈕，點擊後，選擇安裝主題
輸入剛才複製的地址，點擊下載
如果不能下載成功，可以手動下載下來，然後使用本地上傳。成功後點擊啟用即可。
5.4.設置主題
點擊主題的設置可以修改主題的一些配置。
設置主題後網站主頁如下：
主題有很多配置大家可以參照文檔多試試。
6.最後
個人博客地址：http://toptech.top/
閱讀更多 貓給這兒 的文章
