Qinglong 面板首次访问如何初始化登录账号并进入系统

Qinglong 面板首次访问如何初始化登录账号并进入系统【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglongQinglong青龙是一个支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台。部署完成后第一次在浏览器访问面板时你看到的不是登录页而是一个初始化的配置向导它引导你设置任务通知方式和登录账号完成后才能用新建的账号登录进入系统。这篇文章按实际页面顺序说明这条路径如何从默认账号状态走完初始化、如何设置登录账号以及如何确认自己已经成功进入系统。准备工作确认面板地址与默认账号面板默认监听5700端口。本地从源码启动时访问 README 中给出的http://127.0.0.1:5700使用 Docker 运行时README 给出的示例将宿主机的5700映射到容器并挂载数据目录例如docker pull whyour/qinglong:latest docker run -d \ -v /path/to/ql/data:/ql/data \ -p 5700:5700 \ --name qinglong \ whyour/qinglong:latest其中/path/to/ql/data需要替换为你在宿主机上实际准备的数据目录。注意 README 中同时说明了如果需要以非 root 用户运行应改用debian镜像并指定--user qinglong因为latest镜像基于 alpine 构建其 crond 需要 root 权限。首次访问前不需要手动配置账号。系统出厂使用默认凭据admin/admin这在仓库的示例认证文件 sample/auth.sample.json 中可以确认{ username: admin, password: admin }实际的认证信息保存在数据目录的config/auth.json见 back/config/index.ts。只要这份信息还是admin/admin面板就处于“未初始化”状态首次访问会被路由到初始化向导一旦你改过账号初始化接口将不再可用。第一步进入初始化向导并配置通知浏览器打开面板地址后出现“初始化配置”页面第一个步骤是“欢迎使用青龙”点击“开始安装”进入下一步页面实现见 src/pages/initialization/index.tsx。第二个步骤是“通知设置”在“通知方式”下拉框中选择一种通知方式系统内置的notificationModes列表中除closed之外的选项。选择后页面会按该通知方式动态渲染出对应的必填字段逐一填写后点击“保存”如果你暂时不配置通知直接点击“跳过”即可进入下一步之后可以在系统的“通知”设置里再补。保存时前端会调用PUT /api/user/notification/init接口提交所选通知方式见 back/api/user.ts 中/user/notification/init路由。第二步设置登录账号第三个步骤是“账户设置”需要填写三项内容字段填写要求用户名必填自定义密码必填且不能为admin页面用正则(?!admin$)校验并提示“密码不能为admin”确认密码必填必须与密码一致点击“提交”后前端调用PUT /api/user/init把用户名和密码写入认证信息。这个接口是整条初始化路径的核心后端有两个关键约束只在未初始化时有效。back/loaders/express.ts 中对/api/user/init、/api/user/notification/init以及对应的/open前缀做了拦截读取当前认证信息如果不再是默认的admin/admin判断逻辑在 back/shared/auth.ts 的isDefaultAuthInfo直接返回{ code: 450 }。也就是说初始化向导只能走一次账号改过之后无法再次通过该接口重置。Demo 环境下不可用。PUT /api/user/init所在的用户路由里isDemoEnv()为真时同样返回 450线上演示环境不允许修改账号。提交成功接口返回code: 200后自动进入最后一步。第三步登录进入系统最后一步页面显示“恭喜安装完成”点击“去登录”按钮浏览器会重新加载页面此时进入的就是正常的登录页。用第二步设置的账号密码登录登录接口为POST /api/user/login请求体包含username和password见 back/api/user.ts成功后返回登录 token由前端保存在浏览器本地初始化页打开时会先清掉旧的localStorage认证信息避免残留登录接口带有限流15 分钟内最多 100 次频繁输错或脚本化重试会触发限流遇到 429 类响应时应等待窗口过期。登录成功即进入青龙主界面说明初始化已完成任务、订阅、环境等面板功能均可正常使用。如何判断面板当前处于哪个状态初始化前后的状态差异可以直接从行为和接口上核对打开面板直接出现“初始化配置”向导 → 认证信息仍是默认admin/admin属于首次部署按上面步骤走完即可打开面板出现登录页 → 已完成初始化用设置的账号登录若提示“请先登录”credentials_required说明未带有效 token若 token 失效则提示“Token 已失效”invalid_token重新登录即可再次调用PUT /api/user/init返回{ code: 450 }→ 说明账号已不再是默认值初始化已被执行过属于预期行为而不是故障。如果初始化后忘记了账号仓库文档中没有提供通过面板恢复的入口认证信息保存在数据目录的config/auth.json中需要按部署文档的备份与数据目录管理方式来处理不要依赖再次调用 init 接口。限制与边界初始化向导/api/user/init与/api/user/notification/init在账号改为非默认值后不可再调用返回 450Demo 环境下同样不可用登录限流为 15 分钟 100 次latest镜像基于 alpine以非 root 用户运行 Docker 时需改用debian镜像并加--user qinglong通知设置可以在初始化时跳过不影响账号创建与登录。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考