v2.2.4

1Panel-dev/1Panelv2.2.4Jul 27, 2026by wanghe-fit2cloud

AI Summary

This release focuses on significantly enhancing the Web Application Firewall (WAF) with advanced logging, protection modes, and reporting tools. It also introduces new features for file management, database operations, and multi-node monitoring, alongside general system performance optimizations and bug fixes.

Key Highlights

  • Major WAF enhancements including observation mode, province-based access restriction, IP geolocation in logs, and website-level attack statistics.
  • File Browser improvements including the ability to cancel chunked uploads and sort directories by size.
  • New MySQL user management functionality and fixes for container rollback and backup failures.
  • System optimizations such as OpenResty dynamic module compilation and multi-node health checks.

New Features

  • Model accounts now support retrieving model lists
  • MCP Server supports custom command-line arguments
  • OpenResty modules support dynamic compilation
  • New MySQL user management functionality
  • File browser supports canceling chunked file uploads
  • File browser supports caching directory size and sorting by size
  • Process management adds runtime diagnostics
  • WAF adds province-based access restriction configuration
  • WAF adds observation mode
  • WAF supports configuring allowed search engine crawlers
  • WAF adds Host filtering for interception logs
  • WAF adds origin server protection
  • WAF adds IP geolocation lookup to logs
  • WAF adds website-level statistics to attack reports
  • Multi-node support for node health check configuration
  • Website Monitoring supports blocking IP addresses and ranges from logs
  • Log Audit adds Linux host system log viewer
  • System adds Lao (lo_LA) language support

Full Release Notes

## ✨ New Features / 新增功能

* Models: Added support for retrieving model lists from model accounts / 模型账号支持获取模型列表 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13281
* MCP: Added support for custom command-line arguments for MCP Server / MCP Server 支持自定义命令行参数 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13265
* Websites: Added dynamic compilation support for OpenResty modules / OpenResty 模块支持动态编译 by @Snrat in https://github.com/1Panel-dev/1Panel/pull/13291
* Databases: Added MySQL user management / 新增 MySQL 用户管理功能 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13278
* File Browser: Added support for canceling chunked file uploads / 文件分片上传支持取消 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13233
* File Browser: Added directory size caching and sorting by size / 文件管理支持缓存目录大小并按大小排序 by @lan-yonghui in https://github.com/1Panel-dev/1Panel/pull/13220
* Toolbox: Added runtime diagnostics to process management / 进程管理新增运行诊断功能 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13295
* WAF: Added province-based access restriction configuration / 访问限制支持按省份配置 by @zhengkunwang223
* WAF: Added observation mode / 新增观察模式 by @zhengkunwang223
* WAF: Added support for configuring allowed search engine crawlers / 支持设置允许访问的搜索引擎蜘蛛 by @zhengkunwang223
* WAF: Added Host filtering for interception logs / 拦截日志支持按 Host 筛选 by @zhengkunwang223
* WAF: Added origin server protection / 新增源站保护功能 by @zhengkunwang223
* WAF: Added IP geolocation lookup to interception and website monitoring logs / 拦截日志与网站监控日志支持按 IP 归属地查询 by @zhengkunwang223
* WAF: Added website-level statistics to attack reports / 攻击报表新增网站维度统计 by @zhengkunwang223
* Multi-Node: Added node health check configuration / 支持配置节点健康检查 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13268
* Website Monitoring: Added support for blocking IP addresses and IP ranges from logs / 日志支持拉黑 IP 和 IP 段 by @zhengkunwang223
* Log Audit: Added Linux host system log viewer / 新增 Linux 主机系统日志查看功能 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13285
* System: Added Lao (lo_LA) language support / 新增老挝语(lo_LA)语言支持 by @bounkirdni-2025 in https://github.com/1Panel-dev/1Panel/pull/13154

## ⚙️ Enhancements / 功能优化

