תיעוד Nodaroדרישות
מה צריך ל-Nodaro באירוח עצמי: Docker 24 ומעלה עם Compose v2, מסד נתונים של Supabase, אחסון תואם S3, פורטים, ומפתח ספק או חיבור ל-Nodaro Cloud.
ל-Nodaro באירוח עצמי יש חמש דרישות: Docker, מסד נתונים עם התחברות, אחסון אובייקטים תואם S3, Redis ולפחות ספק מודלים אחד. מערך ה-Compose של מהדורת Community כולל את מסד הנתונים, את האחסון ואת Redis, ולכן בשרת יחיד צריך רק Docker וספק מודלים. כל השאר בדף הזה אופציונלי או מיועד לסביבת ייצור.
מה צריך
| דרישה | כלול במערך ה-Compose | או משלכם |
|---|---|---|
| Docker 24+ ו-Docker Compose v2 | — | נדרש. מריצים אותו כ-docker compose, ולא כ-docker-compose. |
| מסד נתונים והתחברות | Supabase Postgres, GoTrue ו-PostgREST. המיגרציות מוחלות באתחול. הרשמה עם אימייל וסיסמה. | פרויקט Supabase מנוהל. המסלול החינמי מספיק. צריך את כתובת הפרויקט, את מפתח ה-service-role ואת מפתח ה-anon שלו, ואת המיגרציות מחילים בעצמכם. |
| אחסון אובייקטים | MinIO, והמדיה נשמרת בדיסק שלכם | כל אחסון תואם S3. נבדקו: Cloudflare R2 (מומלץ, בלי עמלות על תעבורה יוצאת), AWS S3, MinIO ו-Backblaze B2. |
| תורים | Redis 7 | Redis משלכם, כולל אשכול או נקודת קצה של Sentinel |
| ספק מודלים | — | לפחות מפתח ספק אחד, או חיבור ל-Nodaro Cloud |
הדפדפנים של המשתמשים שלכם חייבים להיות מסוגלים לקרוא את המדיה בלי התחברות, כי Nodaro מעביר לדפדפן כתובות URL ציבוריות של מדיה. ה-MinIO המובנה עושה את זה דרך הכתובת של האפליקציה עצמה, תחת /storage/. אם יש לכם bucket משלכם, ראו את הסעיף הגדרת אחסון האובייקטים בדף התקנה.
ספקי מודלים
רכיבים שקוראים למודל AI צריכים ספק. בלי ספק, ההתקנה עולה וההדגמה נפתחת, אבל אף רכיב שקורא למודל לא יכול לרוץ. הוסיפו לפחות אחד מהמפתחות האלה, בדף /setup או בקובץ .env:
| משתנה | מה הוא נותן |
|---|---|
KIE_API_KEY | הכיסוי הרחב ביותר של מודלים: מודלי תמונה, וידאו, אודיו וטקסט |
REPLICATE_API_TOKEN | ספק חלופי עם קטלוג משלו |
ANTHROPIC_API_KEY | מודלי Claude לרכיבי הטקסט |
ELEVENLABS_API_KEY | יכולות קול: טקסט לדיבור, דיבוב, משנה קול ויישור מאולץ |
FAL_KEY | אופציונלי. מודלים כמו Sync Lipsync v3. בלעדיו, המודלים האלה לא זמינים, ושאר האפליקציה לא מושפעת. |
במקום מפתחות, אפשר לחבר את ההתקנה לחשבון Nodaro Cloud: ראו את הדף חיבור ל-Nodaro Cloud. הרשימה המלאה של המפתחות, כולל אלה שמשמשים רכיבים מסוימים, נמצאת בדף מפתחות ספק.
אופציונלי
- Node.js 22 ומעלה, כדי להריץ את ה-API או את ה-workers מחוץ ל-Docker, לפיתוח. גם סקריפט הבדיקה של שורת הפקודה ומחולל המפתחות שבתיקייה
tools/רצים עם Node.js. - שם דומיין ותעודת TLS, לסביבת ייצור. ראו את הדף פרוקסי הפוך ו-HTTPS.
פורטים
| פורט | מי משתמש בו | קובץ ה-Compose חושף אותו |
|---|---|---|
3000 | האפליקציה: העורך, ה-API, המדיה וההתחברות, כולם באותו origin | כן |
9001 | הקונסולה של MinIO, לפתרון בעיות | כן, רק ב-127.0.0.1 |
80 ו-443 | הפרוקסי ההפוך שלכם, ל-HTTPS | Nodaro לא חושף אותם |
9000 | ה-API בתוך הקונטיינר. לקוחות MCP חייבים להגיע אליו ישירות. | לא. ראו את הדף MCP בהתקנה באירוח עצמי. |
Redis ומסד הנתונים נמצאים בתוך הרשת של Compose, ואף פעם לא תופסים פורט במחשב שלכם. אם הפורט 3000 או 9001 תפוס, שנו את צד המארח במיפוי הזה בקובץ docker-compose.community.yml.
דיסק
- האימג׳. האתחול הראשון מוריד כ-2.4 GB.
- ה-volumes. ב-
db-dataנמצא מסד הנתונים, ב-minio-dataהמדיה, ב-redis-dataהתורים וב-app-dataמפתח ההצפנה של המופע. ה-volume של המדיה גדל עם כל תוצאה, כי Nodaro אף פעם לא מוחק מעצמו מדיה שמורה. אם אתם רוצים שמדיה ישנה תימחק אוטומטית, הוסיפו ל-bucket שלכם כלל מחזור חיים. ראו את הדף הרחבת קיבולת.
גודל המכונה
במבנה ברירת המחדל הכול רץ בקונטיינר אחד, וזה מתאים לעד כ-5 משתמשים פעילים. הרינדור הוא העבודה הכבדה ביותר: ה-worker של הרינדור מריץ Chrome ללא ממשק, וה-CPU הוא שמגביל אותו, ולכן תכננו אחד או שניים כאלה לכל מכונה. ליותר משתמשים, פצלו את ה-workers בין כמה קונטיינרים. ראו את הדף הרחבת קיבולת.
לאימג׳ האפליקציה יש גרסאות למכונות amd64 ו-arm64.
Windows
ב-Windows, הריצו את סקריפטי הגיבוי והשחזור מתוך Git Bash, ה-shell ש-Git for Windows מתקין, ולא מ-PowerShell או מ-WSL. ראו את הדף גיבוי ושחזור.
שאלות נפוצות
איזו גרסת Docker נדרשת ל-Nodaro באירוח עצמי?
Nodaro באירוח עצמי צריך Docker בגרסה 24 ומעלה עם Docker Compose v2, שמריצים אותו בפקודה docker compose, ולא docker-compose.
האם צריך חשבון Supabase כדי להריץ את Nodaro באירוח עצמי?
לא. מערך ה-Compose של מהדורת Community כולל את Supabase Postgres, את GoTrue ואת PostgREST, ומחיל את המיגרציות בשבילכם. פרויקט Supabase מנוהל הוא אפשרות, לא דרישה.
איזה אחסון אובייקטים עובד עם Nodaro?
Nodaro עובד עם ה-MinIO המובנה או עם כל אחסון תואם S3. Cloudflare R2, AWS S3, MinIO ו-Backblaze B2 נבדקו, ו-Cloudflare R2 מומלץ כי אין בו עמלות על תעבורה יוצאת.
האם האימג׳ של Nodaro רץ על שרתי ARM?
כן. אימג׳ האפליקציה זמין בגרסה ל-arm64 וגם בגרסה ל-amd64.
כמה משתמשים קונטיינר אחד יכול לשרת?
התקנה שרצה בקונטיינר אחד מתאימה לעד כ-5 משתמשים פעילים. מעבר לזה, פצלו את ה-workers לקונטיינרים נפרדים.
דפים קשורים
התחלה מהירה
התקנה
מפתחות ספק
מסד נתונים
הרחבת קיבולת
עודכן לאחרונה