⬇️ פרק 3

התקנה בשורה אחת

התקנת n8n משורת הפקודה באמצעות התקנה בשורה אחת. לפי One-line setup, זו הדרך המהירה ביותר להפעיל את n8n, בין אם השתמשתם ב-Docker בעבר ובין אם לא.

#למי זה מיועד

מדריך זה מקים מופע חדש של n8n בפקודה אחת, שמחליפה את הגישה הישנה של npm install n8n / npx n8n, אשר אינה פועלת עוד החל מגרסה n8n 3.0.

השיטה מיועדת להתקנות חדשות, ולא לשינוי התקנה קיימת:

• כבר מריצים בהתקנה עצמית עם קובץ Docker Compose משלכם? אין צורך לעבור לסקריפט הזה, אך אפשר לקבל השראה מתהליך ההתקנה של Docker Compose.
• מתקינים כרגע את n8n עם npm? החל מ-n8n 3.0, n8n מופץ אך ורק דרך Docker. ההתקנה הקיימת שלכם ב-npm ממשיכה לעבוד בינתיים, אך התקנות חדשות (ושדרוגים עתידיים) צריכות להשתמש בשיטה זו במקום זאת.

#מה צריך לפני שמתחילים

שיטה זו משתמשת ב-Docker, כלי שמריץ את n8n בחבילה עצמאית כדי שלא תצטרכו להתקין או להגדיר שום דבר אחר בעצמכם. אם עדיין אין לכם אותו:

• מתקינים את Docker. ההתקנה כוללת את Docker Compose, שפקודת ההתקנה צריכה גם כן.

אין צורך להכיר את Docker כדי להשתמש במדריך זה, רק לוודא שהוא מותקן ורץ ברקע.

פקודת ההתקנה בשורה אחת דורשת ספציפית את התוסף docker compose v2 (ולא את הקובץ הבינארי העצמאי הישן docker-compose), ובודקת שה-daemon של Docker פועל. אם אתם משתמשים ב-Podman, ב-Colima או במנועים אחרים שתואמים ל-Docker: התקינו את ה-CLI של docker יחד עם תוסף ה-compose, והפנו את DOCKER_HOST לסוקט שלהם.

צפו במדריך וידאו שמכסה את ההתקנה הזו, מהתקנת Docker ועד הפעלת n8n Assistant: https://www.youtube.com/embed/t5RBVTby9EU

#הרצת הפקודה

פותחים מסוף ומריצים:

curl -fsSL https://get.n8n.io | sh

הפקודה מבצעת הכל עבורכם:

1. בודקת ש-Docker מותקן ורץ, ומסבירה כיצד לתקן אם אינו רץ.
2. יוצרת תיקייה חדשה בשם n8n בתיקייה הנוכחית כדי להחזיק הכל.
3. כותבת את קובצי ההגדרה ש-n8n צריך כדי לרוץ.
4. מורידה את n8n ומפעילה אותו.

בטוח להריץ את הפקודה יותר מפעם אחת. אם n8n כבר מוגדר בתיקייה הזו, הפקודה רק מודיעה שהוא כבר שם במקום לשנות דבר.

פלט של הרצה מוצלחת נראה כך:

$ curl -fsSL https://get.n8n.io | sh

✓ Docker found (24.0.6)
✓ Docker Compose found (v2.24.0)
✓ Created ./n8n/compose.yml
✓ Created ./n8n/searxng-settings.yml
✓ Created ./n8n/.env (unique secrets generated)
Pulling images and starting (this can take a few minutes on first run)...
✓ Started n8n 2.32.0 and sandbox services

n8n is running at: http://localhost:5678
Data stored in:    ./n8n (Docker volume: n8n-data)
Config files:      ./n8n/compose.yml, ./n8n/.env

To stop:      docker compose -f ./n8n/compose.yml down
To upgrade:   curl -fsSL https://get.n8n.io | sh -s -- --upgrade
To uninstall: docker compose -f ./n8n/compose.yml down -v   
# -v DELETES all n8n data
              rm -rf ./n8n

בפעם הראשונה לוקח ל-n8n רגע להשלים את ההפעלה. הפקודה ממתינה ומדפיסה את הכתובת רק כשהוא מוכן. אם הדף אינו נטען מיד, ממתינים מעט ומרעננים.

#מה כלול כברירת מחדל

הרצת הפקודה מגדירה את כל הרכיבים הבאים באופן אוטומטי. אין שום דבר נוסף להתקין:

המלצות להתקנה בצוות או בסביבת ייצור:

• מסד נתונים: אם אתם מגדירים את n8n עבור צוות או עבור סביבת ייצור, שקלו מסד נתונים חזק יותר כמו Postgres במקום ברירת המחדל המובנית. ראו התקנה באמצעות Docker Compose.
• סביבת sandbox: התקנה זו משתמשת ב-sandbox המצורף של n8n, שמתאים להתנסות, אך עבור סביבת ייצור n8n ממליצה כיום על Daytona במקום זאת. ראו הגדרת n8n Assistant.

#רשות: הפעלת n8n Assistant

n8n פועל במלואו גם ללא n8n Assistant, שהוא תוספת רשות. ברגע ש-n8n רץ, הדרך הקלה ביותר להפעיל אותו היא מתוך ממשק המשתמש בהגדרות ה-AI של המופע, ולהוסיף שם את מפתח ה-API של המודל. מעדיפים להגדיר אותו לפני שבכלל התחברתם? ערכו את קובץ .env במקום זאת:

1. פותחים את קובץ .env שהפקודה יצרה (בברירת מחדל בנתיב ./n8n/.env).
2. מוסיפים את מפתח ספק ה-AI לשורה N8N_INSTANCE_AI_MODEL_API_KEY.
3. מפעילים מחדש את n8n: docker compose -f ./n8n/compose.yml up -d

שלבי ההגדרה המלאים, כולל הספקים הנתמכים, מפורטים בתיעוד הגדרת n8n Assistant.

כברירת מחדל, חיפוש הרשת של n8n Assistant פועל דרך כלי חיפוש מצורף ללא צורך בהגדרה. אם אתם מעדיפים להשתמש ב-Brave Search, הוסיפו את מפתח ה-API של Brave לשורה INSTANCE_AI_BRAVE_SEARCH_API_KEY באותו קובץ .env. הוא נכנס לשימוש אוטומטית ברגע שהוגדר.

אין צורך לפתוח פורטים נוספים או להגדיר דבר עבור שירותים אלה. רק n8n עצמו (פורט 5678) נגיש מחוץ למחשב שלכם. כל השאר נשאר פרטי כברירת מחדל.

#פקודות יומיום

#מה משתנה בשדרוג

פקודת השדרוג מעבירה הן את n8n והן את שירותי ה-sandbox המצורפים לגרסאות חדשות יותר. היא עורכת שתי שורות ב-.env: את N8N_VERSION ואת N8N_SANDBOX_VERSION. הנתונים, הסודות וההגדרות האחרות שלכם נשארים כפי שהם.

אם התקנתם לפני שגרסת ה-sandbox עברה אל .env, קובץ ה-compose.yml שלכם עדיין מציין תגיות image קבועות של ה-sandbox. השדרוג הראשון משכתב את שורות ה-image הללו כך שישתמשו ב-N8N_SANDBOX_VERSION, מעביר את כתובת ה-runner של ה-sandbox (SANDBOX_RUNNER_HTTP_BASE_URL) מ-http:// ל-https://, ומדפיס הערה שמציינת זאת. שום דבר אחר ב-compose.yml אינו משתנה, כך שכל עריכה שביצעתם נשמרת במקומה.

#דגלים (לבקרה נוספת)

הוספת דגלים אלה בסוף פקודת ההתקנה משנה את פעולתה:

#מעדיפים לא להריץ סקריפט מהאינטרנט?

אפשר להוריד ולקרוא אותו תחילה, ואז להריץ אותו בעצמכם:

curl -fsSL https://get.n8n.io -o get-n8n.sh
less get-n8n.sh   
# review it
sh get-n8n.sh

#משתמשי Windows

פקודת ההתקנה בשורה אחת זקוקה למסוף שמבין סקריפטים של shell, מה ש-Command Prompt או PowerShell הרגילים של Windows אינם מספקים. הריצו אותה במקום זאת מאחד מאלה:

• WSL (Windows Subsystem for Linux), כאשר אינטגרציית WSL2 של Docker Desktop מופעלת.
• Git Bash (מותקן לצד Git for Windows), כאשר Docker Desktop פועל, יכול גם הוא להריץ סקריפטים של POSIX shell, אך n8n לא אימתה אותו מקצה לקצה עבור פקודת ההתקנה בשורה אחת. מומלץ להישאר עם WSL אלא אם וידאתם ש-Git Bash עובד עבור ההגדרה שלכם.

#מקורות קשורים

• אפשרויות התקנה
• התקנה באמצעות Docker Compose
• התקנה עם npm
• התקנה עם Docker
• שימוש בספק ענן