常见问答
License 授权
License 校验失败 / 到期续费 / 多实例
Imagic 通过 License Key 授权运行。Docker 版的 License 是销售给你的一段长字符串,
填进 后台 → 设置 → 授权 或 LICENSE_KEY 环境变量即可。
启动报 License 错误
打开 imagic 容器日志, 错误原因会写得很清楚, 常见几种:
| 提示 | 含义 | 处理 |
|---|---|---|
| 域名不匹配 | 当前访问域名与 License 绑定的域名不一致 | 联系销售换绑域名, 或把站点反代回 License 上的域名 |
| 已过期 | 服务到期 | 联系销售续费 |
| 签名校验失败 | License Key 被截断 / 拼接错 / 字符丢失 | 重新从邮件 / 工单复制完整 Key, 注意头尾 eyJ... 不要漏 |
| 已吊销 | License 已被官方吊销 | 联系销售确认 |
到期了, 不续费会怎样
老版本继续可用, 不能升级到新版本。具体表现:
- 你当前正在跑的 Imagic 容器不会立刻停服, 业务功能 (用户登录 / 生图 / 充值) 全部继续工作
- 后台 / 前台会有"授权已到期"的轻量提示, 仅作提醒, 不阻塞使用
- 一段宽限期 (默认 7 天) 之后, 业务接口会被收紧, 仅保留登录与后台让你能整理数据
- 这期间你无法
docker compose pull升级到新版本镜像 — 新镜像启动会校验 License 状态拒绝运行
简单理解就是: 续费到哪一天, 你就能用到哪一天的功能。停止续费 ≠ 立即停服, 但没法再享受新版本的功能更新与 bug 修复。
续费之后
销售会给你一份新的 License Key。两种更新方式:
- 后台改 (推荐): 进 后台 → 设置 → 授权, 把 License Key 替换成新值, 保存即生效, 不用重启
- 重启容器: 在
docker-compose.yml把LICENSE_KEY替换成新值, 然后docker compose up -d
更新之后授权状态恢复 ok, 之前的"到期提示"自动消失。
换服务器 / 换域名
License 默认绑定一个域名。要迁机器或换域名:
- 换 IP / 同域名 — 直接搬迁数据, 不需要换 License
- 换域名 — 联系销售重发一份 License (一般免费换绑一次), 拿到新 Key 替换即可
多实例部署
一份 License 默认按"单实例"授权。两种情况要联系销售协商:
- 多个独立站点 (a.com, b.com 各跑一份) — 需要各自的 License
- 同一站点跑多个 imagic 容器做高可用 / 负载均衡 — 需要把授权升级到对应的并发数
擅自部署多实例会触发"实例数超限"告警, 持续超限会进入受限运行 (业务接口被收紧)。 正常滚动部署 (短暂的新旧实例同时存在) 系统会自动忽略, 不会误伤。
License 服务器一时不可达
授权由官方授权服务器发放与续期。极端情况下网络问题或官方运维, 你的站点联系不到授权服务器:
- 不会立刻停服, 系统按"宽限"模式继续放行, 默认宽限 7 天
- 期间偶尔会在管理后台看到"授权状态待确认"的提示, 属正常容错
- 网络恢复后下一次自动校验通过即归位
如果宽限期内一直没恢复, 联系销售拿临时离线 License。
仍然解决不了
把"容器日志最后 100 行 + License Key 前后各 10 个字符"截给销售, 一般 30 分钟内能定位问题。 永远不要把完整 License Key 发到公开渠道(论坛 / 群里 / GitHub issue)。
购买 / 续费 / 换绑
需要购买、续费、换绑域名或多实例授权, 都可以联系微信 wood_czl 或 ikelexy。