--- title: 写在前面 description: 在开始前，您需要了解的事项 --- :::warning 提示 当前文档是 Halo 2.0 测试阶段的文档，强烈不建议尝试将 1.5 升级到 2.0 测试版，也不建议在生产环境使用，当前版本仅用于测试。我们欢迎大家在测试过程中反馈任何问题。另外，在 Halo 2.0 正式发布的时候，我们会提供完整的升级指南。 ::: ## 环境要求 这里将讲述运行 Halo 所要求的一些软硬件的配置，我们建议您在运行或者部署之前先浏览一遍此页面。 ### 硬件配置 :::tip 如果您要使用服务器进行部署 Halo，您需要注意的是，Halo 目前不支持市面上的云虚拟主机，请使用云服务器或者 VPS。 ::: #### CPU 无特别要求。目前我们的 [Docker 镜像](https://hub.docker.com/r/halohub/halo) 也已经支持多平台。 #### 内存 为了获得更好的体验，我们建议至少配置 1G 的 RAM。 #### 磁盘 无特别要求，理论上如果不大量在服务器上传附件，Halo 对磁盘的容量要求并不是很高。但我们推荐最好使用 SSD 硬盘的服务器，能更快的运行 Halo。 #### 网络 Halo 目前必须在外网畅通的情况下使用，否则会导致页面异常。 ### 软件环境 Halo 理论上可以运行在任何支持 Docker 及 Java 的平台。 #### Docker 必须在运行环境安装好 [Docker](https://www.docker.com/) 环境，目前 Halo 的默认安装运行方式均使用容器。 #### JRE（可选） 目前 Halo 的默认及推荐安装方式为 Docker 容器运行，使用 jar 包运行的方式需要用户自行构建 jar 包。 :::info 当前版本（2.0）需要 JRE 17 的版本，推荐使用 OpenJDK 17。 ::: #### PostgreSQL（可选） 也可以使用系统自带的 H2 Database 数据库，无需安装。但不推荐在生产环境中使用 H2 Database。 #### Web 服务器（可选） 如果您部署在生产环境，那么你很可能需要进行域名绑定，这时候我们推荐使用诸如 [Nginx](http://nginx.org/)、[Caddy](https://caddyserver.com/) 之类的 Web 服务器进行反向代理。但需要注意的是，目前 Halo 不支持代理到子目录（如：halo.run/blog）。 #### Wget（可选） 后续的文档中，我们会使用 wget 为例，用于下载所需要的文件，所以请确保服务器已经安装好了这个软件包。当然，下载文件不限制工具，如果你对其他工具熟悉，可以忽略。 #### VIM（可选） 后续的文档中，我们会使用 vim 为例，用于修改一些必要的配置文件，所以同样请确保服务器已经安装了这个软件包。当前，修改文档也不限制工具，如果你对其他编辑软件熟悉，也可以忽略。 ## 浏览器支持 1. 用户前台：视主题所支持的情况而定，由于目前的评论模块使用了 [Vuejs](https://cn.vuejs.org/v2/guide/installation.html#%E5%85%BC%E5%AE%B9%E6%80%A7) 开发，所以在 [Vuejs](https://cn.vuejs.org/v2/guide/installation.html#%E5%85%BC%E5%AE%B9%E6%80%A7) 不支持的某些浏览器中无法正常显示评论区域。 2. 管理后台：支持目前常见的现代浏览器，具体视 [Vuejs](https://cn.vuejs.org/v2/guide/installation.html#%E5%85%BC%E5%AE%B9%E6%80%A7) 框架的支持情况而定。 ## 名词解释 这里将列出后续文档中一些和 Halo 相关的名词含义。 ### ~（符号） 代表当前系统下的 [用户目录](https://zh.wikipedia.org/wiki/%E5%AE%B6%E7%9B%AE%E5%BD%95)。 ### 镜像 指 Halo 构建所产生的 [Docker 镜像](https://docs.docker.com/engine/reference/commandline/images/)。用户通过该镜像启动 Halo 应用。 ### 工作目录 指 Halo 所依赖的工作目录，在 Halo 运行的时候会在系统当前用户目录下产生一个 `.halo2` 的文件夹，绝对路径为 `~/.halo2`。由于这个工作目录是固定的，所以上面所说的 `运行包`不限制所存放的位置，里面通常包含下列目录或文件： 1. `db`：存放 H2 Database 的物理文件，如果你使用其他数据库，那么不会存在这个目录。 2. `themes`：里面包含用户所安装的主题。 2. `plugins`：里面包含用户所安装的插件。 5. `attachments`：附件目录。 4. `logs`：运行日志目录。 6. `application.yaml`：配置文件。 ### 主题 包含了各种站点页面模板的资源包。用户访问 Halo 站点浏览到的内容及样式，由 Halo 管理端所配置使用的主题所决定。 ### 插件 用于扩展 Halo 功能的软件包。插件独立于 Halo 核心应用，可以单独安装、升级、卸载。