安装与登录问题

Crest 服务访问、初始密码、登录失败、端口和 HTTPS 常见问题。

安装与登录问题通常和服务状态、端口、反向代理、初始密码、数据库连接或浏览器缓存有关。排查时先确认服务是否运行，再看登录页面和后端日志。

登录页

登录页截图用于确认前端资源、品牌信息、账号密码登录和 SSO 入口是否正常。页面能打开只说明静态资源基本可用，还要继续验证后端接口、登录请求、Cookie、域名和 HTTPS 配置。

安装完成后打不开页面

推荐排查顺序：

如果服务器本机访问正常、外部访问失败，优先检查防火墙、安全组、Nginx 或 Ingress。如果服务器本机访问也失败，优先检查容器状态、端口监听、数据库连接和应用日志。不建议在初始排查阶段修改密码或重装系统，以免掩盖原始错误。

安装脚本会在安装完成后输出管理员账号和初始密码。若没有保存：

首次登录后请修改密码

初始密码只用于首次登录。登录成功后应立即进入修改密码页面更新密码，并记录管理员账号归属。

修改密码

修改密码截图说明用户可在登录后自行更新密码。正式交付时，管理员应把“初始密码已修改”作为上线检查项。对于应急管理员账号，还应记录保管人和使用审批方式。

v1.5.6 起统一登录入口。用户登录成功后进入数据门户还是后台工作台，取决于当前账号的菜单权限和后台访问权限。

现象	说明	处理
登录后进入数据门户	当前账号主要用于查看已发布资源	正常现象，需要编辑资源时申请后台菜单权限
登录后可进入后台工作台	当前账号具备后台访问权限	正常现象，按岗位继续配置资源权限
登录后页面空白	旧 token 损坏、前端资源异常或接口异常	清理登录态后重新登录，并查看浏览器控制台和后端日志
本地开发端口从 8080 变为 8081 后登录失败	旧版本可能触发 CORS 问题	升级到 v1.5.6，并确认前端代理和 `CREST_ORIGIN_LIST` 配置

公开分享链接通常是 /link/:uuid。v1.5.7 起，已登录后台用户访问该类链接时，也会进入分享展示页，不会因为已有登录态被重定向到工作台。

排查顺序：

常见原因：

处理建议：

CREST_CRYPTO_MODE=sm-suite 属于部署和安全配置，不改变业务页面入口。用户仍然按原流程登录、创建数据源、创建数据集、制作仪表盘、制作数据大屏、分享页面和提交导出。

需要重点检查的是运维配置：

如果启用国密后服务启动失败，先查看应用日志中是否有加密模式或密钥长度相关错误。不要通过更换密钥反复尝试，已有环境更换密钥可能导致历史敏感配置无法解密。

工作台

工作台是登录后的第一道验证页。截图中顶部菜单、资源统计、快捷入口和账号菜单都应正常显示。若工作台打开慢或局部空白，可以同时检查浏览器控制台和后端日志；若只有某个用户异常，优先排查角色和权限。