服务市场
部署 Logto

部署 Logto

Logto (opens in a new tab) 是一个开源的身份验证服务,可以帮助你在你的应用程序中快速实现身份验证,同时也是最著名的 Auth0 (opens in a new tab) 开源替代品。

本文将教你如何在 Zeabur 上轻松部署一个 Logto 服务,并且绑定自己的域名,让你的其他网站能夠用自己部署的 Logto 服务来验证身份。

步骤一:建立项目

首先,我们需要先在 Zeabur 上建立一个项目,请前往 项目列表 (opens in a new tab) 页面,你会看到你的所有项目,而「建立项目」按钮就在所有项目的最后面。

步骤二:部署 PostgreSQL 服务

Logto 会将用户身份数据存储在 PostgreSQL 数据库中,请点击「建立服务」并选择 Prebuilt ,你将在列表中找到 PostgreSQL。

Deploy PostgreSQL

选择了 PostgreSQL 后,你的 PostgreSQL 服务将会自动部署。

步骤三:建立数据库

为了让 Logto 服务能够正常运行,我们需要先在 PostgreSQL 数据库中建立一个名为 logto 的数据库。

方法一:在控制台中建立

通常情况下,你需要一个 PostgreSQL 客户端来连接 PostgreSQL 服务并建立数据库。但是 Zeabur 提供了一个方便的方法来建立数据库。

在你的 PostgreSQL 服务中,你可以找到一个名为 Database 的选项卡,你可以在这里轻松管理你的数据库。

Database Tab

Logto 服务 需要一个名为 logto 的数据库,所以我们需要建立一个名为 logto 的数据库。

方法二:使用 PostgreSQL 客户端

你也可以使用 PostgreSQL 客户端来建立数据库。在本文中,我们使用 psql (opens in a new tab) 来连接。

PostgreSQL Instructions

你可以在 Zeabur 控制台中 PostgreSQL 服务的 Instruction 选项卡中找到相应的 psql 连接命令或其他连接信息。

psql postgresql://root:password@infra.zeabur.com:12345

接下来,请在 psql 中输入以下命令来建立 logto 数据库:

CREATE DATABASE logto;

步骤四:部署 Logto 服务

在 Zeabur 控制台中,点击「建立服务」并选择 Prebuilt ,你将在列表中找到 Logto。

Deploy Logto

在选择了 Logto 服务后,你的 Logto 服务将会自动部署。

💡

如果你先部署了 Logto 服务,然后再部署 PostgreSQL 服务,那么你需要在部署 PostgreSQL 服务并添加好数据库后重启 Logto 服务,以便 Logto 能够获取正确的数据库连接信息。

步骤五:为每个端口绑定域名

在 Zeabur 控制台中,你可以在 Logto 服务的 Domain 选项卡中为其绑定域名。这个域名可以是你自己的域名,也可以是 Zeabur 提供的免费域名。

Logto 服务有两个端口,一个是用于 web 界面的,另一个是用于管理控制台界面的。你可以在控制台中为每个端口绑定一个域名。

点击 Generate DomainCustom Domain,你将看到一个输入框和一个端口选择器,你可以在这里为每个端口绑定一个域名。

Logto domain for web

Logto domain for console

关于如何为你的服务绑定域名的更多信息,请参考 绑定域名

步骤六:设置环境变量

绑定好域名后,我们需要让 Logto 服务知道我们绑定的域名。

Logto 服务需要 2 个环境变量:

  • ENDPOINT: 你给 web 界面绑定的域名,例如 https://logto-web.zeabur.app
  • ADMIN_ENDPOINT: 你给管理控制台界面绑定的域名,例如 https://logto-console.zeabur.app

打开服务页面的 Variables 选项卡,点击 Edit Raw Variables 按钮,你可以在输入框中填写以下变量。

{
  "ENDPOINT": "https://logto-web.zeabur.app", // Your domain name for web interface
  "ADMIN_ENDPOINT": "https://logto-console.zeabur.app" // Your domain name for admin console interface
}

添加好变量后,点击 Restart 按钮并等待大约 1 分钟,服务将会重启并生效。

Step 7: Log in and Configure Logto

步骤七:登录并配置 Logto

现在你的 Logto 服务已经准备就绪,你可以登录并配置它。你可以打开你为管理控制台界面绑定的域名,例如 https://logto-console.zeabur.app,你将会看到 Logto 服务的登录页面。

Logto admin

创造一个账户并开始使用 Logto 服务,只需按照 Logto 服务给出的指示即可。