前言

Halo是一款现代化的开源个人博客系统，基于Spring Boot和Vue.js开发，具有轻量、快速、功能丰富等特点。本教程将带领零基础用户从服务器选购到博客上线的完整流程，使用Ciuic云服务器作为演示平台。

第一步：购买服务器

访问Ciuic云服务器官网注册账号并完成实名认证选择适合的服务器配置：入门配置：1核CPU/1GB内存/25GB SSD（适合个人博客初期）推荐配置：2核CPU/2GB内存/50GB SSD（有更好性能表现）选择操作系统：建议选择CentOS 7或Ubuntu 20.04 LTS

第二步：连接服务器

购买完成后，通过SSH工具连接服务器：

ssh root@你的服务器IP

输入购买时设置的密码即可登录。

第三步：安装必要环境

1. 更新系统

sudo apt update && sudo apt upgrade -y  # Ubuntu# 或sudo yum update -y  # CentOS

2. 安装Docker

Halo推荐使用Docker方式安装，简单高效：

# 安装Dockercurl -fsSL https://get.docker.com | bash -s docker# 启动Dockersystemctl start dockersystemctl enable docker

3. 安装Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(unlink -m)-$(uname -s)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-compose

第四步：安装Halo

1. 创建工作目录

mkdir ~/halo && cd ~/halo

2. 创建配置文件

vim docker-compose.yaml

输入以下内容：

version: "3"services:  halo:    image: halohub/halo:latest    container_name: halo    restart: unless-stopped    ports:      - "8090:8090"    volumes:      - ./:/root/.halo    environment:      - HALO_EXTERNAL_URL=http://localhost:8090/      - HALO_SECURITY_INITIALIZER_SUPERADMINUSERNAME=admin      - HALO_SECURITY_INITIALIZER_SUPERADMINPASSWORD=admin123

按ESC，然后输入:wq保存退出。

3. 启动Halo

docker-compose up -d

等待约1-2分钟，访问http://你的服务器IP:8090即可看到安装界面。

第五步：配置Halo

首次访问会进入初始化页面设置站点名称、用户名和密码（建议修改默认密码）选择喜欢的主题（Halo提供多款免费主题）完成初始化后即可进入后台管理界面

第六步：配置域名（可选）

如果希望使用自己的域名访问博客：

在域名服务商处添加A记录指向服务器IP安装Nginx作为反向代理：

sudo apt install nginx -y

配置Nginx：

sudo vim /etc/nginx/conf.d/halo.conf

输入以下内容：

server {    listen 80;    server_name 你的域名;    location / {        proxy_pass http://127.0.0.1:8090;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    }}

重启Nginx：

sudo systemctl restart nginx

第七步：HTTPS配置（推荐）

使用Let's Encrypt免费证书：

sudo apt install certbot python3-certbot-nginx -ysudo certbot --nginx -d 你的域名

按照提示操作即可完成HTTPS配置。

常见问题解决

无法访问8090端口：检查服务器安全组/防火墙是否放行8090端口忘记管理员密码：

docker exec -it halo halo-cli --halo.security.initializer.superadminpassword=新密码

更新Halo版本：

cd ~/halodocker-compose pulldocker-compose up -d

通过本教程，您已经成功在Ciuic云服务器上部署了Halo博客系统。Halo提供了丰富的插件和主题市场，您可以根据需要进一步定制您的博客。现在，开始撰写您的第一篇博客文章吧！

如需更高级的配置或遇到问题，可以参考Halo官方文档或社区论坛获取帮助。