3.4 KiB
3.4 KiB
快速开始
这份快速开始面向 Planet 的最终用户：你拿到了管理员给的访问地址，要从打开浏览器到第一次完成配置之间的最短路径。所有操作都在浏览器里完成。
如果你是负责部署或运维的同事，请改读 Planet 运维手册。
1. 打开访问地址
打开管理员给的 URL，例如 http://planet.example.com。本地演示一般是 http://localhost:3000。
入口分两类：
- 公开页：
/earth（3D 态势）、/docs（公共文档） - 登录后：
/admin（控制台）、/ai（AI）、/settings（系统配置）
2. 注册账号
- 打开
/login，点击表单下方"注册账户"。 - 在
/register填用户名、邮箱、密码（至少 8 位）。 - 提交后，到邮箱查收 6 位验证码（10 分钟内有效）。
- 在验证页输入验证码，点击"验证并登录"，系统会自动跳到控制台。
收不到邮件时：
- 看一下垃圾邮件或企业邮件网关
- 验证页右下角的"重新发送验证码"会显示倒计时，结束后可以重发
- 提示"邮件服务尚未配置"时联系管理员开 SMTP
默认角色是 viewer，可登录但只能看公共内容。要看采集器、用户管理、系统设置，请联系管理员升级角色或加 Gatekeeper 权限组。
3. 第一次登录
进入 /admin 仪表盘后，建议按这个顺序熟悉控制台：
/settings?tab=collector_credentials：选一个采集器，点插头图标做连接测试。免费 collector（开源 BGP 等）通常直接可用；像AISStream、BarentsWatch这类需要凭证的，需要先填 API Key/Client Secret/ai?tab=providers：填一个 LLM provider（例如minimax/openai）、模型名、Base URL、API Key，点 Base URL 末端的插头测试连接。WebSearch / OCR 工具可选/datasources或/data：看采集器是否已经产出数据/alerts/system：看系统告警是否正常/users（仅super_admin）：根据需要给同事开账号或调权限组
4. 打开 Earth
访问 /earth，公开页面，不需要登录。
进入后建议确认：
- 地球正常显示，右侧图层面板可以打开/关闭
- 搜索可以查找海缆、卫星、算力中心、BGP 事件
- 算力中心和 BGP 观测站详情卡可以自动采集坐标候选，并能在 Earth 上预览
- 鼠标拖动、滚轮缩放、缩放百分比提示工作正常
- 设置面板的旋转 / 巡航 / 动捕模式可以切换
5. 找回密码
忘记密码时打开 /forgot-password，输入邮箱并接收验证码，再输入验证码 + 新密码即可。系统对未注册的邮箱也会返回同样的提示（防止账号枚举）。
6. 看文档
/docs 是文档站。未登录可看：本快速开始、使用手册、常见问题。登录后被分配 docs_user / docs_developer / docs_admin 权限组的用户可以看更多技术文档。
下一步
- 完整 UI 操作说明：Planet 使用手册
- 排障与配置疑问：常见问题
- Earth 坐标候选采集详细流程：Earth 位置候选采集使用手册
- 部署 / 运维相关命令：Planet 运维手册