halo快速部署个人博客
技术方案
docker+docker-compose+nginx+mysql
halo简介
Halo是一款现代化的开源博客/CMS系统,所有代码开源在GitHub上且处于积极维护状态。它是基于 Java Spring Boot 构建的,易于部署,支持REST API、模板系统、附件系统和评论系统等功能。
Halo 作为一款好用又强大的开源建站工具,配合上不同的模板与插件,可以很好地帮助你构建你心中的理想站点。它可以是你公司的官方网站,可以是你的个人博客,也可以是团队共享的知识库,甚至可以是一个论坛、一个商城。
相关地址
开源仓库
halo-dev/halo: 强大易用的开源建站工具。 (github.com)
halo: 强大易用的开源建站工具。 (gitee.com)
中文文档
Halo 文档
社区
Halo 社区
官网
Halo 建站 - 强大易用的开源建站工具
主题仓库
应用市场 - Halo 建站 - 强大易用的开源建站工具
基础设置
关闭防火墙(docker启动之前关闭)
systemctl status firewalld
systemctl stop firewalld
docker
安装
1.卸载旧的版本
$sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine
2.需要的安装包
$sudo yum install -y yum-utils
3.设置镜像的仓库(官方)
$sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo (官网速度慢)
$sudo yum-config-manager \
--add-repo \
http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo(推荐使用,阿里云速度快)
4.更新yum软件包索引
$sudo yum makecache fast
5.安装docker docker-ce 社区版 docker-ee 企业版
$sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
6.启动docker
$sudo systemctl start docker
7.查看docker是否安装成功
$sudo docker version
卸载
1.卸载依赖
$sudo yum remove docker-ce docker-ce-cli containerd.io
2.删除资源
$sudo rm -rf /var/lib/docker
# /var/lib/docker docker的默认工作路径
阿里云镜像加速
配置镜像加速器
通过shell脚本追加文本内容
$sudo mkdir -p /etc/docker
$sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://f2k3b83v.mirror.aliyuncs.com"]
}
EOF
$sudo systemctl daemon-reload
$sudo systemctl restart docker
设置开机自动启动
#systemctl enable docker
查看docker服务状态
#systemctl status docker
查看docker具体信息
#docker info
docker-compose
这里采用离线安装,在线安装或多或少有各种问题
所有版本预览Releases · docker/compose (github.com)
#最好是进入到/usr/local/bin/目录下安装,我第一次在根目录下安装,报错docker-compose: command not found,第二次在上述目录下安装可以成功
#将文件上传到linux后,重命名
mv docker-compose-linux-x86_64.docker-compose-linux-x86_64 docker-compose
#添加可执行权限
chmod +x /usr/local/bin/docker-compose
#测试
docker-compose version
nginx反向代理配置
在系统任意位置创建一个 halo 文件夹,并创建多级目录
mkdir -p /halo/nginx/conf/
编写Nginx配置文件
vim /halo/nginx/conf/nginx.conf
vim: command not found
yum install vim -y
#user root;
error_log /var/log/nginx/error.log notice;
worker_processes 1;
pid /var/run/nginx.pid;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
# 设置上传文件的最大值
client_max_body_size 256m;
upstream blog {
# 使用容器服务名
server halo:8090;
}
server {
listen 80;
# 可进行域名绑定
server_name nwth.xyz;
location / {
# 设置反向代理的地址(实际是请求转发)
proxy_pass http://blog;
# 设置HTTP请求头
proxy_set_header HOST $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
}
Docker-compose部署halo,mysql,nginx
vim /halo/compose.yaml
修改的自定义配置,找到下面的参数所在位置修改:
服务器或虚拟机ip:halo.external-url 中的 ip 设置,修改为自己的服务器ip地址。
超级管理员账号密码
账号 halo.security.initializer.superadminusername,我写的配置中是 admin
密码 halo.security.initializer.superadminpassword ,我写的配置中是 123456
mysql的root用户密码,以下两个参数的值都需要修改且必须保持一致
spring.r2dbc.password,我写的配置中是 123456
MYSQL_ROOT_PASSWORD,我写的配置中是 123456
建议本地编辑再上传
记得用notepad++打开编辑完成后,格式修改为UTF-8无BOM编码格式
要不然报错
parsing /root/halo/compose.yaml: yaml: invalid leading UTF-8 octet
services:
halo:
image: halohub/halo:2.10
container_name: halo
restart: on-failure:3
depends_on:
halodb:
condition: service_healthy
networks:
halo_network:
volumes:
- ./halo:/root/.halo2
ports:
- "8090:8090"
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8090/actuator/health/readiness"]
interval: 30s
timeout: 5s
retries: 5
start_period: 30s
command:
- --spring.r2dbc.url=r2dbc:pool:mysql://halodb:3306/halo
- --spring.r2dbc.username=root
# MySQL 的密码,请保证与下方 MYSQL_ROOT_PASSWORD 的变量值一致。
- --spring.r2dbc.password=123456
- --spring.sql.init.platform=mysql
# 外部访问地址,我的服务器 ip 为8.130.97.145,此处需要修改为你自己的服务器或虚拟机 ip
- --halo.external-url=http://192.168.101.128:80/
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=123456
halodb:
image: mysql:8.1.0
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: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=123456
- MYSQL_DATABASE=halo
halonginx: # 服务名称,用户自定义
image: nginx:1.24.0 # 镜像版本
container_name: halonginx
# 链接到其它容器,能在 nginx.conf 反向代理配置时使用
links:
- halo
networks:
halo_network:
ports:
- 80:80 # 暴露端口
volumes: # 挂载
- /halo/nginx/conf/nginx.conf:/etc/nginx/nginx.conf
privileged: true # 这个必须要,解决nginx的文件调用的权限问题
networks:
halo_network:
容器编排
# 1.进入 halo 目录
cd /halo
# 2.容器编排
启动并访问服务
docker-compose up -d
关停服务
docker-compose down
查看状态:docker ps
访问测试
http://【服务器或虚拟机ip】
初次访问有点慢
账号密码为compose.yml中填写的超级管理员的账号密码
admin/123456
基础操作
参考用户指南 | Halo 文档
主题
2.10版本加入了应用市场,可在其中下载安装喜欢的主题
我的主题!
Hao
另外推荐以下几个主题,都不错
Sakura
Joe
番外:有界面的反向代理神器 Nginx Proxy Manager
创建一个docker-compose.yml 文件
version: '3.8'
services:
app:
image: 'jc21/nginx-proxy-manager:latest'
restart: unless-stopped
ports:
- '8080:80'
- '81:81'
- '443:443'
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
一键启动
docker-compose up -d
登录到管理界面
当docker容器跑起来后, 连接到81端口即可访问管理界面。有时候需要稍等一会儿。
访问:http://你的服务器IP:80
第一次登录的默认管理员账户:
Email: admin@example.com
Password: changeme
第一次登陆后,你会立刻被要求修改登录密码和一些重要信息。
番外:twikoo部署
(目前还没成功,可能配置还有点问题)
云函数部署 | Twikoo 文档
Halo Twikoo 插件以及 ssl 部署 | L’s Blog (liuocean.com)
ssl证书
我使用的就是免费生成的,但是只能用于一个域名,如果还要用二级域名,需要重新生成
cer和key后缀结尾的文件
https://freessl.cn/
ACME v2证书自动化快速入门 (freessl.cn)
参考文章
Let’s Encrypt泛域名证书生成 acme.sh免费申请使用_letsencrypt泛域名-CSDN博客
番外:错误集锦
下面两处错误主要是nginx和nginx proxy端口冲突
Error response from daemon: driver failed programming external connectivity on endpo int nginx-proxy-manager-app-1 (b39ad26f01f7599bcee2fc11c042ea357c4b33369ccdd9effcdb7 97a92ce94e4): Bind for 0.0.0.0:80 failed: port is already allocated
查看docker 代理占用的端口
ps -aux | grep -v grep | grep docker-proxy
关闭docker 服务
sudo service docker stop
### 重启docker服务
sudo service docker start
还不行的话就
docker rm $(docker ps -aq)
sudo rm /var/lib/docker/network/files/local-kv.db
Error response from daemon: failed to update store for object type *libnetwork.endpointCnt: Key not found in store
# pkill docker
# iptables -t nat -F
# ifconfig docker0 down
# brctl delbr docker0
# service docker restart
个人搭建博客简单记录,目前很多配置还有许多问题,之前用hexo搭建部署到github上,但是排版出现问题,不得不放弃,也试过用宝塔部署wordpress,觉得太笨重,耗资源,使用halo框架,进行了简单的配置。
博客网站
大家可以评论留言,提出改进办法,不胜感激,虽然评论也暂时用不了v😂😂😂