KPanel 1.24.0

KPanel 1.24.0

版本更新内容

汇总 rc.1 至 rc.11 已交付内容，重新构建正式产物并提升稳定更新通道。

变更

• 图库支持照片与视频、相册、上传、搜索、缩放、键盘查看、自选封面和跨相册移动；修复更多菜单遮挡，筛选栏随内容滚动，批量选择操作保持可达。媒体继续保存在普通宿主目录，与文件管理互通。
• WebSSH 主机与应用、建站、体检、环境任务终端使用有序确认流水输入；支持本机、完整 Panel 与轻量节点，代理不支持 WebSocket 时回退到 HTTP 批次，旧对端保留 POST 兼容。固定窗口为 32 帧×2048 字节，总队列最多 1 MiB，重连去重，结果不确定时停止输入。
• 同主机可新建多个终端，标签编号稳定，统一块状光标；空闲输入连接定时保活，断开时静默重连。刷新或关闭页面回收已挂载的主机与批量终端，浏览器往返缓存保留会话；崩溃、断网或组件挂载前刷新仍由既有超时回收。
• 多个脚本终端可同时保持输出，暂停后从保留位置继续；浏览器输出背压与分段任务日志限制内存和磁盘占用，修复旧单文件日志重复回放及环境任务完成凭据检查时序。
• 经典文件管理新增独立主机与目录的双栏视图，文件编辑器扩展文本识别与语法高亮；集群主机提供快捷操作菜单，桌面开始菜单可搜索并通过键盘启动应用、站点与快捷方式。
• 集群分享主题升级到沙箱消息协议 2，提供简约看板、星图和午夜终端独立主题包；旧协议 1 继续兼容。
• Docker 容器列表增加有界实时监控；轻量 Node 增加原生 procd 监管、OpenWrt overlay 指标与 Dropbear/logd 事件兼容。修复使用符号链接 Docker/Agent 状态根目录的启动、文件任务和备份路径保护。
• Go 构建工具链升级至 1.27.1，Node 使用 24.21.0 LTS；更新前端、Go 模块、构建 Actions 与固定扫描工具，TypeScript 保持 6.0.3。

安全

• 跨节点文件内容统一采用本地内容策略；Cluster v1 配对默认仅只读摘要，文件管理需被控端管理员显式授权并校验内层签名。
• 收紧 AI 文件自动审批与秘密文件读取范围；账户变更使用统一当前密码复核预算，Passkey/TOTP 失败预算分离；文件权限修改逐级不跟随符号链接并核对对象身份。

升级注意事项

• GitHub Latest 与 Docker latest 提升至 1.24.0，Docker preview 保留 rc.11；加入预览版不会自动安装，退出不会自动降级。同版本正式版高于 RC，轻量 Node 无人值守更新继续跟随稳定版。
• scriptLinkageState=coupled：使用已先发布的兼容脚本 c981fb6c8b481981ac7a006e102e111e435f6d30。升级前备份面板数据及宿主脚本，旧任务需结束后新建才能使用新脚本；回滚按 1.23.0 的不可变镜像和对应数据备份单独执行。
• 无新增数据库迁移。Cluster v1 如需文件管理，请在被控端“集群 → 接入 → 已授权控制端”中允许，并确保控制端也已升级；该授权不随面板备份迁移。
• Windows 轻量节点、RDP、Node 26 和 TypeScript 7 开发候选未纳入。procd 已验证隔离 x86_64 夹具，完整路由器联网接入、重启及 arm64 原生设备仍未验证；WebSSH 尚无 WAN/Cloudflare 长期验证。图库格式显示取决于浏览器。
• 本次发布正式产物，未执行生产主机部署。

升级说明

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

发布产物与完整性

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

完整版本记录：CHANGELOG.md