白虎面板 🐯

白虎面板是一个轻量级定时任务管理系统，基于 Go + Vue 3 构建，单文件部署，开箱即用。

项目名叫白虎，取自中国传统四象之一，寓意守护和力量。

如果你需要管理多个定时任务、脚本文件，并希望有一个简洁的 Web 界面来操作，这个项目可以帮你轻松实现。支持 Cron 表达式调度、在线终端、脚本编辑、环境变量管理等功能。

特色 ✨

• 🔄 轻量级： 单文件部署，无需复杂配置，开箱即用
• 📋 任务调度： 支持标准 Cron 表达式，常用时间规则快捷选择
• 📝 脚本管理： 在线代码编辑器，支持文件上传、压缩包解压
• 🖥️ 在线终端： WebSocket 实时终端，命令执行结果实时输出
• 🔐 环境变量： 安全存储敏感配置，任务执行时自动注入
• 🎨 现代 UI： 响应式设计，深色/浅色主题切换

效果图 📺

快速开始 🚀

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:main

Docker Compose

version: '3.8'

services:
  baihu:
    image: ghcr.io/engigu/baihu:main
    container_name: baihu
    ports:
      - "8052:8052"
    volumes:
      - ./data:/app/data
      - ./configs:/app/configs
      - ./envs:/app/envs
    environment:
      - TZ=Asia/Shanghai
      # 以下环境变量可覆盖配置文件（可选）
      # - BH_SERVER_PORT=8052
      # - BH_DB_TYPE=mysql
      # - BH_DB_HOST=localhost
      # - BH_DB_PORT=3306
      # - BH_DB_USER=root
      # - BH_DB_PASSWORD=password
      # - BH_DB_NAME=baihu
    restart: unless-stopped

docker-compose up -d

访问面板

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

默认账号： admin / 123456

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

功能特性 📋

定时任务管理

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

脚本文件管理

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

在线终端

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

执行日志

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

环境变量

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

系统设置

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

目录结构 📁

./
├── 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 示例：

docker run -d \
  --name baihu \
  -p 8052:8052 \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/envs:/app/envs \
  -e TZ=Asia/Shanghai \
  -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 \
  --restart unless-stopped \
  ghcr.io/engigu/baihu:main

调度设置

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

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

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

技术栈 🛠️

后端： Go 1.21+ / Gin / GORM / SQLite / JWT / Cron / WebSocket

前端： Vue 3 / TypeScript / Vite / Tailwind CSS / Shadcn/ui / Xterm.js

部署： Docker / GitHub Actions / Multi-arch (amd64/arm64)

本地开发 📖

# 克隆项目
git clone https://github.com/engigu/baihu.git
cd baihu

# 安装依赖
make deps
cd web && npm install && cd ..

# 构建前端 + 后端
make build-all

# 运行
./baihu

贡献 🤝

欢迎提交 Issue 和 Pull Request！

许可证 📄

MIT License