跳到主要内容
版本:2.12.0-SNAPSHOT

常见问题

Halo 是什么?

Halo [ˈheɪloʊ],是一款好用又强大的开源建站工具,配合上不同的模板与插件,可以很好地帮助你构建你心中的理想站点。它可以是你公司的官方网站,可以是你的个人博客,也可以是团队共享的知识库,甚至可以是一个论坛、一个商城。

忘记密码怎么办?

如果安装时没有指定 halo.security.initializer.superadminpassword 参数,系统会随机一个初始化密码,可以通过下面的命令进行查看。

docker logs halo | grep 'Generated random password:' | tail -1

如果你已经修改过初始化密码后忘记了密码,假设系统中还有可用的具有用户管理权限的其他用户,可以通过该用户参考修改用户密码部分,修改指定用户的密码。没有可用的具有用户管理权限的管理员用户时,目前需要通过删除数据库记录的方式,触发管理员用户的初始化任务进行密码重置。

假设 Halo 使用容器方式运行,容器名称为 halo,具体操作如下。

  1. 停止 Halo 服务

    docker stop halo
  2. 连接 Halo 使用的数据库,删除管理员的用户记录(配置文件中的 halo.security.initializer.superadminusername),这里以 admin 为例

    以容器化部署的 PostgreSQL 为例,假设容器名称为 halo_db

    # 进入 psql 命令行
    docker exec -it halo_db psql halo

    # 执行下面的 SQL 删除 admin 用户记录
    delete from extensions where name like '/registry/users/admin';
    信息

    其他类型的数据库处理方式类似,先通过命令行或数据库连接工具连接到数据库后,再执行上面的 delete SQL 语句。

  3. 重新启动 Halo 服务

    docker start halo
  4. 登录 Halo 控制台

    如果部署时通过 halo.security.initializer.superadminusernamehalo.security.initializer.superadminpassword 参数指定了初始化用户名和密码,使用该用户名密码登录控制台。

    如果未指定该配置,则默认用户名为 admin,默认密码将打印在 Halo 容器日志中,可以通过如下命令查看。

    docker logs halo | grep 'Generated random password:' | tail -1

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

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

导致网站加载速度慢的原因有很多,建议打开浏览器的 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 halo-1 \
    -p 8090:8090 \
    -v ~/.halo2:/root/.halo2 \
    halohub/halo:2.11 \

    # 第二个 Halo 容器
    docker run \
    -it -d \
    --name halo-2 \
    -p 8091:8090 \
    -v ~/.halo2_2:/root/.halo2 \
    halohub/halo:2.11 \

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

如何查看运行日志?

  1. 可以在 Console 端的概览页面下载最近的日志文件。

  2. 使用 docker logs 命令进行查看。

    # '-f' 滚动更新日志
    # '-n 200' 从倒数第200行开始查看
    # 更多帮助可以查看 'docker logs --help'
    docker logs -f halo -n 200

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

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

  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;
    }