開始使用 OSS
GitPod
要啟動 Logto 的線上 GitPod 工作區，點擊這裡。稍等片刻，你會看到如下訊息：
Logto 預設使用埠 3001 作為核心服務，埠 3002 作為互動式管理控制台。
要繼續你的 Logto 旅程，按下 Ctrl（或 Cmd）並點擊以 https://3002-... 開頭的連結。享受吧！
本地
託管 Logto 的最低建議硬體要求為：
- vCPU：2
- 記憶體：8 GiB
- 磁碟：256 GiB
- Docker Compose
- Docker
- npm-init
Docker Compose CLI 通常隨 Docker Desktop 一同提供。
不要在生產環境中使用我們的 docker compose 指令！由於我們目前將內建的 Postgres 資料庫與 Logto 應用程式一起打包在 docker-compose.yml 中，每次重新執行指令時都會創建一個新的資料庫實例，之前保存的任何資料都將丟失。
curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | docker compose -p logto -f - up
成功組合後，你會看到如下訊息：
步驟 1
準備一個 PostgreSQL@^14.0 實例，並使用 Logto CLI 為 Logto 初始化資料庫：
- CLI
- npx
logto db seed
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。
最後，你會看到如下訊息：
先決條件
- 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，請查看 核心服務。
託管提供商
這些可靠的託管提供商提供 Logto 的一鍵安裝模板。通過易於部署的服務，你可以在幾秒鐘內使用 Logto 設置並啟動你的 CIAM 系統。
具有免費開發租戶的具成本效益的雲服務，便於驗證 (Authentication) 集成。
一個可自託管的 Heroku/Netlify 替代方案，便於應用程式和資料庫管理。
輕量級工具，用於在自己的基礎設施上部署應用程式。
一個現代化的控制面板，用於管理帶有 Docker 的雲伺服器。
完全管理的 DevOps 平台，用於部署你的代碼和開源軟體。
簡化應用程式部署和基礎設施管理。
簡化應用程式部署、擴展和監控，適合開發者。
請注意，我們不提供第三方服務提供商的客戶支持。如需訪問我們的支持渠道，請在 Logto Cloud 上部署。謝謝！
創建帳戶
當你成功在伺服器上託管 Logto 後，點擊歡迎頁面上的「創建帳戶」。請記住，Logto 的開源版本僅允許在初次啟動時創建一個帳戶，且不支持多帳戶。帳戶創建過程僅限於用戶名和密碼組合。