baihu-panel

• 2026.11.04 (v1.6.2) - 单点登录第三方身份与本地账号绑定管理、标签管理跨分类重名校验隔离修复与文档构建依赖优化。

• 2026.11.04 (v1.6.1) - 旧备份两步验证死锁自愈修复、分页空数据白屏异常统一修复、安全漏洞加固与核心依赖升级。

• 2026.11.03 (v1.6.0) - 任务超时支持0不限制、限制并发任务运行中快捷停止、执行历史日志防重渲染、演示模式切面重构与容器控存调优。

• 2026.10.30 (v1.5.9) - Docker 容器异步初始化内建助手库、Node.js 内建通知健壮性加固与返回值支持、变量机密编辑框最后编辑时间展示。

• 2026.10.27 (v1.5.8) - 语言安装下载镜像加速与 Mise 运行时镜像源配置、已装应用更新检测与无损升级中枢、OpenAPI 文件管理能力开放与全站安全加固。

• 2026.10.21 (v1.5.7) - 任务日志自定义变量提取与通知模板注入、设置中心全局悬浮保存与改动追踪、脚本编辑终端重构及体验加固。

• 2026.10.17 (v1.5.6) - 运行时 PageCache 控存策略重构、容器入口标准化与公共库抽取、OIDC 领域层解耦及前端交互优化。

• 2026.10.16 (v1.5.5) - 多身份源单点登录并行共存架构、SSO 独立路由与凭据解耦、移动端响应式与视觉细节打磨。

• 2026.10.15 (v1.5.4) - MCP 双传输共存架构 (Streamable HTTP + SSE)、通用 OAuth 2.0 单点登录与全站 Inter 字体排版。

• 2026.10.15 (v1.5.3) - 原生 OIDC / Pocket ID 单点登录、任务批量设置多类型混选重构、表格分页数独立持久化与演示模式全面加固。

• 2026.10.12 (v1.5.2) - 容器 PageCache 自适应回收与点杀、tini 僵尸进程回收、树形目录批量展开、小屏代码编辑优化。

• 2026.10.09 (v1.5.1) - Windows 托盘无黑窗静默运行、容器内存口径对齐 Docker Stats、OpenAPI MCP 服务健壮性加固。

• 2026.10.07 (v1.5.0) - 原生内置 MCP 服务、Server酱推送通道、文件树按需懒加载与检索、Agent 实时增量同步。

• 2026.10.01 (v1.4.2) - 系统设置全模块视觉与交互重构、声明式应用卸载级联清理与标签自动回收。

• 2026.09.30 (v1.4.1) - 远程 Agent 工作目录解析修复、Windows Agent Shell 免依赖回退、Bark 动态参数覆盖。

• 2026.09.29 (v1.4.0) - RESTful 状态码双轨对齐、Bark 端到端加密推送、任务深层目录展开。

• 2026.09.23 (v1.3.0) - 机密端到端安全解密 (ECDH+AES-GCM)、日志冗余任务名、文档体验升级。

• 2026.09.22 (v1.2.0) - 声明式应用引擎与应用市场、2FA 备份恢复修复、跨平台路径升级。

• 2026.09.11 (v1.1.30) - 标签关联资源穿透跳转、输入法回车丢失修复、调度引擎调优。

• 2026.09.08 (v1.1.29) - Windows ConPTY 伪终端重构、hosts 自动映射、托盘 UI 升级。

• 2026.09.04 (v1.1.28) - IDE 底部 Terminal、环境持久化、任务配置批量更新。

• 2026.08.21 (v1.1.27) - 通知过滤机制、移动端平滑滚动与小屏适配优化。

• 2026.08.17 (v1.1.26) - 统一通知内容与 Options SDK、日志 SSE 状态帧协议。

• 2026.08.10 (v1.1.25) - 企业微信推送接入、备份恢复自动加载调度、安全漏洞修复。

• 2026.07.31 (v1.1.24) - 标签管理系统、Monaco 多语言语法高亮、登录两步验证 (2FA)。

• 2026.07.23 (v1.1.23) - Windows GUI 安装包与后台系统托盘守护程序。

• 2026.07.20 (v1.1.22) - Windows 平台深度适配、网页终端 Ctrl+C 终结、PTY 崩溃修复。

• 2026.07.13 (v1.1.21) - ZSTD 日志压缩、依赖自动补全终端、列表视图联动排序。

• 2026.06.28 (v1.1.20) - 节点互联架构 (变量同步与 OpenConnect)、终端 OOM 防护。

定时任务管理

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

脚本文件管理

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

在线终端

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

执行日志

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

消息推送与系统通知

