SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีติดตั้ง ERPNext บน VPS ด้วย Docker แบบละเอียด

เรียนรู้วิธีติดตั้ง ERPNext บน VPS ด้วย Docker Compose อย่างถูกต้อง ครอบคลุมการจัดการ 11 คอนเทนเนอร์ การตั้งค่า TLS การส่งอีเมล และการสำรองข้อมูลที่กู้คืนได้จริง

สิ่งที่คุณกำลังจะติดตั้งและใช้งาน

การ self-host ERPNext บน VPS เป็นงานด้านปฏิบัติการ (operations) ไม่ใช่การติดตั้งด้วยคำสั่งเดียว Docker Compose stack อย่างเป็นทางการประกอบด้วยคอนเทนเนอร์ 11 รายการ และเป็นที่เก็บข้อมูลบัญชีแยกประเภททั่วไปรวมถึงบันทึกข้อมูลลูกค้าของคุณ สิ่งนี้ยกระดับมาตรฐานสำหรับทุกสิ่งที่จะกล่าวถึงต่อไปนี้: การสำรองข้อมูลจะไม่ถือว่าเป็นการสำรองข้อมูลจนกว่าคุณจะทดสอบกู้คืนได้สำเร็จ และการใช้ image tag ที่ไม่ได้ระบุเวอร์ชัน (unpinned) คือความเสี่ยงที่อาจทำให้เกิด schema migration โดยไม่คาดคิด

มีชื่อเรียกบางอย่างที่ปรากฏอยู่ตลอดคู่มือนี้ ERPNext คือแอปพลิเคชันทางธุรกิจ Frappe คือเฟรมเวิร์กภาษา Python ที่อยู่เบื้องล่าง Bench คือเครื่องมือบรรทัดคำสั่งที่ใช้จัดการไซต์ ซึ่งติดตั้งไว้ภายในคอนเทนเนอร์เรียบร้อยแล้ว ไซต์ (site) คือผู้เช่าหนึ่งราย: ประกอบด้วยฐานข้อมูล MariaDB หนึ่งชุด และไดเรกทอรีสำหรับไฟล์ที่อัปโหลดหนึ่งชุด คำสั่งเกือบทั้งหมดในที่นี้จะรัน bench ภายในคอนเทนเนอร์ backend โดยอ้างอิงกับไซต์ที่ระบุ

คู่มือนี้ใช้ repository frappe_docker ซึ่งเป็นรูปแบบการปรับใช้ที่ทางโครงการดูแลรักษา คำสั่งทั้งหมดด้านล่างได้รับการตรวจสอบกับ repository ดังกล่าวในเดือนสิงหาคม 2026 หากคุณยังใหม่กับ Docker Compose คุณสามารถศึกษา การรัน Docker Compose บน VPS ซึ่งครอบคลุมพื้นฐานที่คู่มือนี้สมมติว่าคุณทราบแล้ว

ERPNext ต้องการทรัพยากร VPS มากน้อยเพียงใด

แผนภูมิERPNext sizing starting points (guidance, not a measurement)
ข้อมูลเบื้องหลังแผนภูมินี้
[
  {
    "label": "Evaluation",
    "vcpu": 2,
    "ram_gb": 4,
    "disk_gb": 40
  },
  {
    "label": "Small production",
    "vcpu": 4,
    "ram_gb": 8,
    "disk_gb": 100
  },
  {
    "label": "Room to grow",
    "vcpu": 4,
    "ram_gb": 16,
    "disk_gb": 160
  }
]

สำหรับการประเมินผล ให้เริ่มต้นที่ 2 vCPU และ 4 GB ของ RAM นี่คือระดับสำหรับการทดสอบ ค่าเหล่านี้เป็นเพียงจุดเริ่มต้น ไม่ใช่การวัดผลจากคู่มือนี้ และปริมาณเอกสารของคุณจะเป็นตัวกำหนดจำนวนที่แท้จริง แถวสุดท้ายไม่ใช่ค่าขั้นต่ำที่ประกาศไว้ แต่เป็นการเพิ่มพื้นที่หน่วยความจำสำรองให้มากขึ้น ไม่ใช่การรับประกันว่าหน่วยความจำจะไม่เต็ม

โปรดพิจารณาแผนขนาดเล็กอย่างตรงไปตรงมา VPS ขนาด 1 GB หรือ 2 GB มีพื้นที่เหลือเพียงเล็กน้อยสำหรับคอนเทนเนอร์ที่ทำงานค้างไว้สิบรายการ รวมกับ buffer pool ของ MariaDB และ Python worker ที่กำลังสร้างรายงาน ภายใต้สภาวะหน่วยความจำไม่เพียงพอ ตัวจัดการ out of memory ของ kernel อาจหยุดการทำงานของคอนเทนเนอร์ และเมื่อใช้ docker inspect ตรวจสอบจะพบ "OOMKilled": true พร้อม exit code 137 การที่ worker ถูกหยุดทำงานกลางคันจะทำให้เอกสารที่ส่งไปมีงานเบื้องหลังที่ทำค้างไว้เพียงครึ่งเดียว

