Roundcube

الوصول إلى Roundcube

• افتح عنوان URL التالي في متصفحك: https://<SERVER_IP>
• يستخدم التثبيت شهادة TLS موقّعة ذاتيًا، لذا سيعرض متصفحك تحذيرًا أمنيًا. اقبل الشهادة للمتابعة.
• تتم إعادة توجيه طلبات HTTP على المنفذ 80 تلقائيًا إلى HTTPS.

تسجيل الدخول

• لا يُنشئ Roundcube حسابات صناديق البريد ولا يخزّنها.
• سجّل الدخول باسم المستخدم وكلمة المرور لصندوق بريد موجود على خادم IMAP الذي أعددته.

إعداد خادم البريد الخاص بك

تُخزَّن إعدادات الاتصال بخادم البريد في: /root/roundcube/.env

إعدادات مهمة:

• مضيف IMAP: IMAP_HOST
• منفذ IMAP: IMAP_PORT
• مضيف SMTP: SMTP_HOST
• منفذ SMTP: SMTP_PORT
• نطاق اسم المستخدم: USERNAME_DOMAIN

تستخدم الإعدادات الافتراضية قيمًا مؤقتة:

IMAP_HOST=ssl://mail.example.org
IMAP_PORT=993

SMTP_HOST=tls://mail.example.org
SMTP_PORT=587

استبدلها باسم مضيف خادم البريد الفعلي لديك.

بعد تغيير الإعدادات، طبّقها عبر:

cd /root/roundcube && docker compose up -d

أنواع اتصالات TLS

استخدم البادئة المناسبة لخادم البريد لديك:

• ssl://: Implicit TLS, typically used with IMAP port 993 or SMTP port 465.
• tls://: STARTTLS, typically used with IMAP port 143 or SMTP port 587.

شهادات خادم البريد الموقّعة ذاتيًا

إذا كان خادم IMAP أو SMTP لديك يستخدم شهادة موقّعة ذاتيًا، فقد يرفض Roundcube الاتصال.

توجد إعدادات التحقق من TLS الاختيارية في: /root/roundcube/config/custom.inc.php

لا تُزل التعليق عن خيارات اتصال IMAP أو SMTP المعنية وتضبطها إلا إذا كنت تثق بخادم البريد والشبكة.

تطبيق الإعدادات:

cd /root/roundcube && docker compose restart roundcube

الإضافات والمظهر

يفعّل التثبيت الافتراضي:

• archive
• zipdownload

Plugins are configured through the PLUGINS variable in: /root/roundcube/.env

على سبيل المثال:

PLUGINS=archive,zipdownload,managesieve

طبّق التغييرات:

cd /root/roundcube && docker compose up -d

Bundled plugins such as managesieve, markasjunk، و enigma can be enabled by adding them to PLUGINS, when supported by the image.

For third-party plugins, add them to ROUNDCUBEMAIL_COMPOSER_PLUGINS in the Compose file and include their names in PLUGINS.

إدارة Roundcube

عرض حالة الحاويات:

cd /root/roundcube && docker compose ps

عرض السجلات:

cd /root/roundcube && docker compose logs -f

إعادة تشغيل Roundcube:

cd /root/roundcube && docker compose restart roundcube

أوقف المجموعة:

cd /root/roundcube && docker compose down

ابدأ تشغيل المجموعة:

cd /root/roundcube && docker compose up -d

الملفات والمجلدات المهمة

• مسار التثبيت: /root/roundcube
• ملف Compose: /root/roundcube/docker-compose.yml
• ملف البيئة: /root/roundcube/.env
• إعدادات إضافية: /root/roundcube/config/custom.inc.php
• وحدة تخزين قاعدة البيانات: /var/lib/docker/volumes/roundcube_db_data
• إعدادات Nginx: /etc/nginx/sites-available/roundcube
• شهادة TLS: /etc/nginx/ssl/roundcube.crt
• المفتاح الخاص لـ TLS: /etc/nginx/ssl/roundcube.key

النطاق وHTTPS

1. Point your domain to the server's IP address (e.g., yourdomain.com;).

2. ثبّت Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Edit NGINX config and replace both server_name _; entries with your domain (e.g., server_name yourdomain.com;):

vim /etc/nginx/sites-available/roundcube

4. أصدر شهادة TLS:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. عدّل /etc/nginx/sites-available/roundcube وحدّث ssl_certificate و ssl_certificate_key التوجيهات لاستخدام شهادة Let's Encrypt الخاصة بك.

Before:
    ssl_certificate     /etc/nginx/ssl/roundcube.crt;
    ssl_certificate_key /etc/nginx/ssl/roundcube.key;
After:
    ssl_certificate  /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. اختبر الإعدادات:

nginx -t

7. أعد تحميل NGINX:

systemctl reload nginx

٨. افتح المتصفح وزر: https://yourdomain.com

ملاحظات

• Roundcube is publicly accessible through Nginx on ports 80 و 443.
• The Roundcube container itself listens only on 127.0.0.1:8000.
• ‏MariaDB خدمة داخلية في Docker ولا تُتاح للمضيف مباشرةً.
• تستخدم واجهة الويب الافتراضية شهادة TLS موقّعة ذاتيًا.
• The upload limit is set to 25 MB; increase both UPLOAD_MAX_FILESIZE and Nginx's client_max_body_size for larger uploads.
• غيّر إعدادات Roundcube بما يناسب احتياجاتك.