进阶 hestiacp.com 2026-11-15 08:32:00 · 17 阅读

第1章 构建软件包指南

第1章 构建软件包

INFO 构建 hestia-nginx 或 hestia-php 至少需要 2 GB 内存!

以下是 src 目录下构建脚本的详细说明。

从分支安装 Hestia

以下方法适用于测试 Pull Request 或 fork 中的分支。

安装 Node.js:下载安装或使用 Node Source APT

bash # 如果要测试自己创建的分支,替换为 https://github.com/username/hestiacp.git git clone https://github.com/hestiacp/hestiacp.git cd ./hestiacp/

# 将 main 替换为你要测试的分支 git checkout main

cd ./src/

# 编译软件包 ./hst_autocompile.sh --all --noinstall --keepbuild '~localsrc'

cd ../install

bash hst-install-{os}.sh --with-debs /tmp/hestiacp-src/deb/

安装命令可以追加任意选项,完整列表见官方文档。

仅构建软件包

bash # 仅构建 Hestia ./hst_autocompile.sh --hestia --noinstall --keepbuild '~localsrc'

bash # 构建 Hestia + hestia-nginx 和 hestia-php ./hst_autocompile.sh --all --noinstall --keepbuild '~localsrc'

构建并安装软件包

INFO 如果你已安装 Hestia,可使用此方式让改动立即生效。

bash # 仅构建 Hestia ./hst_autocompile.sh --hestia --install '~localsrc'

bash # 构建 Hestia + hestia-nginx 和 hestia-php ./hst_autocompile.sh --all --install '~localsrc'

从 GitHub 更新 Hestia

以下方法适用于从 GitHub 拉取最新的 staging/beta 更改并编译。

INFO 此方法仅支持构建 hestia 包。如需构建 hestia-nginx 或 hestia-php,请使用前面介绍的命令。

安装 Node.js:下载安装或使用 Node Source APT

bash v-update-sys-hestia-git [USERNAME] [BRANCH]

注意:使用 dpkg 安装软件包时,依赖关系有时会发生变化,无法提前预载依赖。如果出现这种情况,你会看到类似这样的错误:

bash dpkg: error processing package hestia (–install): dependency problems - leaving unconfigured

解决方法是运行:

bash apt install -f

在同一台机器上为其他架构或 OS 版本构建

hst_autocompile.sh 只会为当前运行环境构建(它自身的 --cross 标志只是让架构无关的 hestia 包直接同时支持 AMD64 和 ARM64,无需模拟)。如果要在同一台机器上为其他架构或 OS 版本构建包含编译后原生代码的 hestia-nginx、hestia-php 或 hestia-web-terminal,请改用 chroot_build_all.sh —— 它会在每个目标环境中启动并运行原封不动的 hst_autocompile.sh。

bash ./chroot_build_all.sh --all '~localsrc'

每种组合都在 QEMU 模拟的 chroot(debootstrap + qemu-user-static)中构建。首次运行会在 /var/lib/hestiacp-build-chroot/-- 下为每种组合下载并生成一个最小根文件系统;后续运行会直接复用,因此只有每种组合的首次构建较慢。

评论 (0)