• 原生内置各大主流平台渠道（钉钉、企业微信、Telegram、Server酱等）
• 支持系统级事件条件触发通知（例如任务失败报警、服务下线提醒）
• 自动生成跨语言调用 API 示例代码供脚本集成

变量与机密

• 支持普通环境变量与安全机密（Secret）分类管理
• 机密使用 AES-GCM 加密存储，数据库不存明文
• 秘钥仅在内存中留存，启动读取后立即销毁（Unset）
• 执行日志自动搜索并屏蔽(******)**敏感机密内容
• 严格权限隔离：机密仅在定时任务调度时注入，终端/测试环境不可见

节点互联体系 (New)

• 支持 OpenConnect 协议，轻松实现多台白虎面板之间的互联互通
• 支持节点间的环境变量无缝同步（保留原有结构与 ID）
• 集成同步管理控制台，统一查看与控制各节点状态与负载指标
• 底层路由深度适配穿透隧道，完美支持分布式前端代理访问

仓库任务同步 (New)

• 支持 青龙 仓库命令格式快捷导入
• 自动解析脚本注释中的 Cron 表达式和环境变量名
• 支持基于正则表达式的白名单、黑名单文件筛选
• 支持脚本依赖文件的识别与保留
• 自动同步远程 Git 仓库变更，增量更新面板任务

系统设置

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

脚本运行环境

白虎面板原生支持以下脚本的定时执行：

• Python3, Node.js, Bash (标准版镜像内置环境)
• 通过 Mise 扩展：支持几乎所有主流编程语言的动态安装与切换。
• Minimal 版：不预置 Python/Node，仅内置 Mise 底座，由用户按需安装。

依赖管理支持

系统内置了高度集成的跨语言依赖管理器，支持自动化安装和管理以下语言的依赖项，并确保在容器内全局可用：

使用方法

1. 安装环境：进入「编程语言」页面，使用 mise 一键安装所需的语言及版本。
2. 依赖管理：在已安装列表点击「依赖管理」，输入名称（可选版本）即可自动在对应环境内完成安装。
3. 隔离机制：系统基于 mise exec 实现了完善的环境隔离，不同版本的依赖包互不冲突。

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

使用 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/baihu.db \
  -e BH_DB_TABLE_PREFIX=baihu_ \
  -e BAIHU_SECRET_KEY=your_secret_key_here \
  --restart unless-stopped \
  ghcr.io/engigu/baihu:latest

提示：如需通过反向代理部署在子路径（如 /baihu），添加环境变量：

-e BH_SERVER_URL_PREFIX=/baihu

配置后访问地址为 http://your-domain.com/baihu/，详见下方「URL 前缀配置」说明。

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/baihu.db
      - BH_DB_TABLE_PREFIX=baihu_
      - BAIHU_SECRET_KEY=your_secret_key_here
      # - BH_SERVER_URL_PREFIX=/baihu  # 可选：配置 URL 前缀用于反向代理
    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_ \
  -e BAIHU_SECRET_KEY=your_secret_key_here \
  --restart unless-stopped \
  ghcr.io/engigu/baihu:latest

提示：如需配置 URL 前缀，添加 -e BH_SERVER_URL_PREFIX=/baihu

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_SERVER_URL_PREFIX=/baihu  # 可选：配置 URL 前缀
      - 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_
      - BAIHU_SECRET_KEY=your_secret_key_here
    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 \
  -e BAIHU_SECRET_KEY=your_secret_key_here \
  --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
      - BAIHU_SECRET_KEY=your_secret_key_here
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped

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

配置文件示例（configs/config.ini）：

[server]
port = 8052
host = 0.0.0.0
# 可选：配置 URL 前缀用于反向代理，例如 /baihu
url_prefix = 
# 全局会话 Cookie 名称
cookie_name = BHToken

[database]
type = sqlite
path = ./data/baihu.db
table_prefix = baihu_

白虎面板通过系统集成也可轻松连接独立的消息聚合服务。这里推荐使用 Message-Push-Nest 作为分布式的统一消息推送中心。

使用 SQLite

创建 docker-compose.yml 文件：

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/baihu.db
      - BH_DB_TABLE_PREFIX=baihu_
      - BAIHU_SECRET_KEY=your_secret_key_here
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped
    depends_on:
      - message-nest

  # 消息推送服务
  message-nest:
    image: ghcr.io/engigu/message-nest:latest
    # 或使用 Docker Hub 镜像
    # image: engigu/message-nest:latest
    container_name: message-nest
    ports:
      - "8053:8000"
    environment:
      - TZ=Asia/Shanghai
      - DB_TYPE=sqlite
    volumes:
      - ./message-nest-data:/app/data
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped

使用 MySQL（适合生产环境，需要已有 MySQL 服务）

