网站

docker+halo部署网站的过程

2023-10-07
22
0
0
24 minutes

docker+halo部署网站的过程

1.拉取镜像

docker pull halohub/halo:2.9

drive:baidu name:halohub/halo:2.9 link:https://pan.baidu.com/s/1MZihnuy6qGGpLxXfkhXCPQ password:srqt

开始创建

以上是简单的使用，下面是正式用 docker-compose安装教程：

1.复制文件夹

将 halo博客部署中的文件拷到 /root目录下，

加载需要的docker镜像

cd ~/root/halo2
chmod +x ./importImg.sh
./importImg.sh

2.安装 `docker-compose`

安装工具源，使用如下命令：

sudo yum -y install epel-release

安装 python-pip 模块，使用如下命令：

sudo yum install python-pip

进入 ./halo2目录下

cd ~/halo2

**将工具 **docker-compose移动到系统可执行目录，使用如下命令：

mv docker-compose /usr/local/bin/docker-compose

修改文件的可执行属性，使用命令如下：

chmod +x /usr/local/bin/docker-compose

**执行 **docker-compose -version命令查看是否安装成功。

3.修改 `docker-compose.yaml`

主要是将 你的密码改成你的数据库密码

将 你的主页地址改成你的主页访问地址

version: "3"

services:
  halo:
    image: halohub/halo:2.9
    container_name: halo
    restart: on-failure:3
    depends_on:
      halodb:
        condition: service_healthy
    networks:
      halo_network:
    volumes:
      - ./:/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=你的密码
      - --spring.sql.init.platform=mysql
      # 外部访问地址，请根据实际需要修改
      - --halo.external-url=http://你的主页地址/

  halodb:
    image: mysql:8.0.11
    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=你的密码
      - MYSQL_DATABASE=halo
  halonginx: # 服务名称，用户自定义
    image: nginx:1.25.2  # 镜像版本
    container_name: halonginx
    # 链接到其它容器，能在 nginx.conf 反向代理配置时使用
    links:
      - halo
    networks:
      halo_network:
    ports:
      - 80:80  # 暴露端口
      - 443:443  # 暴露端口
    volumes: # 挂载
      - ./nginx/conf/nginx.conf:/etc/nginx/nginx.conf
      - ./ssl/certs:/etc/ssl/certs
    privileged: true # 这个必须要，解决nginx的文件调用的权限问题

networks:
  halo_network:

这里的MySQL的版本要和Halo2的版本对应上，否则会报Unhealth；

根据自己的halo2版本查看官方文档进行操作。

参数详解：

参数名	描述
`spring.r2dbc.url`	数据库连接地址，详细可查阅下方的 `数据库配置`
`spring.r2dbc.username`	数据库用户名
`spring.r2dbc.password`	数据库密码
`spring.sql.init.platform`	数据库平台名称，支持 `postgresql`、`mysql`、`h2`
`halo.external-url`	外部访问链接，如果需要在公网访问，需要配置为实际访问地址
`halo.cache.page.disabled`	是否禁用页面缓存，默认为禁用，如需页面缓存可以手动添加此配置，并设置为 `false`。开启缓存之后，在登录的情况下不会经过缓存，且默认一个小时会清理掉不活跃的缓存，也可以在 Console 仪表盘的快捷访问中手动清理缓存。

数据库配置：

链接方式	链接地址格式	`spring.sql.init.platform`
PostgreSQL	`r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}`	postgresql
MySQL	`r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}`	mysql
MariaDB	`r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}`	mysql
H2 Database	`r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE`	h2

3.启动 Halo 服务

docker-compose up -d

实时查看日志：

docker-compose logs -f

这边会有一个BUG，启动时候halo容器会启动失败，只需要用 docker ps -a和 docker retart 容器id

重启即可

用浏览器访问 http://你的主页地址/console 即可进入 Halo 管理页面，首次启动会进入初始化页面。

提示

**如果需要配置域名访问，建议先配置好反向代理以及域名解析再进行初始化。如果通过 **http://ip:端口号 的形式无法访问，请到服务器厂商后台将运行的端口号添加到安全组，如果服务器使用了 Linux 面板，请检查此 Linux 面板是否有还有安全组配置，需要同样将端口号添加到安全组。

4.更新容器组

停止运行中的容器组
```
cd ~/halo && docker-compose down
```
备份数据（重要）
```
cp -r ~/halo ~/halo.archive
```
tips:warn 需要注意的是，halo.archive文件名不一定要根据此文档命名，这里仅仅是个示例
更新 Halo 服务
**修改 **docker-compose.yaml 中配置的镜像版本。

tips:warn 这里的MySQL的版本要和Halo2的版本对应上，否则会报Unhealth, 需要根据自己的halo2版本进行操作。官方文档地址：https://docs.halo.run/getting-started/install/docker-compose

services:
  halo:
    image: halohub/halo:2.9
    container_name: halo

docker-compose pull halo

docker-compose up -d

5.反向代理

修改 /root/halo/nginx/conf/nginx.conf中的 你的域名

`Nginx-80`

#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  你的域名;
      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;
      }
  }
}

`Nginx-443`

修改 你的域名+你的证书+证书密钥

#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       443 ssl;
      # 可进行域名绑定
      server_name  你的域名;
      ssl_certificate    /etc/ssl/certs/你的证书.crt;
      ssl_certificate_key  /etc/ssl/certs/证书密钥.key;
      ssl_session_timeout 5m;
      ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
      ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
      ssl_prefer_server_ciphers on;

      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;
      }
  }
}

访问

访问前台：http://你的域名/

访问后台：http://你的域名/console/

下载主题(以dream为例)：https://github.com/nineya/halo-theme-dream2.0/releases--

插件

官方插件：https://www.halo.run/store/apps

默认插件

应用市场插件

功能：让你安装插件更方便

编辑器插件

halo内置了写文章的插件，但如果想用其他类型的插件写文章的话可以试试这两款

图库插件

类似于一个相册的功能

前台接口：/photos

动态插件

类似于微信的朋友圈，QQ的动态

前台接口：/photos

链接管理插件

通常用来做友链管理

前台接口：/links

更新：

更新halo版本

1.删除容器和文件夹

cd /root/halo
docker ps -a
docker rm -f [mysql容器]
docker rm -f [halo容器]
rm -r mysql
rm -r mysqlBackup

提示：nginx容器不用删除

2.导入新版本的halo镜像

docker load -i halohub_halo_2.10.tar
docker images
docker tag 镜像id halohub/halo:2.10

3.更新yml文件

version: "3.2"

services:
  halo:
    image: halohub/halo:2.10 //仅需修改此行即可

4.启动容器

docker-compose up -d

docker restart halodb
docker restart halo
docker restart halonginx

If you find the article useful, feel free to appreciate

docker Markdown Halo

docker+halo部署网站的过程

https://www.currenspace.cn/archives/1709444896221

Author

柯

Published on

2023-10-07

Updated on

2024-03-03

License

CC BY 4.0

docker+halo部署网站的过程

docker+halo部署网站的过程

1.拉取镜像

开始创建

1.复制文件夹

2.安装 docker-compose

3.修改 docker-compose.yaml

3.启动 Halo 服务

4.更新容器组

5.反向代理

Nginx-80

Nginx-443

访问

插件

默认插件

应用市场插件

编辑器插件

图库插件

动态插件

链接管理插件

更新：

Author

Published on

Updated on

License

Comments

2.安装 `docker-compose`

3.修改 `docker-compose.yaml`

`Nginx-80`

`Nginx-443`