云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载本指南完整讲解 Olares 的激活Activate流程如何在浏览器中打开 Wizard URL用管理员提供的一次性密码one-time password完成初始化并通过 LarePass 手机应用扫码绑定你的 Olares ID、重置登录密码。读完本文你将掌握管理员全新安装、团队成员加入集群、以及重装系统后重新激活三类场景的完整操作路径并理解激活状态机、反向代理节点选择与同网段要求背后的实现原理。激活前准备Olares ID 与 Wizard 凭证激活的本质是把一台已安装 Olares 的设备与你名下的 Olares ID 绑定。Olares ID 形如alice123olares.com由本地名local name和域名domain两部分组成每个 Olares ID 都绑定一个去中心化标识符DID用于密码学层面的身份校验详见 Olares ID 概念文档。开始激活前你需要确认两样东西Olares ID没有的话先在手机上打开 LarePass点击Create an account创建参见 创建 Olares ID。如果你是加入已有集群的成员你的 Olares ID 域名必须与集群使用的域名一致创建前请与管理员确认。Wizard URL 与一次性密码全新安装的管理员可在安装完成后的终端或界面中获得团队成员则由管理员通过邀请分享例如使用olares-cli settings users create username创建用户后获得。管理员如何生成 Wizard URL 与一次性密码CLI 视角从 CLI 源码 mutate.go 可以看到settings users create命令创建成员账号时初始密码由generatePasswordSPA()自动生成规则与 LarePass 桌面端Termipass一致创建后仅展示一次必须立即保存带上-w/--watch默认轮询间隔 2 秒、超时 15 分钟时CLI 会等待用户账号状态变为Created并从后端/api/users/name/status返回的address.wizard字段组装出Wizard URL形如https://wizard-host输出示例TTY 表格模式Olares ID: marvin Original password: xxxxxx Wizard URL: https://wizard.marvin123.olares.com Save this information; it is shown once.管理员把这个 URL 和一次性密码即Original password发给成员成员无需接触设备实体即可远程激活这也正是 加入 Olares 集群 流程的起点。步骤一打开 Wizard URL 并输入一次性密码在浏览器中输入管理员分享的 Wizard URL会进入欢迎页进入欢迎页后按任意键继续。向导随即显示一次性密码输入框。**输入一次性密码点击Continue。⚠️ 注意一次性密码是激活的钥匙输入错误会导致激活无法继续进行拿到凭证后请尽快使用。从源码看Wizard 前端对应 TerminusWizardView.vue 等 Wizard 页面组件在密码校验通过后会通过 BFL 网关轮询设备激活状态。CLI 侧的状态机实现 wizard.go 会不断 GET{baseURL}/bfl/info/v1/olares-info获取wizardStatus并按状态驱动后续动作具体状态流转见下文激活状态机一节。步骤二选择系统语言密码通过后向导要求选择系统语言。Olares 支持以下 7 种语言语言说明English英文默认简体中文Simplified Chinese中文用户常用German德语Spanish西班牙语Italian意大利语French法语Japanese日语关键行为可从 ActivateWizard.vue 的configSystem()/activate()调用POST /bfl/settings/v1alpha1/activate的请求体wizard.system印证选择后向导界面立即切换为该语言该选择会写入系统配置SystemConfig.Language见 wizard.go 中的WizardConfig激活完成后 Olares Desktop 使用同一种语言注意语言选择不影响 LarePass App 本身的语言App 后续步骤仍保持当前语言。步骤三选择反向代理节点FRP接下来选择地理位置上离你最近的反向代理节点。这一步的本质是Olares 设备通常没有公网 IP需要通过 Olares Tunnel官方 FRP 节点建立内外网通道让浏览器和 App 能随时随地访问你的 Olares。如果设备已直连公网 IP此步会自动跳过选择结果后续可以随时在 Olares 设置中修改详见 更改反向代理Settings → Network → Reverse Proxy可在Olares Tunnel官方多区域节点与Self-built FRP自建 FRP 服务器地址、端口与认证信息之间切换。FRP 节点列表是如何获取的源码实现从 frp.go 可以看出节点列表的获取逻辑根据 Olares ID 的后缀决定 API 主机ID 以olares.cn结尾 → 请求https://api.olares.cn/frp其余 →https://api.olares.com/frp对应FrpEnvironmentForOlaresID()函数向{host}/v2/servers发送POST请求体为{name: olaresId}返回结构为[{region, name: {en-US: ..., zh-CN: ...}, machine: [{host}]}]其中name是多语言节点名界面按当前语言渲染machine[0].host是默认选中的可达主机该接口是公开接口无需鉴权因为在激活完成、绑定到用户命名空间之前客户端还没有任何用户凭证。选择节点后向导会把{host, jws}写入 FRP 配置见CustomWizardConfig()中FRPConfig{Host, Jws}字段随系统激活请求一起提交用于打通隧道并签发 HTTPS 证书与 DNS。步骤四用 LarePass 扫码激活并重置密码这是整个流程的核心把设备与你的 Olares ID 建立密码学绑定。⚠️管理员激活必须同网段为避免激活失败请确保手机与 Olares 设备连接在同一网络LarePass 需要先在局域网内发现并绑定设备。a.打开 LarePass App点击 Scan QR code扫描二维码扫描 Wizard 页面上的二维码完成激活。 b.按 LarePass 屏幕提示重置 Olares 的登录密码。首次激活时这里设置的是你以后登录 Olares Desktop 的密码密码会同步到 LarePass 的保险库中供自动填充使用。激活背后的状态机与轮询机制LarePass 客户端从扫码绑定那一刻起就开始以 2 秒间隔轮询设备激活状态见 ActivateWizard.vue 的setInterval(updateInfo, 2 * 1000)。CLI 的 RunWizard() 用同一个状态机逻辑复现了这套流程可参考的状态包括状态含义触发动作wait_activate_system等待系统配置调用configSystem()POST/bfl/settings/v1alpha1/activate提交语言、时区、主题与 FRP 配置system_activating系统配置中等待轮询wait_activate_network等待网络/隧道配置提交 SSL/隧道启用配置network_activating网络配置中等待轮询wait_reset_password等待重置密码登录设备后调用密码重置接口performPasswordReset()先LoginTerminus再ResetPasswordvault_activating/vault_activate_failed保险库Vault激活中/失败失败则中止并报告错误completed激活完成流程结束跳转登录页源码中值得注意的两个健壮性设计双通道状态查询主通道GET {baseURL}/bfl/info/v1/olares-info失败时自动回退到通过用户 Store 记录的authURL发起同名请求authRequestTerminusInfo()连续失败 10 次才判定激活失败对应 LarePass 端getHostTerminusCount 10的失败逻辑DNS 生效等待提示在wait_reset_password状态下若超过 3 分钟未完成会提示DNS 设置可能需要更长时间生效请耐心等待超过 5 分钟则提示切换手机网络后重试见 ActivateWizard.vue。步骤五完成激活与首次登录激活完成后LarePass App 自动返回主屏幕设备出现在我的 Olares列表中Wizard 页面自动跳转到 Olares 登录页即https://desktop.你的Olares ID域名.olares.com一类的桌面地址。首次登录建议按 登录 Olares 的指引操作输入上一步设置的密码并完成两步验证——可在手机 LarePass 上点Confirm确认或手动输入 LarePass 生成的 6 位一次性验证码验证码有时效性须在过期前输入。补充场景一重装后重新激活Reactivate如果你重装 Olares比如重新刷 ISO 或重跑安装脚本原实例会失效。此时不需要创建新 ID用现有 Olares ID 重新激活即可完整步骤见 Reactivate Olares。核心差异在于入口脚本方式重装完成初始化向导后在 Wizard 页面用 LarePass 的Scan QR code直接扫码再按提示重置密码ISO / Docker 方式重装LarePass 会提示 No active Olares found点击Learn more → Reactivate随后通过Discover nearby Olares发现同网段设备依次完成安装、激活、选节点、选语言与重置密码完成后 LarePass 会显示设备的桌面地址如https://desktop.marvin123.olares.com。重新激活同样要求手机与设备处于同一网络。补充场景二团队成员加入集群管理员发出邀请后成员按 加入 Olares 集群 操作先按 创建 Olares ID 创建 ID域名须与集群一致用管理员分享的 Wizard URL 与一次性密码走本文步骤一至步骤五不需要接触设备实体登录后按角色获得相应权限参见 角色与权限。激活异常排查速查表现象可能原因处理建议扫码后迟迟未完成激活手机与设备不在同一网络将两者接入同一局域网后重试长时间停在wait_reset_passwordDNS 记录尚未生效耐心等待 3–5 分钟仍失败则切换手机网络4G/5G后重试状态变为system_activate_failed/network_activate_failed系统配置或隧道建立失败在 Wizard 页点击重试检查设备网络与 FRP 节点连通性想更换隧道节点初始选择不理想登录后在Settings → Network → Reverse Proxy修改参考 更改反向代理相关文档导航安装 Olares从安装到激活的完整主线创建 Olares ID激活前置身份准备加入 Olares 集群成员激活路径Reactivate Olares重装后的重新激活更改反向代理激活后调整隧道节点Olares ID 概念Olares ID 与 DID 的技术设计赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐Olares 一键脚本安装指南前置条件、系统要求与 Wizard URL 激活准备Olares 一键脚本安装指南前置条件、系统要求与 Wizard URL 激活准备 本篇技术指南以 Olares 官方安装文档中的可复用章节 docs/ma云原生后端运维TDengine TSDB Enterprise 激活指南使用激活码完成授权激活与状态核验TDengine TSDB Enterprise 激活指南使用激活码完成授权激活与状态核验 TDengine TSDB Enterprise 通过激活码Ac数据库时序数据库物联网大数据实时分析云原生Beyond Compare 5激活终极指南从密钥生成到完整激活Beyond Compare 5激活终极指南从密钥生成到完整激活 还在为Beyond Compare 5的授权问题烦恼吗这款文件对比领域的标杆工具确实功能强逆向工程应用安全创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考