更新日志

🎉 v2.0.6 更新

📢 致歉声明

数据迁移问题致歉

我们对 v2.0.5 版本中引入的数据目录变更带来的不便表示诚挚歉意。由于文档中未能充分说明数据迁移方法，导致部分用户在升级过程中遭遇数据丢失。我们已在本版本中优化了备份系统，并提供了详细的数据迁移教程。

🔧 重要修复

• 🔍 修复 TR 组件域名前缀无法保存的问题
• ⚙️ 添加域名前缀变更监听器，与 QB 组件保持一致
• ✅ 确保设置的前缀能正确应用和保存

💾 备份系统优化

• 🔒 修复备份清理逻辑，手动创建的备份将永久保留
• 🔄 只有自动备份会受到 100 个数量限制的清理
• 📊 即使创建大量手动备份，也不会影响自动备份功能

📋 升级指南

如果您已经使用 v2.0.5 版本并正确配置了所有挂载目录，可以直接更新镜像即可：

# Docker
docker pull madrays/sun-panel-helper:latest
docker stop sun-panel-helper
docker rm sun-panel-helper
docker run -d \
  --name sun-panel-helper \
  -p 33002:80 \
  -e BACKEND_PORT=3001 \
  -v /your/helper/path/data:/app/backend/data \
  -v /your/helper/path/backups:/app/backend/backups \
  -v /path/to/sunpanel/conf/custom:/app/backend/custom \
  madrays/sun-panel-helper:latest

# Docker Compose
version: '3'
services:
  sun-panel-helper:
    image: madrays/sun-panel-helper:latest
    container_name: sun-panel-helper
    environment:
      - BACKEND_PORT=3001
    ports:
      - "33002:80"
    volumes:
      - /your/helper/path/data:/app/backend/data
      - /your/helper/path/backups:/app/backend/backups
      - /path/to/sunpanel/conf/custom:/app/backend/custom
    restart: unless-stopped

🎉 v2.0.5 更新

✨ 新增功能

💾 备份恢复系统

• 📦 新增完整的备份恢复功能
• 🔄 支持配置文件和部署文件的自动/手动备份
• ⏱️ 每小时自动备份，保留最新48个
• 📁 新增 /app/backend/backups 必要挂载目录（这是Helper自己的目录，需要您自己创建）

💽 数据持久化调整

• 📂 新增 /app/backend/data 必要挂载目录，用于持久化用户数据（这是Helper自己的目录，需要您自己创建）
• 📋 必须挂载 /app/backend/custom 目录（必须指向Sun-Panel的custom目录）

🎨 界面优化与功能增强

• 📚 添加官方文档链接 (helper.cocoyoo.cn)
• 📤 优化文件上传限制
  • 🔠 字体上传限制提升至 50MB
  • 🖼️ Logo 上传限制提升至 15MB
• 🌤️ 修复天气组件 UI 问题

⚡ 性能改进

• 🚀 优化 Nginx 配置（上传大小限制提升至 60MB）
• 🧹 移除调试日志
• 🔧 优化代码结构

🚨 部署变更

重要提示

本版本调整了数据存储目录结构，升级前请务必参考数据迁移教程

📝 文档更新

• 📋 补充 README 部署说明
• ⚠️ 添加升级注意事项

🎉 v2.0.4 更新

✨ 重磅更新

• 🚀 全新TR/QB状态小组件终于来了
  • 支持qBittorrent和Transmission下载器状态监控
  • 精美紧凑的UI设计
  • 实时显示下载/上传速度、活动任务数等自定义参数
  • 可添加为自由/固定组件，灵活布局
  • 支持自定义刷新间隔，确保信息实时准确

🔧 重要功能修复

• 📝 修复MD笔记本导致的浏览器密码错误填充搜索栏问题
  • 解决浏览器自动填充功能与搜索栏冲突的问题
  • 优化表单结构，避免误识别为密码输入框
  • 提升整体用户体验
• 🧩 修复自由组件布局删除功能的错乱问题
  • 解决删除组件后布局错位的问题
  • 优化组件删除交互逻辑
  • 提高操作体验与直观性

🔧 IPv6兼容性优化

• ⚡️ 支持自定义前端监听端口，解决IPv6兼容性问题
  • 通过环境变量FRONTEND_PORT灵活设置监听端口
  • 支持Host网络模式部署，彻底解决IPv6连接问题
  • 向后兼容保证现有用户无需修改配置
• 🌈 优化组件IPv6兼容性提示
  • 为TR/QB组件添加清晰的IPv6提示信息
  • 引导用户正确配置IPv6环境下的下载器
  • 美观直观的用户界面优化

📝 其他说明

• 🎯 项目已趋于稳定，后续将以优化和修复为主
• 🌟 欢迎大佬们投稿优质组件
• 💼 由于作者已开始上班，更新节奏会相对放缓
• 📮 如有好的创意和建议，欢迎通过QQ群或邮箱联系,期待大佬们投稿

🎉 v2.0.3 更新

🔧 功能优化

• 🌤️ 天气组件显示效果优化
  • 改进天气显示布局
  • 优化温度和天气状态展示
  • 提升整体视觉效果
• 🐟 小鱼页脚组件优化
  • 增加速度和层级控制参数
  • 优化水面波动效果
  • 提高动画流畅度和稳定性
  • 修复鼠标交互动画
• 🛠️ 组件兼容性提升
  • 进一步优化组件间的协同工作
  • 减少样式冲突可能性

🎉 v2.0.2 更新

🔧 功能优化

• ✨ 新增轻轻小组件入口
  • 提供快捷访问轻轻小组件官网的入口
  • 支持获取组件链接添加到固定/自由组件
• 🔄 新增版本检测功能
  • 支持自动检查新版本
  • 提供详细的更新指南
  • 优化版本信息展示

🎉 v2.0.1 更新

🔧 功能优化

• ⚡️ 支持自定义后端端口,避免端口冲突
• 🌤️ 优化天气组件404问题
• 🛠️ 优化JS组件加载顺序,解决组件冲突
• 🌟 Markdown编辑器配置保存和部署功能优化
• 📝 修复部分描述文案错误
• 🔗 尝试支持arm64架构（因手头没有arm64架构的设备，故未测试，请自行测试）

✨ 新增组件

• 🎵 音乐播放器组件 (by: MYHK/与末)
  • 支持自定义播放列表
  • 界面美观,操作流畅
• 🔒 公开模式隐藏登录按钮CSS组件 (by: 与末)
  • 适用于公开访问场景
  • 提升界面简洁度