📘 תיעוד 3

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

לאינדקס המלא של התיעוד, ראו llms.txt. גרסאות Markdown של דפי התיעוד זמינות על ידי הוספת .md לכתובות הדפים. הדף הזה זמין כ-Markdown.

התקינו את n8n משורת הפקודה באמצעות התקנה בשורה אחת.

#למי המדריך הזה

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

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

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

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

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

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

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

מידע: פקודת ההתקנה בשורה אחת דורשת במיוחד את תוסף docker compose בגרסה v2 (לא את הקובץ הבינארי העצמאי הישן docker-compose), ובודקת שדמון Docker רץ. אם אתם משתמשים ב-Podman, ב-Colima או במנועים תואמי Docker אחרים, התקינו את ממשק השורה 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 להתקנה הזו.

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

#אופציונלי: הפעלת n8n Assistant

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

1. פתחו את קובץ .env שהפקודה יצרה (כברירת מחדל ב-./n8n/.env).
2. הוסיפו את מפתח ספק הבינה המלאכותית לשורה 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 וגם את שירותי ארגז החול המצורפים לגרסאות חדשות יותר. היא עורכת שתי שורות ב-.env: N8N_VERSION ו-N8N_SANDBOX_VERSION. הנתונים, הסודות ושאר ההגדרות נשארים כפי שהם.

אם התקנתם לפני שגרסת ארגז החול עברה אל .env, הקובץ compose.yml עדיין מציין תגיות תמונה קבועות של ארגז החול. השדרוג הראשון משכתב את שורות התמונה האלה כך שישתמשו ב-N8N_SANDBOX_VERSION, מחליף את כתובת מריץ ארגז החול (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, ושורת הפקודה הרגילה של Windows או PowerShell לא מבינים אותם. הריצו אותה במקום מתוך:

• 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
• שימוש בספק ענן