เริ่มต้นใช้งาน OSS

GitPod

หากต้องการเริ่มต้น workspace ออนไลน์ของ GitPod สำหรับ Logto คลิกที่นี่ รอสักครู่ คุณจะเห็นข้อความประมาณว่า:

Logto ใช้พอร์ต 3001 สำหรับ core service และพอร์ต 3002 สำหรับ Admin Console แบบโต้ตอบโดยปริยาย

เพื่อดำเนินการต่อกับ Logto ของคุณ ให้กด Ctrl (หรือ Cmd) และคลิกลิงก์ที่ขึ้นต้นด้วย https://3002-... ขอให้สนุก!

Local

ข้อกำหนดฮาร์ดแวร์ขั้นต่ำที่แนะนำสำหรับการโฮสต์ Logto ได้แก่:

• vCPU: 2
• Memory: 8 GiB
• Disk: 256 GiB

Docker Compose

Docker Compose CLI มักจะมาพร้อมกับ Docker Desktop

ข้อควรระวัง:

ห้ามใช้คำสั่ง docker compose ของเราใน production! เนื่องจากขณะนี้เรามีฐานข้อมูล Postgres ที่รวมมากับแอป Logto ใน docker-compose.yml ทุกครั้งที่คุณรันคำสั่งนี้ใหม่ อินสแตนซ์ฐานข้อมูลใหม่จะถูกสร้างขึ้น และข้อมูลเดิมทั้งหมดจะหายไป

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

หลังจาก compose สำเร็จ คุณจะเห็นข้อความประมาณว่า:

Docker

ขั้นตอนที่ 1

เตรียมอินสแตนซ์ PostgreSQL@^14.0 และใช้ Logto CLI เพื่อ seed ฐานข้อมูลสำหรับ 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

แมปพอร์ตของ container ไปยัง Logto core และ admin app เช่น 3001:3001 และ 3002:3002 และตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้ให้กับ container:

TRUST_PROXY_HEADER: 1 # ตั้งค่าเป็น 1 หากคุณมี HTTPS proxy (เช่น Nginx) อยู่หน้า Logto
ENDPOINT: https://<your-logto-domain> # (ไม่บังคับ) แทนที่ด้วย URL endpoint ของ Logto หากใช้ custom domain
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (ไม่บังคับ) แทนที่ด้วย URL admin ของ Logto หากใช้ custom domain
DB_URL: postgres://username:password@your_postgres_url:port/db_name # แทนที่ด้วย DSN ของ Postgres ของคุณ
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) ปิด statement_timeout สำหรับ PgBouncer/RDS Proxy

รัน container พร้อมตัวแปรสภาพแวดล้อมที่จำเป็นข้างต้น (ตัวเลือกที่ไม่บังคับถูกละไว้ด้านล่าง; เพิ่มตามต้องการ):

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
• ใช้ host.docker.internal หรือ 172.17.0.1 ใน DB_URL เพื่ออ้างถึง IP ของ host
• หากคุณใช้ PgBouncer หรือ RDS Proxy แล้วพบ unsupported startup parameter: statement_timeout ให้ตั้งค่า DATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT (v1.36.0+)

สุดท้าย คุณจะเห็นข้อความประมาณว่า:

npm-init

ข้อกำหนดเบื้องต้น

• Node.js ^22.14.0
• PostgreSQL ^14.0

เวอร์ชันที่สูงกว่ามักจะใช้ได้แต่ไม่รับประกัน

แนะนำให้ใช้ฐานข้อมูลใหม่ว่างเปล่าที่จัดเตรียมไว้สำหรับ Logto โดยเฉพาะ แม้จะไม่ใช่ข้อบังคับ

ดาวน์โหลดและเริ่มต้น

ใน terminal ของคุณ:

npm init @logto@latest

เมื่อคุณดำเนินการ init เสร็จและเริ่ม Logto แล้ว คุณจะเห็นข้อความประมาณว่า:

Core app is running at http://localhost:3001
Core app is running at https://your-domain-url
Admin app is running at http://localhost:3002
Admin app is running at https://your-admin-domain-url

ไปที่ http://localhost:3002/ เพื่อดำเนินการ Logto ของคุณต่อ ขอให้สนุก!

การใช้ URL ทางเลือกสำหรับดาวน์โหลด

หากคุณต้องการระบุ URL สำหรับไฟล์ zip ของ Logto ให้ใช้ตัวเลือก --download-url ตัวอย่างเช่น:

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

โปรดสังเกตว่าต้องมี -- เพิ่มเติมสำหรับ NPM เพื่อส่งต่อ arguments

การตั้งค่า (ไม่บังคับ)

Logto ใช้ตัวแปรสภาพแวดล้อมสำหรับการตั้งค่า พร้อมรองรับไฟล์ .env ดู การตั้งค่า สำหรับรายละเอียดการใช้งานและรายการตัวแปรทั้งหมด

ดู Core service หากคุณต้องการควบคุมขั้นสูงหรือเข้าถึง Logto แบบโปรแกรม

ผู้ให้บริการโฮสติ้ง

ผู้ให้บริการโฮสติ้งที่เชื่อถือได้เหล่านี้มีเทมเพลตติดตั้ง Logto แบบคลิกเดียว ด้วยบริการที่พร้อมใช้งาน คุณสามารถตั้งค่าและเปิดใช้งานระบบ CIAM ของคุณด้วย Logto ได้ในไม่กี่วินาที

Logto Cloud

บริการคลาวด์ราคาประหยัดพร้อม dev tenant ฟรี สำหรับการผสานการยืนยันตัวตนอย่างง่าย

Coolify

ทางเลือก Heroku/Netlify แบบ self-host สำหรับจัดการแอปและฐานข้อมูลอย่างง่าย

Dokploy

เครื่องมือขนาดเล็กสำหรับดีพลอยแอปบนโครงสร้างพื้นฐานของคุณเอง

Easypanel

แผงควบคุมสมัยใหม่สำหรับจัดการ cloud server ด้วย Docker

Elestio

แพลตฟอร์ม DevOps แบบจัดการเต็มรูปแบบสำหรับดีพลอยโค้ดและซอฟต์แวร์โอเพ่นซอร์สของคุณ

Railway

ช่วยให้การดีพลอยแอปและจัดการโครงสร้างพื้นฐานเป็นเรื่องง่าย

Zeabur

ช่วยให้นักพัฒนาดีพลอย ขยาย และมอนิเตอร์แอปได้ง่าย

โปรดทราบว่าเราไม่ให้บริการสนับสนุนลูกค้าสำหรับผู้ให้บริการภายนอก หากต้องการเข้าถึงช่องทางสนับสนุนของเรา กรุณาดีพลอยบน Logto Cloud ขอบคุณ!

สร้างบัญชี

เมื่อคุณโฮสต์ Logto บนเซิร์ฟเวอร์ของคุณสำเร็จแล้ว ให้คลิก "Create account" บนหน้า welcome โปรดทราบว่า welcome page อนุญาตให้สร้างบัญชีได้เพียงหนึ่งครั้งในช่วงเปิดใช้งานครั้งแรก และขั้นตอนการสร้างบัญชีจำกัดเฉพาะการใช้ username และ password เท่านั้น

เคล็ดลับ:

โดยปกติ Logto OSS (self-hosted) ไม่รองรับการตั้งค่าผู้ดูแลระบบหลายคน หากต้องการเชิญสมาชิกเพิ่มใน Console ให้ติดตั้ง ไลเซนส์ self-hosted และจัดการสมาชิกใน Tenant Settings > Members หรือใช้ Logto Cloud ซึ่งมีฟีเจอร์จัดการทีมครบถ้วน

แหล่งข้อมูลที่เกี่ยวข้อง

การพัฒนา HTTPS ในเครื่อง

แหล่งข้อมูลดีๆ จากชุมชน Logto