2025-08-07

TL;DR: Cài n8n có 2 cách chính - Docker (dễ, ổn định, khuyên dùng cho production) và npm/npx (cần biết Node.js, linh hoạt hơn cho development). Version hiện tại: Stable 2.6.3, Beta 2.7.0.

Thiết lập trận pháp - Khai mở n8n Server

Chào mừng các đạo hữu đã quay trở lại. Sau khi đã hiểu n8n “hữu dụng” như thế nào ở bài trước, hôm nay chúng ta sẽ bắt tay vào việc xây dựng trận pháp (cài đặt server) để bắt đầu tu luyện.

Lưu ý: Self-hosting cần kiến thức kỹ thuật về servers, security.

Đạo Tràng Chọn Vị: Các Phương Thức Triển Khai

Tùy vào căn cơ (kỹ năng) và nhu cầu của mỗi người, ta có thể chọn một trong các pháp môn cài đặt sau:

1. Docker - Pháp Đài Vững Chãi (Khuyên Dùng)

Đây là pháp môn chính tông, được đa số cao thủ sử dụng. Docker đóng gói n8n vào container riêng biệt, cô lập với hệ thống, dễ backup và dễ update. Quan trọng nhất - phù hợp cho production (môi trường thật).

Yêu cầu:

Cài đặt Docker trước:

Docker Desktop - Mac, Windows, Linux
Docker Engine - Linux server

Version khuyên dùng: Stable 2.6.3 (production), Beta 2.7.0 (testing)

Cách triển khai cơ bản:

Sử dụng câu thần chú sau để triệu hồi n8n (nhớ thay <YOUR_TIMEZONE> bằng timezone của bạn, ví dụ: Asia/Ho_Chi_Minh):

1
# Tạo volume để lưu data
2
docker volume create n8n_data
3

4
# Chạy n8n
5
docker run -it --rm \
6
  --name n8n \
7
  -p 5678:5678 \
8
  -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
9
  -e TZ="<YOUR_TIMEZONE>" \
10
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
11
  -e N8N_RUNNERS_ENABLED=true \
12
  -v n8n_data:/home/node/.n8n \
13
  docker.n8n.io/n8nio/n8n

Giải thích các tham số:

-p 5678:5678: Mở port 5678
-e GENERIC_TIMEZONE: Timezone cho schedule nodes
-e TZ: Timezone cho system
-e N8N_RUNNERS_ENABLED=true: Bật Task Runners (recommended)
-v n8n_data:/home/node/.n8n: Lưu data persistent

Nếu muốn dùng PostgreSQL thay vì SQLite mặc định:

1
docker volume create n8n_data
2

3
docker run -it --rm \
4
  --name n8n \
5
  -p 5678:5678 \
6
  -e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
7
  -e TZ="<YOUR_TIMEZONE>" \
8
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
9
  -e N8N_RUNNERS_ENABLED=true \
10
  -e DB_TYPE=postgresdb \
11
  -e DB_POSTGRESDB_DATABASE=<POSTGRES_DATABASE> \
12
  -e DB_POSTGRESDB_HOST=<POSTGRES_HOST> \
13
  -e DB_POSTGRESDB_PORT=<POSTGRES_PORT> \
14
  -e DB_POSTGRESDB_USER=<POSTGRES_USER> \
15
  -e DB_POSTGRESDB_SCHEMA=<POSTGRES_SCHEMA> \
16
  -e DB_POSTGRESDB_PASSWORD=<POSTGRES_PASSWORD> \
17
  -v n8n_data:/home/node/.n8n \
18
  docker.n8n.io/n8nio/n8n

Lưu ý: Ngay cả khi dùng PostgreSQL, vẫn mount volume .n8n vì nó chứa encryption keys, instance logs và source control assets.

Để n8n chạy nền (không bị tắt khi đóng terminal):

1
docker volume create n8n_data
2

3
docker run -d --restart unless-stopped \
4
  --name n8n \
5
  -p 5678:5678 \
6
  -e GENERIC_TIMEZONE="Asia/Ho_Chi_Minh" \
