初始化与授权激活
装完之后，从「打开网页」到「能登录后台」中间只有两步：激活授权、创建首个管理员。 这一页讲清这两步，以及授权状态在界面上怎么表现。
授权本身的运维（Edition 与部署形态匹配、宽限期、受限模式、节点配额、备份） 见授权与版本。
顺序是「先激活，后建管理员」
与部分旧文档描述相反
前端只在授权状态为 ACTIVE 或 GRACE 时才渲染初始化向导。 所以打开后台看到的第一个页面是激活页，不是创建管理员页。
授权不需要你配置任何东西
走部署包安装时，授权相关的准备工作 install.sh 已经全部做完了：
- 从授权中心下载签名公钥并校验，写入部署目录
- 部署包统一给各服务注入租约文件与公钥路径
- 授权代理服务随应用一起启动
你不需要手工放置任何密钥文件，也不需要写额外的 compose 配置。 命令行也不参与激活——首次授权和后续授权状态管理都在网页里完成。
换机迁移时输入的是「迁移码」
如果你是从另一台机器迁移过来，这里应该输入在旧机器的「系统配置 → 授权与迁移」里 生成的迁移码，而不是普通激活码。迁移码只能使用一次，默认 24 小时内有效。
新机器作为全新部署激活成功，Edition、授权期限、功能与配额与原机一致。 如果旧机器还能正常操作，也可以直接复制 data/license/ 目录沿用原部署身份—— 那样不需要迁移码。两条路径的区别见授权与版本。
分布式部署只激活一次
多机部署时只在网页入口（edge 角色所在机器）激活一次。 其余角色会自动从主服务器同步授权状态，不需要各自输入授权码。
授权 Edition 必须与你装的部署模式一致
单机版部署只接受 edition=STANDALONE 的许可证，分布式部署只接受 edition=DISTRIBUTED。 拿错包激活会被拒绝，此时系统保留激活、许可证状态、日志与备份能力，不开放业务功能， 不会删除任何数据。见授权与版本。
界面上的授权状态
后台顶部会有一条横幅，只在非正常状态时出现：
| 你看到 | 含义 | 要做什么 |
|---|---|---|
| 没有横幅 | 授权正常 | 无需处理 |
| 黄色横幅，写着宽限截止时间 | 暂时联系不上授权中心，处于宽限期。业务照常 | 检查服务器能否访问授权中心；在宽限截止前恢复即可 |
| 红色横幅 | 授权已过期或被撤销，进入受限模式 | 见授权与版本的受限模式说明 |
横幅每 60 秒自动刷新一次状态。
激活后先确认两个内置节点
单机版固定内置一个 Storage（node-local-storage）与一个 Play Agent（node-local-play-agent）， 随主应用安装、启动、升级，不需要你安装任何东西。
进 节点管理 确认：
- 两张卡片都是「在线」，并显示「随系统部署 / 随主版本升级」
- 卡片上没有节点令牌、安装命令、卸载与独立升级操作
- 页面里没有「新增节点」按钮，只有手动反代地址区域可以新增
这是单机版的设计行为，由服务端强制执行，不是界面缺功能。 需要外部工作节点时走分布式部署，两种形态（控制面同机 / 按角色多机）见部署模式与版本选择。
单机版只有一个内置节点，界面会自动收敛
文件管理、文件运维、播放设置等页面在只有一个内置节点时隐藏节点切换菜单， 只显示当前服务状态。你看到没有节点选择器，是正常的。
激活阶段的常见问题
页面一直停在「正在检查系统状态」
授权代理没起来，或者控制面连不上它：
docker compose ps
docker compose logs --tail=200 yiyi-app提交授权码后没有跳转
授权状态没变成 ACTIVE 或 GRACE。按顺序查：
- 服务器时间是否准确。时间偏差过大会被判成时钟异常，先校 NTP：bash
timedatectl - 授权码是否已用过。一次性授权码激活即失效，重复使用会被拒绝； 已经激活过的部署也不能用新码覆盖
- 能否访问授权中心。部署包的
.env里YIYI_LICENSE_SERVER_URL必须是 不带路径的 HTTPS 地址，且服务器能出网访问它
创建管理员时提示已初始化
说明这个部署已经创建过管理员了。首个管理员只能创建一次， 直接用已有账号登录；忘记密码走登录页的找回流程。
激活成功但登录后看不到菜单
新建的是管理员账号，应该有全部菜单。如果看不到，检查登录的是不是刚才创建的那个账号， 以及该账号的管理员标记是否生效（用户管理里可以看到角色列）。