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

GitPod

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

Logto ใช้พอร์ต 3001 สำหรับบริการหลัก และพอร์ต 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 ของคุณ

รัน 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

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

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

เคล็ดลับ:

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

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

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