SSD Nodes Learn Hosting plans →
מדריכים Matt Connorמאת Matt Connor · עודכן 2026-10-26

התקנת Discourse על שרת VPS באמצעות Docker

מדריך מעשי להתקנת Discourse על שרת VPS בעזרת ה-launcher הרשמי. נסביר איך להגדיר את קובץ app.yml, לנהל זיכרון ו-swap, להגדיר SMTP ולבצע rebuild תקין למערכת.

התקנת Discourse על שרת VPS: מכולה אחת, קובץ הגדרות אחד

כדי להתקין את Discourse על שרת VPS, יש להריץ את תוכנית ההתקנה של הפרויקט, לענות על אשף קצר ולהמתין לבנייה. Discourse מופץ כמכולת Docker יחידה המכילה את יישום ה-Rails, את PostgreSQL, את Redis ואת nginx. כל שינוי שתבצעו בהמשך מתבצע בקובץ אחד, /var/discourse/containers/app.yml, וכל שינוי מוחל על האתר באמצעות בנייה מחדש (rebuild).

ההתקנה הרשמית היא discourse_docker: סקריפט shell מסוג launcher בצירוף קבוצת תבניות YAML. Discourse אינו תומך בקובץ Compose שתכתבו בעצמכם, והמכולה אינה מיועדת לפירוק ידני. אם אתם רגילים ל-הרצת שירותים על VPS באמצעות Docker Compose, צפו למבנה שונה. אין כאן docker compose up -d, והפקודה ./launcher rebuild app היא זו שמבצעת את הפריסה.

דרישות קדם עבור Discourse

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

  • זיכרון. מכולה אחת מריצה את PostgreSQL, Redis, Sidekiq ושרת אינטרנט מבוסס Ruby. שלב ה-build מהדר קבצים (assets) ודורש יותר זיכרון מאשר האתר בזמן פעילותו השוטפת.
  • שם מתחם (domain name) אמיתי. קובץ התצורה לדוגמה שמגיע עם התוכנה מצהיר על כך במפורש: "Discourse לא יעבוד עם כתובת IP בלבד".
  • נתיב דואר יוצא. הפעלת חשבונות, איפוס סיסמאות, הזמנות מנהלים וסיכומי דואר נשלחים כולם באמצעות SMTP (פרוטוקול העברת דואר פשוט).
  • פורטים 80 ו-443 פנויים במארח, אלא אם בחרתם במכוון להציב את Discourse מאחורי proxy קיים.
תרשיםDiscourse published hardware requirements (official install docs, October 2026)
הנתונים שמאחורי התרשים
[
  {
    "label": "Documented minimum",
    "ram_gb": 1,
    "storage_gb": 10
  },
  {
    "label": "Documented recommended",
    "ram_gb": 2,
    "storage_gb": 20
  }
]

מסמך ההתקנה הרשמי קובע רף מינימלי של 1 GB זיכרון RAM עם swap ו-10 GB שטח אחסון, וממליץ על 2 GB זיכרון RAM עם 20 GB שטח אחסון. יש להתייחס למספר בשורה הראשונה כאל הערך המאפשר לסיום ההתקנה, ולא כאל הערך הרצוי להרצת קהילה. הפער משמעותי כיוון ששיא צריכת הזיכרון מתרחש בזמן ה-build, ולא בזמן הטיפול בתעבורת הגולשים.

הפניית הדומיין לשרת לפני ההתקנה

צרו רשומת A עבור שם המארח (hostname) שבו תשתמשו, ולאחר מכן ודאו את תקינותה מתוך השרת עצמו.

dig +short forum.example.com
curl -4 -s https://ifconfig.co

שתי הפקודות חייבות להציג את אותה כתובת. עליהן להיות מסונכרנות, כיוון שאשף ההתקנה מריץ בדיקת חיבור מול שם המארח שלכם; רשומה שעדיין מצביעה למקום אחר תגרום לכישלון הבדיקה. רשומה שיצרתם לפני שתי דקות עשויה עדיין להיות ב־cache, לכן המתינו עד לסיום ה־TTL (זמן חיים) הישן במקום לנסות לעקוף את האשף.

