数据源授权

SakuraMedia 前端与后端主体代码仍保持开源；外部数据源实现不再完全开源，需要通过免费激活授权后使用。

引入激活授权仅用于控制同时使用人数，不会收取费用。授权失效只会影响外部数据抓取相关功能，不会影响登录、本地媒体库、已导入内容浏览、播放等基础能力。

什么能力需要授权

数据源授权主要影响需要访问外部数据源的能力，例如在线搜索影片或女优、抓取外部元数据、补齐外部数据源提供的信息等。

已经入库的内容不会因为授权状态变化而丢失。也就是说，即使授权暂时失效，你仍然可以继续使用本地媒体库和播放相关功能，只是新的外部数据抓取会受到影响。

获取激活码

激活码通过 Telegram 机器人发放：

• 机器人地址：SakuraMedia Bot
• 一个 Telegram 用户只能获取 1 个激活码
• 激活码不收费，请不要从第三方购买或转卖

请妥善保管自己的激活码，避免泄露给他人。

在 APP 中激活

服务启动并登录后，在桌面端 APP 中完成激活：

1. 打开 配置中心
2. 进入 数据源
3. 在“数据源授权”卡片中粘贴激活码
4. 点击“激活授权”

激活码只在激活请求中使用。前端不会保存激活码，后端也不会把激活码写入配置文件。

激活码使用规则

单个激活码可以多次使用，但同一时间只能激活 1 个服务。

如果你使用同一个激活码激活新的 SakuraMedia 服务，之前已经激活的服务会失效。这适合迁移机器、重装服务或切换部署实例时使用，但不适合把同一个激活码同时分发给多台服务。

授权刷新与失效

激活成功后，后端会每 6 小时自动刷新一次授权状态。只要服务能够正常访问授权中心，通常不需要手动处理。

如果服务连续超过 24 小时无法完成授权刷新，授权会失效。授权失效后，仅外部数据抓取相关功能受影响；登录、本地媒体库、已导入内容浏览、播放等基础能力仍可正常使用。

如果你确认激活码仍然有效，但页面提示“授权待同步”或“授权不可用”，可以先在 配置中心 → 数据源 中点击“同步授权”或“测试连接”。

授权中心代理

授权中心部署在 Cloudflare Workers。某些地区或网络环境可能无法直接访问授权中心，这时可以为授权中心单独配置 HTTP 代理。

在 config.toml 的 [metadata] 中填写：

[metadata]
# 授权中心 HTTP 代理。不需要代理时留空。
license_proxy = "http://192.168.1.1:7890"

注意：

• license_proxy 只用于访问授权中心
• metadata.proxy 用于 DMM 与 GFriends 等元数据访问
• 两者可以填写不同代理，也可以按你的网络环境分别留空

如果授权中心测试失败，优先确认 license_proxy 指向的代理是否能从 SakuraMedia 后端容器内访问。