|
| 1 | +--- |
| 2 | +title: 使用宝塔面板部署 |
| 3 | +description: 使用宝塔面板部署 |
| 4 | +--- |
| 5 | + |
| 6 | +::::info |
| 7 | +在继续操作之前，我们推荐您先阅读[《写在前面》](../prepare)，这可以快速帮助你了解 Halo。 |
| 8 | +:::: |
| 9 | + |
| 10 | +## 宝塔面板简介 |
| 11 | + |
| 12 | +宝塔面板是一个常见的 Linux 服务器运维面板，提供网站、数据库、SSL、Docker 等可视化管理能力。通过宝塔面板的 Docker 模块和应用商店，可以比较方便地完成 Halo 的安装、运行和升级。 |
| 13 | + |
| 14 | + |
| 15 | + |
| 16 | +### 准备工作 |
| 17 | + |
| 18 | +在开始之前，需要确保你已经完成以下准备： |
| 19 | + |
| 20 | +- 已安装并可以正常登录宝塔面板。 |
| 21 | +- 已在服务器上安装宝塔的 Docker 模块。 |
| 22 | +- 已放行服务器的 `80` 和 `443` 端口。 |
| 23 | +- 如果计划使用域名访问 Halo，需要提前将域名解析到当前服务器。 |
| 24 | + |
| 25 | +## 安装 Halo 应用 |
| 26 | + |
| 27 | +进入宝塔面板左侧的 **Docker**，在 **应用商店** 中搜索 `Halo`，然后点击 **安装**。 |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +在安装配置页面中，按照实际情况填写参数： |
| 32 | + |
| 33 | + |
| 34 | + |
| 35 | +参数说明： |
| 36 | + |
| 37 | +- **名称**：当前 Halo 应用的名称。 |
| 38 | +- **版本选择**：建议优先选择最新的稳定版本。 |
| 39 | +- **域名**：Halo 对外访问使用的域名，建议填写已经完成解析的域名。 |
| 40 | +- **允许外部访问**：如果希望直接通过 `IP:端口` 访问，可以启用此选项；如果只打算通过域名访问，通常不需要开启。 |
| 41 | +- **端口**：Halo 容器暴露的服务端口。 |
| 42 | +- **外部访问地址**：Halo 的最终访问地址，建议与实际访问地址保持一致，例如 `https://www.example.com`。 |
| 43 | +- **CPU 核心数限制**、**内存限制**：按服务器资源情况选填，不限制可以保持默认值。 |
| 44 | +- **编辑模板**：默认模板通常即可满足使用需求；如果需要调整镜像、挂载目录或其他编排参数，可以切换到自定义模板。 |
| 45 | + |
| 46 | +宝塔提供的 Halo 应用模板会自动创建 Halo 运行所需的容器。确认参数无误后，点击 **确定** 开始安装。 |
| 47 | + |
| 48 | +如果需要查看或调整底层的 Docker Compose 配置，可以切换到 **自定义** 模板模式： |
| 49 | + |
| 50 | +:::info |
| 51 | +宝塔的 Docker 应用商店的 Halo 版本可能会滞后于官方最新版本，通常建议自定义镜像版本，查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 |
| 52 | + |
| 53 | +此外，宝塔的默认编排是 Halo 社区版本，如果你想安装 Halo 专业版或者商城版，将镜像修改为 `registry.fit2cloud.com/halo/halo-pro` 即可。 |
| 54 | +::: |
| 55 | + |
| 56 | + |
| 57 | + |
| 58 | +安装完成后，进入 **Docker** 的 **已安装** 列表，等待 Halo 应用变为运行中状态。 |
| 59 | + |
| 60 | + |
| 61 | + |
| 62 | +## 配置网站和 SSL |
| 63 | + |
| 64 | +如果你在安装 Halo 时填写了域名，宝塔通常会同步创建对应的网站配置。你可以在已安装应用卡片中点击 **管理网站**，或者直接进入左侧菜单的 **网站** 查看站点状态。 |
| 65 | + |
| 66 | + |
| 67 | + |
| 68 | +如果站点的 **SSL 证书** 一栏显示未部署，可以进入站点管理页面，在 **SSL** 标签页中申请证书。 |
| 69 | + |
| 70 | + |
| 71 | + |
| 72 | +证书申请成功后，即可通过你配置的域名使用 `https` 访问 Halo。首次访问时，根据页面提示完成 Halo 的[初始化](../setup.md)即可。 |
| 73 | + |
| 74 | +::::info |
| 75 | +如果证书申请失败，建议优先检查域名解析是否生效，以及服务器的 `80`、`443` 端口是否已经正确放行。 |
| 76 | +:::: |
| 77 | + |
| 78 | +## 升级 Halo |
| 79 | + |
| 80 | +当需要升级 Halo 时，可以进入 **Docker** 的 **容器编排**，找到当前的 Halo 项目，修改镜像版本为最新版本，然后点击 **确定** 按钮即可完成升级。 |
| 81 | + |
| 82 | +:::info |
| 83 | +查看最新版本请前往 [Halo 版本发布](https://releases.halo.run/)。 |
| 84 | +::: |
| 85 | + |
| 86 | + |
| 87 | + |
| 88 | +更新完成后，宝塔会重新拉取镜像并重建相关容器。建议升级前先备份 Halo 数据目录和数据库，并前往 [Halo 版本发布](https://releases.halo.run/) 查看对应版本的更新说明。 |
| 89 | + |
| 90 | +## 激活许可证 |
| 91 | + |
| 92 | +可以参考 [许可证激活](../../user-guide/activate.md) 进行激活，社区版无需此步骤。 |
0 commit comments