1. 为什么选择Halo搭建个人博客第一次接触Halo是在2020年当时我正在寻找一个既美观又轻量的博客系统。作为一个技术博主我尝试过WordPress、Hexo、Hugo等主流方案但总有些不如意的地方。直到遇见Halo它的后台UI设计让我眼前一亮 - 简洁现代的操作界面流畅的交互体验完全符合我对现代化博客系统的想象。Halo最大的优势在于它的开箱即用特性。相比需要复杂配置的静态网站生成器Halo提供了完整的动态博客功能可视化编辑器、主题市场、插件系统、多用户支持等。最让我惊喜的是它的资源占用 - 在1核1G的云服务器上运行毫无压力这对个人站长来说太友好了。从技术架构看Halo基于Spring Boot实现采用Docker容器化部署方案。这意味着部署简单一条docker-compose命令即可启动维护方便版本升级只需替换镜像扩展性强支持MySQL/PostgreSQL等专业数据库社区活跃官方文档完善问题响应及时2. 部署前的准备工作2.1 服务器选购建议我推荐使用主流云服务商的轻量应用服务器配置建议CPU1核阿里云t6/腾讯云轻量1核内存1GB运行MySQL需1.5GB以上系统Ubuntu 22.04 LTS长期支持版带宽按需选择个人博客3Mbps足够实测下来这样的配置可以支撑日均5000PV的访问量。如果预算有限学生机或海外VPS也是不错的选择但要注意网络延迟问题。2.2 基础环境配置以Ubuntu系统为例我们需要先完成这些准备工作# 更新系统软件包 sudo apt update sudo apt upgrade -y # 安装常用工具 sudo apt install -y curl wget vim git特别提醒如果使用国内服务器建议先配置软件源加速# 替换阿里云源 sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list2.3 Docker环境安装Halo官方推荐使用Docker部署下面是Docker CE的安装步骤# 安装依赖 sudo apt install -y apt-transport-https ca-certificates software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 设置稳定版仓库 echo deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world安装完成后建议将当前用户加入docker组避免每次使用sudosudo usermod -aG docker $USER newgrp docker3. 使用Docker Compose部署Halo3.1 准备部署目录创建一个专用目录存放Halo的配置文件和数据mkdir ~/halo cd ~/halo这个目录将包含docker-compose.yml服务编排文件halo2应用数据目录db数据库数据目录如果使用独立数据库3.2 编写docker-compose.yml我推荐使用PostgreSQL作为生产环境数据库下面是完整配置version: 3 services: halo: image: halohub/halo:2.17 restart: unless-stopped depends_on: halodb: condition: service_healthy volumes: - ./halo2:/root/.halo2 ports: - 8090:8090 healthcheck: test: [CMD, curl, -f, http://localhost:8090/actuator/health/readiness] interval: 30s timeout: 5s retries: 5 command: - --spring.r2dbc.urlr2dbc:pool:postgresql://halodb/halo - --spring.r2dbc.usernamehalo - --spring.r2dbc.passwordyourstrongpassword - --spring.sql.init.platformpostgresql - --halo.external-urlhttps://yourdomain.com halodb: image: postgres:15-alpine restart: unless-stopped volumes: - ./db:/var/lib/postgresql/data environment: POSTGRES_PASSWORD: yourstrongpassword POSTGRES_USER: halo POSTGRES_DB: halo healthcheck: test: [CMD-SHELL, pg_isready -U halo -d halo] interval: 10s timeout: 5s retries: 5 networks: default: name: halo-network关键参数说明halo.external-url必须设置为你的域名PostgreSQL密码需要保持services.halo和halodb一致使用alpine版PostgreSQL镜像减小体积3.3 启动服务执行以下命令启动所有服务docker compose up -d首次启动需要下载镜像耐心等待完成后可以通过日志查看运行状态docker compose logs -f halo当看到Started HaloApplication in XX seconds日志时说明服务已就绪。4. 系统初始化与基础配置4.1 完成安装向导访问http://服务器IP:8090/console进入初始化页面需要填写站点名称显示在浏览器标签页管理员账号建议使用强密码邮箱用于找回密码特别提醒初始化完成后立即到系统-个人资料中修改默认密码。4.2 基础系统设置建议优先配置这些选项站点设置站点URL必须与docker-compose.yml中的external-url一致时区选择Asia/Shanghai备案号国内服务器需要填写评论设置开启评论审核配置反垃圾设置备份设置开启自动备份设置备份保留天数4.3 安装主题Halo的主题市场提供了丰富选择进入外观-主题点击安装主题搜索喜欢的主题推荐Annie、Higan点击安装后启用我实测过十几款主题最终选择了Annie它的特点响应式设计移动端体验优秀支持暗黑模式加载速度极快Lighthouse评分955. 内容创作与发布5.1 撰写第一篇博客点击文章-写文章进入编辑器Halo提供了Markdown和富文本双模式实时预览功能图床支持可配置阿里云OSS写作技巧先写大纲再填充内容合理使用二级、三级标题每段文字控制在3-5行适当添加图片分隔内容5.2 文章SEO优化在发布文章时注意这些SEO设置自定义别名使用英文短链接元描述50-160字符的摘要关键词2-5个核心关键词封面图建议尺寸1200×6305.3 分类与标签管理建立科学的分类体系很重要我的经验分类不超过5个如技术、生活、读书标签可以自由添加每篇文章1-2个分类3-5个标签6. 高级配置与优化6.1 配置HTTPS访问使用Lets Encrypt免费证书安装Nginx并配置反向代理使用certbot获取证书sudo apt install -y nginx certbot python3-certbot-nginx sudo certbot --nginx -d yourdomain.com配置自动续期sudo certbot renew --dry-run6.2 性能优化方案通过这几项设置显著提升速度开启Gzip压缩配置浏览器缓存启用HTTP/2添加CDN加速Nginx配置示例gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xmlrss text/javascript; gzip_min_length 1k; gzip_comp_level 6; gzip_vary on; location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 365d; }6.3 备份与恢复策略我采用的备份方案每日自动备份到阿里云OSS每周完整导出SQL重大更新前手动备份备份命令示例# 备份数据库 docker exec -t halodb pg_dump -U halo -d halo halo_backup.sql # 备份整个halo2目录 tar -czvf halo2_backup.tar.gz ~/halo/halo27. 常见问题解决方案7.1 端口无法访问检查步骤服务器安全组放行8090端口检查防火墙设置sudo ufw status sudo ufw allow 8090/tcp验证服务是否运行docker compose ps7.2 数据库连接失败典型错误排查检查halodb容器是否健康docker compose logs halodb验证网络连通性docker exec -it halo curl http://halodb:5432检查密码是否一致docker compose exec halodb psql -U halo -d halo -W7.3 主题安装失败解决方法检查网络连接尝试手动上传主题包清理浏览器缓存后重试查看日志定位问题docker compose logs halo | grep -i theme8. 我的使用经验分享经过两年多的实际使用Halo已经稳定运行了我的三个技术博客。在这个过程中我总结出几点重要经验首先是定期备份的重要性。曾经因为服务器故障丢失过一周的数据现在我会配置双重备份每日增量备份到本地NAS每周全量备份到云存储。Halo的备份功能很完善但建议同时备份docker-compose.yml和数据库。其次是主题选择要慎重。早期频繁更换主题导致样式错乱现在我会先在测试环境验证主题兼容性。发现Annie主题后就没再更换过它的自定义选项足够丰富能实现我想要的所有效果。最后是插件的使用要克制。虽然Halo的插件生态不错但安装过多插件会影响性能。我目前只保留了百度统计、评论系统和SEO优化这三个必备插件。
Halo博客搭建实战：从零到一的完美部署指南
发布时间：2026/5/21 4:27:52
1. 为什么选择Halo搭建个人博客第一次接触Halo是在2020年当时我正在寻找一个既美观又轻量的博客系统。作为一个技术博主我尝试过WordPress、Hexo、Hugo等主流方案但总有些不如意的地方。直到遇见Halo它的后台UI设计让我眼前一亮 - 简洁现代的操作界面流畅的交互体验完全符合我对现代化博客系统的想象。Halo最大的优势在于它的开箱即用特性。相比需要复杂配置的静态网站生成器Halo提供了完整的动态博客功能可视化编辑器、主题市场、插件系统、多用户支持等。最让我惊喜的是它的资源占用 - 在1核1G的云服务器上运行毫无压力这对个人站长来说太友好了。从技术架构看Halo基于Spring Boot实现采用Docker容器化部署方案。这意味着部署简单一条docker-compose命令即可启动维护方便版本升级只需替换镜像扩展性强支持MySQL/PostgreSQL等专业数据库社区活跃官方文档完善问题响应及时2. 部署前的准备工作2.1 服务器选购建议我推荐使用主流云服务商的轻量应用服务器配置建议CPU1核阿里云t6/腾讯云轻量1核内存1GB运行MySQL需1.5GB以上系统Ubuntu 22.04 LTS长期支持版带宽按需选择个人博客3Mbps足够实测下来这样的配置可以支撑日均5000PV的访问量。如果预算有限学生机或海外VPS也是不错的选择但要注意网络延迟问题。2.2 基础环境配置以Ubuntu系统为例我们需要先完成这些准备工作# 更新系统软件包 sudo apt update sudo apt upgrade -y # 安装常用工具 sudo apt install -y curl wget vim git特别提醒如果使用国内服务器建议先配置软件源加速# 替换阿里云源 sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list2.3 Docker环境安装Halo官方推荐使用Docker部署下面是Docker CE的安装步骤# 安装依赖 sudo apt install -y apt-transport-https ca-certificates software-properties-common # 添加Docker官方GPG密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 设置稳定版仓库 echo deb [archamd64 signed-by/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker run hello-world安装完成后建议将当前用户加入docker组避免每次使用sudosudo usermod -aG docker $USER newgrp docker3. 使用Docker Compose部署Halo3.1 准备部署目录创建一个专用目录存放Halo的配置文件和数据mkdir ~/halo cd ~/halo这个目录将包含docker-compose.yml服务编排文件halo2应用数据目录db数据库数据目录如果使用独立数据库3.2 编写docker-compose.yml我推荐使用PostgreSQL作为生产环境数据库下面是完整配置version: 3 services: halo: image: halohub/halo:2.17 restart: unless-stopped depends_on: halodb: condition: service_healthy volumes: - ./halo2:/root/.halo2 ports: - 8090:8090 healthcheck: test: [CMD, curl, -f, http://localhost:8090/actuator/health/readiness] interval: 30s timeout: 5s retries: 5 command: - --spring.r2dbc.urlr2dbc:pool:postgresql://halodb/halo - --spring.r2dbc.usernamehalo - --spring.r2dbc.passwordyourstrongpassword - --spring.sql.init.platformpostgresql - --halo.external-urlhttps://yourdomain.com halodb: image: postgres:15-alpine restart: unless-stopped volumes: - ./db:/var/lib/postgresql/data environment: POSTGRES_PASSWORD: yourstrongpassword POSTGRES_USER: halo POSTGRES_DB: halo healthcheck: test: [CMD-SHELL, pg_isready -U halo -d halo] interval: 10s timeout: 5s retries: 5 networks: default: name: halo-network关键参数说明halo.external-url必须设置为你的域名PostgreSQL密码需要保持services.halo和halodb一致使用alpine版PostgreSQL镜像减小体积3.3 启动服务执行以下命令启动所有服务docker compose up -d首次启动需要下载镜像耐心等待完成后可以通过日志查看运行状态docker compose logs -f halo当看到Started HaloApplication in XX seconds日志时说明服务已就绪。4. 系统初始化与基础配置4.1 完成安装向导访问http://服务器IP:8090/console进入初始化页面需要填写站点名称显示在浏览器标签页管理员账号建议使用强密码邮箱用于找回密码特别提醒初始化完成后立即到系统-个人资料中修改默认密码。4.2 基础系统设置建议优先配置这些选项站点设置站点URL必须与docker-compose.yml中的external-url一致时区选择Asia/Shanghai备案号国内服务器需要填写评论设置开启评论审核配置反垃圾设置备份设置开启自动备份设置备份保留天数4.3 安装主题Halo的主题市场提供了丰富选择进入外观-主题点击安装主题搜索喜欢的主题推荐Annie、Higan点击安装后启用我实测过十几款主题最终选择了Annie它的特点响应式设计移动端体验优秀支持暗黑模式加载速度极快Lighthouse评分955. 内容创作与发布5.1 撰写第一篇博客点击文章-写文章进入编辑器Halo提供了Markdown和富文本双模式实时预览功能图床支持可配置阿里云OSS写作技巧先写大纲再填充内容合理使用二级、三级标题每段文字控制在3-5行适当添加图片分隔内容5.2 文章SEO优化在发布文章时注意这些SEO设置自定义别名使用英文短链接元描述50-160字符的摘要关键词2-5个核心关键词封面图建议尺寸1200×6305.3 分类与标签管理建立科学的分类体系很重要我的经验分类不超过5个如技术、生活、读书标签可以自由添加每篇文章1-2个分类3-5个标签6. 高级配置与优化6.1 配置HTTPS访问使用Lets Encrypt免费证书安装Nginx并配置反向代理使用certbot获取证书sudo apt install -y nginx certbot python3-certbot-nginx sudo certbot --nginx -d yourdomain.com配置自动续期sudo certbot renew --dry-run6.2 性能优化方案通过这几项设置显著提升速度开启Gzip压缩配置浏览器缓存启用HTTP/2添加CDN加速Nginx配置示例gzip on; gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xmlrss text/javascript; gzip_min_length 1k; gzip_comp_level 6; gzip_vary on; location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ { expires 365d; }6.3 备份与恢复策略我采用的备份方案每日自动备份到阿里云OSS每周完整导出SQL重大更新前手动备份备份命令示例# 备份数据库 docker exec -t halodb pg_dump -U halo -d halo halo_backup.sql # 备份整个halo2目录 tar -czvf halo2_backup.tar.gz ~/halo/halo27. 常见问题解决方案7.1 端口无法访问检查步骤服务器安全组放行8090端口检查防火墙设置sudo ufw status sudo ufw allow 8090/tcp验证服务是否运行docker compose ps7.2 数据库连接失败典型错误排查检查halodb容器是否健康docker compose logs halodb验证网络连通性docker exec -it halo curl http://halodb:5432检查密码是否一致docker compose exec halodb psql -U halo -d halo -W7.3 主题安装失败解决方法检查网络连接尝试手动上传主题包清理浏览器缓存后重试查看日志定位问题docker compose logs halo | grep -i theme8. 我的使用经验分享经过两年多的实际使用Halo已经稳定运行了我的三个技术博客。在这个过程中我总结出几点重要经验首先是定期备份的重要性。曾经因为服务器故障丢失过一周的数据现在我会配置双重备份每日增量备份到本地NAS每周全量备份到云存储。Halo的备份功能很完善但建议同时备份docker-compose.yml和数据库。其次是主题选择要慎重。早期频繁更换主题导致样式错乱现在我会先在测试环境验证主题兼容性。发现Annie主题后就没再更换过它的自定义选项足够丰富能实现我想要的所有效果。最后是插件的使用要克制。虽然Halo的插件生态不错但安装过多插件会影响性能。我目前只保留了百度统计、评论系统和SEO优化这三个必备插件。
