Q1. Halo 是什么？ Halo 是一款现代化的个人独立博客系统，给习惯写博客的同学一个更好的选择。 Q2. 为什么默认的数据库是使用的 H2，而不是 MySQL？虽然 Halo 支持 MySQL ，但是作者并不建议使用 MySQL ，因为一个博客而已，完全没必要单独跑一个 MySQL 服务。使用 H2 的优劣：优点：能更快的完成 Halo 的搭建。无需单独安装 H2 ，数据库随着 Halo 的启动而创建。比 MySQL 更节省资源占用，尤其是你的服务器配置不佳的情况下。性能方面与 MySQL 基本无异（对于这种小型应用），实测 1000 篇文章的情况下，毫无压力。不会因为某个配置不对而导致 Halo 无法正常使用，没有乱七八糟的问题。更符合 Halo 数据架构的特点，所有数据（数据库物理文件，主题文件，上传的附件，日志等）均放在 ~/.halo 文件夹内，所以备份迁移极其方便。如上所述，目前所有备份相关的功能均针对 H2。MySQL 的备份暂无计划。一个误解：很多人认为 H2 通常仅作为开发环境测试所用，生产环境并不适用。错误的说法！请针对实际情况做选择。Halo 甚至可以支持 Oracle，但是有必要吗？作者已经使用两年，所以放心使用。缺点：管理不方便，虽然有在线的控制台，但是并不好用。使用 MySQL 的优劣：优点：管理方便，你可以开启远程连接，在自己电脑即可管理数据库。不过目前我们已经做了一些开发者功能，似乎也没必要怎么管理。缺点（仅针对于 Halo）：部署麻烦，还需要单独跑一个 MySQL，不能做到 Halo 开箱即用。占用内存，尤其是你服务器内存不够的情况下，宛如雪上加霜。当然，服务器强壮的话可无视。版本太多，当你安装了一个 Halo 不支持的版本（目前支持 5.7+）的时候，可能会无法正常使用，甚至无法正常启动。配置繁琐，你可能需要配置如字符集这样的东西，对新手来说极不友好。（字符集 utf8mb4 collate utf8mb4_bin）备份迁移麻烦，你不但需要备份 ~/.halo ，还需要导出数据库脚本。目前暂不支持后台备份 MySQL 数据。 Q3. 为什么项目里面没有 SQL 脚本，难道要我自己建表吗？没有提供 SQL 脚本，当然不用自己建表，不管你是用的 H2 还是 MySQL ，程序启动的时候就已经自动建好表了。另外，不想再有人问我为什么没有提供 SQL 脚本。 Q4. 为什么上传主题或者附件会失败？（413 Request Entity Too Large）这可能是由于 Nginx 的上传大小限制所导致的。可以在 Nginx 的配置文件下的 server 节点加入 client_max_body_size 1024m; 即可解决，如果 1024m 还不够，请自行断定，详细配置参考如下： server { listen 80; server_name localhost; client_max_body_size 1024m; } 如果想要禁用 client_max_body_size ，请将值设置为 0 。 Q5. 为什么有些页面访问 404？这可能是由于主题没有对应的模板导致的，假如我们需要访问所有分类目录的页面（ /categories ），但是你使用的主题下面并没有 categories.ftl 这个模板，就会导致 404。再比如我们需要访问相册页面（ /photos ），但是当前使用的主题下面并没有 photos.ftl 这个模板，所以也是无法访问的，页面能否访问的前提条件是有没有对应模板。总之，看主题支持情况，就目前来说，绝大部分已有主题是支持 /（首页）， /archives（归档）， /links（友情链接）， /tags（标签列表）， /archives/{url}（文章页面）等页面的渲染的。另外，对于没有的模板，可以自行拓展哦。 Q6. 为什么不支持 war 包部署？理论上 Spring Boot 是提供 war 包的打包方式的，但是我们不提供 war 包。并且我们并没有使用 war 包进行测试，如果你非要使用，请自行打包并承担所有未知的问题。总之，别问我。 Q7. 安装完成之后前台页面无样式。请前往后台的博客设置，检查博客地址设置项是否正确，注意 http 和 https 的区分。 Q8. 找不到主题上传的地方？后台 -> 外观 -> 主题，右下角有个蓝色背景的浮动的白色的加号。然后点击一下，会出现安装主题的选项。未完待续…

ruibaby 另外，不想再有人问我为什么没有提供 SQL 脚本。看来已经被问的欲死欲仙了:

wellmoonloft 欲死欲仙嗯，是这样的。

ruibaby implementation 'org.projectlombok:lombok:1.18.8' annotationProcessor 'org.projectlombok:lombok:1.18.8' 改成这样没有问题吧，可以运行，不报错

HarryZhang halo 最新的代码应该已经添加了 Lombok 依赖（没有版本号）。

Halo 使用中的常见问题

PengandZhao

ruibaby 为什么我的打开网页是拒绝访问= =192.168.1.xxx 拒绝了我们的连接请求。前天还好好的呀，检查也下端口，也没有被占用。😫

1390625470

PengandZhao
你是买的服务器吗。

HarryZhang

johnniang 但是lombok的dependency根本每加进来，只有改成那样才有效果

HarryZhang

但是lombok的dependency根本每加进来，只有改成那样才有效果

2071845774

@ruibaby 使用的默认主题，添加菜单的时候标签列表页面404，友情链接和相册页面都正常，求解答Orz

ruibaby

2071845774 默认主题没有标签列表页面的模板 tags.ftl

2071845774

ruibaby 我看到有tag.ftl文件啊，不一样吗？

ruibaby

2071845774 不一样

2071845774

ruibaby 好的，谢谢。

yuninglong

请问，是否支持在首页添加搜索功能？？

johnniang

yuninglong 有些主题是支持的，也就意味着，可以通过自己手动修改主题文件来实现这个功能。

yuninglong

好的，谢谢
还想请问，我用了 halo-theme-pinghsu-1.2，无法进行评论回复，应该如何设置?

ruibaby

yuninglong 能看看你的博客吗？

yuninglong

ruibaby blog.yuninglong.com 这个地址，你去回复看看，没有点击保存的

ruibaby

yuninglong 我刚刚评论了一条哦

yuninglong

ruibaby 没有看到啊，你刷新一下页面

ruibaby

yuninglong 要你审核通过才能看到的

yuninglong

ruibaby 是的，你的居然可以，我的不行
http://www.yuninglong.com//blog/asdfasdfasdf666.jpg

ruibaby

yuninglong 邮箱和昵称是必填。才能提交评论。

yuninglong

ruibaby 可以了
我提点意见哈，现在发布的文章，字体大小好像加粗不明显，还有颜色如果有就更好了

ruibaby

yuninglong 主题吗？

yuninglong

ruibaby 不是主题，就是后台编辑文章的时候，现在好像是没有加文字颜色的吧

johnniang

mrlisir 请确认 Gradle 是否正常工作！