คู่มือการติดตั้ง

คู่มือนี้จะแนะนำคุณผ่านการติดตั้ง Suthep บนระบบของคุณ

ความต้องการของระบบ

ก่อนติดตั้ง Suthep ตรวจสอบว่าระบบของคุณตรงตามความต้องการเหล่านี้:

• Node.js เวอร์ชัน 16 หรือสูงกว่า
• npm, yarn, หรือ pnpm package manager
• สิทธิ์ sudo/administrator (จำเป็นสำหรับการตั้งค่า Nginx และ Certbot)
• ระบบปฏิบัติการ Linux หรือ macOS

การติดตั้ง Suthep

Suthep สามารถติดตั้งแบบ global โดยใช้ package manager ของ Node.js ใดก็ได้

ใช้ npm

npm install -g suthep

ใช้ yarn

yarn global add suthep

ใช้ pnpm

pnpm add -g suthep

ตรวจสอบการติดตั้ง

หลังจากติดตั้ง ตรวจสอบว่า Suthep ติดตั้งถูกต้อง:

suthep --version

คุณควรเห็นหมายเลขเวอร์ชัน (เช่น 1.1.1)

คุณยังสามารถตรวจสอบเมนูช่วยเหลือ:

suthep --help

การติดตั้งสิ่งที่จำเป็น

Suthep ต้องการ Nginx และ Certbot เพื่อทำงาน คุณสามารถติดตั้งสิ่งเหล่านี้โดยอัตโนมัติโดยใช้คำสั่ง setup:

suthep setup

คำสั่งนี้จะ:

• ติดตั้ง Nginx (หากยังไม่ได้ติดตั้ง)
• ติดตั้ง Certbot (หากยังไม่ได้ติดตั้ง)
• ตั้งค่าการพึ่งพาระบบ

การติดตั้งด้วยตนเอง (ไม่บังคับ)

หากคุณต้องการติดตั้งสิ่งที่จำเป็นด้วยตนเอง:

การติดตั้ง Nginx

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y nginx

CentOS/RHEL:

sudo yum install -y nginx

macOS:

brew install nginx

การติดตั้ง Certbot

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y certbot python3-certbot-nginx

CentOS/RHEL:

sudo yum install -y certbot python3-certbot-nginx

macOS:

brew install certbot

Docker (ไม่บังคับ)

หากคุณวางแผนจะ deploy Docker containers ติดตั้ง Docker:

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

macOS:

brew install docker

หรือดาวน์โหลด Docker Desktop จาก docker.com

หลังการติดตั้ง

หลังจากติดตั้ง คุณพร้อมที่จะ:

1. เริ่มต้นการตั้งค่าแรก:

   suthep init

2. หรือไปต่อที่คู่มือเริ่มต้นใช้งาน: ดู คู่มือเริ่มต้นใช้งาน

การแก้ปัญหาการติดตั้ง

Command Not Found

หากคุณได้รับข้อผิดพลาด "command not found":

1. ตรวจสอบการติดตั้ง Node.js:

   node --version
   npm --version

2. ตรวจสอบ global bin path:

   npm config get prefix

3. เพิ่ม npm global bin ไปที่ PATH (หากจำเป็น):

   export PATH="$PATH:$(npm config get prefix)/bin"

ข้อผิดพลาดสิทธิ์

หากคุณพบข้อผิดพลาดสิทธิ์:

1. ใช้ sudo สำหรับการติดตั้งแบบ global:

   sudo npm install -g suthep

2. หรือตั้งค่า npm ให้ใช้ไดเรกทอรีอื่น:

   mkdir ~/.npm-global
   npm config set prefix '~/.npm-global'
   export PATH=~/.npm-global/bin:$PATH

ปัญหาการติดตั้ง Nginx/Certbot

หาก suthep setup ล้มเหลว:

1. ตรวจสอบ package manager ของคุณ:

   • Ubuntu/Debian: ตรวจสอบว่า apt-get พร้อมใช้งาน
   • CentOS/RHEL: ตรวจสอบว่า yum พร้อมใช้งาน
   • macOS: ตรวจสอบว่า Homebrew ติดตั้งแล้ว

2. ลองติดตั้งแยกส่วน:

   # ลองติดตั้งเฉพาะ Nginx ก่อน
   suthep setup --nginx-only
   
   # จากนั้นติดตั้ง Certbot
   suthep setup --certbot-only

3. ติดตั้งสิ่งที่จำเป็นด้วยตนเอง (ดูการติดตั้งด้วยตนเองด้านบน)

ขั้นตอนถัดไป

ตอนนี้ Suthep ติดตั้งแล้ว:

• คู่มือเริ่มต้นใช้งาน - Deploy บริการแรกของคุณ
• คู่มือการตั้งค่า - เรียนรู้เกี่ยวกับตัวเลือกการตั้งค่า

ก่อนหน้า: บทนำ | ถัดไป: เริ่มต้นใช้งาน →