首页
/ Gokapi v2.0.0-beta2 发布:自定义CSS/JS与日志系统升级

Gokapi v2.0.0-beta2 发布:自定义CSS/JS与日志系统升级

2025-06-25 08:39:20作者:何举烈Damon

Gokapi是一个轻量级的自托管文件分享系统,允许用户上传文件并生成分享链接。它特别适合需要临时分享大文件或敏感数据的场景,提供了文件加密、访问限制等安全功能。最新发布的v2.0.0-beta2版本带来了多项重要改进,特别是在自定义界面和日志管理方面。

自定义CSS/JS功能

新版本彻底重构了界面自定义方式,移除了原有的template/static文件夹替换机制,改为更安全稳定的自定义CSS/JS注入方案。这一变化解决了旧版本中自定义内容容易因系统更新而失效的问题。

开发者现在可以通过在应用目录下创建custom文件夹来实现界面定制:

  1. 创建custom.css文件可添加全局CSS样式
  2. public.js用于所有公开页面的JavaScript扩展
  3. admin.js则作用于管理后台页面
  4. 通过version.txt文件可控制客户端缓存

这种设计允许在不修改核心代码的情况下实现界面个性化,同时保证了系统升级时的兼容性。

增强的日志系统

v2.0.0-beta2引入了全新的日志管理功能:

  • 新增API端点用于日志删除
  • 完善了日志记录范围
  • 在管理界面增加了日志过滤和删除功能

这些改进使系统管理员能够更有效地监控和排查问题,特别是在多用户环境中。

重要修复与改进

该版本包含多项关键修复:

  • 修复了OIDC登录后总是重定向的问题
  • 解决了SQLite在端到端重置时的bug
  • 修正了DuplicateFile设置错误关联文件对象的问题
  • 修复了管理用户API权限设置不生效的缺陷
  • 解决了图片文件在上传时可能丢失的问题

实验性功能与配置选项

新版本引入了几个值得关注的配置项:

  • GOKAPI_ENABLE_HOTLINK_VIDEOS环境变量可启用视频热链接实验功能
  • GOKAPI_LENGTH_ID和GOKAPI_LENGTH_HOTLINK_ID分别控制文件ID和热链接ID的长度
  • 热链接URL现在更加简洁

升级注意事项

从v1.x版本升级需要注意:

  1. 必须备份所有数据,beta版本可能存在不稳定性
  2. 原有的template/static文件夹自定义方式已被移除
  3. 新的自定义方案需要按照文档重新配置

对于开发者而言,如果需要深度定制界面,现在可以通过修改internal/webserver/web/templates中的模板文件并重新编译来实现。

总结

Gokapi v2.0.0-beta2通过引入更灵活的自定义机制和增强的日志系统,显著提升了系统的可维护性和可扩展性。这些改进使Gokapi在保持轻量级特性的同时,能够更好地适应企业级应用场景的需求。虽然仍处于beta阶段,但这一版本已经展现出成为稳定生产环境解决方案的潜力。

登录后查看全文
热门项目推荐
相关项目推荐