החליטו כעת אם הרשומה תעבור דרך CDN. רשומה שעוברת דרך proxy מסתירה את כתובת השרת שלכם, ובמקרה כזה בקשת התעודה של המכולה תיכשל, כיוון שהאתגר של ACME (סביבת ניהול תעודות אוטומטית) נענה על ידי ה־proxy במקום על ידי Discourse. השאירו את הרשומה ללא proxy עבור ההתקנה הראשונית.

הרצת המתקין הרשמי

פקודה אחת מתקינה את git, מתקינה את Docker באמצעות סקריפט ההתקנה הרשמי של Docker, משכפלת את discourse_docker לתוך /var/discourse, ומפעילה את אשף ההתקנה.

wget -qO- https://raw.githubusercontent.com/discourse/discourse_docker/main/install-discourse | sudo bash

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

sudo -s
git clone https://github.com/discourse/discourse_docker.git /var/discourse
cd /var/discourse
./discourse-setup

הריצו את הפקודה כ-root. אם תפעילו אותה כמשתמש רגיל, discourse-setup תיעצר מיד עם This script must be run as root. Please sudo or log in as root first.. ללא Docker מותקן על השרת, התהליך ייעצר עם Docker is not installed. Please install Docker first., כיוון ששכפול ידני אינו מתקין עבורכם דבר.

מה שואל אשף ההתקנה, ומה הוא כותב

נכון לאוקטובר 2026, discourse-setup הוא מעטפת (wrapper) דקה. הוא מריץ את discourse/setup-wizard:release כמכולה (container) עם גישה לרשת המארח ועם ה-socket של Docker ממופה, כדי שהאשף יוכל לבחון את המכונה שהוא מגדיר. האשף מבקש את שם המארח (hostname) וכתובות הדוא"ל של מנהל המערכת, ולאחר מכן את פרטי ה-SMTP שלכם. הוא כותב את containers/app.yml, ואז מבצע בנייה מחדש.

כדאי להכיר שני דפוסי פעולה לפני שמתחילים. אם למכונה חסר זיכרון ואין בה swap, האשף יעצור ויציע ליצור אחד: המעטפת תיצור קובץ /swapfile בנפח 2 GB, תוסיף אותו ל-/etc/fstab, תגדיר את vm.swappiness = 10 בתוך /etc/sysctl.d/30-discourse-swap.conf, ותפעיל את האשף מחדש. בסיום הפעולה, האשף מדפיס את Rebuilding app in 5 seconds (Ctrl+C to cancel)... ומריץ את ./launcher rebuild app על המארח. בנייה זו אורכת מספר דקות בשרת VPS קטן, והבנייה הראשונה היא האיטית ביותר מכיוון שכל הרכיבים עוברים הידור (compile) מאפס.

./discourse-setup --help מפרט את הדגלים (flags) החשובים כאשר משהו משתבש. --skip-rebuild כותב את קובץ התצורה ללא ביצוע בנייה, ו---skip-connection-test מדלג על בדיקות ה-DNS והפורטים. השתמשו ב---skip-connection-test רק כאשר אתם כבר יודעים מדוע הבדיקה נכשלת, למשל כאשר המארח נמצא מאחורי חומת אש רשתית שאתם מנהלים.

קראו את app.yml לפני ה-rebuild הראשון

האשף יוצר קובץ שמעתה והלאה נמצא באחריותכם. פתחו אותו באמצעות sudo nano /var/discourse/containers/app.yml. החלקים הבאים הם אלו שקובעים כמעט הכל.

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  - "templates/web.ratelimited.template.yml"
  ## Uncomment these two lines if you wish to add Lets Encrypt (https)
  #- "templates/web.ssl.template.yml"
  #- "templates/web.letsencrypt.ssl.template.yml"

expose:
  - "80:80"   # http
  - "443:443" # https