สำหรับบริษัทที่ใช้งาน ERPNext เป็นประจำทุกวัน ให้เริ่มวางแผนที่ 8 GB และ 4 vCPU พร้อมพื้นที่ SSD 100 GB จากนั้นจึงทดสอบปริมาณงานของคุณ RAM มักจะหมดก่อนเสมอ ส่วนพื้นที่ดิสก์จะเพิ่มขึ้นเร็วกว่าที่คาดไว้ เนื่องจากไฟล์แนบและไฟล์สำรองข้อมูลในเครื่องทั้งหมดจะถูกจัดเก็บไว้ใน volume เดียวกับฐานข้อมูล

คอนเทนเนอร์ทั้ง 11 รายการและหน้าที่ของแต่ละรายการ

ให้รัน docker compose ps หลังจากที่ stack ทำงานและคอนเทนเนอร์ทั้ง 10 รายการเริ่มทำงานแล้ว ส่วนอีก 1 รายการคือ configurator จะทำงานเพียงครั้งเดียวแล้วจบการทำงาน ซึ่งเป็นที่มาของจำนวนรวม 11 รายการ

  • backend รันแอปพลิเคชัน Frappe ภายใต้ gunicorn ซึ่งเป็นที่อยู่ของ bench
  • frontend คือ nginx ทำหน้าที่ให้บริการไฟล์ static และส่งคำขออื่น ๆ ทั้งหมดไปยัง backend
  • queue-short และ queue-long คือ RQ (Redis Queue) workers ทำหน้าที่รันงานเบื้องหลัง เช่น การส่งอีเมล การนำเข้าข้อมูล และการสร้างรายงาน
  • scheduler ทำหน้าที่เรียกใช้งานตามเวลาที่กำหนด รวมถึงรายงานตามตารางเวลาและเอกสารที่ทำซ้ำอัตโนมัติ
  • websocket คือกระบวนการ socket.io ที่อยู่เบื้องหลังการอัปเดตข้อมูลแบบเรียลไทม์ในเบราว์เซอร์
  • db คือ MariaDB
  • redis-cache และ redis-queue คือ Redis สองอินสแตนซ์แยกกัน โดยอินสแตนซ์หนึ่งใช้สำหรับแคชและอีกอินสแตนซ์ใช้สำหรับคิวงาน
  • proxy คือ Traefik ซึ่งถูกเพิ่มเข้ามาโดยการตั้งค่า HTTPS override ทำหน้าที่ดูแลพอร์ต 80 และ 443 รวมถึงดึงข้อมูลใบรับรอง (certificates)

การแยกส่วนประกอบเหล่านี้เป็นสิ่งที่ควรเรียนรู้ เพราะจะช่วยให้คุณทราบว่าควรตรวจสอบ log ของส่วนใด หากอีเมลค้างแสดงว่าเป็นปัญหาที่ queue worker ดังนั้น docker compose logs -f queue-short จึงเป็นคำสั่งที่ถูกต้อง หากหน้าเว็บโหลดได้แต่ไม่ยอมอัปเดตการแจ้งเตือน แสดงว่าเป็นปัญหาที่ websocket การอ่าน log ของ backend สำหรับปัญหาเหล่านี้จะทำให้เสียเวลาโดยเปล่าประโยชน์

ติดตั้งด้วยไฟล์ compose สำหรับใช้งานจริง ไม่ใช่ตัวเดโม

Repository นี้มาพร้อมกับ pwd.yml และไฟล์ README ระบุไว้อย่างชัดเจนว่า "การตั้งค่านี้มีไว้สำหรับการประเมินผลระยะสั้นเท่านั้น คุณจะไม่สามารถติดตั้งแอปพลิเคชันเพิ่มเติมในชุดนี้ได้" ให้ใช้เพื่อทดลองใช้งาน ERPNext เพียงชั่วคราวเท่านั้น ห้ามนำไปใช้รันระบบงานจริงของบริษัท

sudo apt update && sudo apt install -y git
curl -fsSL https://get.docker.com | bash
git clone https://github.com/frappe/frappe_docker
cd frappe_docker
mkdir -p ~/gitops
cp example.env ~/gitops/erpnext.env

เปิดไฟล์ ~/gitops/erpnext.env และแก้ไขค่า 4 รายการ ERPNEXT_VERSION ใช้สำหรับระบุ image tag DB_PASSWORD ถูกตั้งค่าไว้เป็น 123 ในไฟล์ตัวอย่าง SITES_RULE คือกฎการ routing ของ Traefik และ LETSENCRYPT_EMAIL คืออีเมลสำหรับบัญชี ACME เนื่องจาก Let’s Encrypt ได้ยุติการส่งอีเมลแจ้งเตือนเมื่อใบรับรองหมดอายุตั้งแต่วันที่ 4 มิถุนายน 2025 เป็นต้นไป คุณจึงต้องตรวจสอบวันหมดอายุของใบรับรองด้วยวิธีอื่นแยกต่างหาก

ERPNEXT_VERSION=v16.32.1
DB_PASSWORD=<a long random password>
SITES_RULE=Host(`erp.example.com`)
LETSENCRYPT_EMAIL=ops@example.com

จากนั้นให้เรนเดอร์ไฟล์ compose ออกมาหนึ่งไฟล์ แล้วจึงเริ่มการทำงาน

docker compose --project-name erpnext \
  --env-file ~/gitops/erpnext.env \
  -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.https.yaml \
  config > ~/gitops/erpnext.yaml

docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d
export COMPOSE_FILE="$HOME/gitops/erpnext.yaml"

คำสั่ง config จะยังไม่เริ่มการทำงานใดๆ แต่จะทำการรวมไฟล์ฐานเข้ากับไฟล์ override แล้วแสดงผลลัพธ์ที่แทนที่ตัวแปรทั้งหมดเรียบร้อยแล้ว จากนั้นคุณจึงรันไฟล์ที่เรนเดอร์ออกมานั้น ขั้นตอนนี้มีความสำคัญเพราะ stack ที่กำลังทำงานอยู่จะเป็นไฟล์เดียวที่คุณสามารถตรวจสอบได้ ทำให้ค่าไม่เปลี่ยนแปลงไปเองเมื่อมีคนแก้ไขไฟล์ env หรือเมื่อคุณ pull repository ใหม่ วิธีการรวมไฟล์ Docker Compose หลายไฟล์ อธิบายกฎการ override ไว้โดยละเอียด

การ export ค่า COMPOSE_FILE จะทำให้คำสั่งด้านล่างใช้ไฟล์ที่เรนเดอร์ออกมานี้ หากเปิด shell ใหม่ต้องรันคำสั่งนี้ซ้ำ หรือหากใช้ใน cron ให้ระบุ -f ~/gitops/erpnext.yaml ลงไปโดยตรง

รอให้ db เริ่มทำงานและ configurator ทำงานเสร็จสิ้น ซึ่งจะใช้เวลาเพียงไม่กี่วินาที จากนั้นจึงสร้างไซต์

docker compose --project-name erpnext exec backend \
  bench new-site --mariadb-user-host-login-scope=% \
  --db-root-password '<your DB_PASSWORD>' \
  --install-app erpnext \
  --admin-password '<a strong admin password>' \
  erp.example.com

ตรวจสอบผลลัพธ์:

docker compose --project-name erpnext ps
docker compose --project-name erpnext exec backend bench --site erp.example.com list-apps

list-apps ควรแสดงผล frappe และ erpnext พร้อมเวอร์ชันของแต่ละตัว หากระบบทำงานปกติ ps จะแสดง service จำนวน 10 รายการในสถานะ running และไม่มีรายการใดอยู่ในสถานะ restarting

ปัญหาที่พบบ่อยมีสองประการ ประการแรก --mariadb-user-host-login-scope=% จะกำหนดขอบเขต host ของผู้ใช้ฐานข้อมูลสำหรับไซต์ใหม่ให้เป็น wildcard เพื่อให้สามารถล็อกอินได้แม้ Docker จะเปลี่ยน IP address ของ container แอปพลิเคชัน หากไม่มีตัวเลือกนี้ Frappe จะจำกัดสิทธิ์ผู้ใช้ไว้เฉพาะ host ที่เชื่อมต่ออยู่ในขณะนั้น เนื่องจาก container แอปพลิเคชันเชื่อมต่อกับ MariaDB ผ่านเครือข่าย Docker จึงถูกมองว่าเป็น remote host และผู้ใช้ฐานข้อมูลที่ถูกจำกัดไว้ที่ localhost จะไม่สามารถล็อกอินได้ ตัวเลือกนี้จะเปลี่ยนผู้ใช้ฐานข้อมูลของไซต์ ไม่ใช่บัญชี root โดยขอบเขต % จะอนุญาตให้เชื่อมต่อจาก host ใดก็ได้ที่สามารถเข้าถึง MariaDB ดังนั้นควรเก็บฐานข้อมูลไว้ในเครือข่ายส่วนตัวของ Docker เท่านั้น

ประการที่สองคือชื่อไซต์ โดยปกติ frontend จะเลือกไซต์ที่จะให้บริการจาก HTTP Host header ดังนั้นไซต์ที่สร้างด้วยชื่อ erpnext จะไม่สามารถเข้าถึงได้ผ่าน erp.example.com แม้ว่าทั้งสองชื่อจะมีอยู่จริงก็ตาม ให้ตั้งชื่อไซต์ตามชื่อโดเมนดังตัวอย่างด้านบน หรือกำหนดค่า FRAPPE_SITE_NAME_HEADER ในไฟล์ env ให้ตรงกับชื่อไซต์แล้วเรนเดอร์ไฟล์ compose ใหม่อีกครั้ง

HTTPS และสิ่งที่ต้องเตรียมพร้อมก่อนใช้งาน

การตั้งค่า compose.https.yaml จะรัน Traefik บนพอร์ต 443 พร้อมเปลี่ยนเส้นทางพอร์ต 80 มาที่พอร์ตนี้ และร้องขอใบรับรองจาก Let's Encrypt โดย TLS (transport layer security) คือสิ่งที่ป้องกันไม่ให้ใบแจ้งหนี้และ session cookie ถูกส่งผ่านเครือข่ายในรูปแบบข้อความธรรมดา

