【halo】博客系统从部署到访问
部署
本文采用 docker-compose的方式进行部署，可以有效避免一些莫名其妙的问题
halo 支持多种数据库方式进行部署，这里采用的是PSQL方式进行部署，其他数据库部署方式可以参考文档
docker-compose.yaml
- halo
- ports: 端口映射。修改第一个端口值为期望访问的端口
- image: 镜像名。每次更新版本可以通过修改该参数的值执行重新构建即可无痕升级
- command
- spring.r2dbc.password: 数据库密码。需要与下面的halodb中的数据库密码保持一致
- halo.external-url: 外部访问地址。根据实际域名填写，也可以填写127.0.0.1地址
- halodb
- environment
- POSTGRES_PASSWORD: 数据库密码。可以修改为自定义密码。
- environment
version: "3"
services:
halo:
image: halohub/halo:2.10.0
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:postgresql://halodb/halo
- --spring.r2dbc.username=halo
# PostgreSQL 的密码，请保证与下方 POSTGRES_PASSWORD 的变量值一致。
- --spring.r2dbc.password=password
- --spring.sql.init.platform=postgresql
# 外部访问地址，请根据实际需要修改
- --halo.external-url=https://blog.cnkj.site
# 初始化的超级管理员用户名
- --halo.security.initializer.superadminusername=admin
# 初始化的超级管理员密码
- --halo.security.initializer.superadminpassword=P@88w0rd
# 启用缓存
- --halo.cache.page.disabled=false
halodb:
image: postgres:latest
container_name: halodb
restart: on-failure:3
networks:
halo_network:
volumes:
- ./db:/var/lib/postgresql/data
ports:
- "15432:5432"
healthcheck:
test: [ "CMD", "pg_isready" ]
interval: 10s
timeout: 5s
retries: 5
environment:
- POSTGRES_PASSWORD=password
- POSTGRES_USER=halo
- POSTGRES_DB=halo
- PGUSER=halo
networks:
halo_network:
external: false
部署完成后就可以通过 http://127.0.0.1:8090 进行站点访问了
外部访问
这里主要讲解如果通过域名进行公网访问站点
首先你需要一个自己的域名
其次需要打电话给宽带运营商申请动态IP(专线固定IP不用申请)
解析动态IP到域名上
这里采用
python脚本方式解析动态IP到域名上，以便于后续其他各个服务可以使用该域名作为基础域名跳转，而不需要每次都修改相关IP地址
详细部署流程可参考自动获取动态IPV4并解析到阿里云域名
- SSH登录服务器后台或相关可执行计划任务的服务
- 添加脚本到服务器上并设置周期执行时间
- 修改脚本中
__execute方法块中域名相关变量
参考脚本内容
#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""
@Time : 2023/08/23
@Author : LXW
@Site :
@File : ipv4.py
@Software: PyCharm
@Description:
- 版本
-- python==3.8
-- alibabacloud_alidns20150109==3.0.7
-- aliyun-python-sdk-domain==3.14.9
- 依赖安装
-- pip3 install alibabacloud_alidns20150109==3.0.7
-- pip3 install aliyun-python-sdk-domain==3.14.9
"""
import json
import requests
from alibabacloud_alidns20150109 import models as alidns_20150109_models
from alibabacloud_alidns20150109.client import Client as Alidns20150109Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient
class RemoteIp:
def __init__(self, url, username, passwd):
self.url = url
self.username = username
self.passwd = passwd
def __get_token(self):
_url = self.url + "/emby/Users/authenticatebyname?X-Emby-Client=Emby%20Web&X-Emby-Device-Name=Chrome%20macOS&X-Emby-Device-Id=fa6b7733-23fc-4cb7-bae3-d7f0536b485e&X-Emby-Client-Version=4.7.13.0&X-Emby-Language=zh-cn"
content = requests.post(_url, False, {"Username": self.username, "Pw": self.passwd}).text
return json.loads(content)["AccessToken"]
def get_remote_addr(self):
token = self.__get_token()
full_url = self.url + "/emby/System/Info?X-Emby-Token=" + token
content = requests.get(full_url, False).text
addr = list(json.loads(content)["RemoteAddresses"])
remote_add = str(addr[0]).split(":")[1].replace("/", "")
return remote_add
def request_params(request, value):
request.value = value
class AliyunOperation:
def __init__(self, access_key_id, access_secret):
"""
初始化
:param access_key_id: 阿里云AccessKey的ID
:param access_secret: 阿里云AccessKey的密码
"""
config = open_api_models.Config(
# 必填，您的 AccessKey ID,
access_key_id=access_key_id,
# 必填，您的 AccessKey Secret,
access_key_secret=access_secret
)
# Endpoint 请参考 https://api.aliyun.com/product/Alidns
config.endpoint = f'alidns.cn-hangzhou.aliyuncs.com'
self.client = Alidns20150109Client(config)
def describe_subdomain_records(self, subdomain, domain_name):
"""
子域名解析记录查询 https://api.aliyun.com/api/Alidns/2015-01-09/DescribeSubDomainRecords
这个函数会返回一大堆东西，但是目前我们需要使用的就两个，一个是解析记录的数量，一个就是RecordId，RecordId修改域名解析时需要用到
:param domain_name:
:param subdomain:
:return:
"""
describe_sub_domain_records_request = alidns_20150109_models.DescribeSubDomainRecordsRequest(
sub_domain=subdomain,
domain_name=domain_name
)
runtime = util_models.RuntimeOptions()
try:
response = self.client.describe_sub_domain_records_with_options(describe_sub_domain_records_request,
runtime)
if 200 == response.status_code:
return response.body
except Exception as error:
# 如有需要，请打印 error
UtilClient.assert_as_string(error.message)
def add_record(self, domain_name, rr, domain_type, value):
"""
新增域名解析记录 https://api.aliyun.com/api/Alidns/2015-01-09/AddDomainRecord
如果域名解析记录不存在时，就需要新增域名解析记录，新增域名解析记录比较简单，直接填写参数即可
:param domain_name: 域名名称 baidu.com
:param rr: 主机记录。如果要解析@.exmaple.com，主机记录要填写”@”，而不是空。
:param domain_type: 解析记录类型。https://help.aliyun.com/document_detail/29805.html?spm=api-workbench.api_explorer.0.0.6b1a134bcODqcI
:param value: 记录值。String
:return:
"""
add_domain_record_request = alidns_20150109_models.AddDomainRecordRequest(
domain_name=domain_name,
rr=rr,
type=domain_type,
value=value
)
runtime = util_models.RuntimeOptions()
try:
response = self.client.add_domain_record_with_options(add_domain_record_request, runtime)
if 200 == response.status_code:
return response.body
except Exception as error:
# 如有需要，请打印 error
UtilClient.assert_as_string(error.message)
def update_record(self, domain_type, value, rr, record_id):
"""
更新域名解析记录
如果域名解析记录已存在，则不能使用新增，而是更新域名解析记录。更新的时候需要用到RecordId，这个一般查询的时候就会有返回，直接使用即可
:param domain_type: 解析记录类型。https://help.aliyun.com/document_detail/29805.html?spm=api-workbench.api_explorer.0.0.6b1a134bcODqcI
:param value: 记录值。String
:param rr: 主机记录。如果要解析@.exmaple.com，主机记录要填写”@”，而不是空。
:param record_id: 解析记录的ID
:return:
"""
update_domain_record_request = alidns_20150109_models.UpdateDomainRecordRequest(
record_id=record_id,
rr=rr,
type=domain_type,
value=value
)
runtime = util_models.RuntimeOptions()
try:
# 复制代码运行请自行打印 API 的返回值
self.client.update_domain_record_with_options(update_domain_record_request, runtime)
except Exception as error:
# 如有需要，请打印 error
UtilClient.assert_as_string(error.message)
def __execute():
# 获取动态 IPV4 地址（如果是IPV6也可以用相同方式获取）
__remote_addr = __get_from_urls()
if "None" == __remote_addr:
__remote_addr = RemoteIp(url=__url, username=__username, passwd=__passwd).get_remote_addr()
print("current ipv4: " + __remote_addr)
__aliyun_client = AliyunOperation(access_key_id=__accessKeyId, access_secret=__accessSecret)
# 查询 example.com 主机下 test.example.com 域名的解析列表
content = __aliyun_client.describe_subdomain_records("redirect.your.domain", "your.domain")
print("current desc domain content: " + str(content))
if 0 == content.total_count:
# 新增一条 test.example.com 的IPV4域名解析记录（如果是IPV6地址，修改参数 domain_type 为 AAAA）
__aliyun_client.add_record("your.domain", "redirect", "A", __remote_addr)
elif 1 == content.total_count:
# 如果 test.example.com 域名解析已经存在，则进行更新操作
source = content.domain_records.record[0]
record_id = source.record_id
if __remote_addr != source.value:
__aliyun_client.update_record("A", __remote_addr, "redirect", record_id)
# else:
# # 不推荐使用该方式进行域名解析更新，容易错误更新
# sources = content.domain_records.record
# for source in sources:
# # 因为是更新IP，所以只考虑 A 或者 AAAA
# domain_type = source.type
# if "A" == domain_type or "AAAA" == domain_type:
# record_id = source.record_id
# rr = source.rr
# __aliyun_client.update_record(domain_type, __remote_addr, rr, record_id)
def __get_from_urls():
"""
通过url获取本地IP地址
"https://myip4.ipip.net",
"https://ddns.oray.com/checkip",
"https://ip.3322.net",
"https://4.ipw.cn"
:return: ip
"""
ipw = "https://4.ipw.cn"
response = requests.get(ipw)
if 200 == response.status_code:
content = response.text
return content.strip()
ip = "https://ip.3322.net"
response = requests.get(ip)
if 200 == response.status_code:
content = response.text
return content.strip()
myip4 = "https://myip4.ipip.net"
response = requests.get(myip4)
if 200 == response.status_code:
content = response.text.split("：")[1]
content = content.replace("来自于", "")
return content.strip()
ddns = "https://ddns.oray.com/checkip"
response = requests.get(ddns)
if 200 == response.status_code:
content = response.text.split(":")[1]
return content.strip()
return "None"
if __name__ == '__main__':
# emby相关参数，可以不填
__url = "http://127.0.0.1:8096"
__username = "emby_user"
__passwd = "emby_passwd"
# 域名解析权限，必填
__accessKeyId = "__accessKeyId"
__accessSecret = "__accessSecret"
__execute()
设置公网访问
这里以阿里云CDN方式进行公网访问举例，利用了CDN的缓存、去除端口访问的限制、https证书访问配置等优点
假设在上文中解析的动态IP地址到的域名为 redirect.your.domain，那么站点的访问地址应该为 http://redirect.your.domain:8090
- 登录并通过官网购买CDN流量包
- 进入CDN控制台
- 在下面的
域名管理中添加域名 - 填写你要访问的域名，例如访问 http://blog.your.domain ，并根据出现的验证提示选择其中方式进行验证
- 在下面的
源站信息中点击新增源站信息 - 在
新增源站信息页面选择源站信息方式为源站域名 - 填写相关源站信息，其中域名为上文中我们通过动态IP解析到的域名(redirect.your.domain)，端口为我们的站点HTTP访问端口(8090)
- 确认完成后等待完成验证。在左侧
域名管理中就可以看到新增的域名已经完成状态了
- 点击域名右侧
操作中的管理对域名进行配置，大部分配置使用默认参数即可，以下仅说明几个重要配置
CDN配置管理
- IPv6开关: 控制客户端是IPV6地址可以正常访问站点
- 回源配置: 控制站点实际回源信息。因为我们采用的域名回源，所以需要设置最下方的301/302限制，否则实际站点返回可能出现端口
- 缓存配置: 用于配置各个节点的缓存和有效期，通过该配置可以有效提高高频访问数据的访问效率
- HTTPS配置: 该配置可以使我们的站点访问始终请求https证书地址
- 性能优化: 性能优化设置
- 流量限制: 限制峰值流量大小，非常重要。合理的设置可以有效避免你的CDN流量被恶意消耗导致产生高额费用