* Models: Model downloader now supports navigating to the download directory / 模型下载器支持跳转至下载目录 by @zhengkunwang223
* Models: Optimized synchronization of associated models after editing model accounts / 优化模型账号修改后的关联模型同步逻辑 by @zhengkunwang223
* Websites: Optimized website list page styles / 优化网站列表页面样式 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13219
* Websites: Optimized OpenResty module compilation and upgrade workflows / 优化 OpenResty 模块编译与升级流程 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13355
* Certificates: Optimized SSL certificate request logic / 优化 SSL 证书申请逻辑 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13296
* Containers: Optimized the location of batch operation entries / 优化容器批量操作入口位置 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13348
* File Browser: Improved multilingual copy for canceling chunked file uploads / 完善文件分片上传取消功能的多语言文案 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13246
* File Browser: Added prompts when creating files in protected directories / 在受保护目录创建文件时新增提示信息 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13270
* Terminal: Optimized page performance when outputting large amounts of content / 优化大量内容输出时的页面性能 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13312
* WAF: Optimized overview page information display / 优化概览页面信息展示 by @zhengkunwang223
* WAF: Optimized export functionality for interception logs and website monitoring logs / 优化拦截日志与网站监控日志的导出功能 by @zhengkunwang223
* WAF: WAF and website monitoring reports now retain filter criteria / WAF 与网站监控报表支持保留筛选条件 by @zhengkunwang223
* WAF: Optimized file upload content inspection settings / 优化文件上传内容检测配置 by @zhengkunwang223
* Website Monitoring: Added support for sorting the website list by access data / 网站列表支持按访问数据排序 by @zhengkunwang223
* Website Tamper Protection: Optimized website information display in the tamper protection list / 优化防篡改列表的网站信息展示 by @ssongliu
* Log Audit: Optimized host log management and added support for clearing SSH login logs / 优化主机日志管理并支持清空 SSH 登录日志 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13345
* Panel Settings: Optimized API adaptation logic for OneDrive backup accounts / 优化 OneDrive 备份账号的接口适配逻辑 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13284
* System: Automatically synchronizes the script library at 1Panel startup / 1Panel 系统启动时自动同步脚本库 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13376
* System: Optimized table interactions on some list pages / 优化部分列表页的表格交互体验 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13280
* System: List pages now retain filter criteria / 列表页支持保留筛选条件 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13314

## 🛠️ Bug Fixes / 问题修复

* Overview: Fixed inconsistent heights of cards on the right side of the overview page / 修复了概览页右侧卡片高度不一致的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13332
* App Store: Fixed an issue where app versions removed from remote servers could still be selected for installation / 修复了远程服务器下架应用版本后仍可选择安装的问题 by @zhengkunwang223 in https://github.com/1Panel-dev/1Panel/pull/13360
* MCP: Fixed an issue where HTTPS could not be enabled when binding MCP Server to a website / 修复了 MCP Server 绑定网站时无法启用 HTTPS 的问题 by @wanghe-fit2cloud in https://github.com/1Panel-dev/1Panel/pull/13271
* Databases: Fixed an incorrect image tag for MariaDB remote backups / 修复了 MariaDB 远程备份镜像标签异常的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13218
* Containers: Fixed an issue where local image imports could be submitted with an empty path / 修复了本地镜像导入路径为空时仍可提交的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13269
* Containers: Fixed an issue where containers could not roll back properly after an upgrade failure / 修复了容器升级失败后无法正常回滚的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13315
* File Browser: Fixed file permission changes after overwriting files during extraction / 修复了覆盖解压文件后权限发生变化的问题 by @lan-yonghui in https://github.com/1Panel-dev/1Panel/pull/13267
* File Browser: Fixed an issue with batch-selecting items using the Shift key / 修复了使用 Shift 键批量选择数据时出现异常的问题 by @lan-yonghui in https://github.com/1Panel-dev/1Panel/pull/13374
* Monitoring: Fixed duplicate disk I/O statistics / 修复了磁盘 I/O 数据重复统计的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13333
* Firewall: Fixed an issue where Fail2Ban blocking rules were lost after restarting the firewall / 修复了重启防火墙后 Fail2Ban 封禁规则丢失的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13272
* Cron: Fixed an issue where temporary files were not cleaned up after backup failures / 修复了备份失败后临时文件未清理的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13274
* Multi-Node: Fixed abnormal database authorization information display in the node overview / 修复了节点概览中数据库授权信息显示异常的问题 by @ssongliu
* Resource Sync: Fixed insufficient permission validation for the application installation synchronization API / 修复了应用安装同步接口权限校验不完善的问题 by @ssongliu
* Panel Settings: Fixed an issue where the system snapshot upload timeout did not take effect / 修复了系统快照上传超时时间未生效的问题 by @ssongliu in https://github.com/1Panel-dev/1Panel/pull/13275