diff --git a/docs/getting-started/install/bt-panel.md b/docs/getting-started/install/bt-panel.md new file mode 100644 index 00000000..bdcf4ce6 --- /dev/null +++ b/docs/getting-started/install/bt-panel.md @@ -0,0 +1,92 @@ +--- +title: 使用宝塔面板部署 +description: 使用宝塔面板部署 +--- + +::::info +在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare)，这可以快速帮助你了解 Halo。 +:::: + +## 宝塔面板简介 + +宝塔面板是一个常见的 Linux 服务器运维面板，提供网站、数据库、SSL、Docker 等可视化管理能力。通过宝塔面板的 Docker 模块和应用商店，可以比较方便地完成 Halo 的安装、运行和升级。 + +![宝塔 Docker 模块](/img/install/bt-panel/docker.png) + +### 准备工作 + +在开始之前，需要确保你已经完成以下准备： + +- 已安装并可以正常登录宝塔面板。 +- 已在服务器上安装宝塔的 Docker 模块。 +- 已放行服务器的 `80` 和 `443` 端口。 +- 如果计划使用域名访问 Halo，需要提前将域名解析到当前服务器。 + +## 安装 Halo 应用 + +进入宝塔面板左侧的 **Docker**，在 **应用商店** 中搜索 `Halo`，然后点击 **安装**。 + +![选择 Halo 应用](/img/install/bt-panel/halo-app.png) + +在安装配置页面中，按照实际情况填写参数： + +![安装 Halo](/img/install/bt-panel/install-halo.png) + +参数说明： + +- **名称**：当前 Halo 应用的名称。 +- **版本选择**：建议优先选择最新的稳定版本。 +- **域名**：Halo 对外访问使用的域名，建议填写已经完成解析的域名。 +- **允许外部访问**：如果希望直接通过 `IP:端口` 访问，可以启用此选项；如果只打算通过域名访问，通常不需要开启。 +- **端口**：Halo 容器暴露的服务端口。 +- **外部访问地址**：Halo 的最终访问地址，建议与实际访问地址保持一致，例如 `https://www.example.com`。 +- **CPU 核心数限制**、**内存限制**：按服务器资源情况选填，不限制可以保持默认值。 +- **编辑模板**：默认模板通常即可满足使用需求；如果需要调整镜像、挂载目录或其他编排参数，可以切换到自定义模板。 + +宝塔提供的 Halo 应用模板会自动创建 Halo 运行所需的容器。确认参数无误后，点击 **确定** 开始安装。 + +如果需要查看或调整底层的 Docker Compose 配置，可以切换到 **自定义** 模板模式： + +:::info +宝塔的 Docker 应用商店的 Halo 版本可能会滞后于官方最新版本，通常建议自定义镜像版本，查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 + +此外，宝塔的默认编排是 Halo 社区版本，如果你想安装 Halo 专业版或者商城版，将镜像修改为 `registry.fit2cloud.com/halo/halo-pro` 即可。 +::: + +![自定义 Compose 模板](/img/install/bt-panel/custom-compose.png) + +安装完成后，进入 **Docker** 的 **已安装** 列表，等待 Halo 应用变为运行中状态。 + +![已安装的 Halo 应用](/img/install/bt-panel/installed.png) + +## 配置网站和 SSL + +如果你在安装 Halo 时填写了域名，宝塔通常会同步创建对应的网站配置。你可以在已安装应用卡片中点击 **管理网站**，或者直接进入左侧菜单的 **网站** 查看站点状态。 + +![网站列表](/img/install/bt-panel/ssl-status.png) + +如果站点的 **SSL 证书** 一栏显示未部署，可以进入站点管理页面，在 **SSL** 标签页中申请证书。 + +![申请 SSL 证书](/img/install/bt-panel/request-ssl.png) + +证书申请成功后，即可通过你配置的域名使用 `https` 访问 Halo。首次访问时，根据页面提示完成 Halo 的[初始化](../setup.md)即可。 + +::::info +如果证书申请失败，建议优先检查域名解析是否生效，以及服务器的 `80`、`443` 端口是否已经正确放行。 +:::: + +## 升级 Halo + +当需要升级 Halo 时，可以进入 **Docker** 的 **容器编排**，找到当前的 Halo 项目，修改镜像版本为最新版本，然后点击 **确定** 按钮即可完成升级。 + +:::info +查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 +::: + +![升级 Halo](/img/install/bt-panel/update.png) + +更新完成后，宝塔会重新拉取镜像并重建相关容器。建议升级前先备份 Halo 数据目录和数据库，并前往 [Halo 版本发布](https://releases.halo.run/) 查看对应版本的更新说明。 + +## 激活许可证 + +可以参考 [许可证激活](../../user-guide/activate.md) 进行激活，社区版无需此步骤。 diff --git a/sidebars.js b/sidebars.js index 217a5797..d42242a0 100644 --- a/sidebars.js +++ b/sidebars.js @@ -35,6 +35,7 @@ module.exports = { "getting-started/install/docker-compose", "getting-started/install/docker", "getting-started/install/1panel", + "getting-started/install/bt-panel", "getting-started/install/helm", "getting-started/install/podman", "getting-started/install/jar-file", diff --git a/static/img/install/bt-panel/custom-compose.png b/static/img/install/bt-panel/custom-compose.png new file mode 100644 index 00000000..c04acb69 Binary files /dev/null and b/static/img/install/bt-panel/custom-compose.png differ diff --git a/static/img/install/bt-panel/docker.png b/static/img/install/bt-panel/docker.png new file mode 100644 index 00000000..253ecfdb Binary files /dev/null and b/static/img/install/bt-panel/docker.png differ diff --git a/static/img/install/bt-panel/halo-app.png b/static/img/install/bt-panel/halo-app.png new file mode 100644 index 00000000..f4b98395 Binary files /dev/null and b/static/img/install/bt-panel/halo-app.png differ diff --git a/static/img/install/bt-panel/install-halo.png b/static/img/install/bt-panel/install-halo.png new file mode 100644 index 00000000..ef4f3679 Binary files /dev/null and b/static/img/install/bt-panel/install-halo.png differ diff --git a/static/img/install/bt-panel/installed.png b/static/img/install/bt-panel/installed.png new file mode 100644 index 00000000..5f9d8ed2 Binary files /dev/null and b/static/img/install/bt-panel/installed.png differ diff --git a/static/img/install/bt-panel/request-ssl.png b/static/img/install/bt-panel/request-ssl.png new file mode 100644 index 00000000..229c8245 Binary files /dev/null and b/static/img/install/bt-panel/request-ssl.png differ diff --git a/static/img/install/bt-panel/ssl-status.png b/static/img/install/bt-panel/ssl-status.png new file mode 100644 index 00000000..45eab8f4 Binary files /dev/null and b/static/img/install/bt-panel/ssl-status.png differ diff --git a/static/img/install/bt-panel/update.png b/static/img/install/bt-panel/update.png new file mode 100644 index 00000000..b6518a88 Binary files /dev/null and b/static/img/install/bt-panel/update.png differ diff --git a/versioned_docs/version-2.23/getting-started/install/bt-panel.md b/versioned_docs/version-2.23/getting-started/install/bt-panel.md new file mode 100644 index 00000000..bdcf4ce6 --- /dev/null +++ b/versioned_docs/version-2.23/getting-started/install/bt-panel.md @@ -0,0 +1,92 @@ +--- +title: 使用宝塔面板部署 +description: 使用宝塔面板部署 +--- + +::::info +在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare)，这可以快速帮助你了解 Halo。 +:::: + +## 宝塔面板简介 + +宝塔面板是一个常见的 Linux 服务器运维面板，提供网站、数据库、SSL、Docker 等可视化管理能力。通过宝塔面板的 Docker 模块和应用商店，可以比较方便地完成 Halo 的安装、运行和升级。 + +![宝塔 Docker 模块](/img/install/bt-panel/docker.png) + +### 准备工作 + +在开始之前，需要确保你已经完成以下准备： + +- 已安装并可以正常登录宝塔面板。 +- 已在服务器上安装宝塔的 Docker 模块。 +- 已放行服务器的 `80` 和 `443` 端口。 +- 如果计划使用域名访问 Halo，需要提前将域名解析到当前服务器。 + +## 安装 Halo 应用 + +进入宝塔面板左侧的 **Docker**，在 **应用商店** 中搜索 `Halo`，然后点击 **安装**。 + +![选择 Halo 应用](/img/install/bt-panel/halo-app.png) + +在安装配置页面中，按照实际情况填写参数： + +![安装 Halo](/img/install/bt-panel/install-halo.png) + +参数说明： + +- **名称**：当前 Halo 应用的名称。 +- **版本选择**：建议优先选择最新的稳定版本。 +- **域名**：Halo 对外访问使用的域名，建议填写已经完成解析的域名。 +- **允许外部访问**：如果希望直接通过 `IP:端口` 访问，可以启用此选项；如果只打算通过域名访问，通常不需要开启。 +- **端口**：Halo 容器暴露的服务端口。 +- **外部访问地址**：Halo 的最终访问地址，建议与实际访问地址保持一致，例如 `https://www.example.com`。 +- **CPU 核心数限制**、**内存限制**：按服务器资源情况选填，不限制可以保持默认值。 +- **编辑模板**：默认模板通常即可满足使用需求；如果需要调整镜像、挂载目录或其他编排参数，可以切换到自定义模板。 + +宝塔提供的 Halo 应用模板会自动创建 Halo 运行所需的容器。确认参数无误后，点击 **确定** 开始安装。 + +如果需要查看或调整底层的 Docker Compose 配置，可以切换到 **自定义** 模板模式： + +:::info +宝塔的 Docker 应用商店的 Halo 版本可能会滞后于官方最新版本，通常建议自定义镜像版本，查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 + +此外，宝塔的默认编排是 Halo 社区版本，如果你想安装 Halo 专业版或者商城版，将镜像修改为 `registry.fit2cloud.com/halo/halo-pro` 即可。 +::: + +![自定义 Compose 模板](/img/install/bt-panel/custom-compose.png) + +安装完成后，进入 **Docker** 的 **已安装** 列表，等待 Halo 应用变为运行中状态。 + +![已安装的 Halo 应用](/img/install/bt-panel/installed.png) + +## 配置网站和 SSL + +如果你在安装 Halo 时填写了域名，宝塔通常会同步创建对应的网站配置。你可以在已安装应用卡片中点击 **管理网站**，或者直接进入左侧菜单的 **网站** 查看站点状态。 + +![网站列表](/img/install/bt-panel/ssl-status.png) + +如果站点的 **SSL 证书** 一栏显示未部署，可以进入站点管理页面，在 **SSL** 标签页中申请证书。 + +![申请 SSL 证书](/img/install/bt-panel/request-ssl.png) + +证书申请成功后，即可通过你配置的域名使用 `https` 访问 Halo。首次访问时，根据页面提示完成 Halo 的[初始化](../setup.md)即可。 + +::::info +如果证书申请失败，建议优先检查域名解析是否生效，以及服务器的 `80`、`443` 端口是否已经正确放行。 +:::: + +## 升级 Halo + +当需要升级 Halo 时，可以进入 **Docker** 的 **容器编排**，找到当前的 Halo 项目，修改镜像版本为最新版本，然后点击 **确定** 按钮即可完成升级。 + +:::info +查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 +::: + +![升级 Halo](/img/install/bt-panel/update.png) + +更新完成后，宝塔会重新拉取镜像并重建相关容器。建议升级前先备份 Halo 数据目录和数据库，并前往 [Halo 版本发布](https://releases.halo.run/) 查看对应版本的更新说明。 + +## 激活许可证 + +可以参考 [许可证激活](../../user-guide/activate.md) 进行激活，社区版无需此步骤。 diff --git a/versioned_sidebars/version-2.23-sidebars.json b/versioned_sidebars/version-2.23-sidebars.json index 76a06220..ab77a93f 100644 --- a/versioned_sidebars/version-2.23-sidebars.json +++ b/versioned_sidebars/version-2.23-sidebars.json @@ -20,6 +20,7 @@ "getting-started/install/docker-compose", "getting-started/install/docker", "getting-started/install/1panel", + "getting-started/install/bt-panel", "getting-started/install/helm", "getting-started/install/podman", "getting-started/install/jar-file",