مرجع أوامر CLI

يوفر SirrMesh أداة سطر أوامر كاملة الميزات لإدارة وصيانة خادم البريد.

الأوامر الأساسية

sirrmeshd

أمر البرنامج الرئيسي.

bash

sirrmeshd [command] [flags]

الخيارات العامة

bash

--config string      مسار ملف التكوين (افتراضي "~/.sirrmeshd/config.toml")
--debug              تمكين وضع التصحيح
--help, -h           عرض معلومات المساعدة
--version, -v        عرض معلومات الإصدار

إدارة الخدمة

run

بدء خادم البريد.

bash

sirrmeshd run [flags]

الخيارات:

bash

--daemon             التشغيل في الخلفية
--pid-file string    مسار ملف PID

مثال:

bash

sirrmeshd run --config /etc/sirrmeshd/config.toml

stop

إيقاف الخادم قيد التشغيل.

bash

sirrmeshd stop

restart

إعادة تشغيل الخادم.

bash

sirrmeshd restart

status

عرض حالة الخادم.

bash

sirrmeshd status

الإخراج:

الحالة: قيد التشغيل
PID: 12345
وقت التشغيل: 2d 5h 32m
الاتصالات: 42
الرسائل المعالجة: 15,234

إدارة المستخدمين

user create

إنشاء مستخدم جديد.

bash

sirrmeshd user create [flags]

الخيارات:

bash

--username string    اسم المستخدم (عنوان البريد الإلكتروني)
--password string    كلمة المرور
--quota string       حصة التخزين (مثل "5GB")
--blockchain string  عنوان محفظة البلوكتشين

مثال:

bash

sirrmeshd user create \
  --username user@example.com \
  --password secretpass \
  --quota 5GB

user delete

حذف مستخدم.

bash

sirrmeshd user delete --username user@example.com

user list

عرض قائمة جميع المستخدمين.

bash

sirrmeshd user list [flags]

الخيارات:

bash

--domain string      تصفية حسب النطاق
--format string      صيغة الإخراج (table|json|csv)

user modify

تعديل معلومات المستخدم.

bash

sirrmeshd user modify \
  --username user@example.com \
  --quota 10GB

user password

تغيير كلمة مرور المستخدم.

bash

sirrmeshd user password \
  --username user@example.com \
  --new-password newpass

إدارة النطاقات

domain add

إضافة نطاق جديد.

bash

sirrmeshd domain add --name example.com

domain delete

حذف نطاق.

bash

sirrmeshd domain delete --name example.com

domain list

عرض قائمة جميع النطاقات.

bash

sirrmeshd domain list

إدارة التكوين

config init

إنشاء ملف تكوين افتراضي.

bash

sirrmeshd config init > config.toml

config verify

التحقق من ملف التكوين.

bash

sirrmeshd config verify

config get

الحصول على عنصر تكوين.

bash

sirrmeshd config get server.hostname

config set

تعيين عنصر تكوين.

bash

sirrmeshd config set server.hostname mail.example.com

إدارة DKIM

dkim generate

إنشاء زوج مفاتيح DKIM.

bash

sirrmeshd dkim generate \
  --domain example.com \
  --selector default \
  --bits 2048

dkim show

عرض سجل المفتاح العام DKIM.

bash

sirrmeshd dkim show --domain example.com

الإخراج:

أضف سجل TXT هذا إلى DNS الخاص بك:

default._domainkey.example.com. IN TXT "v=DKIM1; k=rsa; p=MIIBIjANBg..."

إدارة الحصص

quota get

عرض حصة المستخدم.

bash

sirrmeshd quota get --user user@example.com

الإخراج:

المستخدم: user@example.com
الحصة: 5 GB
المستخدم: 1.23 GB (24.6%)
المتاح: 3.77 GB

quota set

تعيين حصة المستخدم.

bash

sirrmeshd quota set \
  --user user@example.com \
  --quota 10GB

quota list

عرض قائمة استخدام حصص جميع المستخدمين.

bash

sirrmeshd quota list --sort-by used

النسخ الاحتياطي والاستعادة

backup create

إنشاء نسخة احتياطية.

bash

sirrmeshd backup create \
  --output /backups/sirrchat-$(date +%Y%m%d).tar.gz \
  --compress

الخيارات:

bash

--user string        نسخ احتياطي لمستخدم محدد فقط
--domain string      نسخ احتياطي لنطاق محدد فقط
--exclude-attachments  استبعاد المرفقات

backup restore

استعادة نسخة احتياطية.

bash

sirrmeshd backup restore \
  --input /backups/sirrchat-20250115.tar.gz

backup list

عرض قائمة النسخ الاحتياطية المتاحة.

bash

sirrmeshd backup list --path /backups

إدارة قاعدة البيانات

db migrate

تشغيل ترحيلات قاعدة البيانات.

bash

sirrmeshd db migrate

db ping

اختبار اتصال قاعدة البيانات.

bash

sirrmeshd db ping

db vacuum

تحسين قاعدة البيانات.

bash

sirrmeshd db vacuum

إدارة التخزين

storage stats

عرض إحصائيات التخزين.

bash

sirrmeshd storage stats

storage test

اختبار اتصال التخزين.

bash

sirrmeshd storage test --type s3

storage migrate

ترحيل خلفية التخزين.

bash