env:
  DISCOURSE_HOSTNAME: "forum.example.com"
  DISCOURSE_DEVELOPER_EMAILS: "you@example.com"
  DISCOURSE_SMTP_ADDRESS: smtp.example.com
  DISCOURSE_SMTP_PORT: 587
  DISCOURSE_SMTP_USER_NAME: user@example.com
  DISCOURSE_SMTP_PASSWORD: "your-smtp-password"

DISCOURSE_HOSTNAME הוא הכתובת שבה האתר מגיב, ו-Discourse בונה את הקישורים שלו על פיה; ערך שגוי יגרום לאתר להיטען פעם אחת ואז להפנות אתכם למקום אחר. DISCOURSE_DEVELOPER_EMAILS הוא רשימה מופרדת בפסיקים, וכתובות אלו מקבלות הרשאות מנהל (admin) באופן אוטומטי בעת ההרשמה הראשונה. הזינו את הכתובת שלכם שם והירשמו איתה, שכן כך נוצר חשבון המנהל הראשון.

הקובץ שומר את סיסמת ה-SMTP שלכם בטקסט גלוי, לכן הגבילו את הגישה לתיקייה באמצעות sudo chmod 700 /var/discourse/containers. מדובר בקובץ YAML, מה שאומר שרווחים הם חלק מההגדרה: מפתח שאינו מיושר כראוי יגרום לכשל ב-build עם שגיאת ניתוח (parse error) וישאיר אתכם ללא אתר. מלכודת אחת מתועדת בתוך קובץ הדוגמה עצמו. תו # בתוך סיסמה שאינה במירכאות מתחיל הערה, לכן הקפידו להוסיף מירכאות לכל סיסמה המכילה תו כזה.

דואר אלקטרוני הוא השלב שבו רוב ההתקנות נכשלות

החל מאוקטובר 2026, אשף ההתקנה מאפשר לדלג על הגדרת SMTP ולהשתמש בחיבור דרך Discourse ID במקום זאת, והפקודה app.yml כוללת את ה־switch התואם DISCOURSE_SKIP_EMAIL_SETUP, המתואר שם כביטול אימות הגדרות הדואר. דילוג על שלב זה סביר עבור התרשמות ראשונית מהתוכנה. זוהי בחירה גרועה עבור קהילה פעילה, כיוון שללא דואר יוצא, משתמשים לא יוכלו להפעיל חשבונות או לאפס סיסמאות.

