תיעוד 5
ניהול הגדרות באמצעות משתני סביבה
הגדרת בעלים של מופע n8n בהתקנה עצמית, SSO, מדיניות אבטחה, הזרמת יומנים, MCP וחבילות קהילה מתוך משתני סביבה.
אפשר לנהל חלק מהגדרות המופע מתוך משתני סביבה, במקום להגדיר אותן דרך ממשק המשתמש. זה שימושי כשמקימים מופעי n8n באופן אוטומטי, למשל דרך צינור פריסה פנימי.
לכל תחום נתמך יש משתנה סביבה ייעודי בשם <AREA>_MANAGED_BY_ENV. הגדר את המשתנה הזה ל-true כדי להפעיל ניהול באמצעות משתני סביבה לתחום הזה. לאחר מכן n8n מחיל את משתני הסביבה הקשורים ונועל את פקדי ממשק המשתמש התואמים.
#איך זה עובד
כאשר מגדירים את <AREA>_MANAGED_BY_ENV ל-true:
- n8n מחיל מחדש את ההגדרות ממשתני הסביבה בכל הפעלה.
- פקדי ממשק המשתמש התואמים הופכים לקריאה בלבד.
כאשר <AREA>_MANAGED_BY_ENV הוא false (ברירת המחדל), n8n מתעלם ממשתני הסביבה הקשורים, גם אם הגדרת אותם.
הערכים נשמרים כשמכבים את *_MANAGED_BY_ENV
החזרת *_MANAGED_BY_ENV ל-false מחזירה גישת כתיבה בממשק המשתמש, אבל שומרת את הערכים שהוחלו לאחרונה. ערוך אותם אחר כך דרך ממשק המשתמש אם ברצונך לשנות אותם.
פקדי ממשק לקריאה בלבד באופן לא צפוי
אם הגדרה מופיעה כקריאה בלבד ולא ציפית לכך, בדוק אם משתנה *_MANAGED_BY_ENV התואם הוא true בסביבה שלך.
התחומים הנתמכים ומשתני ההפעלה שלהם:
- בעלים של המופע:
N8N_INSTANCE_OWNER_MANAGED_BY_ENV - SSO:
N8N_SSO_MANAGED_BY_ENV - מדיניות אבטחה:
N8N_SECURITY_POLICY_MANAGED_BY_ENV - הזרמת יומנים:
N8N_LOG_STREAMING_MANAGED_BY_ENV - MCP:
N8N_MCP_MANAGED_BY_ENV - חבילות קהילה:
N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV
הגדר את <AREA>_MANAGED_BY_ENV כדי להפעיל את הקבוצה
לשאר משתני הסביבה של תחום אין השפעה אלא אם <AREA>_MANAGED_BY_ENV הוא true. הגדר אותו ל-true כדי להפעיל את הקבוצה.
#בעלים של המופע
זמינות התכונה
ניהול בעלים של המופע באמצעות משתני סביבה זמין מ-n8n 2.17.0.
אפשר להכין מראש את בעלים של המופע מתוך משתני סביבה, במקום לעבור את תהליך ההגדרה בתוך היישום. כדי לשנות את כתובת הדוא"ל של הבעלים אחרי ההגדרה, ראה שינוי כתובת הדוא"ל של בעלים המופע ב-n8n בהתקנה עצמית.
N8N_INSTANCE_OWNER_PASSWORD_HASH חייב להיות גיבוב bcrypt
המשתנה הזה מצפה לערך bcrypt שכבר עבר גיבוב. הגדרת סיסמה בטקסט גלוי שוברת את ההתחברות.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_INSTANCE_OWNER_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל את בעלים המופע מתוך משתני סביבה. כאשר הערך הוא true, n8n דורס את פרטי בעלים המופע שלהלן בכל הפעלה, נועל את פקד ממשק המשתמש של המשתמש הזה, ודוחה כתיבות API. |
N8N_INSTANCE_OWNER_EMAIL | String | - | כתובת דוא"ל של בעלים המופע. |
N8N_INSTANCE_OWNER_FIRST_NAME | String | - | שם פרטי של בעלים המופע. |
N8N_INSTANCE_OWNER_LAST_NAME | String | - | שם משפחה של בעלים המופע. |
N8N_INSTANCE_OWNER_PASSWORD_HASH | String | - | גיבוב bcrypt של סיסמת בעלים המופע. הגדרת סיסמה בטקסט גלוי שוברת את ההתחברות. |
כתובת הדוא"ל של הבעלים חייבת להיות ייחודית
N8N_INSTANCE_OWNER_EMAIL אסור שכבר תהיה שייכת למשתמש אחר במופע. ההגדרה הזו מעדכנת את חשבון בעלים המופע הקיים. היא לא מעבירה בעלות למשתמש קיים אחר ולא ממזגת חשבונות משתמש. כדי להשתמש בכתובת דוא"ל שכבר שייכת למשתמש אחר, שנה או מחק את המשתמש הזה קודם כדי שכתובת הדוא"ל תהיה פנויה.
#SSO
זמינות התכונה
כניסה יחידה (single sign-on) זמינה ב:
- התקנה עצמית: Business, Enterprise
n8n Cloud Enterprise תומך גם בכניסה יחידה, אבל לא דרך משתני הסביבה בדף הזה.
ניהול SSO מתוך משתני סביבה זמין מ-n8n 2.18.0.
הגדר כניסה יחידה מתוך משתני סביבה.
#הפעלה והגדרות משותפות
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_SSO_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל SSO מתוך משתני סביבה. כאשר הערך הוא true, n8n מחיל את משתני ה-SSO בכל הפעלה ונועל את פקדי ממשק המשתמש התואמים. |
N8N_SSO_USER_ROLE_PROVISIONING | Enum string: disabled, instance_role, instance_and_project_roles | disabled | איך n8n מקצה תפקידים למשתמשים שנכנסים דרך SSO. disabled לא מקצה שום תפקידים. instance_role מקצה רק את התפקיד ברמת המופע. instance_and_project_roles מקצה גם תפקידים ברמת המופע וגם תפקידי פרויקט. |
#OIDC
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_SSO_OIDC_LOGIN_ENABLED | Boolean | false | האם להפעיל כניסת OIDC. |
N8N_SSO_OIDC_CLIENT_ID | String | - | מזהה לקוח OIDC שהנפיק ספק הזהויות שלך. |
N8N_SSO_OIDC_CLIENT_SECRET | String | - | סוד לקוח OIDC שהנפיק ספק הזהויות שלך. |
N8N_SSO_OIDC_DISCOVERY_ENDPOINT | String | - | כתובת URL של נקודת הקצה לגילוי OIDC (כתובת ה-URL של .well-known/openid-configuration של ספק הזהויות שלך). |
N8N_SSO_OIDC_PROMPT | String | - | פרמטר prompt אופציונלי של OIDC לשליחה עם בקשת ההרשאה, למשל login או consent. |
N8N_SSO_OIDC_ACR_VALUES | String | - | פרמטר acr_values אופציונלי של OIDC. השתמש בזה כדי לבקש הקשר אימות מסוים, למשל תהליך MFA מסוג step-up. |
#SAML
משתני המטא-דאטה של SAML בלעדיים הדדית
הגדר את N8N_SSO_SAML_METADATA (XML מוטמע) או את N8N_SSO_SAML_METADATA_URL (URL), לא את שניהם.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_SSO_SAML_LOGIN_ENABLED | Boolean | false | האם להפעיל כניסת SAML. |
N8N_SSO_SAML_METADATA | String | - | מטא-דאטה של ספק הזהויות ב-SAML כמחרוזת XML. בלעדי הדדית עם N8N_SSO_SAML_METADATA_URL. אל תגדיר את שניהם. |
N8N_SSO_SAML_METADATA_URL | String | - | כתובת URL שממנה נשלף מטא-דאטה של ספק הזהויות ב-SAML. בלעדי הדדית עם N8N_SSO_SAML_METADATA. אל תגדיר את שניהם. |
#מדיניות אבטחה
זמינות התכונה
ניהול מדיניות האבטחה מתוך משתני סביבה זמין מ-n8n 2.18.0.
נהל את מדיניות האבטחה של המופע מתוך משתני סביבה, כולל אכיפת MFA והגבלות על המרחב האישי.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_SECURITY_POLICY_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל את מדיניות האבטחה מתוך משתני סביבה. כאשר הערך הוא true, n8n מחיל את משתני מדיניות האבטחה בכל הפעלה ונועל את פקדי ממשק המשתמש התואמים. |
N8N_MFA_ENFORCED_ENABLED | Boolean | false | האם לאכוף אימות דו-שלבי על כל המשתמשים (true) או לא (false). |
N8N_PERSONAL_SPACE_PUBLISHING_ENABLED | Boolean | true | האם משתמשים יכולים לפרסם מהמרחב האישי שלהם (true) או לא (false). |
N8N_PERSONAL_SPACE_SHARING_ENABLED | Boolean | true | האם משתמשים יכולים לשתף משאבים מהמרחב האישי שלהם (true) או לא (false). |
#הזרמת יומנים
זמינות התכונה
ניהול הזרמת יומנים מתוך משתני סביבה זמין מ-n8n 2.19.0.
נהל יעדי הזרמת יומנים מתוך משתני סביבה. ראה הגדרה באמצעות משתני סביבה למבנה ה-JSON של כל יעד.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_LOG_STREAMING_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל הזרמת יומנים מתוך משתני סביבה. כאשר הערך הוא true, n8n מחיל את משתני הזרמת היומנים בכל הפעלה ונועל את פקדי ממשק המשתמש התואמים. |
N8N_LOG_STREAMING_DESTINATIONS | JSON string | - | מערך JSON של יעדי הזרמת יומנים. כל יעד הוא אובייקט עם type של webhook, syslog או sentry, ובנוסף ההגדרה של הסוג הזה. |
#MCP
זמינות התכונה
ניהול גישת MCP ברמת המופע מתוך משתני סביבה זמין מ-n8n 2.20.0.
נהל גישת MCP ברמת המופע מתוך משתני סביבה.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_MCP_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל הגדרות MCP מתוך משתני סביבה. כאשר הערך הוא true, n8n מחיל את משתני ה-MCP בכל הפעלה ונועל את פקדי ממשק המשתמש התואמים. |
N8N_MCP_ACCESS_ENABLED | Boolean | false | האם להפעיל גישת MCP ברמת המופע (true) או לא (false). |
#חבילות קהילה
זמינות התכונה
ניהול חבילות קהילה מותקנות מתוך משתני סביבה זמין מ-n8n 2.21.0.
נהל את קבוצת חבילות הקהילה המותקנות מתוך משתני סביבה. n8n מתאם את החבילות המותקנות מול הרשימה בכל הפעלה. אי אפשר להסיר או לעדכן חבילות מנוהלות דרך ממשק המשתמש.
גם N8N_COMMUNITY_PACKAGES_ENABLED חייב להיות מוגדר ל-true (ברירת המחדל). כאשר חבילות קהילה מושבתות, n8n מתעלם מ-N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV וכותב אזהרה ליומן.
| משתנה | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV | Boolean | false | הגדר ל-true כדי לנהל חבילות קהילה מותקנות מתוך משתני סביבה. כאשר הערך הוא true, n8n מתאם את החבילות המותקנות מול N8N_COMMUNITY_PACKAGES בכל הפעלה, מתקין חבילות חסרות, מתקן גרסאות, ומסיר כל חבילה שמותקנת כרגע ואינה ברשימה. דף ההגדרות Community nodes הופך לקריאה בלבד: אי אפשר להתקין, לעדכן או להסיר חבילות מממשק המשתמש כל עוד זה מופעל. |
N8N_COMMUNITY_PACKAGES | JSON string | - | מערך JSON של חבילות קהילה להתקנה. כל רשומה היא אובייקט עם name (חובה) ושדות אופציונליים version ו-checksum. אפשר גם לשלב את הגרסה בתוך השם בצורה <package-name>@<version>. ראה התקנה באמצעות משתנה סביבה לעיון המלא לפי שדה. |
#דוגמה משולבת
הדוגמה הבאה מגדירה מופע שכל ששת התחומים בו מנוהלים באמצעות משתני סביבה. היא יוצרת את בעלים המופע, מגדירה SSO ב-OIDC, אוכפת MFA, רושמת יעד הזרמת יומנים מסוג webhook, מפעילה גישת MCP, ומנהלת חבילת קהילה.
# בעלים של המופע
export N8N_INSTANCE_OWNER_MANAGED_BY_ENV=true
export N8N_INSTANCE_OWNER_EMAIL=<owner-email>
export N8N_INSTANCE_OWNER_FIRST_NAME=<first-name>
export N8N_INSTANCE_OWNER_LAST_NAME=<last-name>
export N8N_INSTANCE_OWNER_PASSWORD_HASH=<bcrypt-hash>
# SSO באמצעות OIDC
export N8N_SSO_MANAGED_BY_ENV=true
export N8N_SSO_USER_ROLE_PROVISIONING=instance_role
export N8N_SSO_OIDC_LOGIN_ENABLED=true
export N8N_SSO_OIDC_CLIENT_ID=<client-id>
export N8N_SSO_OIDC_CLIENT_SECRET=<client-secret>
export N8N_SSO_OIDC_DISCOVERY_ENDPOINT=<discovery-url>
# מדיניות אבטחה
export N8N_SECURITY_POLICY_MANAGED_BY_ENV=true
export N8N_MFA_ENFORCED_ENABLED=true
export N8N_PERSONAL_SPACE_PUBLISHING_ENABLED=false
export N8N_PERSONAL_SPACE_SHARING_ENABLED=false
# הזרמת יומנים
export N8N_LOG_STREAMING_MANAGED_BY_ENV=true
export N8N_LOG_STREAMING_DESTINATIONS='[{"type":"webhook","url":"https://logs.example.com/n8n"}]'
# MCP
export N8N_MCP_MANAGED_BY_ENV=true
export N8N_MCP_ACCESS_ENABLED=true
# חבילות קהילה
export N8N_COMMUNITY_PACKAGES_MANAGED_BY_ENV=true
export N8N_COMMUNITY_PACKAGES='[{"name":"n8n-nodes-foo","version":"1.2.3"}]'#הגדרת משתני סביבה
לדרכים הנתמכות להגדרת משתני סביבה, ראה שיטות הגדרה.