开始使用 OSS

GitPod

要启动 Logto 的在线 GitPod 工作区，点击这里。稍等片刻，你会看到如下信息：

Logto 默认使用端口 3001 作为其核心服务，端口 3002 用于交互式管理控制台。

要继续你的 Logto 之旅，按下 Ctrl（或 Cmd）并点击以 https://3002-... 开头的链接。享受吧！

本地

托管 Logto 的最低推荐硬件要求是：

• vCPU: 2
• 内存: 8 GiB
• 磁盘: 256 GiB

Docker Compose

Docker Compose CLI 通常随 Docker Desktop 一起提供。

警告:

不要在生产环境中使用我们的 docker compose 命令！由于我们目前在 docker-compose.yml 中将内置的 Postgres 数据库与 Logto 应用程序捆绑在一起，每次重新执行命令时都会创建一个新的数据库实例，之前持久化的任何数据都会丢失。

curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | docker compose -p logto -f - up

成功组合后，你会看到如下信息：

Docker

步骤 1

准备一个 PostgreSQL@^14.0 实例，并使用 Logto CLI 为 Logto 种子数据库：

CLI

logto db seed

npx

npx @logto/cli db seed

步骤 2

拉取镜像：

# ghcr
docker pull ghcr.io/logto-io/logto:latest
# DockerHub
docker pull svhd/logto:latest

步骤 3

将容器端口映射到 Logto 核心和管理应用程序，例如，3001:3001 和 3002:3002；并将以下环境变量设置到容器中：

TRUST_PROXY_HEADER: 1 # 如果在 Logto 前面有 HTTPS 代理（例如 Nginx），请设置为 1
ENDPOINT: https://<your-logto-domain> # （可选）如果使用自定义域，请替换为你的 Logto 端点 URL
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # （可选）如果使用自定义域，请替换为你的 Logto 管理 URL
DB_URL: postgres://username:password@your_postgres_url:port/db_name # 替换为你的 Postgres DSN

使用上述所有环境变量运行容器：

docker run \
  --name logto \
  -p 3001:3001 \
  -p 3002:3002 \
  -e TRUST_PROXY_HEADER=1 \
  -e ENDPOINT=https://<your-logto-domain> \
  -e ADMIN_ENDPOINT=https://<your-logto-admin-domain> \
  -e DB_URL=postgres://username:password@your_postgres_url:port/db_name \
  ghcr.io/logto-io/logto:latest

提示:

• 如果你使用 Docker Hub，请使用 svhd/logto:latest 而不是 ghcr.io/logto-io/logto:latest。
• 在 DB_URL 中使用 host.docker.internal 或 172.17.0.1 来引用主机 IP。

最后，你会看到如下信息：

npm-init

先决条件

• Node.js ^18.12.0
• PostgreSQL ^14.0

更高版本通常可以工作，但不保证。

我们建议使用一个新的空数据库专用于 Logto，尽管这不是硬性要求。

下载并启动

在你的终端中：

npm init @logto@latest

一旦你完成初始化过程并启动 Logto，你会看到如下信息：

核心应用程序正在运行于 http://localhost:3001
核心应用程序正在运行于 https://your-domain-url
管理应用程序正在运行于 http://localhost:3002
管理应用程序正在运行于 https://your-admin-domain-url

前往 http://localhost:3002/ 继续你的 Logto 之旅。享受吧！

使用备用 URL 下载

如果你想为 Logto zip 文件指定一个 URL，请使用 --download-url 选项。例如：

npm init @logto@latest -- --download-url=https://github.com/logto-io/logto/releases/download/v1.2.2/logto.tar.gz

注意需要额外的 -- 以便 NPM 传递参数。

配置（可选）

Logto 使用环境变量进行配置，并支持 .env 文件。有关详细用法和完整变量列表，请参阅 配置。

查看 核心服务 以获取更高级的控制或对 Logto 的编程访问。

托管服务提供商

这些可靠的托管服务提供商提供 Logto 的一键安装模板。通过易于部署的服务，你可以在几秒钟内使用 Logto 设置并启动你的 CIAM 系统。

Logto Cloud

一种具有免费开发租户的经济高效的云服务，便于集成认证 (Authentication)。

Coolify

一个可自托管的 Heroku/Netlify 替代方案，便于应用程序和数据库管理。

Dokploy

用于在你自己的基础设施上部署应用程序的轻量级工具。

Easypanel

一个用于管理带有 Docker 的云服务器的现代控制面板。

Elestio

完全托管的 DevOps 平台，用于部署你的代码和开源软件。

Railway

简化应用程序部署和基础设施管理。

Zeabur

简化应用程序部署、扩展和监控，为开发者提供便利。

请注意，我们不为第三方服务提供商提供客户支持。要访问我们的支持渠道，请在 Logto Cloud 上部署。谢谢！

创建账户

一旦你成功在服务器上托管了 Logto，请在欢迎页面上点击“创建账户”。请记住，Logto 的开源版本仅允许在初次启动时创建一个账户，并且不支持多个账户。账户创建过程仅限于用户名和密码组合。

相关资源

处理本地 HTTPS 开发