7
  -e TZ="Asia/Ho_Chi_Minh" \
8
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
9
  -e N8N_RUNNERS_ENABLED=true \
10
  -v n8n_data:/home/node/.n8n \
11
  docker.n8n.io/n8nio/n8n

Với --restart unless-stopped, container sẽ tự động khởi động lại khi server reboot.

Sau khi chạy lệnh, hãy mở trình duyệt và truy cập vào địa chỉ: http://localhost:5678.

Cập nhật n8n Docker:

1
# Pull phiên bản mới nhất
2
docker pull docker.n8n.io/n8nio/n8n
3

4
# Hoặc pull phiên bản cụ thể
5
docker pull docker.n8n.io/n8nio/n8n:2.6.3
6

7
# Stop container hiện tại
8
docker stop n8n
9

10
# Remove container cũ
11
docker rm n8n
12

13
# Start lại với image mới
14
docker run -d --restart unless-stopped \
15
  --name n8n \
16
  -p 5678:5678 \
17
  -e GENERIC_TIMEZONE="Asia/Ho_Chi_Minh" \
18
  -e TZ="Asia/Ho_Chi_Minh" \
19
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
20
  -e N8N_RUNNERS_ENABLED=true \
21
  -v n8n_data:/home/node/.n8n \
22
  docker.n8n.io/n8nio/n8n

2. npm/npx - Cài Trực Tiếp Qua Node.js

Cách này cài n8n như một package Node.js global. Linh hoạt cho development nhưng phức tạp hơn cho production.

Yêu cầu:

Node.js: Version 20.19 đến 24.x

Thử nghiệm nhanh với npx:

Không cần cài đặt, chỉ cần chạy:

1
npx n8n

Lệnh này sẽ tải và chạy n8n ngay lập tức. Truy cập http://localhost:5678 để sử dụng.

Cài đặt global với npm:

1
# Cài đặt n8n global
2
npm install n8n -g
3

4
# Khởi động n8n
5
n8n start

Hoặc cài đặt version cụ thể:

1
# Cài version 2.6.3
2
npm install -g n8n@2.6.3
3

4
# Cài version beta
5
npm install -g n8n@next

Cập nhật n8n npm:

1
# Update lên phiên bản stable mới nhất
2
npm update -g n8n
3

4
# Hoặc cài next version
5
npm install -g n8n@next

Revert version (nếu update lỗi):

Nếu update lên version mới bị lỗi, bạn có thể quay lại version cũ:

1
# Cài lại version cũ
2
npm install -g n8n@<version-cũ>
3

4
# Nếu có database migration, revert lại
5
n8n db:revert

3. n8n với Tunnel (Chỉ Development)

Cảnh báo: Chỉ dùng cho local development và testing. KHÔNG dùng cho production!

Để webhooks từ services bên ngoài gọi được vào n8n local:

1
# Docker với tunnel
2
docker run -it --rm \
3
  --name n8n \
4
  -p 5678:5678 \
5
  -e GENERIC_TIMEZONE="Asia/Ho_Chi_Minh" \
6
  -e TZ="Asia/Ho_Chi_Minh" \
7
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
8
  -e N8N_RUNNERS_ENABLED=true \
9
  -v n8n_data:/home/node/.n8n \
10
  docker.n8n.io/n8nio/n8n \
11
  start --tunnel
12

13
# npm với tunnel
14
n8n start --tunnel

Cấu hình sau khi cài đặt

Truy cập http://localhost:5678 lần đầu, tạo tài khoản Owner với email và password mạnh (12+ ký tự). Nếu deploy ra internet, bắt buộc phải dùng HTTPS.

Environment Variables quan trọng:

1
# Timezone (rất quan trọng cho Schedule nodes)
2
GENERIC_TIMEZONE="Asia/Ho_Chi_Minh"
3
TZ="Asia/Ho_Chi_Minh"
4

