白虎面板

白虎面板是一个轻量级定时任务管理系统，基于Go+Vue3构建，docker或者docker-compose，内置python3、nodejs、bash环境，开箱即用。

演示站点(演示站点的服务器比较烂，见谅) 演示站点

项目来由

多少和青龙面板有点关系，我自己也是青龙面板的使用者，但是现在的青龙面板性能我觉得有点难以接受。以我自己的使用（机器1C2G）为例，一个python的requests脚本每隔30s执行一次，有时候cpu执行的时候能跳变到50%以上。可以看看下面gif图片（如果不动，点击图片查看）

我觉得一个内存和性能占用低的面板更合适自己，所以做了这个项目。

如果你和我一样需要一个性能和内存占用低的定时面板，这个项目你可以体验下。

同样的定时场景和代码，这个项目的情况如下（cpu执行定时跳变不超过20%）：

特色

• 轻量级： docker/compose部署，无需复杂配置，开箱即用
• 任务调度： 支持标准 Cron 表达式，常用时间规则快捷选择。日志不落文件，没有磁盘频繁io的问题
• 脚本管理： 在线代码编辑器，支持文件上传、压缩包解压
• 在线终端： WebSocket 实时终端，命令执行结果实时输出
• 环境变量： 安全存储敏感配置，任务执行时自动注入
• 现代UI： 响应式设计，深色/浅色主题切换
• 移动端： 适配移动小屏样式
• 远程执行： 支持远程agent执行任务，展示执行结果

功能特性

点击展开查看详细功能

定时任务管理

• 支持标准 Cron 表达式调度
• 常用时间规则快捷选择
• 任务启用/禁用状态切换
• 手动触发执行
• 任务超时控制

脚本文件管理

• 在线代码编辑器
• 文件树形结构展示
• 支持创建、重命名、删除文件/文件夹
• 支持压缩包上传解压
• 支持多文件批量上传

在线终端

• WebSocket 实时终端
• 支持常用 Shell 命令
• 命令执行结果实时输出

执行日志

• 任务执行历史记录
• 执行状态追踪（成功/失败/超时）
• 执行耗时统计
• 日志内容压缩存储
• 日志自动清理

环境变量

• 安全存储敏感配置
• 变量值脱敏显示
• 任务执行时自动注入

系统设置

• 站点标题、标语、图标自定义
• 分页大小、Cookie 有效期配置
• 调度参数热重载
• 数据备份与恢复

效果图

快速部署

方式一：环境变量部署（推荐）

通过环境变量指定配置，简单灵活，适合容器编排场景。

使用 SQLite（默认）：

docker run -d \
--name baihu \
-p 8052:8052 \
-v $(pwd)/data:/app/data \
-v $(pwd)/envs:/app/envs \
-e TZ=Asia/Shanghai \
-e BH_SERVER_PORT=8052 \
-e BH_SERVER_HOST=0.0.0.0 \
-e BH_DB_TYPE=sqlite \
-e BH_DB_PATH=/app/data/ql.db \
-e BH_DB_TABLE_PREFIX=baihu_ \
--restart unless-stopped \
ghcr.io/engigu/baihu:latest

Docker Compose（SQLite）：

services:
baihu:
image: ghcr.io/engigu/baihu:latest
container_name: baihu
ports:
- "8052:8052"
volumes:
- ./data:/app/data
- ./envs:/app/envs
environment:
- TZ=Asia/Shanghai
- BH_SERVER_PORT=8052
- BH_SERVER_HOST=0.0.0.0
- BH_DB_TYPE=sqlite
- BH_DB_PATH=/app/data/ql.db
- BH_DB_TABLE_PREFIX=baihu_
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
restart: unless-stopped

使用 MySQL：

docker run -d \
--name baihu \
-p 8052:8052 \
-v $(pwd)/data:/app/data \
-v $(pwd)/envs:/app/envs \
-e TZ=Asia/Shanghai \
-e BH_SERVER_PORT=8052 \
-e BH_SERVER_HOST=0.0.0.0 \
-e BH_DB_TYPE=mysql \
-e BH_DB_HOST=mysql-server \
-e BH_DB_PORT=3306 \
-e BH_DB_USER=root \
-e BH_DB_PASSWORD=your_password \
-e BH_DB_NAME=baihu \
-e BH_DB_TABLE_PREFIX=baihu_ \
--restart unless-stopped \
ghcr.io/engigu/baihu:latest

Docker Compose（MySQL）：

