作者： George Curta ·
后端 API URL 被拒绝（SSRF 允许列表）
应用拒绝保存后端 API URL，或请求因“URL 不被允许”错误而失败。
原因
在发起任何请求之前，两款应用都会根据运行时校验的主机允许列表（UrlGuard）验证所配置的后端 API URL。这道 SSRF 防护的作用是确保恶意或配置错误的 URL 永远无法让应用的 Bearer token 到达攻击者控制的主机。只有 anonym.legal 和 anonymize.business（DEV 主机）被允许——其他所有主机都会被拒绝，这是刻意的设计。
解决方法
- 1.将后端 API URL 精确设置为 https://anonym.legal（生产环境）或 https://anonymize.business（DEV）。
- 2.去除 URL 中多余的路径、端口或拼写错误——允许列表按主机名精确匹配。
- 3.如果您认为某个合法主机被误拒，请联系支持团队——该允许列表刻意设计为用户不可编辑。
“有新版本可用”提醒
应用的管理员设置中显示一条提醒，表明存在更新版本。
原因
两款应用都会定期检查新版本，如有新版本会显示一条简单的管理员提醒，并附带更新日志链接。这只是一条手动升级提醒，而非自动更新——不会在您的 Nextcloud 实例上自行安装任何内容。
解决方法
- 1.点击提醒中的更新日志链接，查看具体变更内容。
- 2.从 GitHub releases 页面下载新的应用压缩包。
- 3.解压到 apps/ 目录并运行 occ upgrade——与初次安装相同的手动安装步骤——按您自己的节奏进行。
403 错误：“需要 Basic 或更高级别计划”
应用发起的 API 调用返回 403 状态码，并提示需要 Basic 或更高级别的计划。
原因
两款 Nextcloud 应用都需要 Basic 或更高级别的 anonym.legal 账户。免费计划不包含这些应用所依赖的 API 访问权限，因此后端会返回 403 状态码，并显示消息“Nextcloud 集成需要 Basic 或更高级别的计划。请升级您的计划。”，而不是静默失败。
解决方法
- 1.确认所配置的令牌属于哪个 anonym.legal 账户。
- 2.将该账户升级到 Basic 或更高级别的计划。
- 3.重试请求——账户升级后无需重新安装或重新配置。
集成令牌无法读取加密密钥——这是个 bug 吗？
使用配置的令牌尝试获取解密后密钥材料的请求被拒绝。
原因
不是——这是有意为之的设计。这些应用使用的是集成范围的令牌，其权限被有意限制得比完整账户 API 令牌更小：它可以分析和匿名化内容，但任何会返回解密后密钥材料的端点，都会对集成范围的令牌返回 403，因此即便 Nextcloud 服务器被攻破，也永远无法用它解密您的可逆加密历史记录。
该怎么做
- 1.这是预期行为，并非需要修复的错误——这些应用的分析/匿名化/去匿名化工作流程从不需要解密后的密钥材料。
- 2.如果某个工作流程确实需要完整账户权限，请在您可控的环境中，在这些应用之外使用完整范围的 API 令牌。