KPanel 1.25.0

KPanel 1.25.0

版本更新内容

修复

• 修复 OpenWrt、LEDE、ImmortalWrt、iStoreOS 轻量节点在面板重启或容器重建后从列表消失、无法继续上报的问题；原记录、密钥、节点进程和网络仍可用时，无需重新配对。
• 文件上传、远程下载、重命名、压缩解压、粘贴及拖拽完成后选中并定位成功结果；桌面文件直接打开预览，“打开所在目录”可有界翻页定位，切换主机或目录后不会被迟到结果抢走选择。
• 修复远程下载新旧任务索引冲突、Docker 命名卷及匿名卷跨数据目录恢复、网站配置失败回滚和私有状态提交后误报失败；系统工具窗口短暂读取失败后能继续恢复状态。

新增

• Compose 项目支持停止并删除部署、备份或保留配置，并单独选择是否删除数据卷；Docker 容器可查看实际创建命令，敏感值默认遮蔽。
• 上传、跨主机传输与 URL 下载共用持久化文件接收流程，支持分块校验、中断恢复、进度确认和主动取消；新版接收单文件及目录总量上限 10 GiB，目录最多 10,000 项。
• 文件管理支持 DOCX、XLSX、PPTX 的基础内容预览和编辑；桌面及文件窗口提供新建文件夹和常用文本文件菜单，创建后选中，不自动执行。
• 备份中心提供自动备份健康状态、漏跑及上传清理异常提醒；新增可选成功登录通知，Linux 轻量节点可选择统计网卡并在接入时补齐依赖、使用经过校验的下载镜像回退。

变更

• 手机桌面支持分页、分组文件夹和左侧组件页；改善小组件高度、边缘手势和触屏焦点，减少非主动操作弹出键盘。应用脚本可后台运行，标题栏操作与重新打开后的任务状态保持一致。
• 公共集群分享页支持协议 2 主题接管整页，并提供受限消息驱动的刷新、浅深色切换及默认样式；旧主题继续兼容。监控延迟图展示中位数与最小值区间。
• 集群轻量节点仅支持 Linux；RC 阶段的 Windows 节点、PowerShell 和 RDP 功能已移除。Docker 容器批处理继续排除。

安全

• AI 文件写入审批根据实际 Compose 来源判断，未知来源、链接或不完整遍历转人工确认；共享网络地址分类继续保留各业务已授权的私网策略，不扩大节点、文件或宿主机权限。

升级注意事项

• 升级保留现有配置和数据，备份异常及登录通知需按需开启；集群节点继续仅支持 Linux。原软路由进程、网络、记录及凭据仍有效时可重试上报；本版不修复已删除的记录、凭据或停掉的节点进程。
• Compose 删除仅在管理员主动确认后执行；容器内未持久化数据会随容器删除，勾选删除数据卷会移除项目命名卷与匿名卷。外部卷、宿主机挂载目录和镜像仍保留；配置备份可用于恢复部署。
• 文件接收的校验与持久化会增加正常传输开销，目录需约两倍临时空间；10 GiB 与 10,000 项是上限，真实 WAN、满额传输和突然断电尚未验证。任务索引迁入 file-transfers/jobs-v1.json 并保留旧记录；回滚前应备份状态和数据。已加入预览的用户可向前升级到本正式版，退出预览不会自动降级。

发布边界

• 本序列正式版目标为 GitHub Latest 与 Docker latest，保留已有 RC 和 Docker preview；生产实例部署属于单独授权范围。
• scriptLinkageState=coupled：汇总此前 RC4 的脚本联动，继续固定已经先行发布的 c3a8bd895f8878d9e4ced7592c91a20c974472a5；本次正式版准备不创建新的脚本提交或改变应用市场安装契约。

升级说明

• 已安装用户可继续通过 kejilion.sh 应用市场或 KPanel 稳定版通道原位升级。
• 默认兼容升级并保留现有数据目录、端口与反向代理配置；如上方列有升级注意事项，以该版本的明确说明为准。
• 更新前建议记录当前版本与镜像摘要；失败时按原应用市场回滚流程恢复上一镜像。

发布产物与完整性

• 生产镜像：docker.io/kjlion/kejilion-panel@sha256:a183a818ac94446e19078087cee0b7d9d7505bd8ecae8e6fdac1e5c8efc326d9
• 面板本体仅支持 Docker 部署；Release 不提供 paneld 原生二进制或 web dist。
• kejilion-panel-meta-1.25.0.tar.gz 仅含部署脚本、文档和许可等元数据，不是可构建源码包。
• Linux Agent、Linux 轻量节点和元数据归档须使用附件 SHA256SUMS 校验后再使用。
• Release 流水线已经执行测试、漏洞扫描、双架构构建、镜像运行契约及摘要一致性检查。

完整版本记录：CHANGELOG.md