跳到主要内容
版本:1.5

常见问题

Halo 是什么?

Halo [ˈheɪloʊ],一款现代化的开源博客/CMS系统,值得一试。

没有提供 SQL 脚本,是否需要手动建表?

得益于我们使用的 ORM 框架,Halo 在首次启动的时候会自动根据实体类创建表结构,无需通过 SQL 脚本自行创建,也不会提供所谓的 SQL 脚本。所以仅需配置好数据库连接地址和用户名密码即可。注意,H2 无需手动创建数据库,MySQL 需要。

详情可见:配置参考

为什么百度无法搜索到我的站点?

这是一个暂时无法解答的问题。所涉及到的问题过多,受影响因素可能有域名、服务器 IP 位置、建站时间、网站结构、内容等等。建议了解一下 SEO 相关知识对网站进行优化,目前我们在程序方面做的优化有:

  • 支持 sitemap 站点地图:可访问 /sitemap.xml/sitemap.html
  • 全站绝对路径
  • 页面静态化
  • 支持自定义文章关键字和描述
  • 支持自定义站点关键字以及站点描述

忘记了管理员密码,如何重置?

目前在登录页面含有隐藏的 找回密码 链接,点击即可进入找回密码页面,具体可参考以下步骤:

  1. 在登录页面按下键盘快捷键(Windows / Linux:Shift + Alt + H,macOS:Shift + Command + H)即可显示 找回密码 链接。
  2. 按照表单提示输入用户名和邮箱,点击 获取 按钮即可发送带有验证码的邮件。
  3. 按照表单填写验证码和新密码,点击重置密码即可。

需要注意的是,第 2 步中的获取验证码需要事先配置了 SMTP 发信设置,否则无法发送验证码。但你可以登录服务器查看 Halo 运行日志,搜索 Got reset password code 关键字即可获取到验证码。

附件上传提示 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;
}

开启了两步验证但丢失了验证设备或 APP,如何取消两步验证?

可以参考 忘记了管理员密码,如何重置? 重置密码,完成重置密码之后即可清除两步验证。

网站加载速度慢,是什么问题导致的?

导致网站加载速度慢的原因有很多,建议打开浏览器的 Developer Tools 查看具体是哪个请求时间过长,然后进行针对性的优化。这里提供一些可能的原因:

  1. 服务器带宽过小,很多厂商提供的最低带宽一般是 1M。
  2. 服务器地区过远,这个需要自行取舍。
  3. 网站上的图片过多或者体积过大,可以尝试压缩图片,或者参考 优雅的让 Halo 支持 webp 图片输出 的教程配置一个 Webp 图片的服务。
  4. 部分主题的静态资源可能是由公共 CDN 提供的,当这个 CDN 不稳定的时候可能会导致加载变慢。

一些提升网站加载速度的建议:

  1. 尽量不要选择 1M 带宽的服务器,可以根据自己的预算适当提升带宽。一般 3M 以上即可。
  2. 尽量购买网络质量较好的服务器,或者较近区域的服务器。
  3. 如果一定需要放大量的图片,建议先无损压缩一下再使用。
  4. 如上所说,可以自行搭建一个 Webp 图片转换的服务,参考 优雅的让 Halo 支持 webp 图片输出
  5. 如果网站的静态资源加载慢是由三方 CDN 导致的,可以自行修改主题。
  6. 可以使用全站 CDN 加速的方案。

如何在一台服务器上部署多个站点?

参考 写在前面/工作目录 我们可以知道,工作目录对于 Halo 主程序来说是固定的。如果我们需要部署多个站点,我们提供以下两种方式以供参考:

  1. 创建多个 Linux 账户,并在每个账户上运行一个独立的 Halo。因为工作目录是基于账户的,所以每个账户都有自己的工作目录。但是有一点需要注意,就是需要修改每一个 Halo 的运行端口,参考:配置参考/端口

  2. 使用 Docker 创建多个容器,因为使用 Docker 可以将内部的工作目录映射到宿主机的任何目录,可以参考以下创建容器的方式:

    # 第一个 Halo 容器
    docker run -it -d --name halo1 -p 8090:8090 -v ~/.halo.1:/root/.halo --restart=unless-stopped halohub/halo:latest

    # 第二个 Halo 容器
    docker run -it -d --name halo2 -p 8091:8090 -v ~/.halo.2:/root/.halo --restart=unless-stopped halohub/halo:latest

更多 Docker 相关的教程请参考:使用 Docker 部署 Halo

如何查看运行日志?

  1. 登录到服务器,查看工作目录下的 logs/spring.log
  2. 在 Halo 后台进入开发者选项(点击左上角 Halo Dashboard 10 次),选择 实时日志 界面。

SMTP 发信设置配置正确,但是发信失败,如何解决?

可能是部分厂商不允许使用密码作为客户端登录的凭证,一般会提供类似 授权码 的设置,将 授权码 当做密码在 Halo 后台设置即可。如还有其他类型的原因,欢迎向我们提交 issue:https://github.com/halo-dev/halo/issues/new/choose

网站配置了全站 CDN 导致后台部分功能异常,如何解决?

可能是 CDN 厂商默认关闭了 参数跟随 选项,导致部分接口参数没有正确添加到回源请求上。你可以在 CDN 控制台查找此选项并打开。或者设置路径过滤,过滤掉 /api/admin,让接口请求始终访问回源地址。

前台样式丢失,如何解决?

前台样式不正常或者丢失有很多种问题的可能,最快捷定位问题的方式就是打开浏览器控制台查看具体请求的错误,以下列出了部分导致出现该问题的常见原因:

  1. 后台设置的 博客地址 与实际访问地址不一致。也可能是开启了 https 之后,无法正常加载 http 资源,将 博客地址 改为 https 协议即可。

  2. Nginx 配置了静态资源缓存,但没有设置 proxy_pass,参考如下:

    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf|flv|mp4|ico)$ {
    proxy_pass http://halo;
    expires 30d;
    access_log off;
    }