https://doks.xazz.top/docs/halo/Recent content in 博客部署 onHugo -- gohugo.ioWed, 10 Jun 2026 16:20:00 +0800https://doks.xazz.top/docs/halo/deployment/Wed, 10 Jun 2026 16:20:00 +0800https://doks.xazz.top/docs/halo/deployment/官方参考 # Halo 官方文档 使用 Docker Compose 部署 配置说明 官方文档推荐生产部署优先使用 Docker Compose，并根据实际情况选择 PostgreSQL、MySQL 或外部数据库。 架构概览 # 一个通用的生产链路可以按访问路径理解： 访客 -> 域名/CDN -> 反向代理 -> Halo 容器 -> 数据库 各层职责如下： 层级 作用 常见检查点 Docker Compose 编排 Halo 和数据库 容器状态、网络、挂载目录 Halo 提供博客和后台服务 健康检查、日志、插件 数据库 保存文章、配置和用户数据 连接状态、备份、磁盘空间 反向代理 提供 HTTPS 和域名访问 证书、转发头、上游地址 CDN 或托管平台 对外访问入口 回源状态、缓存、部署状态 i 排障时先确认 Halo 容器和数据库正常，再检查反向代理、CDN 或托管平台，不要只盯最终域名。 项目目录 # 官方示例使用 ~/halo 作为部署目录，也可以换成团队约定的路径： ~/halo 主要文件和目录： 路径 用途 docker-compose.yaml Halo 和数据库编排 .env 可选，保存端口、域名、数据库密码等变量 halo2/ Halo 应用数据目录 db/ 数据库数据目录 backups/ 手动备份目录 Compose 服务 # 常见 compose 中至少包含两个核心服务：https://doks.xazz.top/docs/halo/operations/Wed, 10 Jun 2026 16:20:00 +0800https://doks.xazz.top/docs/halo/operations/进入目录 # 所有命令默认在部署目录中执行： cd ~/halo 查看状态 # 查看容器： docker compose ps 查看资源占用： docker stats 查看最近日志： docker compose logs --tail=120 halo docker compose logs --tail=120 halodb 持续跟踪 Halo 日志： docker compose logs -f halo 重启服务 # 只重启 Halo： docker compose restart halo 重启整套服务： docker compose restart 停止服务： docker compose down 重新启动： docker compose up -d 数据备份 # 备份数据库前先创建备份目录： mkdir -p backups 如果使用 MySQL，可以导出 SQL： docker compose exec halodb sh -c 'mysqldump -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" halo' \ > backups/halo_mysql_$(date +%Y%m%d_%H%M%S).https://doks.xazz.top/docs/halo/troubleshooting/Wed, 10 Jun 2026 16:20:00 +0800https://doks.xazz.top/docs/halo/troubleshooting/排障原则 # Halo2 公开访问链路较长，排障时要分段确认： Halo 容器 -> 数据库 -> 反向代理 -> CDN 或托管平台 -> 公开域名 不要只看最终域名是否能打开。最终域名失败只能说明链路某处异常，不能直接证明 Halo 应用坏了。 第一段：本机 Docker # 检查容器是否运行： cd ~/halo docker compose ps 检查本机页面： curl -I --max-time 10 http://127.0.0.1:8090/ 查看日志： docker compose logs --tail=200 halo 常见问题： 现象 优先检查 Halo 容器反复重启 docker compose logs --tail=200 halo 数据库不健康 docker compose logs --tail=200 halodb 页面 500 Halo 日志、数据库连接、插件报错 本机都打不开 端口占用、容器状态、.env 配置 第二段：数据库 # 如果 Halo 容器启动了但页面报错，继续检查数据库： docker compose ps halodb docker compose logs --tail=200 halodb 重点看：