Self Hosted

Getting started

פתרון הדואר האלקטרוני העצמאי שלנו, כמו כל המוצרים שלנו, הוא קוד פתוח 100% — גם בצד הלקוח וגם בצד השרת. משמעות הדבר:

1. שקיפות מלאה: כל שורת קוד שמעבדת את האימיילים שלך זמינה לבחינה ציבורית
2. תרומות מהקהילה: כל אחד יכול לתרום שיפורים או לתקן בעיות
3. אבטחה באמצעות פתיחות: פגיעויות יכולות להיות מזוהות ותוקנו על ידי קהילה עולמית
4. ללא תלות בספק: אתה אף פעם לא תלוי בקיומה של החברה שלנו

כל בסיס הקוד זמין ב-GitHub בכתובת https://github.com/forwardemail/forwardemail.net, ברישיון MIT.

הארכיטקטורה כוללת מכולות עבור:

• שרת SMTP לדואר יוצא
• שרתי IMAP/POP3 לקבלת דואר
• ממשק ווב לניהול
• מסד נתונים לאחסון הגדרות
• Redis למטמון וביצועים
• SQLite לאחסון תיבות דואר מאובטח ומוצפן

Requirements

לפני הרצת סקריפט ההתקנה, ודא שיש לך את הדברים הבאים:

• מערכת הפעלה: שרת מבוסס לינוקס (תומך כרגע ב-Ubuntu 22.04+).
• משאבים: 1 vCPU ו-2GB RAM
• גישה כ-root: הרשאות מנהל לביצוע פקודות.
• שם דומיין: דומיין מותאם אישית מוכן להגדרת DNS.
• IP נקי: ודא שלשרת שלך יש כתובת IP נקייה ללא מוניטין ספאם קודם על ידי בדיקת רשימות שחורות. מידע נוסף כאן.
• כתובת IP ציבורית עם תמיכה בפורט 25
• יכולת להגדיר PTR הפוך
• תמיכה ב-IPv4 ו-IPv6

Cloud-init / User-data

רוב ספקי הענן תומכים בקונפיגורציית cloud-init כאשר שרת וירטואלי פרטי (VPS) מוקצה. זו דרך מצוינת להגדיר קבצים ומשתני סביבה מראש לשימוש בלוגיקת ההגדרה הראשונית של הסקריפט, שתעקוף את הצורך בשאלות בזמן הרצת הסקריפט לקבלת מידע נוסף.

אפשרויות

• EMAIL - אימייל לשימוש בתזכורות פקיעת תעודת certbot
• DOMAIN - דומיין מותאם אישית (למשל example.com) לשימוש בהגדרת האחסון העצמי
• AUTH_BASIC_USERNAME - שם משתמש להגנה על האתר בהגדרה הראשונית
• AUTH_BASIC_PASSWORD - סיסמה להגנה על האתר בהגדרה הראשונית
• /root/.cloudflare.ini - (רק למשתמשי Cloudflare) קובץ קונפיגורציה של Cloudflare לשימוש certbot בהגדרת DNS. יש להגדיר את אסימון ה-API שלך באמצעות dns_cloudflare_api_token. קרא עוד כאן. דוגמה:

#cloud-config
write_files:
  - path: /root/.cloudflare.ini
    content: |
      dns_cloudflare_api_token = "xxx"
    owner: root:root
    permissions: '0600'
  - path: /etc/profile.d/env.sh
    content: |
      export EMAIL="test@myemail.com"
      export DOMAIN="mydomain.com"

runcmd:
  - chmod +x /etc/profile.d/env.sh

התקנה

הרץ את הפקודה הבאה בשרת שלך כדי להוריד ולהריץ את סקריפט ההתקנה:

bash <(curl -fsSL https://raw.githubusercontent.com/forwardemail/forwardemail.net/master/self-hosting/setup.sh)

סקריפט התקנה לדיבוג

הוסף DEBUG=true לפני סקריפט ההתקנה לפלט מפורט:

DEBUG=true bash <(curl -fsSL https://raw.githubusercontent.com/forwardemail/forwardemail.net/master/self-hosting/setup.sh)

תפריטים

1. הגדרה ראשונית
2. הגדרת גיבויים
3. הגדרת עדכונים אוטומטיים
4. חידוש תעודות
5. שחזור מגיבוי
6. עזרה
7. יציאה

• הגדרה ראשונית: הורדת קוד forward email העדכני ביותר, קונפיגורציה של הסביבה, בקשה לדומיין מותאם אישית והגדרת כל התעודות, המפתחות והסודות הנדרשים.
• הגדרת גיבוי: יגדיר קרון לגיבוי mongoDB ו-redis באמצעות אחסון תואם S3 לאחסון מרוחק ומאובטח. בנוסף, sqlite יגובה בעת התחברות אם יש שינויים לגיבויים מוצפנים ומאובטחים.
• הגדרת עדכון: יגדיר קרון לחיפוש עדכונים ליליים אשר יבנו מחדש ויתחילו בבטחה את רכיבי התשתית.
• חידוש תעודות: Certbot / lets encrypt משמשים לתעודות SSL והמפתחות פוקעים כל 3 חודשים. זה יחידש את התעודות לדומיין שלך וימקם אותן בתיקייה הנדרשת לצריכת הרכיבים הרלוונטיים. ראה נתיבי קבצים חשובים
• שחזור מגיבוי: יפעיל שחזור mongodb ו-redis מנתוני הגיבוי.

הגדרה ראשונית (אפשרות 1)

בחר באפשרות 1. הגדרה ראשונית כדי להתחיל.

בסיום, תראה הודעת הצלחה. ניתן גם להריץ docker ps כדי לראות את הרכיבים שהופעלו. מידע נוסף על הרכיבים למטה.

שירותים

שם השירות	פורט ברירת מחדל	תיאור
Web	443	ממשק רשת לכל האינטראקציות הניהוליות
API	4000	שכבת API להפרדת מסדי נתונים
Bree	None	מנהל משימות וריצות רקע
SMTP	465 (מומלץ) / 587	שרת SMTP לדואר יוצא
SMTP Bree	None	משימת רקע SMTP
MX	2525	חילופי דואר לדואר נכנס והפניות דואר
IMAP	993/2993	שרת IMAP לדואר נכנס וניהול תיבות דואר
POP3	995/2995	שרת POP3 לדואר נכנס וניהול תיבות דואר
SQLite	3456	שרת SQLite לאינטראקציה עם מסדי נתונים מסוג sqlite
SQLite Bree	None	משימת רקע SQLite
CalDAV	5000	שרת CalDAV לניהול לוח שנה
CardDAV	6000	שרת CardDAV לניהול לוח שנה
MongoDB	27017	מסד נתונים MongoDB לניהול רוב הנתונים
Redis	6379	Redis למטמון וניהול מצב
SQLite	None	מסדי נתונים SQLite לתיבות דואר מוצפנות

נתיבי קבצים חשובים

הערה: נתיב המארח למטה הוא יחסי ל-/root/forwardemail.net/self-hosting/.

רכיב	נתיב מארח	נתיב במכולה
MongoDB	./mongo-backups	/backups
Redis	./redis-data	/data
Sqlite	./sqlite-data	/mnt/{SQLITE_STORAGE_PATH}
קובץ Env	./.env	/app/.env
תעודות/מפתחות SSL	./ssl	/app/ssl/
מפתח פרטי	./ssl/privkey.pem	/app/ssl/privkey.pem
תעודת שרשרת מלאה	./ssl/fullchain.pem	/app/ssl/fullchain.pem
תעודת CA	./ssl/cert.pem	/app/ssl/cert.pem
מפתח פרטי DKIM	./ssl/dkim.key	/app/ssl/dkim.key

תצורה

הגדרת DNS ראשונית

ב ספק ה-DNS שבחרת, הגדר את רשומות ה-DNS המתאימות. שים לב שכל דבר בסוגריים משולשים (<>) הוא דינמי ויש לעדכן אותו בערך שלך.

Type	Name	Content	TTL
A	"@", ".", or blank	<ip_address>	auto
CNAME	api	<domain_name>	auto
CNAME	caldav	<domain_name>	auto
CNAME	carddav	<domain_name>	auto
CNAME	fe-bounces	<domain_name>	auto
CNAME	imap	<domain_name>	auto
CNAME	mx	<domain_name>	auto
CNAME	pop3	<domain_name>	auto
CNAME	smtp	<domain_name>	auto
MX	"@", ".", or blank	mx.<domain_name> (priority 0)	auto
TXT	"@", ".", or blank	"v=spf1 a -all"	auto

רשומת DNS הפוכה / PTR

רשומות DNS הפוכות (rDNS) או רשומות מצביע הפוכות (PTR) הן חיוניות לשרתי דואר אלקטרוני מכיוון שהן עוזרות לאמת את הלגיטימיות של השרת ששולח את הדואר. כל ספק ענן עושה זאת בצורה שונה, לכן תצטרך לבדוק כיצד להוסיף "DNS הפוך" כדי למפות את המארח וה-IP לשם המארח המתאים. סביר להניח שזה נמצא בחלק הרשת של הספק.

פורט 25 חסום

חלק מספקי האינטרנט וספקי הענן חוסמים את פורט 25 כדי למנוע פעילות זדונית. ייתכן שתצטרך לפתוח פנייה לתמיכה כדי לפתוח את פורט 25 עבור SMTP / דואר יוצא.

התחלת עבודה

1. פתח את דף הנחיתה עבור אל https://<domain_name>, כאשר מחליפים את <domain_name> בשם הדומיין שהוגדר בהגדרות ה-DNS שלך. אמור להופיע דף הנחיתה של Forward Email.

2. התחבר והגדר את הדומיין שלך

• היכנס עם דואר אלקטרוני וסיסמה תקינים.
• הזן את שם הדומיין שברצונך להגדיר (חייב להתאים להגדרות ה-DNS).
• עקוב אחר ההנחיות להוספת רשומות MX ו-TXT הנדרשות לאימות.

3. השלם את ההגדרה

• לאחר האימות, גש לדף הכינויים כדי ליצור את הכינוי הראשון שלך.
• במידת הצורך, הגדר SMTP לדואר יוצא בהגדרות הדומיין. זה דורש רשומות DNS נוספות.

בדיקות

יצירת הכינוי הראשון שלך

1. עבור לדף הכינויים פתח את דף ניהול הכינויים:

https://<domain_name>/en/my-account/domains/<domain_name>/aliases

2. הוסף כינוי חדש

• לחץ על הוסף כינוי (למעלה מימין).
• הזן את שם הכינוי והתאם את הגדרות הדואר לפי הצורך.
• (אופציונלי) אפשר תמיכה ב-IMAP/POP3/CalDAV/CardDAV על ידי סימון התיבה.
• לחץ על צור כינוי.

3. הגדר סיסמה

• לחץ על צור סיסמה כדי ליצור סיסמה מאובטחת.
• סיסמה זו תידרש לכניסה ללקוח הדואר שלך.

4. הגדר את לקוח הדואר שלך

• השתמש בלקוח דואר כמו Thunderbird.
• הזן את שם הכינוי והסיסמה שנוצרה.
• הגדר את הגדרות IMAP ו-SMTP בהתאם.

הגדרות שרת הדואר

שם משתמש: <alias name>

Type	Hostname	Port	Connection Security	Authentication
SMTP	smtp.<domain_name>	465	SSL / TLS	Normal Password
IMAP	imap.<domain_name>	993	SSL / TLS	Normal Password

שליחה / קבלה של הדואר הראשון שלך

לאחר ההגדרה, תוכל לשלוח ולקבל דואר לכתובת הדואר החדשה והמאוחסנת בעצמך!

פתרון בעיות

למה זה לא עובד מחוץ לאובונטו ודביאן

כרגע אנחנו מחפשים לתמוך ב-MacOS ונבחן פלטפורמות נוספות. אנא פתחו דיון או תתרמו אם תרצו לראות תמיכה בפלטפורמות נוספות.

למה אתגר ה-certbot acme נכשל

הבעיה הנפוצה ביותר היא ש-certbot / letsencrypt לפעמים מבקשים 2 אתגרים. עליכם לוודא להוסיף שני רשומות txt.

דוגמה: ייתכן שתראו שני אתגרים כאלה: _acme-challenge.example.com -> "randomstring1" _acme-challenge.example.com -> "randomstring2"

יתכן גם שהפצת ה-DNS לא הושלמה. תוכלו להשתמש בכלים כמו: https://toolbox.googleapps.com/apps/dig/#TXT/_acme-challenge.<your_domain>. זה ייתן לכם מושג אם השינויים ברשומת TXT שלכם צריכים להיות משוקפים. כמו כן, ייתכן שמטמון ה-DNS המקומי במחשב שלכם עדיין משתמש בערך ישן או לא קלט את השינויים האחרונים.

אפשרות נוספת היא להשתמש בשינויים האוטומטיים של certbot ב-DNS על ידי הגדרת הקובץ /root/.cloudflare.ini עם אסימון ה-API ב-cloud-init / user-data בעת ההתקנה הראשונית של ה-VPS או ליצור קובץ זה ולהריץ את הסקריפט שוב. זה ינהל את שינויים ב-DNS ועדכוני האתגר באופן אוטומטי.

מה שם המשתמש והסיסמה של אימות הבסיס

לאירוח עצמי, אנו מוסיפים בפעם הראשונה פופ-אפ אימות מקורי בדפדפן עם שם משתמש פשוט (admin) וסיסמה (נוצרה אקראית בהתקנה הראשונית). אנו מוסיפים זאת כהגנה למקרה שאוטומציה / סקרייפרים יקדימו אתכם בהרשמה הראשונה בחוויית האינטרנט. תוכלו למצוא סיסמה זו לאחר ההתקנה הראשונית בקובץ .env תחת AUTH_BASIC_USERNAME ו-AUTH_BASIC_PASSWORD.

איך אני יודע מה רץ

ניתן להריץ docker ps כדי לראות את כל המכולות שרצות שנוצרות מקובץ docker-compose-self-hosting.yml. ניתן גם להריץ docker ps -a כדי לראות הכל (כולל מכולות שאינן רצות).

איך אני יודע אם משהו לא רץ כשצריך

ניתן להריץ docker ps -a כדי לראות הכל (כולל מכולות שאינן רצות). ייתכן שתראו יומן יציאה או הערה.

איך אני מוצא לוגים

ניתן לקבל לוגים נוספים באמצעות docker logs -f <container_name>. אם משהו יצא, סביר להניח שזה קשור לקובץ .env שהוגדר בצורה שגויה.

בממשק האינטרנטי, ניתן לצפות ב-/admin/emails ו-/admin/logs עבור לוגים של דואר יוצא ולוגי שגיאות בהתאמה.

למה הודעות הדואר היוצאות שלי מתעכבות

אם אתם רואים הודעה כמו Connection timed out when connecting to MX server... ייתכן שתצטרכו לבדוק אם פורט 25 חסום. זה נפוץ שספקי אינטרנט או ספקי ענן חוסמים את הפורט כברירת מחדל, וייתכן שתצטרכו לפנות לתמיכה / לפתוח פנייה כדי לפתוח אותו.

אילו כלים כדאי להשתמש כדי לבדוק תצורת דואר ופרופיל IP

עיינו ב-שאלות נפוצות שלנו כאן.