5
# Database (nếu dùng PostgreSQL)
6
DB_TYPE=postgresdb
7
DB_POSTGRESDB_HOST=localhost
8
DB_POSTGRESDB_PORT=5432
9
DB_POSTGRESDB_DATABASE=n8n
10
DB_POSTGRESDB_USER=n8n_user
11
DB_POSTGRESDB_PASSWORD=your_password
12

13
# Security
14
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
15

16
# Task Runners (recommended)
17
N8N_RUNNERS_ENABLED=true
18

19
# Production settings
20
N8N_HOST=your-domain.com
21
N8N_PROTOCOL=https
22
N8N_PORT=443
23
WEBHOOK_URL=https://your-domain.com/

So sánh các phương pháp

Tiêu chí	Docker	npm/npx
Độ khó	Dễ hơn	Khó hơn (cần biết Node.js)
Phù hợp cho	Production, Long-term	Development, Testing
Cô lập môi trường	Tốt (isolated)	Phụ thuộc hệ thống
Dễ backup	Rất dễ	Phức tạp hơn
Khả năng scale	Tốt	Giới hạn
Level	High-level, abstracted	Low-level, hands-on

Khuyến nghị: Dùng npx n8n để test nhanh. Production thì dùng Docker với PostgreSQL.

Các bước tiếp theo

Sau khi triển khai xong:

Làm quen với Canvas editor và Nodes
Setup credentials cho services (Google, Slack, API…)
Tham khảo n8n Documentation và Templates
Setup backup và monitoring

Khắc phục sự cố thường gặp

Vấn đề 1: Port 5678 đã được sử dụng

1
# Kiểm tra port nào đang dùng
2
lsof -i :5678
3

4
# Đổi sang port khác (ví dụ 5679)
5
docker run -p 5679:5678 ...
6
# Hoặc với npm
7
n8n start --port 5679

Vấn đề 2: Container bị stop do thiếu memory

1
# Kiểm tra logs
2
docker logs n8n
3

4
# Tăng memory limit cho Docker
5
docker run -m 2g ...  # Giới hạn 2GB RAM

Vấn đề 3: Permission denied với volume

1
# Fix permissions
2
sudo chown -R 1000:1000 ~/.n8n
3
# hoặc với named volume
4
docker volume inspect n8n_data

Vấn đề 4: Node.js version không đúng (npm)

1
# Kiểm tra version hiện tại
2
node --version
3

4
# Cài đúng version với nvm
5
nvm install 20
6
nvm use 20
7

8
# Reinstall n8n
9
npm install -g n8n

Góc chia sẻ

Trong quá trình tu luyện, tại hạ có xây dựng một trận pháp N8N local với một số bí tịch: n8n:latest, postgreSQL, redis (queue mode). Chư vị huynh đài nếu hứng thú có thể xem tại: Github

Tổng kết

Vậy là đạo hữu đã khai mở thành công trận pháp n8n. Những điểm quan trọng cần nhớ:

Docker dễ hơn và tốt nhất cho production (high-level, abstracted)
npm/npx low-level hơn, cần biết Node.js, phù hợp development
Luôn enable Task Runners (N8N_RUNNERS_ENABLED=true)
Timezone quan trọng cho Schedule nodes
PostgreSQL tốt hơn SQLite cho workload lớn
Self-hosting cần kiến thức kỹ thuật

Ở Chương 3, tại hạ sẽ dẫn các đạo hữu tham quan trận pháp và làm quen với các pháp khí cơ bản.

Chúc các đạo hữu triển khai thuận lợi! Hẹn gặp lại!

Cập nhật lần cuối: Tháng 2/2026 - Dựa trên n8n Documentation stable v2.6.3

Series:

n8n-tutorial

Bài 2/5

Nội dung series:

1. Chương 1: Giới thiệu n8n - Nền tảng Workflow Automation mạnh mẽ
2. Chương 2: Khởi Nguyên - Triển Khai n8n Như Đặt Nền Móng Tu Luyện Đang đọc
3. Chương 3: Làm quen với giao diện và các Nodes cơ bản trong n8n
4. Chương 4: Hướng dẫn tạo Workflow đầu tiên với n8n
5. Tìm hiểu về Triggers và Webhooks trong n8n