创建 docker-compose.yml 文件：

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=192.168.1.100  # 修改为你的 MySQL 地址
      - BH_DB_PORT=3306
      - BH_DB_USER=root
      - BH_DB_PASSWORD=your_password  # 修改为你的 MySQL 密码
      - BH_DB_NAME=baihu
      - BH_DB_TABLE_PREFIX=baihu_
      - BAIHU_SECRET_KEY=your_secret_key_here
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped
    depends_on:
      - message-nest

  # 消息推送服务
  message-nest:
    image: ghcr.io/engigu/message-nest:latest
    # 或使用 Docker Hub 镜像
    # image: engigu/message-nest:latest
    container_name: message-nest
    ports:
      - "8053:8000"
    environment:
      - TZ=Asia/Shanghai
      - DB_TYPE=mysql
      - MYSQL_HOST=192.168.1.100  # 修改为你的 MySQL 地址
      - MYSQL_PORT=3306
      - MYSQL_USER=root
      - MYSQL_PASSWORD=your_password  # 修改为你的 MySQL 密码
      - MYSQL_DB=message_nest
      - MYSQL_TABLE_PREFIX=message_
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    restart: unless-stopped

启动服务：

docker-compose up -d

访问地址：

• 白虎面板：http://localhost:8052
• 消息推送服务：http://localhost:8053

注意：使用 MySQL 方式时，请先在 MySQL 中创建 baihu 和 message_nest 两个数据库，并修改配置中的 MySQL 地址和密码。也可以使用同一个数据库。

在任务中使用推送

如今你无需依赖任何外部服务，可以通过面板自身完成：

1. 进入白虎面板「消息推送」模块，新建你需要通知的渠道。
2. 可以在「事件绑定」中直接设定自动化系统通知（如监控任务失败或脚本异常中止时进行自动提醒）。
3. 如需在自己的脚本逻辑内动态推送，可以点击「脚本调用」页面，立刻获取一键调用的 Shell / API 代码，内嵌进你的业务逻辑中即可完成推信！

(如继续使用 Message-Push-Nest，你可以通过其管理界面中「消息模板」的「复制推送代码」提取旧有版集成样例。)

提示：在 Docker Compose 部署的环境中，推送服务地址使用 http://message-nest:8000（容器内部通信）。如果是独立部署，请使用实际的服务地址。

如果需要通过域名和 HTTPS 访问白虎面板，可以使用 Nginx 作为反向代理。

Nginx 配置示例：

# 在 http 块中添加 WebSocket 升级配置
map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

server {
    listen 443 ssl http2;
    server_name example.com;
    
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    
    access_log /var/log/nginx/example.access.log;
    error_log  /var/log/nginx/example.error.log warn;
    
    location / {
        proxy_pass http://172.17.0.1:8052;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto https;
        
        # WebSocket 支持（终端功能需要）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        
        proxy_buffering off;
        proxy_read_timeout 60s;
    }
}

# HTTP 自动跳转 HTTPS（可选）
server {
    listen 80;
    server_name example.com;
    return 301 https://$server_name$request_uri;
}

配置说明：

1. 将 example.com 替换为你的域名
2. 修改 SSL 证书路径为你的实际路径
3. 172.17.0.1:8052 是 Docker 容器的宿主机地址和端口，根据实际情况修改
4. WebSocket 配置是必需的，否则在线终端功能无法使用

重载 Nginx 配置：

nginx -t && nginx -s reload

白虎面板在环境内内置了同名的 baihu 命令行工具。如果您在终端内需要执行系统级别的操作，可以使用以下命令：

baihu server             # 以前台方式启动面板的后台进程服务（面板启动指令）
baihu reposync           # 供定时任务调用，将远程 Git 仓库的高级特性同步到本地目录中
baihu resetpwd           # 交互式重置系统 admin 账号密码（密码丢失时可通过进入终端重置）
baihu restore <file>     # 使用本地的 .zip 备份压缩包文件，一条命令直接全量恢复系统数据

终端执行 baihu 会直接打印内置支持的高级命令帮助列表。

配置文件

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

[server]
port = 8052
host = 0.0.0.0
url_prefix =

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

环境变量

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

URL 前缀配置

如果需要通过反向代理（如 Nginx）将白虎面板部署在子路径下，可以配置 URL 前缀。

配置方式：

# 方式一：配置文件
[server]
url_prefix = /baihu

# 方式二：环境变量
-e BH_SERVER_URL_PREFIX=/baihu

配置效果：

配置 url_prefix = /baihu 后，访问路径变为：

Nginx 反向代理配置示例：

location /baihu/ {
    proxy_pass http://localhost:8052/baihu/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

MySQL 示例：

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

调度设置

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

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