เงื่อนไขสองประการต้องเป็นจริง มิฉะนั้นจะไม่มีการออกใบรับรองให้: DNS A record สำหรับ erp.example.com ต้องชี้มาที่ VPS แล้ว และพอร์ต 80 กับ 443 ต้องสามารถเข้าถึงได้จากอินเทอร์เน็ต เนื่องจาก Let's Encrypt จะตรวจสอบว่าคุณเป็นเจ้าของชื่อโดเมนจริงผ่านการทำ HTTP-01 challenge บนพอร์ต 80 ให้ตรวจสอบทั้ง network firewall ของผู้ให้บริการและ firewall ภายในเซิร์ฟเวอร์ด้วย เนื่องจากเป็นระบบควบคุมที่แยกจากกัน และ firewall บนหน้าเว็บจัดการมักเป็นสิ่งที่ผู้ใช้งานลืมตรวจสอบ

ใบรับรองจะถูกเก็บไว้ใน volume cert-data ที่ตำแหน่ง /letsencrypt/acme.json หากเบราว์เซอร์แสดงใบรับรองเริ่มต้นแทนที่จะเป็นของคุณ ให้ค้นหาชื่อบริการ proxy ใน docker compose --project-name erpnext ps แล้วอ่าน log เพื่อดูข้อผิดพลาดของ ACME (automatic certificate management environment) หากคุณรันเว็บแอปอื่นบนเซิร์ฟเวอร์เดียวกัน การใช้ Traefik หนึ่ง instance หน้าแอป Docker Compose หลายตัว จะแสดงวิธีแชร์ proxy แทนการแย่งใช้พอร์ต 443 แอปที่สองบนเซิร์ฟเวอร์ลักษณะนี้มักเป็นแอปที่ให้บริการลูกค้า และ การติดตั้ง Chatwoot support desk ด้วยตนเอง ก็สามารถวางไว้หลัง proxy ตัวเดียวกันนี้ได้ เพื่อให้ทีมงานที่ดูแลใบแจ้งหนี้สามารถตอบอีเมลและแชทของลูกค้าได้ในที่เดียว

อีเมลขาออก หรือการที่ใบแจ้งหนี้ไม่ถูกส่งออกจากเซิร์ฟเวอร์

นี่คือขั้นตอนที่คู่มือ ERPNext ส่วนใหญ่มักข้ามไป และเป็นขั้นตอนที่ตัดสินว่าระบบจะใช้งานได้จริงหรือไม่ หากอีเมลขาออกไม่ทำงาน ใบแจ้งหนี้จะไม่ถึงมือลูกค้า การรีเซ็ตรหัสผ่านจะใช้งานไม่ได้ และรายงานที่ตั้งเวลาไว้จะไม่ถูกส่งออกไป ทั้งนี้ stack ของระบบไม่ได้รวม mail server มาให้

อย่าพยายามส่งอีเมลโดยตรงจาก VPS ผ่านพอร์ต 25 ผู้ให้บริการอย่าง AWS จะบล็อกพอร์ต 25 ขาออกโดยค่าเริ่มต้น และ IP ที่เพิ่งเริ่มใช้งานใหม่ซึ่งไม่มีประวัติการส่งจะเพิ่มความเสี่ยงที่จะถูกปฏิเสธหรือถูกมองว่าเป็นสแปม ทั้งสองกรณีนี้สามารถหลีกเลี่ยงได้ ให้ใช้ authenticated relay ผ่านพอร์ต 587 และตรวจสอบกฎการส่งอีเมลขาออกของผู้ให้บริการก่อน โดย DigitalOcean จะบล็อกพอร์ต 25, 465 และ 587 บน Droplets ตามค่าเริ่มต้น

วิธีที่รองรับคือการตั้งค่าผ่านหน้าจอ Email Account ในอินเทอร์เฟซของ ERPNext ซึ่งจะจัดเก็บรหัสผ่านแบบเข้ารหัสไว้ คุณยังสามารถเขียนค่าคีย์ลงในไฟล์ site config ได้โดยตรง:

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_server smtp.example.com

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_port 587 --parse

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config use_tls 1 --parse

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config mail_login 'erp@example.com'

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-config auto_email_id 'erp@example.com'

--parse จะจัดเก็บ 587 เป็นตัวเลขแทนที่จะเป็นสตริง "587" ให้ตรวจสอบไฟล์อีกครั้งและยืนยันว่าค่าทั้งสองไม่มีเครื่องหมายคำพูดล้อมรอบ:

docker compose --project-name erpnext exec backend \
  cat sites/erp.example.com/site_config.json

สำหรับการจัดเก็บรหัสผ่านแบบเข้ารหัส ให้กำหนดค่า outgoing server, login และ password พร้อมกันในหน้าจอ Email Account โดยช่องรหัสผ่านในหน้าจอนี้จะไม่ไปตั้งค่าคีย์ mail_password ใน site config แยกต่างหาก

จากนั้นให้ทดสอบส่งข้อความจริง สร้าง Sales Invoice แล้วส่งอีเมลไปยังที่อยู่ที่คุณควบคุมได้ จากนั้นให้เฝ้าดูคิวในขณะที่ดำเนินการ:

docker compose --project-name erpnext logs -f queue-short

