> For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt.

# 使用 1Panel 部署

:::info 先阅读《写在前面》
在继续操作之前，我们推荐您先阅读[《写在前面》](https://docs.halo.run/guide/prepare.md)，这可以快速帮助你了解 Halo。
:::

## 1Panel 简介

[1Panel](https://1panel.cn) 是一个现代化、开源的 Linux 服务器运维管理面板。

![1Panel 截图](/img/install/1panel/1panel.png)

### 功能

- **快速建站**：深度集成 WordPress 和 Halo，域名绑定、SSL 证书配置等一键搞定。
- **高效管理**：通过 Web 端轻松管理 Linux 服务器，包括应用管理、主机监控、文件管理、数据库管理、容器管理等。
- **安全可靠**：最小漏洞暴露面，提供防火墙和安全审计等功能。
- **一键备份**：支持一键备份和恢复，备份数据云端存储，永不丢失。

### 安装

关于 1Panel 的安装部署与基础功能介绍，请参考 [1Panel 官方文档](https://1panel.cn/docs/installation/online_installation/)。此处假设你已经完成了 1Panel 的安装部署，并对其功能有了基础了解。

### 安装基础软件

在安装 Halo 之前，我们需要先在 1Panel 上安装好所需的软件，包括 OpenResty 和数据库（MySQL、PostgreSQL、MariaDB 都可以）。在接下来的文档中，我们会默认你已经安装好了这两个软件，并不再赘述。

![OpenResty 和 MySQL](/img/install/1panel/openresty-mysql.png)

## 安装 Halo 应用

进入应用商店应用列表，选择其中的 Halo 应用进行安装。

![选择 Halo 应用](/img/install/1panel/app-store-halo.png)

在应用详情页选择最新的 Halo 版本进行安装。

![选择 Halo 版本](/img/install/1panel/install-halo.png)

参数说明：

- **名称**：要创建的 Halo 应用的名称。
- **版本**：选择最新的版本即可。
- **数据库服务**：Halo 应用使用的数据库应用，支持下拉选择已安装的数据库应用，1Panel 会自动配置 Halo 使用该数据库。
- **数据库名**：Halo 应用使用的数据库名称，1Panel 会在选中的数据库中自动创建这个数据库。
- **数据库用户**：Halo 应用使用的数据库用户名，1Panel 会在选中的数据库中自动创建这个用户，并添加对应的数据库授权。
- **数据库用户密码**：Halo 应用使用的数据库用户密码，1Panel 会在选中的数据库中自动为上一步创建的用户配置该密码。
- **外部访问地址**：Halo 应用的最终访问地址，如果有为 Halo 规划域名，需要配置为域名格式，例如 `http://halo.example.com`。否则配置为 `http://服务器IP:PORT`，例如 `http://192.168.1.1:8090`。
- **端口**：Halo 应用的服务端口。

开始安装后页面自动跳转到已安装应用列表，等待刚刚安装的 Halo 应用变为已启动状态。

![Halo 运行状态](/img/install/1panel/halo-status.png)

## 创建网站

完成 Halo 应用的安装后，此时并不会自动创建一个网站，我们需要手动创建一个网站，然后将 Halo 应用绑定到这个网站上才能使用域名访问。

点击 1Panel 菜单的 **网站**，进入网站列表页，点击 **创建网站** 按钮。

![创建网站](/img/install/1panel/new-site.png)

1. 在已装应用中选择我们刚刚新建的 Halo 应用。
2. 正确填写主域名，需要注意的是需要提前解析好域名到服务器 IP。

最后，点击确认按钮，等待网站创建完成即可访问网站进行 [初始化](https://docs.halo.run/guide/setup.md)。

![网站列表](/img/install/1panel/site.png)

## 升级 Halo

:::info 新版本上架有延迟
当 Halo 发布新版本之后，并不会在 1Panel 的应用商店中实时查看到新版本，通常需要等待一段时间才会显示，这取决于 1Panel 的应用商店更新频率。
:::

:::warning 升级前查看更新日志
目前 1Panel 不支持在升级应用的时候查看应用的更新日志，所以建议在升级前前往 [Halo 版本发布](https://releases.halo.run/) 查看对应版本的更新日志，了解新版本的变化。
:::

当 Halo 在 1Panel 的应用商店有更新时，可以在 **应用商店** 的 **可升级** 选项卡中看到 Halo 应用的升级按钮。

![升级 Halo](/img/install/1panel/upgrade.png)

点击 **升级** 按钮后，可以在升级界面中选择最新的 Halo 版本，最后点击 **确认** 按钮即可完成升级。

![升级 Halo](/img/install/1panel/upgrade-2.png)

## 激活许可证

可以参考 [许可证激活](https://docs.halo.run/guide/use/activate.md) 进行激活，社区版无需此步骤。