Admin 账号与密码

默认密码在哪

第一次启动 Imagic 时, 系统会自动生成一个随机密码, 打到容器启动日志:

docker compose logs imagic | grep -i "初始密码"
# 输出形如: 初始密码: 35031ce2c331161c

默认管理员账号: admin@imagic.local

登录之后第一件事是进 个人中心 → 账号安全 改成你自己的密码。

忘记密码了怎么办

镜像内置一个一次性自救通道。在 docker-compose.yml 里给 imagic 加一条环境变量:

services:
  imagic:
    environment:
      RESET_ADMIN_PASSWORD: "你的新密码"

然后:

docker compose up -d
docker compose logs imagic | grep -i "Admin 密码已重置"

看到"已重置"提示就代表新密码生效了, 用新密码登录即可。

重要: 用完立刻删掉这一行环境变量再重启一次, 否则:

• 每次重启都会强制覆盖密码, 你后台改的新密码会被盖回去
• 密码会反复出现在容器日志里, 别人看到日志就拿到了密码

services:
  imagic:
    environment:
      # RESET_ADMIN_PASSWORD: "..."   # 删掉这一行

docker compose up -d

想换成自己的真实邮箱当 admin

admin@imagic.local 是系统兜底账号, 不要直接改它的邮箱地址。推荐做法:

1. 在 后台 → 用户管理 找到 (或新建) 一个用真实邮箱注册的账号
2. 把这个账号设成"管理员"角色
3. 用真实邮箱登录验证一切 OK 后, 把 admin@imagic.local 切成普通用户或封禁

这样真实邮箱能收注册验证 / 找回密码邮件, 兜底账号留作应急。

新增管理员

后台 → 用户管理 找到目标用户, 行末"提升为 admin"即可。 管理员数量没有限制, 但建议保持 1-2 个真人 admin + 兜底账号。

不小心把所有 admin 都禁用了

直接登不进后台时, 用上面的 忘记密码自救通道 重置 admin@imagic.local 的密码, 然后用这个兜底账号进后台把别人的状态改回来。

如果你自己也手贱把 admin@imagic.local 给禁了, 联系销售技术支持, 他们可以远程帮你恢复。

一直显示"会话已过期"反复要求登录

通常是浏览器缓存问题或反向代理配置异常。按顺序排查:

1. 清浏览器对该站点的 cookie + 强刷 (Ctrl+Shift+R)
2. 站点必须全程 HTTPS, 不能 HTTP / HTTPS 混用
3. 检查反向代理有没有改 cookie 的 domain / path (一般不要动)

仍然不行联系销售技术支持, 提供"浏览器开发者工具 → Network → 任意 /api/v1 请求的截图"。