อีเมลขาออกเป็น background job ดังนั้นข้อความที่ไม่ถึงปลายทางมักจะปรากฏเป็นงานที่ล้มเหลวใน log ดังกล่าว แทนที่จะแสดงข้อผิดพลาดในเบราว์เซอร์ คุณควรประกาศระเบียน SPF (sender policy framework) และ DKIM (domainkeys identified mail) สำหรับโดเมนที่ใช้ส่งอีเมล จากนั้นจึงเพิ่มนโยบาย DMARC หากไม่มีการยืนยันตัวตน ใบแจ้งหนี้ที่ถูกต้องตามเทคนิคก็มีความเสี่ยงที่จะถูกปฏิเสธหรือถูกจัดเป็นสแปม หากคุณต้องการควบคุมเส้นทางทั้งหมดด้วยตนเอง การใช้ Mailcow mail server ที่โฮสต์เอง จะช่วยให้คุณมี relay ที่ควบคุมได้บนเซิร์ฟเวอร์แยกต่างหากจาก ERP

การสำรองข้อมูลที่กู้คืนได้จริง

การทำ database dump เพียงอย่างเดียวไม่ใช่การสำรองข้อมูลที่สมบูรณ์ของ ERPNext ไฟล์แนบและไฟล์ส่วนตัวจะถูกจัดเก็บอยู่ในไดเรกทอรี sites ไม่ใช่ใน MariaDB หากคุณกู้คืนเฉพาะฐานข้อมูล ใบสั่งซื้อที่อัปโหลดไว้ทั้งหมดจะกลายเป็นลิงก์ที่ใช้งานไม่ได้

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com backup --with-files

คำสั่งดังกล่าวจะเขียนไฟล์ 4 ไฟล์ลงใน sites/erp.example.com/private/backups ภายใน volume sites:

  • ไฟล์ dump -database.sql.gz
  • ไฟล์ archive -files.tar ของไฟล์สาธารณะ
  • ไฟล์ archive -private-files.tar ของไฟล์ส่วนตัว
  • ไฟล์สำเนา -site_config_backup.json ของการตั้งค่าไซต์ (site config)

ไฟล์ที่สี่คือสิ่งที่ผู้คนมักละเลยและเป็นไฟล์ที่สร้างปัญหามากที่สุด ไฟล์นี้เก็บ encryption_key ซึ่งเป็นคีย์ที่ Frappe ใช้สำหรับเข้ารหัสรหัสผ่านที่จัดเก็บไว้ ไม่ว่าจะเป็นข้อมูลรับรองบัญชีอีเมล, คีย์ของ payment gateway หรือความลับของการเชื่อมต่อ (integration secret) ทั้งหมด หากคุณกู้คืนฐานข้อมูลโดยไม่มีคีย์ที่ตรงกัน ไซต์จะโหลดขึ้นมาได้ตามปกติ แต่การส่งอีเมลจะล้มเหลวพร้อมข้อความ:

frappe.exceptions.ValidationError: Encryption key is invalid! Please check site_config.json

จงเก็บไฟล์ทั้งสี่ไว้ด้วยกันเสมอ

จากนั้นให้ย้ายไฟล์ออกจากเซิร์ฟเวอร์ การสำรองข้อมูลที่เก็บไว้ภายใน volume จะไม่คงอยู่หากเซิร์ฟเวอร์เสียหาย อีกทั้ง bench จะลบข้อมูลเหล่านั้นทิ้งโดยอัตโนมัติ โดยค่าเริ่มต้นระบบจะลบไฟล์สำรองที่มีอายุเกิน 23 ชั่วโมงออกจากไดเรกทอรีดังกล่าว ค่าเริ่มต้นนี้เคยเป็น 24 ชั่วโมงก่อนหน้า Frappe เวอร์ชัน 16.20.0 และ 15.114.0 โดยคีย์ keep_backups_for_hours ใน site config สามารถใช้เพื่อกำหนดค่านี้ใหม่ได้

docker compose --project-name erpnext cp \
  backend:/home/frappe/frappe-bench/sites/erp.example.com/private/backups \
  ~/erpnext-backups

ให้รันคำสั่งดังกล่าวผ่าน cron จากนั้นส่งไดเรกทอรีไปยังที่อื่นที่คุณไม่ได้เป็นผู้ดูแลระบบ การสำรองข้อมูลด้วย restic แบบเข้ารหัสไปยังที่จัดเก็บภายนอก เป็นเครื่องมือที่เหมาะสมที่สุด เนื่องจากจะทำการเข้ารหัสก่อนอัปโหลด และ restic check จะช่วยยืนยันว่า repository ยังคงอ่านข้อมูลได้ปกติ การสำรองข้อมูล ERP คือการคัดลอกบัญชีแยกประเภททั้งหมดของคุณ ดังนั้นข้อมูลนี้จึงควรถูกจัดเก็บในสถานะเข้ารหัสบนฮาร์ดแวร์อื่นที่ไม่ใช่เครื่องนี้

ทดสอบการกู้คืนก่อนถึงเวลาใช้งานจริง

การสำรองข้อมูลที่ไม่ได้ผ่านการทดสอบถือเป็นเพียงการคาดเดาเท่านั้น ให้ทดสอบการกู้คืนไปยังไซต์ที่สองบนเซิร์ฟเวอร์เดียวกัน ห้ามกู้คืนทับไซต์ที่ใช้งานจริงโดยเด็ดขาด

docker compose --project-name erpnext exec backend \
  bench new-site --mariadb-user-host-login-scope=% \
  --db-root-password '<your DB_PASSWORD>' \
  --admin-password '<a strong admin password>' \
  restore-test.example.com

