为 Olares 设置自定义域名

默认情况下，在 LarePass 中创建账户时，系统会分配一个 olares.cn 域名的 Olares ID。这意味着你通过类似 desktop.{your-username}.olares.cn 的 URL 访问 Olares 服务。如果你希望使用自己的域名，可以按照本教程完成配置。

学习目标

通过本教程，你将学习：

• 在 Olares Space 中添加并验证自定义域名
• 在 LarePass 中创建组织和域名下的 Olares ID
• 使用自定义域名安装并激活 Olares
• 在 Olares Space 中为组织添加成员

自定义域名工作原理

在 Olares 中，自定义域名通过组织进行管理。无论你是个人用户还是代表公司，都需要先创建一个组织。所需操作取决于你的角色：

步骤	组织管理员	组织成员
在 LarePass 中创建 DID	✅	✅
将自定义域名添加到 Olares Space	✅
为域名创建组织，并以管理员身份 在 LarePass 中创建 Olares ID	✅
在 Olares Space 中为组织添加新用户	✅
加入组织，并在 LarePass 中创建 Olares ID		✅
安装 Olares	✅	✅

如果你要加入已有组织，可以直接跳到以成员身份加入组织。

前提条件

请确保你已准备好：

• 从域名注册商购买了一个有效的域名。
• 在手机上安装了 LarePass 应用。你将使用 LarePass 登录 Olares Space，并将自定义域名与 Olares ID 关联。

INFO

如果你之前已在设备上安装并激活过 Olares，并且想在同一硬件上使用自定义域名，请先恢复出厂设置，然后创建新账户，再按照本教程操作。

第 1 步：创建 DID

DID（去中心化标识符）是获取最终 Olares ID 之前的临时账户状态。只有在 DID 阶段，才能将自定义域名与账户关联。创建步骤如下：

1. 在 LarePass 应用中，打开账户创建页面。

2. 点击创建账户。

   

   此操作将创建一个处于 DID 阶段的 Olares 账户。在切换账户页面，该账户显示为"未关联 Olares ID"，标识符类似 did:key:xxxx。

   

第 2 步：添加域名

以下步骤以 space.n1.monster 为例。

1. 在浏览器中打开 Olares Space，使用 LarePass 扫码登录。

   

2. 在 Olares Space 中，进入域名管理页面，点击域名设置。

   

3. 在弹出的对话框中输入一个有效的子域名，然后点击确认。

   不要使用主域名

   使用 yourdomain.com 这样的主域名会将所有 DNS 管理迁移到 Olares Space，且不会自动迁移已有的 DNS 记录。 请使用 app.yourdomain.com 这样的子域名。

4. 添加并验证 TXT 记录，以证明域名所有权。

   a. 在操作列中点击引导。 b. 在你的 DNS 服务商设置中，按照对话框中提供的名称和值添加一条 TXT 记录。

   

   验证通过后，状态会更新为等待添加域名 NS 记录。

5. 验证域名的 NS（Name Server）记录。此操作将域名的 DNS 解析委托给 Olares 的 Cloudflare。

   a. 在操作列中点击引导。

   b. 在你的 DNS 服务商设置中，按照对话框中提供的值为子域名添加两条 NS 记录。

   

   验证通过后，域名状态将更新为等待为域名申请可验证凭证。

   WARNING

   验证成功后，请勿修改 NS 记录。否则会导致自定义域名解析失败，无法正常访问。

TXT 和 NS 记录验证通过后，可以在 LarePass 中创建组织。

第 3 步：创建组织

在 LarePass 中，为你的域名创建组织并获得管理员权限的 Olares ID。

1. 在手机上打开 LarePass，在账户创建页面点击右上角的 display_settings，进入高级账户创建页面。

2. 前往组织 Olares ID > 创建新组织。已验证的域名会自动显示在列表中。

   

   

3. 点击域名。

   WARNING

   为域名创建组织后，该域名将无法从 Olares Space 中移除。

4. 输入 Olares ID 的用户名部分。例如输入 alex，则 Olares ID 为 [email protected]。

   INFO

   用户名部分应为 1-63 个字符，仅支持小写字母和数字。

   

5. 点击确认。

   

   Olares ID 已创建，并拥有管理该域名下用户的管理员权限。

6. 点击下一步，进入 Olares 激活页面。

第 4 步：安装并激活 Olares

现在可以使用你的 Olares ID 安装并激活 Olares 了。

安装步骤与标准流程类似。以下以 Linux 为例，其他系统请参阅安装指南。

检查网络连接

为避免激活失败，请确保你的手机和 Olares 设备连接到同一网络。

1. 在要安装 Olares 的设备上打开终端，运行以下命令：

   export PREINSTALL=1 &&
   curl -sSfL https://cn.olares.sh | bash -

   此命令仅执行预安装阶段，不会进入完整安装流程。

2. 打开 LarePass，在账号激活页面点击发现附近的 Olares。LarePass 将列出同一网络中检测到的 Olares 实例。

3. 从列表中选择目标 Olares 实例，并点击立即安装。

   

4. 安装完成后，点击立即激活。

激活完成后，LarePass 将显示带有自定义域名的 Olares 桌面地址，如 https://desktop.alex.space.n1.monster。

第 5 步：添加成员

作为管理员，在 Olares Space 中为组织添加成员。

1. 在 Olares Space 中刷新域名管理页面，域名状态已更新为已分配。

2. 在操作列中点击查看。

3. 点击添加新用户，输入成员的用户名（自定义域名前面的部分）。例如 alice。

   

4. 点击提交。

   

5. （可选）重复步骤 2 和 3 添加更多用户。

6. 将用户名和密码提供给成员。

   成员将使用这些凭据在 LarePass 中创建自己的 Olares ID。

7. （可选）如果成员将使用你现有的 Olares 实例而非单独安装设备，你还需要在 Olares 上创建该用户并分配资源。详见管理团队。

以成员身份加入组织

在 LarePass 应用中，点击创建账户开始账户创建流程。

1. 在账户创建页面，点击右上角的 display_settings，进入高级账户创建页面。

   

2. 前往组织 Olares ID > 加入已有组织。

3. 输入带域名的用户名（如 [email protected]）和管理员提供的密码。

   一次性密码

   此密码为一次性密码，用于创建 Olares ID 时验证你的身份。

   

4. 点击继续。

自定义域名的 Olares ID 创建完成。下一步是激活 Olares：

• 在单独的设备上安装：按照第 4 步操作。
• 在与管理员相同的设备上：从管理员处获取激活向导地址和一次性密码，然后在 LarePass 中扫描向导二维码完成激活。详见激活 Olares。

了解更多

• Olares 账户：DID、Olares ID 和组织的工作原理。
• 安装 Olares：不同平台和环境的安装方式。
• 管理团队：在 Olares 实例中创建和管理用户账户。