תיעוד Nodaroהתחלה מהירה
הפעילו את Nodaro במהדורת Community באירוח עצמי בשתי פקודות, בדקו אותו בדף /setup, ואז הוסיפו מפתח ספק או חיבור ל-Nodaro Cloud כדי ליצור.
ההתחלה המהירה של מהדורת Community מביאה אתכם בשתי פקודות מאפס ל-Nodaro שרץ באירוח עצמי. מערך השירותים של Docker Compose מגיע עם מסד נתונים, שירות התחברות, אחסון ותורים משלו, ולכן אין חשבונות ענן ליצור, אין מפתחות API לחפש ואין מה להגדיר. צריך Docker בגרסה 24 ומעלה עם Docker Compose v2.
הפעלת Nodaro
שכפול מאגר הקוד והפעלת המערך
git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml upהאתחול הראשון מוריד את אימג׳ האפליקציה הבנוי מראש, בגודל של כ-2.4 GB, ואת השירותים שמגיעים איתו. זו הורדה, לא קומפילציה, ולכן היא לא מעמיסה על המעבד שלכם. האתחולים הבאים נמשכים שניות.
פתיחת האפליקציה ויצירת החשבון שלכם
פתחו את http://localhost:3000 והירשמו עם כל כתובת אימייל וסיסמה. החשבון עובד מיד, כי מערך מקומי לא שולח אימייל אישור.
בביקור הראשון, דף הבית מוסיף את תהליך ההדגמה Welcome Demo. זה תהליך שכבר רץ עד הסוף: תסריט, תמונה, וידאו, קול ועריכה סופית, וכל התוצאות שלו כבר נוצרו. אפשר לפתוח את הרכיבים שלו ולנגן את הקליפ הסופי עוד לפני שמגדירים משהו.
בדיקת ההתקנה בדף /setup
פתחו את http://localhost:3000/setup. הדף מציג את הסטטוס בזמן אמת של מסד הנתונים, של Redis, של האחסון, של מפתח ההצפנה ושל מפתחות הספק שלכם, והוא לא דורש התחברות. במערך חדש, כל הכרטיסים ירוקים חוץ מהכרטיס של מפתחות הספק.
הוספת ספק מודלים
בחרו אחת משלוש הדרכים שלמטה. כשיש ספק, לחצו על הרצה ברכיב תמונת הסצנה של ההדגמה. הרכיב משתמש ב-Z-Image, מודל התמונה הזול ביותר, ומחזיר תוצאה בתוך שניות.
אילו שירותים מופעלים
| שירות | מה הוא עושה | איפה הנתונים שלו נשמרים |
|---|---|---|
| Postgres (אימג׳ של Supabase) | מסד הנתונים. המיגרציות מוחלות מעצמן באתחול הראשון. | ה-volume db-data |
| GoTrue | התחברות עם אימייל וסיסמה. לא צריך שרת אימייל. | — |
| PostgREST | ה-API של הנתונים, שהעורך מדבר איתו | — |
| MinIO | אחסון המדיה. התמונות, הסרטונים והאודיו שנוצרים נשארים בדיסק שלכם. | ה-volume minio-data |
| Redis | תורי המשימות | ה-volume redis-data |
| Nodaro | האפליקציה: העורך, ה-API וה-workers, בפורט 3000 | ה-volume app-data |
המערך חושף שני פורטים במחשב שלכם: הפורט 3000 לאפליקציה והפורט 9001 לקונסולה של MinIO, שזמינה רק בממשק ה-loopback.
הוספת ספק מודלים
הצפייה בהדגמה לא עולה כלום ועובדת גם בלי חיבור לאינטרנט. כדי להריץ רכיבים בעצמכם, ההתקנה צריכה ספק מודלים. עד שיש לה ספק, דף הבית מציג הודעה שאפשר לסגור, ההתקנה הזו עדיין לא יכולה ליצור, עם כפתור לכל אפשרות.
שלוש הדרכים יכולות לפעול זו לצד זו, עם כלל אחד. כשההתקנה מחוברת ל-Nodaro Cloud ויש לה גם NODARO_API_KEY, היא משתמשת בחיבור ומתעלמת מהמפתח.
בלי קבצים ובלי הפעלה מחדש.
- פתחו את הדף
/setupוהשלימו את שלב 1, יצירת פרטי ההתחברות לשרת. כרטיסי התקינות לא דורשים התחברות, אבל שמירת מפתח כן. - מצאו את אריחי הספקים במקטע תקינות ההתקנה. אותם אריחים נמצאים גם באפליקציה, תחת אינטגרציות › ספקי מודלים.
- לחצו על הדבקת מפתח באחד האריחים, הדביקו את המפתח ושמרו.
כל אריח מציין במה המפתח שלו משמש ואיפה אפשר להשיג מפתח כזה. המפתח נשמר מוצפן במסד הנתונים שלכם ונכנס לתוקף מיד. אם תחברו את ההתקנה ל-Nodaro Cloud, אף אריח לא נדרש: החיבור מכסה את כולם.
בלי מפתחות לנהל.
- בדף
/setup, בשלב 2, חיבור ספק מודלים, לחצו על חיבור nodaro.ai. - הדפדפן שלכם פותח את מסך ההסכמה של Nodaro Cloud. התחברו, או צרו חשבון חינמי עם 1,500 קרדיטים, ואשרו.
- אתם חוזרים להתקנה שלכם, וההתקנה כבר מחוברת.
מודלי תמונה, וידאו, דיבור וטקסט רצים אז דרך חשבון ה-Nodaro Cloud שלכם, ומשלמים עליהם בקרדיטים. הפרטים נמצאים בדף חיבור ל-Nodaro Cloud.
למי שעובד בתשתית כקוד (IaC). צרו קובץ בשם .env ליד קובץ ה-Compose:
KIE_API_KEY=... # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=... # a personal API token from app.nodaro.ai, Settings › API Tokensואז החילו אותו:
docker compose -f docker-compose.community.yml up -dמפתח בקובץ .env גובר על מפתח שהודבק במסך. האריח שלו מציג set (env), ואי אפשר לערוך אותו במקום.
בדף מפתחות ספק מפורטים כל הספקים, ומה כל אחד מהם מאפשר.
אתם משלמים ישירות לספקים שלכם. במהדורת Community אין מערכת קרדיטים, אין עמלות של Nodaro ואין סימן מים.
למידת העורך בחינם
הלשונית מדריכים בדף הבית נפתחת בסדרה של מדריכים שלב אחר שלב, שנוספים באתחול הראשון. העיון בהם לא עולה כלום. התמונות, הסרטונים והאודיו שלהם נטענים מה-CDN של Nodaro, ולכן הם צריכים חיבור לאינטרנט. ראו את הדף מדריכים ותבניות.
בדיקת ההתקנה משורת הפקודה
לבדיקה מעמיקה יותר ממה שהדף /setup יכול להציג, הריצו את סקריפט בדיקת החוזה מהעותק המשוכפל שלכם. הסקריפט צריך Node.js.
node tools/community-smoke.mjs http://localhost:3000הסקריפט רושם חשבון זמני, יוצר תהליך, שולח יצירה, ממתין עד שהמשימה מגיעה למצב הסופי שלה ומדווח אילו בדיקות עברו. בדיקה שלא רלוונטית להתקנה שלכם, למשל כי כבר הוספתם מפתח ספק, מדווחת כבדיקה שדולגה. בלי דגלים נוספים, הסקריפט אף פעם לא מוציא כסף.
כדי לבדוק גם יצירה אמיתית, הוסיפו --keyed:
node tools/community-smoke.mjs http://localhost:3000 --keyedהדגל --keyed דורש KIE_API_KEY או REPLICATE_API_TOKEN בהתקנה, בקובץ .env או כמפתח שהודבק בדף /setup. הוא מריץ יצירה אחת במודל הזול ביותר של המפתח הזה: Z-Image עם KIE_API_KEY, ו-Flux 2 Klein עם REPLICATE_API_TOKEN. בדרך כלל זה עולה אצל הספק פחות מסנט אחד. אחר כך הסקריפט בודק שהמדיה הגיעה לאחסון של ההתקנה עצמה. חיבור או אסימון של Nodaro Cloud נבדקים בנפרד.
פקודות יומיומיות
| פעולה | פקודה |
|---|---|
| הפעלה ברקע | docker compose -f docker-compose.community.yml up -d |
| מעקב אחרי היומנים | docker compose -f docker-compose.community.yml logs -f |
| עצירת המערך | docker compose -f docker-compose.community.yml down |
החלת קובץ .env ששונה | docker compose -f docker-compose.community.yml up -d |
אל תוסיפו -v ל-down אלא אם זו באמת הכוונה: הפקודה docker compose down -v מוחקת את ה-volumes, ואיתם את מסד הנתונים ואת המדיה שלכם.
לפני שאנשים אחרים יוכלו לגשת להתקנה
ברירות המחדל של קובץ ה-Compose נועדו לשימוש מקומי, והן ציבוריות. לפני שאתם חושפים את המערך לרשת, צרו מפתחות אימות חדשים, הגדירו סיסמאות חדשות למסד הנתונים ולאחסון והגישו את ההתקנה ב-HTTPS. פעלו לפי הסעיף הקשחת ההתקנה לפני שחושפים אותה בדף התקנה ולפי הדף פרוקסי הפוך ו-HTTPS.
השלבים הבאים
- התקנה — ההגדרה המלאה, עם שירותים מנוהלים, אחסון וסודות.
- פרוקסי הפוך ו-HTTPS — הגשת ההתקנה בדומיין שלכם.
- עדכון גרסה — תגי אימג׳ ועדכונים.
- גיבוי ושחזור — פקודה אחת לכל כיוון.
- פתרון בעיות — כשכרטיס בדף
/setupאדום.
שאלות נפוצות
כמה זמן נמשכת ההפעלה הראשונה של Nodaro באירוח עצמי?
האתחול הראשון של Nodaro באירוח עצמי מוריד את אימג׳ האפליקציה הבנוי מראש, בגודל של כ-2.4 GB, ואת השירותים שמגיעים איתו, ולכן הוא נמשך כמה דקות בחיבור רגיל. זו הורדה, לא קומפילציה. האתחולים הבאים נמשכים שניות.
האם צריך קובץ .env כדי להריץ את מהדורת Community?
לא. לכל ערך בקובץ docker-compose.community.yml יש ברירת מחדל שעובדת. צרו קובץ .env רק כדי להוסיף מפתחות ספק, לשנות את הכתובת הציבורית או להשתמש בשירותים מנוהלים משלכם.
למה ההתקנה החדשה שלי לא יכולה ליצור כלום?
להתקנה חדשה עדיין אין ספק מודלים. הדביקו מפתח ספק בדף /setup, הגדירו מפתח בקובץ .env או חברו את ההתקנה לחשבון Nodaro Cloud. עד שיש ספק, דף הבית מציג הודעה עם שתי האפשרויות.
האם בטוח לחשוף לאינטרנט את ההתקנה עם הגדרות ברירת המחדל?
לא. המפתחות והסיסמאות שמוגדרים כברירת מחדל בקובץ ה-Compose הם ציבוריים. לפני שאנשים אחרים יוכלו לגשת להתקנה, צרו מפתחות אימות חדשים, הגדירו סיסמאות חדשות והגישו אותה ב-HTTPS מאחורי פרוקסי הפוך.
כמה עולה מהדורת Community?
על מהדורת Community לא משלמים ל-Nodaro כלום. אין בה מערכת קרדיטים, אין עמלות של Nodaro ואין סימן מים. אתם משלמים ישירות לספקי המודלים שלכם, או משלמים בקרדיטים על מה שרץ דרך חיבור ל-Nodaro Cloud.
דפים קשורים
התקנה
מפתחות ספק
חיבור ל-Nodaro Cloud
פרוקסי הפוך ו-HTTPS
פתרון בעיות
עודכן לאחרונה
מחולל AI באירוח עצמי
הריצו את Nodaro כמחולל וידאו, תמונות ומוזיקה ב-AI באירוח עצמי, על השרת שלכם, עם המפתחות והאחסון שלכם, בחינם במסגרת רישיון ה-fair-code שלו.
דרישות
מה צריך ל-Nodaro באירוח עצמי: Docker 24 ומעלה עם Compose v2, מסד נתונים של Supabase, אחסון תואם S3, פורטים, ומפתח ספק או חיבור ל-Nodaro Cloud.