
基于1Panel面板搭建Halo博客的详细教程
一、环境准备
服务器选择
推荐阿里云、腾讯云等主流云平台。
系统选择Ubuntu/CentOS等Linux发行版(建议内存≥2GB)。
若使用国内服务器,需提前完成域名ICP备案。
域名注册
二、安装1Panel面板
1Panel官网链接:1Panel - 现代化、开源的 Linux 服务器运维管理面板 - 官网
一键安装命令
CentOS/RedHat:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sh quick_start.sh
Ubuntu:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh
Debian:
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh
配置安装路径与端口
默认安装路径为
/opt
,端口建议选择10000-60000区间(如20000)。安装完成后,记录生成的外网访问地址和账号密码。
防火墙设置
在云服务器控制台开放1Panel面板端口(如20000)及后续Halo的访问端口(如8090)。
三、部署Halo博客
安装依赖服务
进入1Panel的应用商店,依次安装:
OpenResty(Web服务器)
MySQL/PostgreSQL(数据库)。
部署Halo应用
在应用商店中找到Halo,配置参数:
数据库:选择已安装的数据库实例,自动创建库和用户。
外部访问地址:填写
http://服务器IP:8090
(端口可自定义)。
点击安装,等待状态变为“已启动”。
初始化Halo
浏览器访问
http://服务器IP:8090
,完成管理员账号设置。在Halo后台安装主题并启用。
四、域名绑定与HTTPS配置
DNS解析
在域名服务商处添加A记录,将域名指向服务器IP。
1Panel反向代理配置
进入1Panel的网站管理,创建新网站:
主域名:填写已注册的域名(如
cwyue.cn
)。代理地址:设置为
服务器IP:8090
。
启用HTTPS,通过1Panel的证书管理自动申请Let's Encrypt免费SSL证书。
五、进阶配置
图床整合
使用EasyImage或兰空图床,配合PicGo实现Markdown图片自动上传。
避免Gitee等平台的防盗链限制,推荐自建图床或使用OSS存储。
备份与维护
1Panel支持一键备份网站和数据库,建议定期备份至云端。
通过1Panel监控服务器资源(CPU/内存/磁盘)。
常见问题
端口冲突
确保Halo的端口(如8090)未被占用,否则修改为其他端口。
主题兼容性
部分Halo主题需调整模板,建议选择官方推荐主题。
备案提示
国内服务器需完成ICP备案,否则域名无法解析。