配置

环境变量

Logto 按以下顺序处理环境变量：

因此，系统环境变量将覆盖 .env 中的值。

警告

如果你在项目根目录通过 npm start 运行日志 (Logto)，NODE_ENV 将始终为 production。

在默认值中，protocol 将根据你的 HTTPS 配置为 http 或 https。

Key	Default Value	Type	Description
NODE_ENV	`undefined`	`'production' \| 'test' \| undefined`	Logto 运行的环境类型。
PORT	`3001`	`number`	Logto 监听的本地端口。
ADMIN_PORT	`3002`	`number`	Logto 管理控制台监听的本地端口。
ADMIN_DISABLE_LOCALHOST	N/A	`string \| boolean \| number`	将其设置为 `1` 或 `true` 以禁用管理控制台的端口。如果未设置 `ADMIN_ENDPOINT`，它将完全禁用管理控制台。
DB_URL	N/A	`string`	Logto 数据库的 Postgres DSN。
HTTPS_CERT_PATH	`undefined`	`string \| undefined`	详情请参见启用 HTTPS。
HTTPS_KEY_PATH	`undefined`	`string \| undefined`	同上。
TRUST_PROXY_HEADER	`false`	`boolean`	同上。
ENDPOINT	`'protocol://localhost:$PORT'`	`string`	你可以为在线测试或生产指定一个带有自定义域名的 URL。这也会影响 OIDC 发行者标识符的值。
ADMIN_ENDPOINT	`'protocol://localhost:$ADMIN_PORT'`	`string`	你可以为生产指定一个带有自定义域名的 URL（例如 `ADMIN_ENDPOINT=https://admin.domain.com`）。这也会影响管理控制台重定向 URI 的值。
CASE_SENSITIVE_USERNAME	`true`	`boolean`	指定用户名是否区分大小写。修改此值时请谨慎；更改不会自动调整现有数据库数据，需要手动管理。

Node 原生支持 HTTPS。提供 BOTH HTTPS_CERT_PATH 和 HTTPS_KEY_PATH 以通过 Node 启用 HTTPS。

HTTPS_CERT_PATH 表示你的 HTTPS 证书的路径，而 HTTPS_KEY_PATH 表示你的 HTTPS 密钥的路径。

另一种常见做法是在 Node 前面设置一个 HTTPS 代理（例如 Nginx）。

在这种情况下，你可能希望将 TRUST_PROXY_HEADER 设置为 true，这表示是否应信任代理头字段。 Logto 将把该值传递给 Koa 应用程序设置。

有关何时配置此字段的信息，请参见信任 TLS 卸载代理。

管理过多的环境变量既不高效也不灵活，因此我们的大多数通用配置都存储在数据库表 logto_configs 中。

该表是一个简单的键值存储，键可枚举如下：

Key	Type	Description
oidc.cookieKeys	`string[]`	签名 cookie 密钥的字符串数组。
oidc.privateKeys	`string[]`	用于 OIDC JWT 签名的私钥内容字符串数组。