写在前面

提示

当前文档是 Halo 2.0 测试阶段的文档，强烈不建议尝试将 1.5 升级到 2.0 测试版，也不建议在生产环境使用，当前版本仅用于测试。我们欢迎大家在测试过程中反馈任何问题。另外，在 Halo 2.0 正式发布的时候，我们会提供完整的升级指南。

环境要求

这里将讲述运行 Halo 所要求的一些软硬件的配置，我们建议您在运行或者部署之前先浏览一遍此页面。

硬件配置

提示

如果您要使用服务器进行部署 Halo，您需要注意的是，Halo 目前不支持市面上的云虚拟主机，请使用云服务器或者 VPS。

CPU

无特别要求。目前我们的 Docker 镜像 也已经支持多平台。

内存

为了获得更好的体验，我们建议至少配置 1G 的 RAM。

磁盘

无特别要求，理论上如果不大量在服务器上传附件，Halo 对磁盘的容量要求并不是很高。但我们推荐最好使用 SSD 硬盘的服务器，能更快的运行 Halo。

网络

Halo 目前必须在外网畅通的情况下使用，否则会导致页面异常。

软件环境

Halo 理论上可以运行在任何支持 Docker 及 Java 的平台。

Docker

必须在运行环境安装好 Docker 环境，目前 Halo 的默认安装运行方式均使用容器。

JRE（可选）

目前 Halo 的默认及推荐安装方式为 Docker 容器运行，使用 jar 包运行的方式需要用户自行构建 jar 包。

信息

当前版本（2.0）需要 JRE 17 的版本，推荐使用 OpenJDK 17。

PostgreSQL（可选）

也可以使用系统自带的 H2 Database 数据库，无需安装。但不推荐在生产环境中使用 H2 Database。

Web 服务器（可选）

如果您部署在生产环境，那么你很可能需要进行域名绑定，这时候我们推荐使用诸如 Nginx、Caddy 之类的 Web 服务器进行反向代理。但需要注意的是，目前 Halo 不支持代理到子目录（如：halo.run/blog）。

Wget（可选）

后续的文档中，我们会使用 wget 为例，用于下载所需要的文件，所以请确保服务器已经安装好了这个软件包。当然，下载文件不限制工具，如果你对其他工具熟悉，可以忽略。

VIM（可选）

后续的文档中，我们会使用 vim 为例，用于修改一些必要的配置文件，所以同样请确保服务器已经安装了这个软件包。当前，修改文档也不限制工具，如果你对其他编辑软件熟悉，也可以忽略。

浏览器支持

1. 用户前台：视主题所支持的情况而定，由于目前的评论模块使用了 Vuejs 开发，所以在 Vuejs 不支持的某些浏览器中无法正常显示评论区域。
2. 管理后台：支持目前常见的现代浏览器，具体视 Vuejs 框架的支持情况而定。

名词解释

这里将列出后续文档中一些和 Halo 相关的名词含义。

~（符号）

代表当前系统下的 用户目录。

镜像

指 Halo 构建所产生的 Docker 镜像。用户通过该镜像启动 Halo 应用。

工作目录

指 Halo 所依赖的工作目录，在 Halo 运行的时候会在系统当前用户目录下产生一个 .halo2 的文件夹，绝对路径为 ~/.halo2。由于这个工作目录是固定的，所以上面所说的 运行包不限制所存放的位置，里面通常包含下列目录或文件：

1. db：存放 H2 Database 的物理文件，如果你使用其他数据库，那么不会存在这个目录。
2. themes：里面包含用户所安装的主题。
3. plugins：里面包含用户所安装的插件。
4. attachments：附件目录。
5. logs：运行日志目录。
6. application.yaml：配置文件。

主题

包含了各种站点页面模板的资源包。用户访问 Halo 站点浏览到的内容及样式，由 Halo 管理端所配置使用的主题所决定。

插件

用于扩展 Halo 功能的软件包。插件独立于 Halo 核心应用，可以单独安装、升级、卸载。