sirrmeshd storage migrate \
  --from local \
  --to s3

storage cleanup

تنظيف البيانات منتهية الصلاحية.

bash

sirrmeshd storage cleanup \
  --older-than 2y \
  --dry-run

إدارة الوحدات

module list

عرض قائمة جميع الوحدات.

bash

sirrmeshd module list

module enable

تمكين وحدة.

bash

sirrmeshd module enable spam-filter

module disable

تعطيل وحدة.

bash

sirrmeshd module disable spam-filter

module reload

إعادة تحميل وحدة.

bash

sirrmeshd module reload --name spam-filter

إدارة السجلات

logs view

عرض السجلات.

bash

sirrmeshd logs view [flags]

الخيارات:

bash

--lines int          عدد الأسطر للعرض (افتراضي 100)
--follow, -f         متابعة السجلات في الوقت الفعلي
--level string       تصفية حسب مستوى السجل
--grep string        تصفية حسب الكلمة المفتاحية

أمثلة:

bash

sirrmeshd logs view --lines 50 --level error
sirrmeshd logs view --follow --grep "user@example.com"

أوامر المراقبة

stats

عرض إحصائيات الخادم.

bash

sirrmeshd stats

الإخراج:

إحصائيات الخادم
-----------------
وقت التشغيل: 2d 5h 32m
إجمالي المستخدمين: 1,234
الجلسات النشطة: 42
الرسائل اليوم: 5,678
التخزين المستخدم: 125.5 GB

إحصائيات SMTP
---------------
المرسل: 2,345
المستقبل: 3,333
المرفوض: 12

إحصائيات IMAP
---------------
الاتصالات النشطة: 42
الأوامر: 12,345

health

فحص الصحة.

bash

sirrmeshd health

الإخراج:

✓ قاعدة البيانات: OK
✓ SMTP: OK
✓ IMAP: OK
✓ التخزين: OK
✓ الذاكرة: OK (45% مستخدم)
✓ القرص: OK (32% مستخدم)

أدوات التشخيص

diagnose

تشغيل فحوصات التشخيص.

bash

sirrmeshd diagnose

test-smtp

اختبار وظائف SMTP.

bash

sirrmeshd test-smtp \
  --from sender@example.com \
  --to recipient@example.com \
  --subject "Test Email"

test-imap

اختبار وظائف IMAP.

bash

sirrmeshd test-imap \
  --user user@example.com \
  --password pass

إكمال Shell

إنشاء سكربتات إكمال shell.

Bash

bash

sirrmeshd completion bash > /etc/bash_completion.d/sirrmeshd

Zsh

bash

sirrmeshd completion zsh > "${fpath[1]}/_sirrmeshd"

Fish

bash

sirrmeshd completion fish > ~/.config/fish/completions/sirrmeshd.fish

متغيرات البيئة

bash

SIRRCHAT_CONFIG      مسار ملف التكوين
SIRRCHAT_DEBUG       تمكين وضع التصحيح
SIRRCHAT_LOG_LEVEL   مستوى السجل
SIRRCHAT_DATA_DIR    دليل البيانات

مزيد من المعلومات:

مرجع أوامر CLI ​

الأوامر الأساسية ​

sirrmeshd ​

الخيارات العامة ​

إدارة الخدمة ​

run ​

stop ​

restart ​

status ​

إدارة المستخدمين ​

user create ​

user delete ​

user list ​

user modify ​

user password ​

إدارة النطاقات ​

domain add ​

domain delete ​

domain list ​

إدارة التكوين ​

config init ​

config verify ​

config get ​

config set ​

إدارة DKIM ​

dkim generate ​

dkim show ​

إدارة الحصص ​

quota get ​

quota set ​

quota list ​

النسخ الاحتياطي والاستعادة ​

backup create ​

backup restore ​

backup list ​

إدارة قاعدة البيانات ​

db migrate ​

db ping ​

db vacuum ​

إدارة التخزين ​

storage stats ​

storage test ​

storage migrate ​

storage cleanup ​

إدارة الوحدات ​

module list ​

module enable ​

module disable ​

module reload ​

إدارة السجلات ​

logs view ​

أوامر المراقبة ​

stats ​

health ​

أدوات التشخيص ​

diagnose ​

test-smtp ​

test-imap ​

إكمال Shell ​

Bash ​

Zsh ​

Fish ​

متغيرات البيئة ​

مرجع أوامر CLI

الأوامر الأساسية

sirrmeshd

الخيارات العامة

إدارة الخدمة

run

stop

restart

status

إدارة المستخدمين

user create

user delete

user list

user modify

user password

إدارة النطاقات

domain add

domain delete

domain list

إدارة التكوين

config init

config verify

config get

config set

إدارة DKIM

dkim generate

dkim show

إدارة الحصص

quota get

quota set

quota list

النسخ الاحتياطي والاستعادة

backup create

backup restore

backup list

إدارة قاعدة البيانات

db migrate

db ping

db vacuum

إدارة التخزين

storage stats

storage test

storage migrate

storage cleanup

إدارة الوحدات

module list

module enable

module disable

module reload

إدارة السجلات

logs view

أوامر المراقبة

stats

health

أدوات التشخيص

diagnose

test-smtp

test-imap

إكمال Shell

Bash

Zsh

Fish

متغيرات البيئة