侧边栏壁纸
博主头像
比特研习社博主等级

求真求实 至诚至简

  • 累计撰写 12 篇文章
  • 累计创建 14 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录
教程

利用Docker搭建开源建站工具Halo 2.0

比特研习社
比特研习社
2024-01-19 / 0 评论 / 0 点赞 / 46 阅读 / 9200 字

比起 Hexo 等静态博客，Halo 自带后台和评论功能，非常省心；比起 Wordpress，Halo 搭建简单，Docker 搭建，一行命令搞定，迁移更新也更方便。对于对主题要求没那么高，只是想要搭建一个博客好好写文章的小伙伴来说，Halo 绝对是一个不二的选择。

随着开发者们的不懈努力，Halo 在昨天晚上已经更新到了 2.3.1，咕咕有个测试站点也跟着升级了一下，一番使用之后，发现现在是时候和大家分享一下全新的 Halo 2.0 了。

我们今天主要来看一下全新的 Halo2.x 版本，以及试着安装 Halo2.x，最后咕咕会推荐一个适配 2.x 的 Hexo 博客里面的同款主题～

1. Halo2.0 简单介绍

Halo 1.x 版本的是：

Halo [ˈheɪloʊ]，一款现代化的开源博客 / CMS 系统，值得一试。

Halo 2.x 版本改成了：

Halo [ˈheɪloʊ]，好用又强大的开源建站工具。

可见 2.x 版本，Halo 已经不仅仅满足只用来搭建一个博客了，而是可以搭建任何网站。

1.1 插件机制

Halo 2.0 带来了灵活可扩展的插件机制，通过插件可以在运行时为系统添加丰富的功能，也可以保持 Halo 自身的简洁轻量。目前支持 Halo 2.0 的插件可以查阅：halo-sigs/awesome-halo

1.2 模板机制

完善的模板系统，支持自定义配置，主题预览，多语言等功能。开发主题也十分方便，欢迎大家参与主题的开发。

1.3 附件管理

采用多策略存储模式，同时支持通过插件扩展外部存储位置，你可以更方便的管理你文章中的附件。

1.4 搜索引擎

Halo 2.0 带来了内置的全文搜索引擎支持，同时也支持通过插件扩展外部搜索引擎。

1.5 多用户

与 1.0 相比，Halo 2.0 增加了多用户机制，并且可以给不同的用户赋予不同的权限，多人管理维护一个网站变成了可能。

1.6 一建部署

采用了程序与用户配置分离的方式，迁移和备份成本大大降低。你只需要一条命令即可运行成功，同时也支持 Docker 部署。

2. 项目展示

文档地址：http://docs.halo.run/
社区地址：https://bbs.halo.run/
官网地址：https://halo.run/
GitHub 地址：https://github.com/halo-dev/halo
Demo 地址：https://demo.halo.run
Demo 后台：https://demo.halo.run/console
用户名：demo
密码：P@ssw0rd123..

这边直接丢出核心的 docker-compose.yaml 文件，熟悉 docker 环境的小伙伴可以直接拷贝搭建。

halo 部署：

YAML
version: "3"

services:
  halo:
    image: halohub/halo:2.6.0
    container_name: halo
    restart: on-failure:3
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - ./:/root/.halo2
    ports:
      - "8090:8090"
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
      - --spring.r2dbc.username=root
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=o#DwN&JSa56
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/
      # 初始化的超级管理员用户名
      - --halo.security.initializer.superadminusername=admin
      # 初始化的超级管理员密码
      - --halo.security.initializer.superadminpassword=P@88w0rd

  halodb:
    image: mysql:8.0.31
    container_name: halodb
    restart: on-failure:3
    networks:
      halo_network:
    command: 
      - --default-authentication-plugin=mysql_native_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_general_ci
      - --explicit_defaults_for_timestamp=true
    volumes:
      - ./mysql:/var/lib/mysql
      - ./mysqlBackup:/data/mysqlBackup
    ports:
      - "3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
      interval: 3s
      retries: 5
      start_period: 30s
    environment:
      # 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
      - MYSQL_ROOT_PASSWORD=o#DwN&JSa56
      - MYSQL_DATABASE=halo

networks:
  halo_network:

注意：docker-compose.yml 里面的 --halo.external-url=http://localhost:8090/ ，其中的 http://localhost:8090/ 需要更改为你的域名，如果你打算用的域名是 abc.com 也就是要改成 --halo.external-url=https://abc.com

版本号 2.6.0，可以看这边：https://github.com/halo-dev/halo/releases 保证自己是新版本～

接着，千万记得改密码！！！

不然，你也会像这样：

75799c30a3a90bd3e5dc2d6f3c6286d4.png

PS：细心的小伙伴会发现，docker-compose.yml 里面数据库 3306 并没有写成 3306:3306，官网是写的后者，咕咕改成了前者，为的就是不在公网暴露 halo 数据库的端口，这样也能一定程度保障博客的安全。