docker compose --project-name erpnext exec backend \
  bench --site restore-test.example.com --force restore \
  sites/erp.example.com/private/backups/<stamp>-erp_example_com-database.sql.gz \
  --with-public-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-files.tar \
  --with-private-files sites/erp.example.com/private/backups/<stamp>-erp_example_com-private-files.tar \
  --db-root-password '<your DB_PASSWORD>'

คัดลอก encryption key จากไฟล์ config ที่สำรองไว้ไปยังไซต์ที่กู้คืน มิฉะนั้นการเชื่อมต่อกับระบบอื่นจะใช้งานไม่ได้

docker compose --project-name erpnext exec backend \
  bench --site restore-test.example.com set-config encryption_key '<value from site_config_backup.json>'

ตรวจสอบการกู้คืนด้วยวิธีเดียวกับที่นักบัญชีทำ ให้เปิดรายงาน Accounts Receivable แล้วเปรียบเทียบยอดคงเหลือปิดงวดกับไซต์ที่ใช้งานจริง จากนั้นเปิดใบแจ้งหนี้การซื้อล่าสุดแล้วดาวน์โหลดไฟล์แนบ การที่ไซต์แสดงหน้าล็อกอินได้ไม่ได้พิสูจน์ว่าระบบทำงานได้สมบูรณ์

ลบไซต์ทดสอบออกเมื่อดำเนินการเสร็จสิ้น:

docker compose --project-name erpnext exec backend \
  bench drop-site restore-test.example.com

เหตุใดการตรึงเวอร์ชัน (version pinning) จึงสำคัญยิ่งสำหรับ ERPNext

สำหรับเว็บไซต์แบบ static การไม่ตรึง image tag อาจทำให้เกิดการ restart โดยไม่คาดคิด แต่สำหรับ ERPNext มันหมายถึงการทำ schema migration โดย bench migrate จะเขียนทับตารางฐานข้อมูลและอาจเขียนทับข้อมูลในเอกสาร ซึ่งไม่มีคำสั่งย้อนกลับ (undo) การย้อนคืนทำได้เพียงการกู้คืนจาก backup เท่านั้น ไม่ใช่การใช้ docker compose down

ดังนั้นควรตรึง tag ไว้ โดย ERPNEXT_VERSION=v16.32.1 คือ release ที่ถูกตรึงไว้ใน pwd.yml ของ repository เองเมื่อเดือนสิงหาคม 2026 ณ วันที่ 2026-11-16 ทั้ง pwd.yml และ example.env ได้ตรึง v16.55.0 ไว้ ห้ามนำตัวเลขใดๆ ไปใช้ต่อโดยไม่ได้ตรวจสอบก่อน คุณสามารถดู release ปัจจุบันได้ที่ หน้า release ของ frappe/erpnext และดู image tag ที่มีอยู่ได้ที่ Docker Hub โปรดอ่านบันทึกประจำรุ่นของเวอร์ชันที่คุณกำลังจะย้ายไปก่อนดำเนินการ

กระบวนการอัปเกรดเริ่มต้นด้วยการทำ backup และเข้าสู่โหมดบำรุงรักษา (maintenance mode)

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com backup --with-files

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-maintenance-mode on

แก้ไข ERPNEXT_VERSION ใน ~/gitops/erpnext.env จากนั้นทำการ render, pull และ migrate

docker compose --project-name erpnext \
  --env-file ~/gitops/erpnext.env \
  -f compose.yaml \
  -f overrides/compose.mariadb.yaml \
  -f overrides/compose.redis.yaml \
  -f overrides/compose.https.yaml \
  config > ~/gitops/erpnext.yaml

docker compose --project-name erpnext -f ~/gitops/erpnext.yaml pull
docker compose --project-name erpnext -f ~/gitops/erpnext.yaml up -d

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com migrate

docker compose --project-name erpnext exec backend \
  bench --site erp.example.com set-maintenance-mode off

โหมดบำรุงรักษามีความสำคัญเนื่องจาก migrate จะปรับเปลี่ยน schema ในขณะที่ทำงาน หากผู้ใช้ส่งเอกสารเข้ามาในขณะที่ตารางถูก migrate ไปเพียงครึ่งเดียว จะทำให้คุณต้องลงมือซ่อมแซมข้อมูลด้วยตนเอง

ให้ย้ายเวอร์ชันทีละ major version โดยทำ backup คั่นระหว่างแต่ละขั้นตอนเสมอ ตรวจสอบคำแนะนำการ migrate สำหรับแต่ละ major version ก่อนดำเนินการต่อ

นอกจากนี้ repository ยังมาพร้อมกับ overrides/compose.migrator.yaml ซึ่งเพิ่ม container ที่รัน bench --site all migrate เมื่อเริ่มทำงานหากมีไซต์อยู่และเปิดใช้งาน MIGRATE_SITES ไว้ (ซึ่งเป็นค่าเริ่มต้น) แม้จะสะดวกสบาย แต่ก็หมายความว่าการทำ docker compose up ด้วย tag ที่เปลี่ยนไปจะทำให้ฐานข้อมูลการผลิตของคุณถูก migrate โดยไม่มีใครเฝ้าดู สำหรับระบบธุรกิจ ควรดำเนินการ migrate ในฐานะการตัดสินใจที่คุณได้วางแผนไว้แล้วในวันนั้น