הבעיה המעשית היא שרוב ספקי ה-VPS חוסמים את פורט 25 לתעבורה יוצאת, ולכן שרת דואר פשוט על השרת לא יצליח לשלוח הודעות. השתמשו ב-relay מאומת בפורט 587, או בפורט 465 עם TLS (ר"ת של Transport Layer Security) מובלע. עבור פורט 465, הגדירו את DISCOURSE_SMTP_FORCE_TLS: true, כפי שמומלץ בקובץ התצורה לדוגמה עבור פורט זה. בדקו את הקישוריות מהשרת לפני ביצוע rebuild.

nc -vz smtp.example.com 587

תוצאה תקינה היא שורה בודדת שמסתיימת ב-succeeded!. פקודה שנתקעת ומסתיימת ב-timeout מעידה על כך שהפורט חסום בנתיב היציאה מה-VPS שלכם, ושום הגדרה ב-Discourse לא תפתור זאת. עברו לפורט שהספק מאפשר, או בקשו מהספק לפתוח את הפורט.

ברגע שהאתר פעיל, שלחו הודעת בדיקה מתוך דף הדואר (Email) בלוח הניהול (Admin), ולאחר מכן קראו את הלשוניות Skipped ו-Bounced באותו דף. בלשוניות אלו Discourse מתעד דואר שסירב לשלוח ודואר שה-relay דחה, והן מציינות את סיבת הכשל, מה שמהיר יותר מקריאת לוגים.

TLS: אפשרו למכולה להנפיק לעצמה תעודה

אם Discourse מאזין לפורטים 80 ו-443, השתמשו במנגנון ההנפקה המובנה שלו. בטלו את ההערה בשורות ה-template של ה-SSL המוצגות לעיל, ולאחר מכן בצעו rebuild. ה-template מפעיל את acme.sh, שומר תעודות בנפח המשותף תחת /shared/ssl, מחדש אותן לפי לוח זמנים בתוך המכולה, ומגדיר את Discourse לכפות HTTPS.

פורט 80 חייב להישאר נגיש מהאינטרנט כדי שתהליך זה יצליח, שכן אתגר ה-HTTP נענה שם. Firewall שמאפשר רק את פורט 443 יגרום לבנייה להסתיים בהצלחה, אך התעודה לעולם לא תונפק. בדקו את התוצאה באמצעות ./launcher logs app מיד לאחר ה-rebuild.

האם כדאי להציב Nginx או Caddy בחזית?

אם Discourse הוא שירות האינטרנט היחיד בשרת ה-VPS, אין לעשות זאת. המכולה כבר מריצה Nginx מכוונן, ו-proxy נוסף מוסיף דילוג (hop), תעודה נוספת לחידוש ומקור חדש לתקלות ב-headers.

הציבו proxy בחזית כאשר ה-VPS משרת אתרים נוספים. הוסיפו את templates/web.socketed.template.yml לרשימת ה-templates, בצעו comment לשתי השורות של expose, והשאירו את שני ה-templates של ה-SSL במצב comment. המכולה תאזין כעת ל-unix socket בכתובת /var/discourse/shared/standalone/nginx.http.sock ולא תחזיק בפורטים כלל, מה שיפנה את פורטים 80 ו-443 עבור ה-proxy שלכם.

server {
  listen 443 ssl;
  server_name forum.example.com;

  location / {
    proxy_pass http://unix:/var/discourse/shared/standalone/nginx.http.sock:;
    proxy_set_header Host $http_host;
    proxy_http_version 1.1;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

הנקודתיים בסוף .sock הן חלק מתחביר ה-unix socket של Nginx, ו-sudo nginx -t תדחה את התצורה בלעדיהן. גם X-Forwarded-Proto אינו אופציונלי. Discourse כותב קישורים מוחלטים, לכן ללא ה-header הזה הוא יפיק קישורי http:// בדף HTTPS, ודפדפנים יחסמו אותם כתוכן מעורב (mixed content). כאשר המכולה עובדת מול socket, ה-TLS הופך לאחריותכם, לכן הנפיקו את התעודה במארח (host) בעזרת Certbot ב-Ubuntu 24.04 ו-Nginx. אם טרם החלטתם על proxy, השוואת Nginx, Caddy ו-Traefik מפרטת את השיקולים שעליכם לקחת בחשבון.

בנייה מחדש, שדרוגים והפקודות שתשתמשו בהן בפועל

cd /var/discourse
./launcher rebuild app

rebuild עוצר את המכולה הרצה, מאתחל מכולה חדשה מתוך app.yml, מסיר את המכולה הישנה ומפעיל את החדשה. האתר אינו זמין לאורך כל תהליך הבנייה, לכן יש להתייחס לכל שינוי בתצורה כאל השבתה מתוכננת של מספר דקות.

שינוי ערכים תחת env: בלבד אינו דורש זאת. ./launcher destroy app && ./launcher start app יוצר מחדש את המכולה מה-image שכבר בניתם, פעולה האורכת שניות ספורות. כל שינוי תחת templates: או hooks: משנה את ה-image עצמו, ולכן מחייב בנייה מחדש מלאה.

שדרוגים מגיעים בשתי דרכים. גרסאות נקודה (point releases) מוחלות דרך ממשק האינטרנט ב-/admin/upgrade, באמצעות תוסף docker_manager ש-app.yml משכפל (clone) במהלך הבנייה. שינויים ב-base image או בתבניות מגיעים מ-git.

cd /var/discourse
git pull
./launcher rebuild app

בנייה מחדש היא הנקודה שבה שרתים קטנים נכשלים, כיוון שקימפול נכסים (asset compilation) הוא שיא צריכת הזיכרון של המערכת כולה. בנייה שנעצרת באמצע, כאשר dmesg מציג שורה כמו Out of memory: Killed process המציינת תהליך ruby, מעידה על מחסור בזיכרון במהלך הבנייה, גם אם האתר עצמו פעל היטב לפני כן. הוסיפו swap והריצו את הבנייה מחדש.

./launcher logs app
./launcher enter app
./launcher cleanup

logs מדפיס את הפלט של המכולה, ו-enter פותח shell בתוכה. cleanup מסיר מכולות עצורות וכל image שלא נעשה בו שימוש ושגילו עולה על שעה, כאשר Docker מבקש אישור לכל פעולת מחיקה. טקסט העזרה של ה-launcher עדיין מציין שהוא מסיר מכולות שנעצרו לפני יותר מ-24 שעות, אך נכון לאוקטובר 2026 הפקודה רצה עם מסנן של שעה אחת. הריצו את cleanup מדי פעם, כיוון שכל בנייה מחדש מותירה מאחור את ה-image הקודם, והדיסק ב-VPS קטן עלול להתמלא בשקט.

גיבויים, והקובץ שהגיבוי אינו מכיל

בצעו גיבויים מדף ה-Backups ב-Admin. הארכיון נשמר על המארח ב-/var/discourse/shared/standalone/backups/default/. אותה פעולה ניתנת לביצוע גם מתוך ה-shell.

cd /var/discourse
./launcher enter app
discourse backup

discourse restore <filename> מבצע את הפעולה ההפוכה, ושחזורים נדחים עד להרצת discourse enable_restore. מנגנון הגנה זה קיים כדי למנוע פקודה שגויה מלהחליף פורום פעיל.

ישנם שני פערים שעליכם לסגור בעצמכם. הארכיון מכיל את מסד הנתונים, והוא מכיל קבצים שהועלו רק כאשר הגדרת הגיבוי הכוללת העלאות מופעלת; לכן, בדקו הגדרה זו לפני שתסתמכו עליה. הארכיון לעולם אינו מכיל את app.yml, לכן שחזור על גבי VPS חדש עדיין דורש את שם המארח (hostname) ובלוק ה-SMTP שלכם, מה שאומר שיש להעתיק גם קובץ זה אל מחוץ לשרת.

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

rsync -avz root@forum.example.com:/var/discourse/shared/standalone/backups/default/ ~/discourse-backups/

העלות ב-RAM של פורום פעיל

ה-bootstrap מגדיר את UNICORN_WORKERS ואת db_shared_buffers על סמך הזיכרון וה-CPU שהוא מזהה, וקובץ התצורה לדוגמה מגביל את ה-shared buffers לרבע מסך הזיכרון. כל worker של unicorn הוא תהליך Ruby מלא, ו-Sidekiq מריץ משימות רקע לצדם, לכן צריכת הזיכרון נגזרת ממספר הבקשות בו-זמנית ולא ממספר המשתמשים הרשומים. פורום שקט עם כמה מאות משתמשים אינו מהווה עומס כבד. לרוב, מה שמשתף את השרת חשוב יותר; אם מדובר בספריית תמונות, רצפות ה-RAM שנמדדו ב-השוואה בין PhotoPrism ל-Immich יבהירו לכם אם נותר ל-Discourse מספיק מרווח פעולה כדי לסיים תהליך rebuild.

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

free -m
docker stats --no-stream

שימוש קבוע ב-swap יחד עם דפים איטיים מעיד על מחסור ב-RAM. זיכרון יציב לצד דפים איטיים מעיד בדרך כלל על בעיה אחרת, לכן קראו את ./launcher logs app לפני שאתם רוכשים תוכנית גדולה יותר. הוסיפו בדיקה חיצונית לשרת, כיוון שפורום שנגמר לו הזיכרון ב-3 לפנות בוקר קורס בשקט: צג סטטוס Uptime Kuma בניהול עצמי על מארח נפרד יתריע בפניכם לפני שהמשתמשים שלכם ידווחו על כך.

מתי Discourse אינו הבחירה הנכונה

Discourse הוא יישום גדול בעל תהליך התקנה כבד ומחזור בנייה מחדש (rebuild) עבור כל הגדרה השמורה בתוך app.yml. עלות זו מקנה כלי ניהול תוכן אמיתיים ומנוע חיפוש שמתפקד היטב גם כאשר הארכיון גדול. עבור קבוצה של שלושים איש המעוניינים במקום לנהל בו שיחות, מדובר במערכת כבדה מדי ביחס לצרכי התקשורת. קראו תחילה את השוואת תוכנות הפורומים לאירוח עצמי, ובחרו ב־Discourse רק אם אתם זקוקים ליכולות הספציפיות שלו, ולא רק משום שזהו השם המוכר לכם.

FAQ

האם ניתן להתקין Discourse על שרת VPS ללא שם מתחם?

לא. התצורה המופצת קובעת ש־Discourse לא יעבוד עם כתובת IP בלבד, ונדרש DISCOURSE_HOSTNAME. Discourse בונה קישורים מוחלטים על בסיס שם המארח הזה, לכן שימוש בכתובת IP ישבור את הקישורים וימנע הנפקת תעודות. צרו רשומת A לפני שתתחילו, וודאו באמצעות dig +short forum.example.com שהיא מתרגמת לכתובת השרת שלכם.

האם חובה להגדיר SMTP כדי להשלים את ההתקנה?

נכון לאוקטובר 2026, ניתן לדלג על כך. אשף ההתקנה מציע במקום זאת התחברות באמצעות Discourse ID, וקובץ app.yml כולל הגדרה המדלגת על אימות הגדרות הדואר. לכל שימוש מעבר להתרשמות ראשונית, הגדירו זאת, כיוון שהפעלת חשבונות ואיפוס סיסמאות מתבצעים באמצעות דואר אלקטרוני. השתמשו ב־relay מאומת בפורט 587 או 465, שכן רוב ספקי ה־VPS חוסמים תעבורה יוצאת בפורט 25.

מדוע תהליך ה-rebuild של Discourse נכשל באמצע הדרך?

זיכרון הוא הגורם הנפוץ לכך. הידור הנכסים (assets) במהלך ה-build דורש יותר זיכרון מאשר האתר בזמן ריצה, לכן שרת שמריץ את הפורום היטב עלול להיכשל בביצוע rebuild. אם dmesg מציג Out of memory: Killed process המצביע על תהליך ruby, הוסיפו swap (קובץ ה-swap של האשף הוא בגודל 2 GB) והריצו את ./launcher rebuild app שוב. build שנעצר בשל שגיאת YAML מצביע על טעות בהזחה (indentation) בתוך app.yml.

האם כדאי להציב את Discourse מאחורי Nginx או Caddy משלי?

רק כאשר ה-VPS משרת אתרים נוספים. אם הוא לבדו על השרת, הניחו למכולה להחזיק בפורטים 80 ו-443 ולהנפיק לעצמה תעודה, מה שמפחית את מספר הרכיבים המעורבים. כדי לשתף את המכונה, הוסיפו templates/web.socketed.template.yml, הפכו את שורות expose להערה, ובצעו proxy ל-unix socket בכתובת /var/discourse/shared/standalone/nginx.http.sock. העבירו את X-Forwarded-Proto, אחרת Discourse יפיק קישורי http:// בדף HTTPS.

כיצד מגבים התקנת Discourse עצמית?

השתמשו בדף הגיבויים (Backups) בממשק הניהול, או הריצו את discourse backup לאחר ./launcher enter app. ארכיונים נשמרים במארח בנתיב /var/discourse/shared/standalone/backups/default/. ודאו שההגדרה הכוללת העלאות (uploads) פעילה, העתיקו את /var/discourse/containers/app.yml לצד הארכיון, והעבירו את שניהם למכונה אחרת, כיוון שגיבוי שנמצא על אותו דיסק של האתר לא יגן עליכם במקרה של כשל שבעבורו הוא נוצר.

האם המאמר הזה היה מועיל?