services:
baihu:
image: ghcr.io/engigu/baihu:latest
container_name: baihu
ports:
- "8052:8052"
volumes:
- ./data:/app/data
- ./envs:/app/envs
environment:
- TZ=Asia/Shanghai
- BH_SERVER_PORT=8052
- BH_SERVER_HOST=0.0.0.0
- BH_DB_TYPE=mysql
- BH_DB_HOST=mysql-server
- BH_DB_PORT=3306
- BH_DB_USER=root
- BH_DB_PASSWORD=your_password
- BH_DB_NAME=baihu
- BH_DB_TABLE_PREFIX=baihu_
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
restart: unless-stopped

方式二：配置文件部署

通过挂载 config.ini 配置文件来管理配置，适合需要持久化配置的场景。

Docker 命令：

docker run -d \
--name baihu \
-p 8052:8052 \
-v $(pwd)/data:/app/data \
-v $(pwd)/configs:/app/configs \
-v $(pwd)/envs:/app/envs \
-e TZ=Asia/Shanghai \
--restart unless-stopped \
ghcr.io/engigu/baihu:latest

Docker Compose：

services:
baihu:
image: ghcr.io/engigu/baihu:latest
container_name: baihu
ports:
- "8052:8052"
volumes:
- ./data:/app/data
- ./configs:/app/configs
- ./envs:/app/envs
environment:
- TZ=Asia/Shanghai
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
restart: unless-stopped

首次使用需要复制 configs/config.example.ini 为 configs/config.ini，然后根据需要修改配置。

环境变量优先级高于配置文件，两种方式可以混合使用。

访问面板

启动后访问：http://localhost:8052

默认账号： admin / 123456

首次登录后请立即修改默认密码

数据目录

./
├── baihu                 # 可执行文件
├── data/                 # 数据目录（自动创建）
│   ├── ql.db             # SQLite 数据库
│   └── scripts/          # 脚本文件存储
├── configs/
│   └── config.ini        # 配置文件（自动创建）
└── envs/                 # 运行环境目录（自动创建）
├── python/           # Python 虚拟环境
└── node/             # Node.js npm 全局安装目录

Docker 启动流程

容器启动时 docker-entrypoint.sh 会执行以下操作：

1. 创建必要目录：/app/data、/app/data/scripts、/app/configs、/app/envs
2. 初始化 Python 虚拟环境：如果 /app/envs/python 不存在，自动创建并配置清华 pip 镜像源
3. 配置 Node.js 环境：设置 npm prefix 到 /app/envs/node，配置 npmmirror 镜像源
4. 激活环境：将 /app/envs/python/bin 和 /app/envs/node/bin 加入 PATH
5. 启动应用

通过挂载 ./envs:/app/envs 可以持久化 Python 和 Node.js 环境，避免每次重启容器都重新安装依赖。

配置说明

点击展开查看配置详情

配置文件

配置文件路径：configs/config.ini

[server]
port = 8052
host = 0.0.0.0

[database]
type = sqlite
host = localhost
port = 3306
user = root
password =
dbname = ql_panel
table_prefix = baihu_

环境变量

所有配置项都支持通过环境变量覆盖，环境变量优先级高于配置文件：

环境变量	对应配置	说明	默认值
BH_SERVER_PORT	server.port	服务端口	8052
BH_SERVER_HOST	server.host	监听地址	0.0.0.0
BH_DB_TYPE	database.type	数据库类型 (sqlite/mysql)	sqlite
BH_DB_HOST	database.host	数据库地址	localhost
BH_DB_PORT	database.port	数据库端口	3306
BH_DB_USER	database.user	数据库用户	root
BH_DB_PASSWORD	database.password	数据库密码	-
BH_DB_NAME	database.dbname	数据库名称	ql_panel
BH_DB_PATH	database.path	SQLite 文件路径	./data/ql.db
BH_DB_TABLE_PREFIX	database.table_prefix	表前缀	baihu_
BH_SECRET	security.secret	JWT 密钥	手动指定

MySQL 示例：

参考上方「方式一：环境变量部署」中的 MySQL 配置示例。

调度设置

系统采用 Worker Pool + 任务队列的架构来控制任务执行，可在「系统设置 > 调度设置」中配置：

设置项	说明	默认值
Worker 数量	并发执行任务的 worker 数量	4
队列大小	任务队列缓冲区大小	100
速率间隔	任务启动间隔（毫秒）	200

修改调度设置后立即生效，无需重启服务。

关于推送

面板现在没有推送功能，还在考虑方式，但是现在有很多现成的消息聚合面板（这里自荐下自己的另一个项目Message-Push-Nest），如果大家有合适的方式可以提交Issue。

贡献

欢迎提交 Issue 和 Pull Request！

许可证

MIT License