การเสริมความปลอดภัยให้กับเซิร์ฟเวอร์ที่เก็บข้อมูลลูกค้า

เปลี่ยนรหัสผ่าน Administrator ในการเข้าสู่ระบบครั้งแรก ไฟล์ compose ที่ใช้สำหรับการประเมินผลกำหนดให้ admin เป็นรหัสผ่านเริ่มต้น และมักมีผู้ใช้งานนำค่านี้ไปใช้ในสภาพแวดล้อม production จริงโดยไม่เปลี่ยน

เปลี่ยนค่า DB_PASSWORD ออกจาก 123 ในไฟล์ example.env ค่าดังกล่าวจะถูกนำไปแสดงในไฟล์ ~/gitops/erpnext.yaml ที่ถูกสร้างขึ้นในรูปแบบข้อความธรรมดา ดังนั้นให้ chmod 600 ไฟล์ดังกล่าวและเก็บให้ห่างจาก git repository ทุกแห่ง หากต้องการความปลอดภัยที่สูงขึ้น overrides/compose.mariadb-secrets.yaml จะอ่านรหัสผ่านจากไฟล์ Docker secret แทนการใช้ environment variable เนื้อหาใน การจัดการไฟล์ env และ secrets ใน Docker Compose ได้อธิบายถึงข้อดีและข้อเสียของแต่ละวิธีไว้แล้ว

เปิดเผยเฉพาะพอร์ตที่จำเป็นเท่านั้น เมื่อมีการใช้ HTTPS override พอร์ต 80 และ 443 จะเป็นพอร์ตเดียวที่เปิดใช้งาน อย่าเพิ่มการทำ ports mapping ไปยังบริการ db เพื่อให้เชื่อมต่อกับ database client ได้ง่ายขึ้น เพราะการกระทำดังกล่าวจะทำให้ MariaDB เข้าถึงได้จากอินเทอร์เน็ตสาธารณะ ให้ใช้ docker compose --project-name erpnext exec backend bench mariadb แทน ในระดับโฮสต์ ให้เปิดพอร์ต 22, 80 และ 443 เท่านั้น ปฏิเสธการเชื่อมต่อส่วนที่เหลือ และตรวจสอบ firewall ของเครือข่ายที่ผู้ให้บริการจัดเตรียมไว้ด้วย

เปิดใช้งานการยืนยันตัวตนแบบสองชั้น (two-factor authentication) ใน System Settings สำหรับทุกบัญชีที่มีบทบาท System Manager เนื่องจากบทบาทนี้สามารถแก้ไข System Settings ได้ จึงควรปฏิบัติกับบัญชีนี้เสมือนเป็นบัญชีผู้ดูแลระบบ ไม่ใช่บัญชีเพื่อความสะดวกทั่วไป หากคุณใช้งานแอปพลิเคชันแบบ self-hosted หลายตัว การใช้ Authentik ในฐานะผู้ให้บริการ single sign-on แบบ self-hosted จะเป็นทางเลือกที่ดีกว่าการตั้งรหัสผ่านแยกสำหรับแต่ละแอป

อัปเดตแพตช์โฮสต์และรีบูตเครื่องเมื่อมีการอัปเดต kernel ก่อนที่จะเชื่อมั่นว่า stack จะกลับมาทำงานได้ตามปกติ ให้ตรวจสอบไฟล์ที่ถูกสร้างขึ้นว่ามีการกำหนดนโยบาย restart ในแต่ละบริการหรือไม่ เพราะ stack ที่ไม่มีนโยบายนี้จะไม่กลับมาทำงานโดยอัตโนมัติหลังการรีบูต เนื้อหาใน การทำให้ Docker Compose stack เริ่มทำงานใหม่หลังรีบูต ได้อธิบายถึงการตั้งค่าในส่วนของ systemd ไว้แล้ว

เมื่อ ERPNext เริ่มทำงานบน VPS เดียวไม่ไหว

VPS หนึ่งเครื่องอาจรองรับบริษัทขนาดเล็กได้เป็นเวลานาน สัญญาณที่บ่งบอกว่าทรัพยากรไม่เพียงพอมีดังนี้:

  • งานเบื้องหลัง (background jobs) ค้างสะสม ส่งผลให้การส่งอีเมลและการนำเข้าข้อมูลล่าช้าไปหลายนาทีหรือหลายชั่วโมง
  • docker inspect รายงานสถานะของคอนเทนเนอร์ด้วย "OOMKilled": true หรือ exit code 137
  • รายงานที่เคยใช้เวลาประมวลผล 2 วินาทีกลับใช้เวลาถึง 30 วินาที และ MariaDB เป็นกระบวนการที่กิน CPU สูงสุด
  • การสำรองข้อมูลใช้เวลานานจนทับซ้อนกับรอบการทำงานถัดไปที่ตั้งไว้

