KPanel 1.27.1

KPanel 1.27.1

版本更新内容

稳定版，汇总 1.27.0-rc.1 至 rc.23 的更新；以下为主要变更，完整记录仍见各预览版条目。

新增

• 本地应用支持配置和图标的创建、编辑、删除及入驻引导；备份中心接入 OneDrive，可用于上传、导入和备份计划。
• 桌面新增 Windows XP 与 Windows 98 外观，支持上传账号头像；移动终端增加触控操作和辅助按键。

变更

• 优化图库时间线和移动端查看体验，采用视口渲染、有界缩略图缓存与预加载，并扩展图片格式支持。
• 交互终端增加命令历史、多视图布局和移动端操作；批量终端改为 Panel 后台排队，关闭浏览器后可恢复进度和近期记录。
• 文件编辑器支持多窗格、查找与行跳转，保留隐藏文件草稿；文件路径栏和窄窗口工具栏更易操作，备份恢复增加完整预审。
• systemd 安装器按实际挂载关系选择服务注册方式，独立挂载卷会等待存储就绪。

安全

• 更新 Go 证书信任修复及 Markdown 解析依赖；加强自签名 TLS 资源限制、凭据遮蔽、文件权限和恢复边界。
• 更新 DOMPurify 至 3.4.17；Node.js 构建基座更新至 24.22.1，并配套更新 Vite 8.3.5、Vitest 5.0.5 与官方场景打包产物。

修复

• 完善登录与终端会话边界，修复断线恢复、接收超时和旧会话准入问题；更新失败时重新读取实际状态，避免快捷命令因结果不确定而重复执行。
• 修复发布附件许可证路径和草稿查询，稳定发布在提升通道前绑定完整附件及草稿身份。1.27.0 发布在通道提升前被门禁拦截，未作为正式稳定版公开。

升级注意事项

• 升级前备份面板数据，并配套更新 Panel 与 Agent。systemd 独立挂载卷会使用受管服务副本；请通过现有生命周期流程升级或回滚，不要只替换镜像。
• 批量任务只在 Panel 持续运行期间执行；Panel 或宿主机重启后不会自动重放未完成命令。记录保留 24 小时且受 2 MiB 元数据上限约束，输出只在内存中保留最近 10 轮。
• OneDrive 需要配置 Microsoft Entra 应用，真实账户与云端往返尚未实测；回退到不支持它的版本前，先移除连接并调整备份计划。自签名 TLS 端口仍接受明文 HTTP API，HTTP 登录可能暴露凭据；请限制端口在可信网络并强制使用 HTTPS。

升级说明

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

发布产物与完整性

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

完整版本记录：CHANGELOG.md