chore: add env deps isntall docs #91

This commit is contained in:
duorameng
2026-05-11 20:19:11 +08:00
parent 97ab8d8927
commit fb617ae24c
3 changed files with 76 additions and 0 deletions
+10
View File
@@ -8,6 +8,7 @@
- **Python3**, **Node.js**, **Bash** (标准版镜像内置环境)
- 通过 **Mise** 扩展:支持几乎所有主流编程语言的动态安装与切换。
> [!TIP]
> **Minimal 镜像注意**:如果您使用的是 `minimal` 标签的镜像,系统初始不包含 Python 和 Node.js。您需要进入「编程语言」页面手动点击安装您所需的运行时。
@@ -62,6 +63,15 @@ mise use -g ansible@latest
安装完成后,您可以在「脚本管理」或「定时任务」中直接调用 `ansible``ansible-playbook` 命令。
## PHP 环境特别说明
在 Docker 容器或精简版 Linux 环境中,通过 `mise` 安装某些 PHP 版本时,如果官方没有提供预编译的二进制包,系统会尝试从源码编译。这需要额外的系统级构建依赖(如 `autoconf`, `bison`, `pkg-config` 等)。
如果您在安装 PHP 时遇到 `autoconf not found``buildconf failed` 等错误,请参考以下方案:
1. **运行预设脚本**: 我们在项目根目录提供了示例脚本 [install_php_env_deps.sh](file:///example/deps/install_php_env_deps.sh),它会自动安装所需的系统库。
2. **配置为开机任务**: 由于 Docker 容器层通常是只读的或在重启后重置(非挂载目录),建议在面板中创建一个 **触发类型为 `baihu_startup`** 的定时任务,命令填写 `bash example/deps/install_php_env_deps.sh`。这样可以确保每次容器启动时都会自动准备好 PHP 编译环境。
---
## 隔离机制说明
+13
View File
@@ -21,3 +21,16 @@
- **预设 Cron 规则**:在编辑任务时,提供常用的 `每分钟执行``每小时整点` 等预设样式。
- **下次触发预测**:实时计算并展示任务下一次执行的北京时间,帮助验证调度逻辑是否符合预期。
## 特殊任务类型
除了标准的 Cron 定时触发,白虎面板还支持以下特殊触发场景:
### 开机启动任务 (`baihu_startup`)
当您在定时规则(Schedule)中填写 `baihu_startup` 时,该任务将被标记为**系统启动任务**。
- **触发时机**: 面板主进程启动或重启完成后立即执行。
- **应用场景**:
- 自动挂载磁盘或网络共享。
- **环境预热**: 例如安装 PHP 编译依赖(参考 [PHP 编译依赖说明](languages.md#php-环境特别说明))。建议命令: `bash example/deps/install_php_env_deps.sh`
- 启动自定义的后台常驻服务。