เริ่มต้นด้วยการจัดสรรทรัพยากรให้ MariaDB โดยเฉพาะโดยไม่ให้แชร์กับส่วนอื่น เนื่องจากฐานข้อมูลและ Python workers แย่งชิงหน่วยความจำกัน และ buffer pool คือส่วนที่ต้องการหน่วยความจำเพิ่มมากที่สุด การขยายขนาด application server ช่วยได้น้อยกว่าที่คาดไว้ การรันฐานข้อมูลใน Docker หรือบนโฮสต์ จะช่วยให้ตัดสินใจในเรื่องนี้ได้ และ การตั้งค่าขีดจำกัดหน่วยความจำใน Docker Compose จะช่วยป้องกันไม่ให้คอนเทนเนอร์หนึ่งแย่งทรัพยากรจากคอนเทนเนอร์อื่นในระหว่างที่คุณดำเนินการปรับปรุงระบบ

หลังจากนั้น ให้เพิ่มจำนวน queue workers แทนการเพิ่มขีดความสามารถของเว็บเซิร์ฟเวอร์ งานที่ล่าช้าของ ERPNext มักเป็นงานเบื้องหลัง เช่น การสร้างรายงานและการนำเข้าข้อมูลจำนวนมาก การเพิ่มจำนวน workers จำเป็นต้องใช้ CPU และหน่วยความจำสำรอง การเพิ่มคอนเทนเนอร์ลงใน VPS ที่ทรัพยากรเต็มอยู่แล้วจะไม่ช่วยเพิ่มขีดความสามารถในการประมวลผลแต่อย่างใด

FAQ

ERPNext ต้องการ RAM เท่าใดบน VPS?

สำหรับการประเมินผล ให้เริ่มต้นที่ 4 GB และ 2 vCPU สำหรับการใช้งานจริงในองค์กร ให้วางแผนที่ 8 GB และ 4 vCPU พร้อมพื้นที่ SSD 100 GB เมื่อหน่วยความจำไม่เพียงพอ kernel out of memory killer อาจหยุดการทำงานของคอนเทนเนอร์ ซึ่ง docker inspect จะรายงานเป็น "OOMKilled": true พร้อม exit code 137 ค่าเหล่านี้เป็นเพียงจุดเริ่มต้นไม่ใช่ค่ามาตรฐานที่ตายตัว ดังนั้นควรตรวจสอบการใช้หน่วยความจำของคุณเองตลอดเดือนแรก

ฉันสามารถรัน pwd.yml ในสภาพแวดล้อม production ได้หรือไม่?

ไม่ได้ ไฟล์ดังกล่าวระบุไว้ใน README ของโปรเจกต์ว่ามีไว้สำหรับการประเมินผลระยะสั้นเท่านั้น และไม่สามารถติดตั้งแอปพลิเคชันเพิ่มเติมได้ ให้ใช้ compose.yaml ร่วมกับ override ของ MariaDB, Redis และ HTTPS จากนั้นรวมไฟล์เข้าด้วยกันด้วย docker compose config แล้วจึงรันไฟล์นั้น

ทำไมไซต์ ERPNext ของฉันถึงเข้าใช้งานไม่ได้ทันทีหลังจากสร้าง?

โดยปกติ frontend จะเลือกไซต์ที่จะให้บริการจาก HTTP Host header ดังนั้นชื่อไซต์ต้องตรงกับโดเมนในเบราว์เซอร์ ไซต์ที่สร้างด้วยชื่อ erpnext จะไม่ถูกให้บริการที่ erp.example.com ให้สร้างไซต์โดยใช้ชื่อโดเมน หรือตั้งค่า FRAPPE_SITE_NAME_HEADER ในไฟล์ env ให้เป็นชื่อไซต์ จากนั้น render ไฟล์ compose ใหม่อีกครั้งและรีสตาร์ท stack

สิ่งที่ต้องมีในการสำรองข้อมูล ERPNext คืออะไร?

ต้องมี 4 ไฟล์ที่เก็บไว้ด้วยกัน ได้แก่ ไฟล์ dump ของ -database.sql.gz, ไฟล์ archive ของ -files.tar และ -private-files.tar, และสำเนาไฟล์ config ของ -site_config_backup.json การรัน bench --site erp.example.com backup --with-files จะสร้างไฟล์ทั้ง 4 รายการนี้ สำเนาไฟล์ config จะเก็บ encryption_key ไว้ ดังนั้นหากกู้คืนโดยไม่มีไฟล์นี้ รหัสผ่านที่ใช้เชื่อมต่อระบบจะถูกถอดรหัสไม่ได้ ซึ่งจะแสดงข้อผิดพลาดเป็น Encryption key is invalid! Please check site_config.json

ฉันจะอัปเกรด ERPNext โดยไม่ให้ข้อมูลเสียหายได้อย่างไร?

ให้สำรองข้อมูลด้วย --with-files, เปิดโหมด maintenance, เปลี่ยนค่า ERPNEXT_VERSION ในไฟล์ env ของคุณ, render ไฟล์ compose ใหม่อีกครั้ง, สั่ง pull, รัน stack ขึ้นมา จากนั้นรัน bench --site erp.example.com migrate แล้วจึงปิดโหมด maintenance ให้ขยับเวอร์ชันหลักทีละขั้นและอ่าน release notes ก่อนเสมอ เพราะ migrate จะเขียนทับ schema และข้อมูลเอกสารโดยไม่สามารถย้อนกลับได้ การย้อนกลับทำได้เพียงการกู้คืนข้อมูลจากไฟล์สำรองที่คุณทำไว้ตั้งแต่เริ่มต้นเท่านั้น

บทความนี้มีประโยชน์หรือไม่