5 分钟跑通 Halo:新手也能上手的开源建站工具
【免费下载链接】haloHalo 是一款强大易用的开源建站工具,从个人博客、知识库,到企业官网、在线商城,Halo 都能助您轻松实现,一站式满足您的多样化建站需求。项目地址: https://gitcode.com/GitHub_Trending/ha/halo
Halo 是一款开源建站工具,自带完整的内容管理系统:发文章、管页面、处理评论、装主题插件,全在一个后台里搞定。比如你刚拿到一台新服务器,想当天下午就上线一个能发文章的网站,用它就对了。
先跑起来:Docker 一条命令
⚡ 只要机器上装好了 Docker,一条命令就能启动:
# 一条命令跑起 Halo:8090 端口对外,数据存到本地目录 docker run -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 halohub/halo:2.25浏览器访问 http://localhost:8090,第一次打开会引导你初始化:设置管理员账号密码,网站就活了。后台入口在 /console 后面。想从源码了解原理的话,clone 仓库(git clone https://gitcode.com/GitHub_Trending/ha/halo)再跑./gradlew bootRun就行,先跑起来的话用上面这条命令足够。
它到底能干什么
第一篇文章怎么发
后台进「内容 → 文章 → 新建」。编辑器是富文本的,顶部一排工具栏,正文里敲/还能弹出菜单插入图片、表格、代码块:
写好标题正文,右上角点发布,文章就上线了。没想好就存草稿,回头接着改。
企业介绍页怎么建
文章是博客内容,公司介绍这类静态页面要用「内容 → 页面」。建好后到「界面 → 菜单」把新页面拖进导航,访客在站点头部就能点到。
访客评论去哪里处理
「内容 → 评论」里能看到全部评论,可以审核通过或标为垃圾评论。建议先勾上评论审核开关,免得垃圾留言直接展示出来。
搜索功能怎么开
内置搜索开箱即用,站点搜索框能按标题和正文查文章。内容量大、想要更灵敏的搜索体验,就装一个搜索插件接上 MeiliSearch:
让它更顺手:4 个配置
邮件通知配一下
📌 文章被人评论了,总得知道,不然访客干等。在「系统 → 通知」里填好 SMTP 信息、打开邮件通知器,之后评论事件就会发到你的邮箱:
SMTP 服务器、端口、账号密码四个空填好就行,其他不用动它。
一键备份在哪里配
「系统 → 备份」里点一下就能把数据库、主题、插件全打包成 zip,文件存在数据目录(~/.halo2)下的 backups 里。养成习惯定期下载一份到别处,出问题时能整站恢复。
站点标题和描述改在哪
「系统设置」里能改站点标题、Logo 和站点描述。描述是搜索引擎读到的话,写成"企业官网 + 主营业务"比较实在。
多人协作权限怎么设
只有一个管理员的话默认角色就够用了,先别管。真要多人写内容,就在「用户 → 角色」里给写手分个编辑角色,能发文但碰不了系统设置。
进阶 & 你可能遇到的坑
往后再试的三个方向:
- 主题定制:挑一个顺眼的主题改配色和布局,主题模板和开发说明可以看仓库里 docs/ 目录
- 二次开发:插件体系能扩展各种能力,后端 Java 源码在 application/,后台前端源码在 ui/console-src/
- 性能调优:正式环境把静态资源挂 CDN,反代层开缓存
✅ 几个高频坑:
端口不通:浏览器打不开 8090,先看docker ps里端口映射在不在,再看服务器防火墙或安全组放没放行。
备份下载失败:备份文件写在-v挂载的宿主目录里,下不动就检查挂载路径存不存在、磁盘还有没有空间。
镜像拉取慢:新机器拉 halohub/halo 慢,配个镜像加速器,或者找台网络好的机器拉下来再传过去。
下一步 & 资源
- docs/:项目文档与设计提案,想搞懂某个功能原理(全文搜索、通知、备份)时看
- ui/console-src/:后台前端源码,想改后台界面时看
- application/:后端 Java 源码,做插件二次开发时看
- gitcode 仓库的 Issue 区:遇到 bug 或想提功能需求时去
跑起来之后,先写两三篇文章、把通知和备份配好,剩下的定制什么时候想弄什么时候弄。
【免费下载链接】haloHalo 是一款强大易用的开源建站工具,从个人博客、知识库,到企业官网、在线商城,Halo 都能助您轻松实现,一站式满足您的多样化建站需求。项目地址: https://gitcode.com/GitHub_Trending/ha/halo
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考