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

GitPod

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

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

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

Local

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

• vCPU: 2
• หน่วยความจำ: 8 GiB
• ดิสก์: 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 # แทนที่ด้วย Postgres DSN ของคุณ
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 ^18.12.0
• PostgreSQL ^14.0

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

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

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

ในเทอร์มินัลของคุณ:

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 ส่งอาร์กิวเมนต์ไป

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

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" ที่หน้าต้อนรับ โปรดทราบว่าเวอร์ชันโอเพ่นซอร์สของ Logto อนุญาตให้สร้างบัญชีได้เพียงหนึ่งบัญชีในช่วงเปิดใช้งานครั้งแรก และไม่รองรับหลายบัญชี กระบวนการสร้างบัญชีจำกัดเฉพาะการใช้ชื่อผู้ใช้และรหัสผ่านเท่านั้น

เคล็ดลับ:

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

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

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

แหล่งข้อมูลดี ๆ จากคอมมูนิตี้ Logto