以下是详细搭建教程。

3. 搭建教程

3.1 安装 Docker

可以直接参考这篇内容：

https://blog.laoda.de/archives/nginxproxymanager

3.2 创建安装目录

创建一下安装的目录：

BASH
sudo -i

mkdir -p /root/data/docker_data/halo

cd /root/data/docker_data/halo

这边我们直接用 docker 的方式安装。

BASH
vim docker-compose.yml

英文输入法下，按 i

YAML
version: "3"

services:
  halo:
    image: halohub/halo:2.6.0
    container_name: halo
    restart: on-failure:3
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - ./:/root/.halo2
    ports:
      - "8090:8090"
    command:
      - --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
      - --spring.r2dbc.username=root
      # MySQL 的密码，请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
      - --spring.r2dbc.password=o#DwN&JSa56
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://localhost:8090/
      # 初始化的超级管理员用户名
      - --halo.security.initializer.superadminusername=admin
      # 初始化的超级管理员密码
      - --halo.security.initializer.superadminpassword=P@88w0rd

  halodb:
    image: mysql:8.0.31
    container_name: halodb
    restart: on-failure:3
    networks:
      halo_network:
    command: 
      - --default-authentication-plugin=mysql_native_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_general_ci
      - --explicit_defaults_for_timestamp=true
    volumes:
      - ./mysql:/var/lib/mysql
      - ./mysqlBackup:/data/mysqlBackup
    ports:
      - "3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent"]
      interval: 3s
      retries: 5
      start_period: 30s
    environment:
      # 请修改此密码，并对应修改上方 Halo 服务的 SPRING_R2DBC_PASSWORD 变量值
      - MYSQL_ROOT_PASSWORD=o#DwN&JSa56
      - MYSQL_DATABASE=halo

networks:
  halo_network:

注意：docker-compose.yml 里面的 --halo.external-url=http://localhost:8090/ ，其中的 http://localhost:8090/ 需要更改为你的域名，如果你打算用的域名是 abc.com 也就是要改成 --halo.external-url=https://abc.com

版本号 2.6.0，可以看这边：https://github.com/halo-dev/halo/releases 保证自己是新版本～

接着，千万记得改密码！！！

不然，你也会像这样：

75799c30a3a90bd3e5dc2d6f3c6286d4.png

PS：细心的小伙伴会发现，docker-compose.yml 里面数据库 3306 并没有写成 3306:3306，官网是写的后者，咕咕改成了前者，为的就是不在公网暴露 halo 数据库的端口，这样也能一定程度保障博客的安全。

修改好之后，注意切换成英文输入法，然后按一下 esc，然后 :wq 保存退出。

3.3 打开服务器防火墙（非必需）并访问网页

打开防火墙的端口 8090

查看端口是否被占用（以 8090 为例），输入：

BASH
lsof -i:8090  #查看 8090 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

BASH
-bash: lsof: command not found

运行：

BASH
apt install lsof  #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 8081，注意 docker 命令行里和防火墙都要改）

最后：

BASH
cd /root/data/docker_data/halo    # 来到 dockercompose 文件所在的文件夹下

docker-compose up -d

理论上我们就可以输入 http://ip:8090 访问安装了。

注意：

1、不知道服务器 IP，可以直接在命令行输入：curl ip.sb，会显示当前服务器的 IP。

2、遇到访问不了的情况，请再次检查在宝塔面板的防火墙和服务商的后台防火墙是否打开对应了端口。

3.4 更新 halo

BASH
cd /root/data/docker_data/halo

docker-compose down 

cp -r /root/data/docker_data/halo /root/data/docker_data/halo.archive  # 万事先备份，以防万一

docker-compose pull

docker-compose up -d    # 请不要使用 docker-compose stop 来停止容器，因为这么做需要额外的时间等待容器停止；docker-compose up -d 直接升级容器时会自动停止并立刻重建新的容器，完全没有必要浪费那些时间。

docker image prune  # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

提示：

BASH
WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]

输入 y

利用 Docker 搭建的应用，更新非常容易～

3.5 卸载 halo

BASH
cd /root/data/docker_data/halo

docker-compose down

cd ..

rm -rf /root/data/docker_data/halo  # 完全删除映射到本地的数据

可以卸载得很干净。

4. 使用教程

4.1 插件安装

地址：https://github.com/halo-sigs/awesome-halo

大家可以自己先尝试看看，不难，详细的操作的话等咕咕周末搞个视频见出来。

4.2 主题安装

推荐 Butterfly 主题，地址：https://github.com/dhjddcn/halo-theme-butterfly

参考资料

文档地址：http://docs.halo.run/
社区地址：https://bbs.halo.run/
官网地址：https://halo.run/
GitHub 地址：https://github.com/halo-dev/halo

0
Wordpress Halo
版权归属： 比特研习社
许可协议： 本文使用《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》协议授权

评论区