云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载本篇围绕 TerminusOlares仓库中 自定义域名设置文档 展开讲解如何把自有域名接入 Olares Space为什么自定义域名只能绑定在 DID 阶段的账户上、如何通过 TXT 记录证明域名所有权、如何通过 NS 记录把子域解析委托给 Olares 的 Cloudflare以及验证完成后如何为组织创建 Olares ID。读完本文你可以独立完成从域名接入、两级 DNS 验证到组织域名分配Allocated的全流程操作。背景自定义域名在 Olares 中的作用默认情况下在 LarePass 中创建账户会得到一个olares.com域名的 Olares ID例如alice123olares.com访问服务的 URL 形如desktop.alice123.olares.com。Olares ID 的结构与邮箱一致由 local name前缀 域名后缀组成Olares 会自动为账户分配个人主页、Desktop、Files 等子域并附带免费的 HTTPS 证书见 Olares ID 概念文档。Olares 中的域名分为三类引自 Olares ID 概念文档域名类型用途说明Individual domain个人使用目前 Olares 为个人用户提供默认域名olares.comOrganizational domain组织使用组织域名长度为 2-24 个字符成员加入组织后可以在该组织域名下申请 Olares ID管理员可以在成员离开组织时撤销其 Olares IDEntity domain应用及其他实体无法归类为个人或组织的实体自定义域名属于组织域名的接入方式无论是希望员工使用公司专属域名的组织用户还是希望使用自有域名的个人都可以在 Olares Space 中为 Olares 系统设置自定义域名见 原文档。整个流程由组织统一管理分为两部分在账户仍处于DID 阶段时把域名添加进 Olares Space 并创建该域名下的 Olares ID用这个自定义域名的 Olares ID 激活一台新设备或恢复出厂设置后的 Olares 设备。不同角色承担的动作引自 端到端教程步骤组织管理员组织成员准备一台未激活或已恢复出厂的 Olares 设备✅✅在 LarePass 中创建 DID✅✅在 Olares Space 添加自定义域名✅为该域名创建组织并在 LarePass 中以管理员身份创建 Olares ID✅在 Olares Space 向组织添加新成员✅加入组织并在 LarePass 中创建 Olares ID✅使用自定义域名的 Olares ID 安装并激活 Olares✅✅需要注意的关键约束自定义域名只能关联处于 DID 阶段的账户。DID 阶段是账户的最初形态此时已生成助记词、私钥和 DIDDecentralized Identifier但尚未绑定 Olares ID。从 账户体系概念文档 可以确认处于该阶段的账户“可以访问 Olares Space 来申请组织域名”这正是本文流程的起点一旦账户绑定了 Olares ID就应走既有的设备激活路径而不是自定义域名流程。前置条件开始之前请确认已满足以下全部条件继承自 原文档拥有一个处于DID 阶段的账户。自定义域名只能与 DID 阶段的账户关联创建方法见 创建组织账户文档。已用该 DID 登录 Olares Space账户管理方式见 登录与管理账户。通过域名注册商注册了一个域名且该域名尚未与 Olares Space 中的其他账户关联。手机上已安装 LarePass。拥有该域名 DNS 设置页面的操作权限用于配置 TXT 记录和 NS 记录。在 Olares Space 中添加域名以下步骤以space.n1.monster作为示例自定义域名该示例步骤定义在可复用内容块 custom-domain.md 的custom-domain-add-domain-steps区域被多篇手册文档引用。第 1 步设置域名名称在 Olares Space 中进入Domain management域名管理页面选择Set up domain name。在弹出的对话框中输入一个有效的子域名点击Confirm。警告不要使用主域名。使用yourdomain.com这样的一级域名会把全部 DNS 管理权转移到 Olares Space并且不会自动迁移你现有的 DNS 记录。请改用app.yourdomain.com这样的子域名。第 2 步添加并验证 TXT 记录证明域名所有权TXT 记录是域名所有权验证的标准手段Olares 在对话框中给出一组只有域名持有者才可能在 DNS 中写入的名称与值验证方通过解析该 TXT 记录确认你对域名拥有控制权。在域名列表的Action列点击Guide查看需要添加的 TXT 记录。到你的 DNS 服务商的设置页面按照对话框提示添加相应名称和值的 TXT 记录。TXT 记录验证通过后域名状态更新为Awaiting NS record configuration等待配置 NS 记录。第 3 步验证 NS 记录委托 DNS 解析NS 记录的作用是把该子域名的 DNS 解析权委托给 Olares 的 Cloudflare 接入点之后的服务子域都解析到 Olares 网络。在Action列点击Guide查看需要添加的 NS 记录。在 DNS 服务商处为你的子域名添加两条NS 记录值使用对话框中提供的数值。NS 记录验证通过后域名状态更新为Awaiting the application for the Domains Verifiable Credential等待申请域名的可验证凭证。警告验证成功后不要修改 NS 记录。修改 NS 记录会导致自定义域名解析失败、服务不可访问。TXT 与 NS 两级验证都完成后即可进入 LarePass 创建组织见下文“验证成功之后”。域名状态流转一览把上述步骤中的状态机整理如下便于排查卡点域名状态含义触发/后续动作初始未验证已提交子域名待验证按 Guide 添加 TXT 记录Awaiting NS record configurationTXT 已验证等待 NS 配置添加两条 NS 记录Awaiting the application for the Domains Verifiable CredentialNS 已验证等待域名 VC 申请在 LarePass 创建组织Allocated组织已创建域名完成分配可在 Domain management 页查看成员、添加新用户其中Allocated状态出现在组织创建之后刷新 Domain management 页面即可看到域名状态更新并可进入成员管理见 管理域名成员。验证机制原理TXT、NS 与 Domain VC三个环节分别解决不同层面的信任问题TXT 记录 —— 证明“你是域名持有者”。对话框中的记录值由平台一侧生成DNS 服务商侧的写入动作构成所有权证明对应 W3C 去中心化身份体系中“验证方”的校验逻辑。NS 记录 —— 把解析权交给平台。NS 委托后desktop.user子域等所有服务地址都由 Olares 的 Cloudflare 统一解析这是自定义域名能够承载多个用户子域的前提也解释了为什么验证成功后 NS 记录被修改会导致整体解析失败。Domain Verifiable Credential —— 把域名变成可验证的身份凭证。“Awaiting the application for the Domains Verifiable Credential” 这一状态指的是域名的 VCVerifiable Credential申请阶段。VC 是 W3C 标准凭证与 DID 配合实现无信任中介的验证涉及 Issuer签发方、Holder持有方、Verifier验证方三个角色验证过程依赖 DID Registry 对签名做真实性校验详见 Verifiable Credential 概念文档。在这个流程中域名本身作为一个实体被签发 VC与账户 DID 建立加密关联之后创建的每个组织 Olares ID 都挂在这条“域名—DID”信任链之下。验证成功之后创建组织与 Olares ID域名验证完成后下一步是在 LarePass 中为该域名创建组织和 Olares ID对应原文档的 Whats next 一节完整指引见 创建组织账户。关键操作与约束如下引自 可复用内容块在 LarePass 的账户创建页进入右上角的Advanced account creation高级账户创建页面。选择Organization Olares IDCreate a new organization已验证的域名会自动出现在列表中点击域名后输入 Olares ID 的用户名。例如输入alex2026则管理员的 Olares ID 为alex2026space.n1.monster。点击Confirm创建的 Olares ID 默认拥有该域名下的管理员权限可管理此域名下的用户。两个必须牢记的命名规则与不可逆约束用户名Olares ID 中之前的用户名部分应为8-24 个字符且仅包含小写字母和数字该规则同时见于 Olares ID 概念文档。不可移除一旦为某个域名创建了组织该域名无法再从 Olares Space 移除。设备约束安装激活环节需要使用新设备或已恢复出厂设置的设备——已用其他 Olares ID 激活的设备无法就地切换到自定义域名的 Olares ID见 端到端教程的告警。组织创建后管理员可以在 Domain management 页面为组织添加成员例如用户名alice把用户名和一次性密码交给成员成员在 LarePass 中通过Join an existing organization输入alicespace.n1.monster加密码加入一次性密码仅用于创建 Olares ID 时验证身份。成员管理添加/移除用户的完整操作见 管理域名成员。如果你希望看到包含 DID 创建、Olares 安装激活export PREINSTALL1 curl -sSfL https://olares.sh | bash -的预备安装、LarePass 发现设备、反向代理节点选择等步骤和成员加入在内的完整端到端演练请直接参考 为你的 Olares 设置自定义域名设备激活阶段还可参考 安装 Olares 与 加入已有 Olares。仓库中的相关实现CLI 侧的域名管理命令除 Olares Space 的组织域名外仓库源码中还能看到同一主题在另一层面的落地——已激活 Olares 实例内按应用入口entrance粒度的自定义域名管理可作为对照理解两者的分工cli/cmd/ctl/settings/apps/domain.go 实现了olares-cli settings apps domain get|set|finish app entrance管理GET/POST /api/applications/app/entrance/setup/domain端点。源码注释明确区分了两条流水线third-level domainUI 中的 “custom route ID”设置即完成、无需 DNS 操作third-party domain 则需要 PEM 证书 RSA 私钥、CNAME 指向cname_target、调用domain finish后再轮询cname_status直至active。这与本文的“组织域名”是不同层次前者面向单个应用入口后者面向整个组织的域名体系。cli/cmd/ctl/doctor/thirdleveldomain.go 提供了olares-cli doctor thirdleveldomain只读审计命令检查各用户区内Application.spec.settings.customDomain.third_level_domain的冲突同一前缀被多个 app/entrance 重复使用、或使用了保留前缀auth/desktop/wizard并支持--force-dedupe修复会写回 Application CR需先审阅再执行。入口元数据可通过 cli/cmd/ctl/settings/apps/entrances.go 的olares-cli settings apps entrances list app查询获取domain子命令所需的app与entrance参数。这些命令与本文的 Olares Space 组织域名流程互补先在 Space 完成 TXT/NS 验证拿到组织域名实例激活后如需为具体应用入口配置独立域名或子域前缀再使用 CLI 侧的命令。常见问题与注意事项能否直接给已激活的设备换域名不能。已用其他 Olares ID 激活的设备无法就地切换需要先 恢复出厂设置 再从头走自定义域名流程。主域名和子域名的区别使用主域名会让全部 DNS 管理权转移到 Olares Space 且不迁移现有记录强烈建议使用app.yourdomain.com形式的子域名。验证通过后还能改 NS 记录吗不能任何修改都会导致自定义域名解析失败。用户名长度有限制吗有。用户名部分必须为 8-24 个字符的小写字母数字组合组织域名本身为 2-24 个字符。域名状态长期停在某一阶段怎么办按上文状态流转表定位卡点Awaiting NS record configuration说明 NS 记录未生效确认两条记录的值与名称都正确Awaiting the application for the Domains Verifiable Credential说明还差 LarePass 侧的组织创建动作。小结Olares 自定义域名的核心流程可以概括为DID 阶段账户 → Olares Space 添加子域名 → TXT 记录验证所有权 → NS 记录委托解析 → 域名 VC 申请 → LarePass 创建组织与管理员 Olares ID → 域名进入 Allocated 状态并管理成员。理解了 TXT/NS/VC 三个环节各自解决的信任问题所有权、解析委托、身份凭证签发你就能正确处理验证过程中的各种状态卡点并安全地为团队成员分配形如alicespace.n1.monster的组织 Olares ID。赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐TerminusOlares自定义域名实战DID、组织与 DNS 验证全流程TerminusOlares自定义域名实战DID、组织与 DNS 验证全流程 本文基于 Terminus 仓库的官方最佳实践文档完整讲解如何为你的 Ol云原生后端运维Olares 自定义域名组织账号创建指南从 DID 到组织级 Olares ID 的完整实操Olares 自定义域名组织账号创建指南从 DID 到组织级 Olares ID 的完整实操 在 Olares 中自定义域名由「组织」统一管理域名所有者先云原生后端运维Olares 应用入口级配置指南用 olares-cli 管理自定义域名、访问策略与认证级别Olares 应用入口级配置指南用 olares cli 管理自定义域名、访问策略与认证级别 本指南讲解 Olares 中应用入口entrance级别云原生后端运维上一篇从0到1掌握React-Redux-Firebase2025年前端数据管理新范式下一篇探索 ZeroBrane Studio一款轻量级的 Lua 开发环境创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考