آموزش نصب Rocket.Chat با Docker Compose روی سرور
راهنمای کامل نصب Rocket.Chat روی VPS با Docker Compose. رفع خطای MongoDB replica set، تنظیمات TLS و مدیریت بکآپ برای اجرای پایدار این جایگزین متنباز Slack.
آنچه در حال ساخت آن هستید
یک محیط گفتگوی تیمی خصوصی که مالکیت کامل آن با شماست: Rocket.Chat که روی VPS شخصی شما و تحت Docker Compose اجرا میشود، با TLS termination محافظت شده و تمامی پیامها در یک پایگاه داده MongoDB ذخیره میشوند که میتوانید از آن نسخه پشتیبان تهیه کرده و جابهجا کنید. Rocket.Chat جایگزین متنباز و بالغ برای Slack و Teams است که امکاناتی نظیر کانالها، پیامهای مستقیم، رشتههای گفتگو (threads)، اشتراکگذاری فایل و تماسهای صوتی و تصویری را روی سختافزاری که اجاره کردهاید و کنترل آن را در دست دارید، ارائه میدهد. البته این تنها گزینه معتبر نیست و اگر هنوز در حال انتخاب هستید، مقایسه Mattermost، Rocket.Chat، Synapse و Zulip این گزینهها را بر اساس مواردی که بعداً چالشبرانگیز میشوند بررسی میکند: میزان مصرف RAM، پایگاه داده، اعلانهای موبایل (push)، احراز هویت یکپارچه (SSO) و ارتقاها. این برنامه یک کانتینر واحد است که در عرض چند دقیقه بالا میآید. هر مشکلی که واقعاً رخ دهد در پایگاه داده کنار آن نهفته است، بنابراین بخش عمدهای از این راهنما به MongoDB اختصاص دارد و بهویژه به یک پیشنیاز که در اولین تجربه همه را غافلگیر میکند: Rocket.Chat روی یک MongoDB مستقل (standalone) اجرا نمیشود. این برنامه به یک replica set نیاز دارد، حتی اگر این "مجموعه" فقط شامل یک گره (node) باشد.
پیشنیازها و محاسبات رم که کسی به شما نمیگوید
سختافزار را واقعبینانه انتخاب کنید. حداقل منابع منطقی برای یک تیم کوچک، 2 هسته vCPU و 4 گیگابایت رم است. پردازش Node.js در Rocket.Chat بهتنهایی حدود 1 تا 1.5 گیگابایت رم نیاز دارد و حافظه کش WiredTiger در MongoDB بهصورت پیشفرض بزرگترین مقدار بین «50 درصد از (کل رم منهای 1 گیگابایت)» یا 0.256 گیگابایت را اشغال میکند. این مقدار پیشفرض فرض را بر این میگذارد که mongod تمام منابع سرور را در اختیار دارد؛ این محاسبه بر اساس کل رم انجام میشود و هیچ توجهی به میزان مصرف فعلی Node ندارد. بنابراین در یک سرور 4 گیگابایتی، 1.5 گیگابایت و در یک سرور 2 گیگابایتی حدود 0.5 گیگابایت رم را اشغال میکند که این مقدار علاوه بر heap مربوط به Node، حافظه خارج از کش mongod و سیستمعامل است. در یک VPS با 2 گیگابایت رم، این دو سرویس هنگام بوت بالا میآیند اما به محض ورود ترافیک واقعی، با هم تداخل پیدا میکنند: MongoDB کش خود را بزرگ میکند، Node حافظه heap خود را افزایش میدهد، کرنل با کمبود صفحه (page) مواجه میشود و OOM Killer بزرگترین پردازش، یعنی معمولاً mongod را میکشد. کانتینر پیام Killed را چاپ میکند، Docker آن را ریاستارت میکند و شما با یک سرور چت مواجه میشوید که زیر بارِ کاریِ عادی، هر چند دقیقه یکبار قطع میشود. 2 گیگابایت رم فقط برای تست اولیه با 2 نفر مناسب است و برای یک سرور تیمی کافی نیست. با 4 گیگابایت شروع کنید و اگر انتظار دهها کاربر همزمان، تماسهای ویدیویی یا تاریخچه آپلود رو به رشد دارید، 8 گیگابایت رم در نظر بگیرید. برای سایر سرویسهایی که روی سرور اجرا میشوند نیز بودجهبندی کنید: قرار دادن یک فضای کاری AFFiNE مشابه Notion روی همان VPS، چهار کانتینر دیگر اضافه میکند که برای همان صفحات رم رقابت میکنند، بنابراین رم آنها باید علاوه بر رم Rocket.Chat تأمین شود.
پیش از شروع، باید سه مورد را آماده کنید. یک نام دامنه با A record که به IP عمومی VPS اشاره میکند؛ ویژگیهای بلادرنگ Rocket.Chat و کلاینتهای موبایل به یک hostname پایدار نیاز دارند، نه یک IP خام. پورتهای 80 و 443 باید هم در فایروال سرور و هم در فایروال شبکهٔ ارائهدهنده (که در اکثر پنلها یک کنترل جداگانه است) باز باشند. همچنین به یک VPS با سیستمعامل Ubuntu 24.04 KVM و دسترسی root یا sudo نیاز دارید. اگر هنوز در حال تصمیمگیری هستید که آیا سرور چت اولین سرویس مناسب برای میزبانی شخصی است یا خیر، راهنمای آنچه در سال 2026 ارزش میزبانی شخصی دارد، جوانب مثبت و منفی آن را بررسی کرده است.
نصب موتور Docker و افزونه Compose
از مخزن apt اختصاصی Docker استفاده کنید، نه بسته docker.io که در Ubuntu ارائه میشود و نه فایل باینری قدیمی و مستقل docker-compose که با Python نوشته شده است. نسخه مدرن Compose یک افزونه برای Docker است که آن را به صورت docker compose فراخوانی میکنید (با یک فاصله، نه خط تیره). نسخه قدیمی docker-compose v1 به پایان عمر خود رسیده است، اگرچه آخرین نسخه آن یعنی 1.29.2 از شرط وابستگی service_healthy که در ادامه استفاده شده، پشتیبانی میکند.
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginحضور هر دو بخش را تأیید کنید:
sudo docker version
sudo docker compose versiondocker compose version چاپ یک خط نسخه، بررسی اصلی و مهم است. نسخههای فعلی Docker Compose version v5.x را چاپ میکنند (نسخه v5.6.0 که در 2 اکتبر 2026 منتشر شد، تا تاریخ 2026-10-10 آخرین نسخه بوده است)؛ یک نصب قدیمیتر ممکن است همچنان v2.x را چاپ کند و Docker از هر دو پشتیبانی میکند. Docker نسخه Compose v5 را از نظر عملکرد کاملاً مشابه v2 توصیف میکند و شمارهگذاری v5 برای جلوگیری از سردرگمی با فرمتهای قدیمی فایل compose یعنی v2 و v3 انجام شده است، بنابراین هر دو برای این راهنما مناسب هستند. اگر با خطای docker: 'compose' is not a docker command مواجه شدید، یعنی افزونه نصب نشده است و در ادامه با خطاهای گیجکنندهای روبرو خواهید شد؛ پس همینجا آن را اصلاح کنید.
فایل compose: استفاده از MongoDB به عنوان یک replica set تکعضوی
این بخشی است که افراد در آن دچار اشتباه میشوند، پس آن را با دقت بخوانید. Rocket.Chat از change streams در MongoDB برای ارسال پیامهای جدید به کلاینتهای متصل بهصورت بلادرنگ استفاده میکند. این قابلیت فقط در replica setها و کلاسترهای sharded در دسترس است و در سرورهای standalone وجود ندارد. اگر Rocket.Chat را به یک mongod ساده متصل کنید، اتصال برقرار میشود اما در باز کردن change stream شکست میخورد و در یک حلقهٔ بیپایانِ راهاندازی مجدد (restart-loop) گیر میکند. راهحل پیچیده نیست: شما یک کانتینر معمولی MongoDB را اجرا میکنید، اما آن را با --replSet شروع کرده و سپس یک مجموعهٔ تکعضوی را مقداردهی اولیه میکنید.
یک دایرکتوری کاری و یک compose.yml ایجاد کنید:
services:
mongodb:
image: mongo:8.0
restart: always
command: ["mongod", "--replSet", "rs0", "--bind_ip_all", "--oplogSize", "128"]
volumes:
- mongodb_data:/data/db
- mongodb_config:/data/configdb
healthcheck:
test: ["CMD", "mongosh", "--quiet", "--eval", "db.adminCommand('ping')"]
interval: 10s
timeout: 10s
retries: 12
rocketchat:
image: registry.rocket.chat/rocketchat/rocket.chat:8.5.1
restart: always
depends_on:
mongodb:
condition: service_healthy
environment:
MONGO_URL: "mongodb://mongodb:27017/rocketchat?replicaSet=rs0"
ROOT_URL: "https://chat.example.com"
PORT: "3000"
ports:
- "127.0.0.1:3000:3000"
volumes:
mongodb_data:
mongodb_config:چند انتخاب در اینجا آگاهانه انجام شده است. پورت Rocket.Chat روی 127.0.0.1:3000 منتشر میشود، نه 0.0.0.0. خود برنامه فاقد TLS است، بنابراین فقط reverse proxy که روی همان سیستم قرار دارد باید به آن دسترسی داشته باشد؛ bind کردن آن روی تمام اینترفیسها باعث میشود صفحهٔ ورود به صورت متنباز (plaintext) مستقیماً روی اینترنت عمومی قرار بگیرد. MongoDB اصلاً روی هاست منتشر نمیشود؛ این سرویس فقط از طریق شبکهٔ داخلی Compose و با نام mongodb قابل دسترسی است که دقیقاً همان نام هاستی است که MONGO_URL از آن استفاده میکند. MONGO_URL شامل ?replicaSet=rs0 است که نام مجموعه را بهطور صریح مشخص میکند؛ MongoDB توصیه میکند برای رفتار یکسان در درایورهای مختلف، این مورد تنظیم شود. حذف آن به تنهایی باعث خرابی نمیشود: directConnection بهصورت پیشفرض از false استفاده میکند، بنابراین درایور همچنان replica set را شناسایی کرده و عملیات را به primary میفرستد، مشروط بر اینکه مجموعه با نام هاستی مقداردهی شده باشد که Rocket.Chat بتواند آن را resolve کند، که بخش بعدی به این موضوع میپردازد. MONGO_OPLOG_URL در نسخه 8.0.0 از Rocket.Chat حذف شده است، بنابراین در اینجا آورده نشده؛ Rocket.Chat به جای آن از MongoDB change streams استفاده میکند. در depends_on از condition: service_healthy استفاده شده است، بنابراین Compose تا زمانی که MongoDB به یک ping پاسخ ندهد، Rocket.Chat را شروع نمیکند؛ این همان هدف healthcheck است.
نسخههای واقعی (version tags) را برای هر دو ایمیج قفل کنید، مانند mongo:8.0 و یک نسخه صریح از Rocket.Chat مانند 8.5.1 در اینجا، و از :latest اجتناب کنید، زیرا ممکن است هنگام بازسازی کانتینر، نسخهای ناخواسته انتخاب شود. docker pull فقط ایمیج را دانلود میکند؛ استقرار آن نیازمند اقدام دیگری مانند docker compose up -d است و Rocket.Chat هنگام شروع کانتینر جدید، مهاجرتهای (migrations) خود را اجرا میکند. پیش از قفل کردن نسخه، نسخه پایدار فعلی Rocket.Chat و نسخههای MongoDB که پشتیبانی میکند را بررسی کنید. جدول پشتیبانی Rocket.Chat برای نسخه 8.x، استفاده از MongoDB 8.0 و بالاتر را ذکر کرده که با نسخه 8.2 تأیید شده است، بنابراین mongo:8.0 یک انتخاب پشتیبانیشده است و نه تنها موتورِ قابل استفاده. یادداشتهای انتشار نسخه 8.5.1 آن را به عنوان یک نسخه LTS معرفی میکنند. همه پروژهها ایمیجهای نسخهبندیشده منتشر نمیکنند؛ در چنین مواردی، قفل کردن نسخه به منبع منتقل میشود: میزبانی شخصی ردیاب تمرین openGym به این معنی است که به جای دنبال کردن یک شاخه (branch) متغیر، یک تگ خاص git را checkout کرده و از روی آن build بگیرید.
راهاندازی اولیه replica set
پشته (stack) را بالا بیاورید:
sudo docker compose up -dRocket.Chat بلافاصله دچار کرش میشود و Docker مدام آن را ریاستارت میکند؛ این رفتار مورد انتظار است، زیرا replica set هنوز وجود ندارد. آن را یکبار بهصورت دستی ایجاد کنید:
sudo docker compose exec mongodb mongosh --eval 'rs.initiate({_id: "rs0", members: [{_id: 0, host: "mongodb:27017"}]})'نتیجه صحیح { ok: 1 } است. ظرف چند ثانیه، تکگره (single node) خود را بهعنوان primary انتخاب میکند؛ این موضوع را با دستور زیر تأیید کنید:
sudo docker compose exec mongodb mongosh --quiet --eval 'rs.status().members[0].stateStr'شما باید PRIMARY را مشاهده کنید. مهمترین جزئیات در کل این صفحه، آرگومان host: "mongodb:27017" است. اگر دستور rs.initiate() را بدون لیست اعضا اجرا کنید، MongoDB نام replica set را با hostname داخلی کانتینر تبلیغ میکند که یک هش تصادفی مانند a1b2c3d4e5f6 است. Rocket.Chat که از کانتینر خودش متصل میشود، نمیتواند این نام را resolve کند، بنابراین درایور MongoDB در DNS با خطا مواجه شده و دائماً پیام MongoServerSelectionError: getaddrinfo ENOTFOUND a1b2c3d4e5f6 را لاگ میکند. همیشه مقداردهی اولیه را با نام سرویس صریحی انجام دهید که با MONGO_URL شما مطابقت دارد.
اولین راهاندازی: نظارت بر بالا آمدن سرویس
هنگامی که مجموعه به وضعیت primary رسید، راهاندازی مجدد بعدی Rocket.Chat بهدرستی متصل شده و مهاجرتهای اولیه (first-run migrations) را آغاز میکند. لاگها را دنبال کنید:
sudo docker compose logs -f rocketchatخطی که باید منتظر آن باشید، بنر شروع به کار است:
+--------------------------------------------+
SERVER RUNNING
Rocket.Chat Version: 8.5.1
NodeJS Version: 22.22.3 - x64
+--------------------------------------------+اولین راهاندازی کند است، زیرا برنامه مهاجرتهای دیتابیس را اجرا کرده و ایندکسها را میسازد؛ بنابراین پیش از نگرانی، یک یا دو دقیقه به آن زمان بدهید. اگر لاگ بهجای آن، MongoServerSelectionError: Server selection timed out after 30000 ms را با توصیف توپولوژی از نوع ReplicaSetNoPrimary تکرار میکند، درایور هیچ primary شناختهشدهای ندارد؛ برای یافتن عدم مقداردهی اولیه، انتخابات (election) یا غیرقابلدسترس بودن primary، rs.status() را بررسی کنید. اگر getaddrinfo ENOTFOUND را روی یک هش تصادفی تکرار میکند، نام میزبان (hostname) عضو تبلیغشده در پیکربندی replica set را بررسی کنید. هنگامی که SERVER RUNNING را مشاهده کردید، Rocket.Chat روی 127.0.0.1:3000 در حال گوش دادن است و زمان آن رسیده که یک نام میزبان واقعی و TLS را در مقابل آن قرار دهید.
قرار دادن پشت TLS
هرگز Rocket.Chat را روی HTTP ساده در معرض دید قرار ندهید. یک بار ورود از طریق http:// کافی است تا رمز عبور مدیریت خود را به دست هر کسی که در مسیر شبکه قرار دارد، بسپارید. TLS را در یک reverse proxy روی همان سرور خاتمه دهید و درخواستها را به 127.0.0.1:3000 هدایت کنید. دو نکته اهمیت دارد: پروکسی باید هدرهای WebSocket upgrade را فوروارد کند، زیرا Rocket.Chat یک سرویس بلادرنگ است و بدون این هدرها از کار میافتد؛ همچنین ROOT_URL کانتینر باید دقیقاً با آدرس HTTPS عمومی که کاربران وارد میکنند، مطابقت داشته باشد.
با یک بلاک سرور HTTP ساده در nginx شروع کنید که درخواستها را به برنامه پروکسی کرده و هدرهای upgrade را فوروارد میکند. آن را در /etc/nginx/sites-available/rocketchat ذخیره کنید، یک symlink به sites-enabled ایجاد کنید و nginx را reload کنید:
server {
listen 80;
server_name chat.example.com;
client_max_body_size 100M;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}فعلاً آن را روی پورت 80 نگه دارید؛ بلاکی با listen 443 ssl; و بدون گواهی، حتی از sudo nginx -t عبور نخواهد کرد. nginx را reload کنید (sudo nginx -t && sudo systemctl reload nginx) و سپس گواهی را صادر کنید. تمیزترین روش در Ubuntu استفاده از گواهیهای TLS Let's Encrypt با Certbot و nginx است: certbot --nginx بلاک بالا را در محل بازنویسی کرده، listen 443 ssl;، خطوط ssl_certificate و یک تغییر مسیر خودکار از 80 به 443 را اضافه میکند و تمدید گواهی را برای شما زمانبندی میکند. اگر در حال حاضر چندین کانتینر را پشت یک پروکسی اجرا میکنید، Traefik با TLS خودکار برای چندین برنامه Docker گزینه مرتبتری است؛ کافی است برچسبهای router و service را به سرویس rocketchat اضافه کنید تا Traefik درخواست گواهی را انجام داده و آن را برای شما تمدید کند، بدون اینکه نیازی به هیچ بلاک nginx باشد. در هر صورت، ROOT_URL را در compose.yml روی https://chat.example.com تنظیم کنید و sudo docker compose up -d را دوباره اجرا کنید تا کانتینر تغییرات را اعمال کند. اگر میخواهید سرور فقط از داخل شبکه خودتان قابل دسترسی باشد و نه از اینترنت عمومی، آن را پشت یک VPN شخصی WireGuard روی VPS قرار دهید و پروکسی را به آدرس تونل bind کنید.
ویزارد راهاندازی اولیه
به آدرس https://chat.example.com بروید تا Rocket.Chat شما را از طریق یک ویزارد کوتاه راهنمایی کند. ابتدا حساب کاربری مدیر (admin account)، شامل نام واقعی، نام کاربری، ایمیل و یک رمز عبور قوی را وارد کنید؛ این تنها حسابی است که در ابتدا وجود دارد، پس آن را فراموش نکنید. سپس اطلاعات سازمان شامل نام، صنعت، اندازه و کشور را وارد کنید. مستندات فعلی راهاندازی Rocket.Chat، ثبت فضای کاری (workspace) در Rocket.Chat Cloud را الزامی میداند؛ این مستندات روشهای ثبت آنلاین و آفلاین را شرح میدهند و گزینهای مستقل برای نادیده گرفتن ثبتنام وجود ندارد.
ثبتنام، امکان استفاده از اعلانهای فشاری (push notifications) موبایل را از طریق درگاه Rocket.Chat و بازار افزونهها فراهم میکند، اما به قیمت ایجاد یک رابطه کنترلکننده با ابر Rocket.Chat تمام میشود؛ اعلانهای ارسالی از طریق این درگاه، در محدودیت ماهانه فضای کاری شما محاسبه میشوند. سرویسهای ابری همچنین نیازمند استفاده از نسخهای از Rocket.Chat هستند که در بازه پشتیبانی قرار دارد. اپلیکیشنهای رسمی iOS و Android تنها از طریق درگاه Rocket.Chat اعلانهای فشاری را دریافت میکنند که این امر مستلزم ثبت فضای کاری و پذیرش شرایط حریم خصوصی سرویس ابری است. راه حل جایگزین، استفاده از نسخه اختصاصی (white-labeled) خودتان از اپلیکیشن موبایل است: در تنظیمات Push، درگاه را غیرفعال کنید، گواهیهای APNs و اعتبارنامههای Firebase Cloud Messaging خود را وارد کنید و از کاربران بخواهید به جای اپلیکیشن رسمی، اپلیکیشن شما را نصب کنند. پس از تغییر تنظیمات درگاه، Rocket.Chat را مجدداً راهاندازی کنید.
پیش از دعوت دیگران، دسترسیها را محدود کنید
پیش از دعوت هر فرد، Registration Form را بررسی کنید: وقتی روی Public تنظیم شده باشد، هر کسی که URL را پیدا کند میتواند حساب کاربری بسازد. روی یک نام دامنه عمومی، این به معنای باز گذاشتن در است. به مسیر Manage → Workspace → Settings → Accounts → Registration بروید و Registration Form را روی Disabled قرار دهید تا بتوانید حسابها را دستی یا با لینک دعوت بسازید، یا آن را روی Secret URL تنظیم کنید. در همان بخش، گزینههای Allow Anonymous Read و Allow Anonymous Write را غیرفعال کنید، مگر اینکه مشخصاً به یک کانال عمومی با دسترسی فقطخواندنی نیاز داشته باشید. اگر ساخت دستی تکتک حسابها خستهکننده است و این تنها سرویسی نیست که تیم شما از آن استفاده میکند، ورود Rocket.Chat را به یک سرور SSO خودمیزبان Authentik متصل کنید تا مدیریت ورود و خروج کاربران بهجای انجام در هر برنامه بهصورت جداگانه، یکبار و در یک نقطه متمرکز انجام شود.
همچنین تصمیم بگیرید که فایلهای آپلود شده کجا ذخیره شوند. حافظه پیشفرض برای File Upload گزینه GridFS است که تمام تصاویر و پیوستها را درون خود MongoDB ذخیره میکند. این روش ساده است، اما باعث میشود دیتابیس شما و هر mongodump که میگیرید، با ارسال اسکرینشات توسط کاربران، بدون محدودیت رشد کند. در مسیر Manage → Workspace → Settings → File Upload میتوانید نوع ذخیرهسازی را به فایلسیستم محلی یا یک bucket سازگار با S3 تغییر دهید و یک حداکثر اندازه معقول برای فایلها تعیین کنید. اگر تیم شما بهجای اسکرینشاتهای گاهبهگاه، کل کتابخانههای عکس را جابهجا میکند، این فایلها باید در یک سرور اختصاصی عکس ذخیره شوند، نه در دیتابیس چت. مطلب مقایسه PhotoPrism و Immich بررسی میکند که هر کدام چه میزان RAM مصرف میکنند و چه دستورات پشتیبانگیری (backup) نیاز دارند. برای یک تیم کوچک، GridFS مناسب است؛ فقط به یاد داشته باشید که حجم پشتیبانهای شما بهمرور زمان افزایش مییابد.
پشتیبانگیری با mongodump
با استفاده از ذخیرهسازی پیشفرض GridFS، دادههای فضای کاری شما در volume مربوط به mongodb_data قرار دارند. صرفاً کپی کردن volume از زیر یک دیتابیس در حال اجرا کافی نیست؛ با استفاده از mongodump یک dump تهیه کنید و آن را به صورت stream در فایلی روی host ذخیره نمایید. برای اطمینان از سازگاری دادهها، Rocket.Chat و هر پردازش دیگری که در حال نوشتن در دیتابیس است را در طول مدت این dump متوقف کنید و پس از موفقیتآمیز بودن عملیات، Rocket.Chat را دوباره اجرا نمایید:
sudo docker compose stop rocketchat
sudo docker compose exec -T mongodb mongodump --db rocketchat --archive --gzip > rocketchat-$(date +%F).archive.gz
sudo docker compose start rocketchatآن آرشیو واحد که با gzip فشرده شده، کل فضای کاری شماست: کاربران، کانالها، پیامها، تنظیمات و اگر آپلودها را در GridFS باقی گذاشته باشید، فایلها نیز در آن قرار دارند. اگر آپلودها را به filesystem یا S3 منتقل کردهاید، آن محل ذخیرهسازی را جداگانه پشتیبانگیری کنید. برای بازیابی روی یک stack جدید، ابتدا replica set را مقداردهی اولیه کنید و سپس هنگام بازیابی، Rocket.Chat را متوقف نمایید:
sudo docker compose stop rocketchat
sudo docker compose exec -T mongodb mongorestore --archive --gzip --drop < rocketchat-2026-07-15.archive.gz
sudo docker compose start rocketchatآرشیو را به خارج از سرور، object storage، یک سرور دیگر یا هر جایی که در صورت خرابی VPS، پشتیبان از بین نرود منتقل کنید و dump را به صورت شبانه از طریق cron اجرا نمایید. پشتیبانی که هرگز آن را بازیابی نکردهاید، صرفاً یک امید است، نه یک پشتیبان؛ بازیابی را یک بار روی یک VPS موقت تمرین کنید تا پیش از نیاز واقعی، از عملکرد آن مطمئن شوید.
ارتقاها: پین کردن تگها، مطالعه یادداشتها و رعایت ماتریس سازگاری Mongo
دو قانون باعث میشود ارتقاها بدون دردسر انجام شوند. نخست، Rocket.Chat را هر بار یک نسخه اصلی (Major) ارتقا دهید. این نرمافزار هنگام بالا آمدن، مهاجرتهای Schema را اجرا میکند و مستندات ارتقای Rocket.Chat تأکید دارند که همیشه باید بهصورت متوالی در نسخههای اصلی حرکت کنید؛ چرا که پرش از نسخههای اصلی میتواند باعث مشکلات جدی در سازگاری شود. به این تکیه نکنید که نرمافزار جلوی شما را میگیرد: هیچ تضمینی در مستندات وجود ندارد که پرش مستقیم از 6.x به 8.x بهطور ایمن مسدود شود و اگر مهاجرت در میانه راه شکست بخورد، lock باقی میماند و نیاز به تعمیر دستی پیدا میکند. تگ image را به آخرین نسخه از Major بعدی تغییر دهید، یادداشتهای آن نسخه را برای تغییرات ساختارشکن (Breaking Changes) بخوانید، دستور docker compose up -d را اجرا کنید و پیش از ادامه، لاگها را زیر نظر بگیرید تا مهاجرت کامل شود. دوم، ماتریس پشتیبانی MongoDB را رعایت کنید. الزامات موتور دیتابیس در نسخه مقصد و جدول پشتیبانی Rocket.Chat را با هم چک کنید: نسخه MongoDB ذکر شده حداقلِ مورد نیاز است و Rocket.Chat 8.x از MongoDB 8.0 و بالاتر پشتیبانی میکند که با 8.2 تأیید شده است. هنگام ارتقای MongoDB، مثلاً از 7.0 به 8.0، هر بار یک نسخه اصلی جلو بروید و پس از هر مرحله، نسخه سازگاری ویژگی (feature-compatibility version) را تنظیم کنید. در MongoDB 8.0، این دستور نیازمند یک confirm: true صریح است، در غیر این صورت با پیامی که از شما میخواهد دستور را با فلگ تأیید مجدداً اجرا کنید، متوقف میشود:
sudo docker compose exec mongodb mongosh --eval 'db.adminCommand({setFeatureCompatibilityVersion: "8.0", confirm: true})'پیش از هر ارتقا در هر یک از این دو مؤلفه، یک mongodump تهیه کنید. پیکربندی Compose و هرگونه فضای ذخیرهسازی خارجی برای آپلودها را نیز ذخیره کنید تا نسخه پشتیبان کل deployment را پوشش دهد.
حالتهای شکست، همراه با رشتههای دقیق
سرویس Rocket.Chat بلافاصله پس از docker compose up وارد حلقه راهاندازی مجدد (restart-loop) میشود و docker compose logs rocketchat با یک MongoServerSelectionError پر میشود. درایور نمیتواند سرور MongoDB مناسبی را انتخاب کند؛ برای یافتن علت، توصیف توپولوژی و خطاهای زیرین را بررسی کنید. Server selection timed out after 30000 ms با نوع توپولوژی ReplicaSetNoPrimary به این معنی است که درایور میداند در حال اتصال به یک replica set است اما هیچ primary شناختهشدهای ندارد؛ عدم مقداردهی اولیه، انجام نشدن انتخابات (election) یا غیرقابل دسترس بودن primary از دلایل احتمالی هستند. getaddrinfo ENOTFOUND به همراه یک هش تصادفی، نشاندهنده نام میزبان (hostname) غیرقابل حل برای یکی از اعضای معرفیشده است. با استفاده از sudo docker compose exec mongodb mongosh --eval 'rs.status()' عیبیابی کنید: اگر خطای MongoServerError: no replset config has been received دریافت کردید، مجموعه را مقداردهی اولیه کنید؛ اگر عضوی را نشان میدهد که name آن یک هش تصادفی است، پیکربندی را با rs.conf() بازیابی کنید، host آن عضو را به mongodb:27017 تغییر دهید و آن را با rs.reconfig() روی primary اعمال کنید. اگر پیکربندی صحیح است، وضعیت عضو، لاگهای MongoDB و اتصال از داخل container مربوط به Rocket.Chat را بررسی کنید.
رابط کاربری وب بارگذاری میشود اما فرآیند ورود (login) بیپایان میچرخد و هرگز تکمیل نمیشود. کنسول مرورگر را باز کنید؛ در آنجا WebSocket connection to 'wss://chat.example.com/websocket' failed را خواهید دید. این مشکل تقریباً همیشه ناشی از عدم تطابق ROOT_URL یا پروکسی است که هدرهای upgrade را فوروارد نمیکند. تأیید کنید که ROOT_URL دقیقاً با آدرس عمومی شامل https:// برابر باشد و بلوک location در nginx شما، Upgrade و Connection "upgrade" را با proxy_http_version 1.1 تنظیم کرده باشد. پس از تغییر ROOT_URL، دستور docker compose up -d را دوباره اجرا کنید؛ پس از تغییر nginx، دستور sudo nginx -t && sudo systemctl reload nginx را اجرا کنید.
یک container مدام متوقف میشود و docker compose ps نشان میدهد که Restarting. متن docker compose logs در میانه خط قطع میشود و sudo dmesg | tail نشاندهنده Out of memory: Killed process 12345 (mongod) توسط oom-killer است؛ کد خروج 137 است. سرور با کمبود RAM مواجه است. راهحل اصلی، استفاده از یک VPS بزرگتر با حداقل 4 GB رم است. بهعنوان یک راهحل موقت، swap اضافه کنید و کش MongoDB را با --wiredTigerCacheSizeGB در فایل command محدود کنید. این مقدار را کمتر از پیشفرض تنظیم کنید، برای مثال 1 روی یک سرور 4 GB (پیشفرض 1.5) یا 0.3 روی یک سرور 2 GB (پیشفرض حدود 0.5)؛ اما توجه داشته باشید که swap فقط وقوع OOM بعدی را تحت بار واقعی به تأخیر میاندازد:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfiledocker compose up با خطای Error response from daemon: driver failed programming external connectivity ... bind: address already in use شکست میخورد. چیزی در حال حاضر پورت 3000 را اشغال کرده است؛ اغلب یک container قبلی از Rocket.Chat است که بهدرستی متوقف نشده یا برنامه دیگری است. آن را با sudo ss -ltnp | grep :3000 پیدا کنید، آن فرآیند یا container را متوقف کنید، یا سمت میزبان (host side) نگاشت پورت را به 127.0.0.1:3001:3000 تغییر دهید و proxy_pass پروکسی خود را مطابق با آن بهروزرسانی کنید.
FAQ
آیا Rocket.Chat واقعاً به یک MongoDB replica set نیاز دارد؟
بله، حتی برای یک سرور تکی با یک گره دیتابیس. Rocket.Chat پیامها را بهصورت بلادرنگ با استفاده از change streamهای MongoDB ارسال میکند که نیازمند یک replica set یا sharded cluster است؛ یک نمونه standalone از mongod نمیتواند چنین قابلیتی را ارائه دهد. نیازی به چندین ماشین ندارید؛ میتوانید یک کانتینر MongoDB را با --replSet rs0 اجرا کرده و یک set تکعضوی را با rs.initiate() مقداردهی اولیه کنید. اگر این مرحله را نادیده بگیرید، درایور هرگز یک primary پیدا نمیکند و در نتیجه Rocket.Chat با خطای MongoServerSelectionError: Server selection timed out در حلقهٔ راهاندازی مجدد گیر کرده و هرگز بالا نمیآید.
Rocket.Chat خودمیزبان (self-hosted) به چه مقدار RAM نیاز دارد؟
حداقل 4 گیگابایت رم را بهعنوان مقدار عملیاتی در نظر بگیرید و برای یک تیم فعال، 8 گیگابایت پیشنهاد میشود. پردازش Node در Rocket.Chat حدود 1 تا 1.5 گیگابایت رم مصرف میکند و کش پیشفرض WiredTiger در MongoDB برابر با نصفِ (کل رم منهای 1 گیگابایت) است، بهطوری که فرض میشود هیچ برنامهٔ دیگری روی سیستم در حال اجرا نیست. در یک سیستم با 2 گیگابایت رم، این کش، heap مربوط به Node و سربار خودِ mongod با هم تداخل پیدا میکنند و OOM killer (قاتل کمبود حافظه) در هر بار فشار کاری واقعی، mongod را متوقف میکند که در لاگها با Killed و کد خروج 137 نمایش داده میشود. 2 گیگابایت رم تنها برای ارزیابی نرمافزار با چند کاربر آزمایشی کافی است.
چگونه Rocket.Chat را پشت HTTPS قرار دهم؟
یک reverse proxy روی همان VPS اجرا کنید که TLS را خاتمه داده و درخواستها را به 127.0.0.1:3000 هدایت کند، سپس ROOT_URL کانتینر را روی https:// عمومی خود تنظیم کنید. پروکسی باید هدرهای WebSocket upgrade را منتقل کند، در غیر این صورت ورود به سیستم متوقف میشود. استفاده از Certbot به همراه nginx سادهترین روش برای یک برنامه تکی است؛ اگر چندین کانتینر را پشت یک پروکسی اجرا میکنید و مدیریت خودکار گواهیها را میخواهید، Traefik گزینهٔ تمیزتری است.
چگونه از یک Rocket.Chat خودمیزبان نسخه پشتیبان تهیه کنم؟
پیش از تهیه dump از دیتابیس، Rocket.Chat و هر نویسندهٔ دیگری که به دیتابیس دسترسی دارد را متوقف کنید: docker compose exec -T mongodb mongodump --db rocketchat --archive --gzip > backup.archive.gz. پس از موفقیتآمیز بودن dump، Rocket.Chat را دوباره اجرا کنید. آن آرشیو شامل کاربران، کانالها، پیامها و تنظیمات است؛ همچنین اگر ذخیرهسازی را روی GridFS باقی گذاشته باشید، فایلهای آپلود شده نیز در آن قرار دارند. فایل را از سرور خارج کنید، آن را با cron بهصورت شبانه خودکار کنید و یک mongorestore را روی یک سیستم آزمایشی تمرین کنید تا مطمئن شوید که بازیابی واقعاً کار میکند.
چگونه Rocket.Chat را بدون آسیب زدن به MongoDB ارتقا دهم؟
Rocket.Chat را هر بار یک نسخه اصلی (major version) ارتقا دهید. این برنامه هنگام بالا آمدن، مهاجرتهای دیتابیس را اجرا میکند و مستندات آن هشدار میدهند که پریدن از نسخههای اصلی میتواند باعث مشکلات جدی سازگاری شود؛ پیش از تغییر تگ image، یادداشتهای هر نسخه (release notes) را مطالعه کنید. نیازمندیهای موتور دیتابیس برای نسخه مقصد را با جدول پشتیبانی MongoDB در Rocket.Chat چک کنید؛ Rocket.Chat 8.x از MongoDB 8.0 و بالاتر پشتیبانی میکند که با 8.2 تأیید شده است. هنگام ارتقای MongoDB، هر بار یک نسخه اصلی جلو بروید و پس از هر مرحله setFeatureCompatibilityVersion را تنظیم کنید؛ MongoDB 7.0 و نسخههای بعد از آن نیازمند confirm: true هستند. همیشه ابتدا یک mongodump تهیه کنید.