Repository navigation
KPanel 1.30.0
版本更新内容
新增
- 特色功能：新建桌面 URL 快捷方式时自动识别网站公开图标；网站和快捷方式还可从图片 URL 导入图标，查看进度并重试或取消。浏览器首页集中展示桌面应用、网站和 URL 快捷方式。
- 媒体中心：音乐、图片和影视目录及播放位置按管理员偏好同步；音乐保留原音频并同步队列与进度、匹配当前曲目缺失的歌词和封面；影视库提供海报、详情、编辑、全屏播放和单片进度。
- 站点与移动操作：网站设置增加访问密码入口，手机终端增加 Ctrl 辅助键。
变更
- 音乐资料缓存并支持按文件名和标签搜索，曲目行更紧凑且资料加载时保持滚动位置；桌面网站入口可选内置或系统浏览器，壁纸切换统一过渡。
- 历史监控按 Ping、TCP、HTTP 同页分组并可独立控制图表和状态；媒体入口合并，影视扫描逐步显示已发现内容。
修复
- 修复桌面冷启动后 Agent 应用目录未及时刷新的问题；改善文件权限设置、音乐状态与队列恢复、终端关闭和断线恢复。
- 改进网站访问保护及 AI/MCP 文件读取的失败处理；安全读取条件无法满足时，仅拒绝对应文件读取结果。
安全
- Panel 与可选浏览器组件工具链更新至 Go 1.27.4，修复 GO-2026-6859；可选浏览器组件固定到已验证的 0.1.0-rc.5 多架构镜像。
兼容性
- 媒体目录、播放位置和队列沿用管理员偏好，不新增数据库 schema 或 Agent 协议。影视资料按需查询，不执行全库后台刮削；查询会向所选外部来源发送影片名称。
- 自动图标读取沿用受保护接口并仅访问公网地址；图片 URL 导入继续执行图片校验，不修改目标网站文件。网站访问密码沿用已发布的兼容脚本。
- 在线歌词和封面可保存为媒体目录旁车文件，不覆盖已有同名文件。
升级注意事项
- 升级前备份 Panel、Agent 数据、媒体偏好和自定义宿主脚本；回退到 v1.29.0 前应恢复升级前备份，以免旧版本丢失新偏好字段。
- 保存在线歌词或封面会在媒体目录新增旁车文件；已有同名文件不会覆盖。
- 自动安装更新仍需用户单独开启；加入预览版不会自动安装，退出预览不会自动降级。
升级说明
- 已安装用户可继续通过 kejilion.sh 应用市场或 KPanel 稳定版通道原位升级。
- 默认兼容升级并保留现有数据目录、端口与反向代理配置；如上方列有升级注意事项，以该版本的明确说明为准。
- 更新前建议记录当前版本与镜像摘要；失败时按原应用市场回滚流程恢复上一镜像。
发布产物与完整性
- 生产镜像：
docker.io/kjlion/kejilion-panel@sha256:4523345173d5e8eefcf6fccc46ff350c32491a8abf81e7f226bfe0685a8c212e - 面板本体仅支持 Docker 部署；Release 不提供 paneld 原生二进制或 web dist。
kejilion-panel-meta-1.30.0.tar.gz仅含部署脚本、文档和许可等元数据，不是可构建源码包。- Linux Agent、Linux 轻量节点、Windows 轻量节点及安装器和元数据归档须使用附件
SHA256SUMS校验后再使用。 - Windows 节点提供历史监控、文件与 PowerShell 命令行终端；不包含远程桌面。Windows 附件未使用代码签名证书，须核对固定版本官方 HTTPS 来源和 SHA-256。
- Release 流水线已经执行测试、漏洞扫描、双架构构建、镜像运行契约及摘要一致性检查。
完整版本记录：CHANGELOG.md