نصب n8n روی سرور لینوکس؛ راهنمای کامل 2026

bash
# ۱) به‌روزرسانی فهرست بسته‌ها روی اوبونتو/دبیان
sudo apt update && sudo apt upgrade -y

# ۲) نصب Docker Engine با اسکریپت رسمی داکر
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# ۳) اجرای داکر بدون sudo (کاربر فعلی به گروه docker اضافه می‌شود)
sudo usermod -aG docker $USER
# پس از این دستور یک‌بار از سرور خارج و دوباره وارد شوید

# ۴) بررسی نصب
docker --version

bash
# ساخت یک volume برای نگه‌داری دائمی داده‌ها
docker volume create n8n_data

# اجرای n8n (به‌جای <YOUR_TIMEZONE> منطقه زمانی خود را بگذارید، مثلاً Asia/Tehran)
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="Asia/Tehran" \
 -e TZ="Asia/Tehran" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -e N8N_RUNNERS_ENABLED=true \
 -v n8n_data:/home/node/.n8n \
 docker.n8n.io/n8nio/n8n

# اکنون پنل در آدرس http://localhost:5678 در دسترس است

bash
# n8n به نسخه Node.js بین 20.19 تا 24.x نیاز دارد

# تست سریع بدون نصب دائمی
npx n8n

# یا نصب سراسری با npm
npm install n8n -g

# اجرای n8n
n8n start

# به‌روزرسانی به آخرین نسخه پایدار
npm update -g n8n

bash
# اجرای n8n با دیتابیس PostgreSQL به‌جای SQLite پیش‌فرض
docker run -it --rm \
 --name n8n \
 -p 5678:5678 \
 -e GENERIC_TIMEZONE="Asia/Tehran" \
 -e TZ="Asia/Tehran" \
 -e DB_TYPE=postgresdb \
 -e DB_POSTGRESDB_DATABASE=n8n \
 -e DB_POSTGRESDB_HOST=postgres \
 -e DB_POSTGRESDB_PORT=5432 \
 -e DB_POSTGRESDB_USER=n8n \
 -e DB_POSTGRESDB_PASSWORD=<POSTGRES_PASSWORD> \
 -v n8n_data:/home/node/.n8n \
 docker.n8n.io/n8nio/n8n

bash
# دریافت آخرین نسخه ایمیج n8n
docker pull docker.n8n.io/n8nio/n8n

# پیدا کردن شناسه کانتینر در حال اجرا
docker ps -a

# توقف و حذف کانتینر قدیمی (به‌جای <id> شناسه واقعی را بگذارید)
docker stop <id>
docker rm <id>

# اجرای مجدد با همان volume داده (داده‌ها حفظ می‌شوند)