第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/