Gokapi v2.0.0-beta1发布：多用户支持功能详解

Gokapi是一个轻量级的自托管文件分享解决方案，它允许用户通过简单的Web界面快速上传和分享文件。作为一个开源项目，Gokapi特别适合需要临时文件分享功能的个人用户和小型团队使用。最新发布的v2.0.0-beta1版本带来了多项重要更新，其中最引人注目的是多用户支持功能。

多用户支持功能解析

v2.0.0-beta1版本的核心特性是实现了多用户支持系统。这一功能为Gokapi带来了更完善的权限管理体系，使得不同用户可以拥有独立的访问权限和操作范围。系统管理员现在可以创建多个用户账户，并为每个用户分配特定的权限级别。

用户权限管理

新版本引入了细粒度的权限控制系统，主要包括以下几种权限类型：

• 文件管理权限：允许用户上传、删除和管理文件
• 用户管理权限：允许管理其他用户账户
• API密钥管理权限：允许创建和管理API密钥
• 系统配置权限：允许修改系统全局设置

这种权限划分方式使得团队协作更加灵活，可以根据实际需求为不同成员分配适当的权限。

认证系统改进

v2.0.0-beta1对认证系统进行了重大重构，特别是对于使用OAuth2/OIDC认证的用户：

1. 现在所有用户必须设置有效的电子邮件地址
2. 认证过程现在完全基于电子邮件地址
3. 可以通过用户组来限制访问权限
4. 升级时必须设置GOKAPI_ADMIN_USER环境变量，指定超级管理员的电子邮件

对于使用Header认证的用户，升级时需要注意移除用户名中的通配符(*)，并确保GOKAPI_ADMIN_USER环境变量包含超级管理员的用户名。

API变更说明

新版本对API进行了多项不兼容性修改，开发者需要特别注意：

1. API调用现在必须提供有效的API密钥，不再支持通过会话认证
2. 部分API端点现在要求参数通过请求头传递，而不是URL编码表单
3. 参数命名规范化，如apiKeyToModify更名为targetKey
4. 错误响应更加精确，对于存在的资源但当前用户无权限访问的情况，现在返回404状态码
5. 布尔参数现在有更严格的验证，只接受特定值(1/t/true/0/f/false)
6. API密钥新增了公共ID概念，可用于部分API操作
7. 文件上传API的默认值变更，现在默认14天有效期、最大1次下载且无密码

升级注意事项

由于这是重大版本更新，升级前必须备份所有数据。升级后无法降级回旧版本。特别需要注意的是：

1. 使用OAuth2/OIDC认证的系统必须确保所有用户有有效的电子邮件地址
2. 使用Header认证的系统需要清理用户名中的通配符
3. 未使用认证的系统需要通过代理限制特定URL的访问
4. 必须设置GOKAPI_ADMIN_USER环境变量指定超级管理员

测试版使用建议

作为beta版本，v2.0.0-beta1可能存在未发现的bug，建议在测试环境中充分验证后再部署到生产环境。使用Docker的用户可以通过gokapi:latest-dev标签获取此测试版。

这个版本为Gokapi带来了更强大的多用户支持能力，使其从小型个人工具向团队协作平台迈进了一大步。期待社区用户的测试反馈，帮助开发团队进一步完善这个功能强大的文件分享解决方案。