VPS-এ Matrix Synapse সেটআপ ও রক্ষণাবেক্ষণের নিয়ম
VPS-এ Matrix Synapse চালানোর জন্য প্রয়োজনীয় রিসোর্স, Postgres কনফিগারেশন এবং মিডিয়া স্টোরেজ ম্যানেজমেন্ট শিখুন। সার্ভার সচল রাখতে রেজিস্ট্রেশন সুরক্ষা ও ব্যাকআপের সঠিক উপায় জানুন।
একটি Matrix Synapse homeserver সচল রাখার প্রয়োজনীয়তা
Matrix Synapse ইনস্টল করা সহজ, কিন্তু একে অবহেলা করাও সহজ। এর ইনস্টলেশন প্রক্রিয়ায় একটি apt repository, একটি configuration file, একটি reverse proxy block এবং একটি DNS record প্রয়োজন হয়। এক বছর ধরে homeserver-কে সুস্থ রাখা সম্পূর্ণ ভিন্ন একটি কাজ: এর জন্য প্রয়োজন একটি প্রকৃত database, media store যা নিয়মিত পরিষ্কার (prune) করা হয়, এমন registration ব্যবস্থা যা অপরিচিতরা ব্যবহার করতে পারে না, এবং একটি backup যা সার্ভারের উভয় অংশকেই সংরক্ষণ করে।
এই নির্দেশিকাটি Ubuntu 24.04 LTS-এর জন্য তৈরি এবং এটি matrix.org apt repository থেকে Synapse ইনস্টল করে, যা Debian এবং Ubuntu-এর জন্য Synapse প্রজেক্ট কর্তৃক রক্ষণাবেক্ষণ করা প্যাকেজ সোর্স। প্যাকেজ ভার্সন প্রতি কয়েক সপ্তাহ পরপর পরিবর্তিত হয়, তাই এখানে কোনো নির্দিষ্ট ভার্সন নম্বর উল্লেখ করা হয়নি। নিচে উল্লিখিত প্রতিটি path এবং option বর্তমান Synapse documentation থেকে নেওয়া হয়েছে।
Sizing: 1টি vCPU এবং 2 GB RAM আসলে আপনাকে কী দেয়
আগস্ট 2026 পর্যন্ত প্রকাশিত সাইজিং পেজগুলোতে সাধারণত Synapse homeserver-এর জন্য 1টি vCPU এবং 2 GB RAM-এর সুপারিশ করা হয়। এটি একটি নির্দিষ্ট ক্ষেত্রে সঠিক: একটি ব্যক্তিগত সার্ভার, যেখানে ব্যবহারকারী কম, রুমগুলো ছোট এবং কোনো ব্যস্ত পাবলিক রুম নেই। Synapse-এর ডকুমেন্টেশন অন্য ক্ষেত্রটির ব্যাপারে সরাসরি সতর্ক করে। সেখানে বলা হয়েছে, "আপনি যদি #matrix:matrix.org-এর মতো বড় পাবলিক রুমে যোগ দিতে চান, তবে অন্তত 1 GB ফ্রি RAM প্রয়োজন।" এই ফ্রি RAM-এর হিসাবটি Python, Postgres এবং কার্নেলের ব্যবহারের অতিরিক্ত।
একটি রুম আপনার সাইজিংয়ের প্রয়োজনীয়তা বদলে দিতে পারে, কারণ জয়েন করার প্রক্রিয়াটি সেভাবেই কাজ করে। যখন কোনো লোকাল ব্যবহারকারী একটি রুমে যোগ দেন, আপনার homeserver সেই রুমের একজন পূর্ণ অংশগ্রহণকারী হয়ে ওঠে। এটি সেই রুমের প্রতিটি সার্ভার থেকে আসা প্রতিটি ইভেন্ট গ্রহণ করে, প্রতিটির সিগনেচার যাচাই করে এবং রুমের স্টেট লোকালি সংরক্ষণ করে। একটি বড় পাবলিক রুমে শত শত সার্ভার জুড়ে হাজার হাজার সদস্য থাকে, তাই আপনার ব্যবহারকারী রুমটি খুলুন বা না খুলুন, আপনার সার্ভারকে ক্রমাগত এই কাজগুলো করতে হয়। পরবর্তীতে রুম থেকে বেরিয়ে গেলেও আপনার সংরক্ষিত হিস্ট্রি মুছে যায় না।
Synapse-এর RAM-এর বেশিরভাগ অংশ ক্যাশে (caches) ব্যবহৃত হয়। caches সেকশনে একটি global_factor আছে যা একসাথে সব ক্যাশ স্কেল করে এবং SYNAPSE_CACHE_FACTOR এনভায়রনমেন্ট ভেরিয়েবল একই কাজ করে। এটি বাড়ালে RAM খরচ হয় কিন্তু ডাটাবেস কুয়েরি কমে। এটি কমালে CPU এবং Postgres-এর ওপর চাপ বাড়ে কিন্তু RAM বাঁচে। Postgres-এর নিজেরও মেমোরি প্রয়োজন, তাই 2 GB-এর একটি বক্সে এই দুটি একই মেমোরির জন্য প্রতিযোগিতা করে।
ছোট প্ল্যানের জন্য দুটি ব্যবহারিক নিয়ম মেনে চলুন। Swap যোগ করুন: swap Synapse-কে দ্রুত করবে না, কিন্তু বড় কোনো রুমে যোগ দেওয়ার সময় কার্নেল যাতে প্রসেসটিকে কিল (kill) না করে, তা নিশ্চিত করবে। এরপর প্রথম সপ্তাহ থেকেই ডিস্কের দিকে নজর রাখুন, কারণ মিডিয়া স্টোর এবং রুম স্টেট টেবিল—এই দুটি জিনিসই কোনো সীমা ছাড়াই বাড়তে থাকে এবং উভয়ই ডিস্কে জায়গা নেয়।
কেন Postgres ব্যবহার করবেন এবং কেন SQLite আর কার্যকর নয়
Debian প্যাকেজটি ডিফল্টভাবে SQLite দিয়ে শুরু হয়। প্রথমবার বুট করার জন্য এটি ঠিক থাকলেও, অন্য ব্যবহারকারীরা ব্যবহার করেন এমন সার্ভারের জন্য এটি উপযুক্ত নয়। SQLite-এ একবারে কেবল একজন রাইটার (writer) কাজ করতে পারে। ফেডারেশন ট্রাফিক এবং ক্লায়েন্ট রিকোয়েস্ট একই সময়ে ডেটা রাইট করার চেষ্টা করলে, একটি সাধারণ রিকোয়েস্টকে ধীরগতির রিকোয়েস্টের জন্য অপেক্ষা করতে হয়। এর ফলে ব্যবহারকারীরা অভিযোগ করেন যে অ্যাপটি মাঝেমধ্যে কয়েক সেকেন্ডের জন্য হ্যাং হয়ে যাচ্ছে।
দ্বিতীয় কারণটি কাঠামোগত। Synapse-এর ওয়ার্কার প্রসেসগুলো একাধিক CPU কোর ব্যবহারের সমর্থিত উপায়, আর এই ওয়ার্কারগুলোর জন্য Postgres প্রয়োজন। SQLite-এ আটকে থাকলে আপনি পারফরম্যান্সের পাশাপাশি আপগ্রেড করার সুবিধাও হারাবেন।
পরবর্তীতে মাইগ্রেট করার সুযোগ থাকলেও তাতে ডাউনটাইম প্রয়োজন হয়, তাই ব্যবহারকারী আসার আগেই এটি সম্পন্ন করুন। Synapse-এর সাথে synapse_port_db টুলটি থাকে, যা একটি SQLite ডেটাবেসকে প্রস্তুতকৃত Postgres ডেটাবেসে কপি করে:
synapse_port_db --sqlite-database homeserver.db --postgres-config homeserver-postgres.yamlআপনি যদি Synapse-এর পাশাপাশি কন্টেইনারে ডেটাবেস চালাতে চান, তবে এর সুবিধা-অসুবিধাগুলো Docker-এ বা হোস্ট মেশিনে ডেটাবেস চালানো অংশে দেখুন।
Ubuntu 24.04-এ Synapse ইনস্টল করা
sudo apt install -y lsb-release wget apt-transport-https
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/matrix-org.list
sudo apt update
sudo apt install matrix-synapse-py3Ubuntu 24.04-এ lsb_release -cs কমান্ডটি noble প্রিন্ট করে এবং matrix.org রিপোজিটরি একটি noble স্যুট প্রকাশ করে। Ubuntu-এর নিজস্ব আর্কাইভ থেকে matrix-synapse প্যাকেজটি ব্যবহার করবেন না। Synapse প্রজেক্ট এটি ব্যবহার না করার পরামর্শ দেয়, কারণ সেই বিল্ডগুলো তাদের রিলিজের তুলনায় পিছিয়ে থাকে এবং সেগুলোতে পরিচিত নিরাপত্তা ত্রুটি থাকতে পারে।
ইনস্টলারটি একটি সার্ভার নাম জানতে চাইবে এবং উত্তরটি /etc/matrix-synapse/conf.d/server_name.yaml ফাইলে লিখে রাখবে। সতর্কতার সাথে উত্তর দিন। server_name হলো প্রতিটি ইউজার আইডি (@alice:example.com)-এর কোলনের পরের অংশ এবং এটি আপনার সার্ভারের তৈরি প্রতিটি রুমে এমবেড করা থাকে। পরবর্তীতে এটি পরিবর্তন করলে কোনো কিছু স্থানান্তর হয় না: এটি একটি ভিন্ন হোমসার্ভার তৈরি করে। আপনার মূল ডোমেইন, example.com ব্যবহার করুন, এমনকি যখন Synapse নিজে matrix.example.com-এ চলবে তখনও। ডেলিগেশন এই দুটির মধ্যে সংযোগ স্থাপন করে এবং সেটি পরবর্তী সেকশনে আলোচনা করা হয়েছে।
প্যাকেজটি Synapse-কে matrix-synapse ইউজার হিসেবে চালায়, এর ডেটা /var/lib/matrix-synapse-এর অধীনে রাখে এবং /etc/matrix-synapse/homeserver.yaml ফাইলটি পড়ার পর /etc/matrix-synapse/conf.d/-এর প্রতিটি ফাইল পড়ে। আপনার নিজস্ব সেটিংস conf.d-এর ছোট ছোট ফাইলে রাখুন। প্যাকেজ আপগ্রেড করার সময় এই ফাইলগুলো অপরিবর্তিত থাকে।
sudo systemctl restart matrix-synapse
systemctl status matrix-synapse
sudo journalctl -u matrix-synapse -n 100 --no-pagerএকটি সফল শুরুর পর লিসেনারগুলো চালু হয় এবং তারপর সিস্টেমটি শান্ত হয়ে যায়। কোনো কারণে সার্ভিসটি বন্ধ হয়ে গেলে systemd ইউনিট কয়েক সেকেন্ডের মধ্যে তা পুনরায় চালু করে, তাই Synapse যে কনফিগারেশন গ্রহণ করে না তা একটি লুপে চালু হতে এবং বন্ধ হতে থাকে। জার্নালের শেষ লাইনগুলোতে সেই কী (key)-এর নাম থাকে যা এটি প্রত্যাখ্যান করেছে।
Synapse-কে Postgres-এর দিকে নির্দেশ করুন
sudo apt install -y postgresql
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapseLocale কোনো সাজসজ্জার বিষয় নয়। Synapse ভিন্ন COLLATE এবং CTYPE মান দিয়ে তৈরি করা ডাটাবেসের সাথে শুরু হতে অস্বীকার করে, যদি না আপনি ডাটাবেস কনফিগারেশনে allow_unsafe_locale সেট করেন। এর পরবর্তী নথিভুক্ত সমাধান হলো ডাটাবেস ডাম্প করা এবং সঠিকভাবে তৈরি করা নতুন ডাটাবেসে তা পুনরায় লোড করা। তাই প্রথমবারই এটি সঠিকভাবে তৈরি করুন।
database:
name: psycopg2
txn_limit: 10000
args:
user: synapse_user
password: secretpassword
dbname: synapse
host: localhost
port: 5432
cp_min: 5
cp_max: 10আপনার সমস্ত কনফিগারেশন ফাইল জুড়ে শুধুমাত্র একটি database: কি (key) রাখুন। conf.d-এর অধীনে দ্বিতীয় কোনো কপি যোগ না করে homeserver.yaml-এর ভেতরের SQLite ব্লকটি প্রতিস্থাপন করুন। এতে কোনটি কার্যকর তা নিয়ে কোনো বিভ্রান্তি থাকবে না। রিস্টার্ট করুন, তারপর নিশ্চিত করুন যে Synapse সত্যিই Postgres ব্যবহার করছে:
sudo -u postgres psql synapse -c "SELECT count(*) FROM users;"একটি সংখ্যা আসার অর্থ হলো Synapse এই ডাটাবেসে তার স্কিমা তৈরি করেছে। কোনো missing relation সংক্রান্ত ত্রুটি পাওয়ার অর্থ হলো এটি এখনও SQLite ফাইলে লিখছে, যার মানে আপনি যে কনফিগারেশনটি এডিট করেছেন সেটি পড়া হচ্ছে না।
Reverse proxy, TLS এবং .well-known ফাইল ফেডারেশনের প্রয়োজনীয়তা
Synapse লোকালহোস্টে পোর্ট 8008-এ plain HTTP-তে লিসেন করে। TLS এবং পাবলিক পোর্ট এর সামনে থাকা একটি reverse proxy-র দায়িত্ব।
listeners:
- port: 8008
tls: false
type: http
x_forwarded: true
bind_addresses:
- '::1'
- '127.0.0.1'
resources:
- names:
- client
- federation
compress: falsex_forwarded: true Synapse-কে নির্দেশ দেয় যেন এটি প্রক্সির সেট করা X-Forwarded-For হেডারটিকে বিশ্বাস করে। এটি ছাড়া প্রতিটি ক্লায়েন্টকে 127.0.0.1 থেকে আসা বলে মনে হয়, ফলে রেট লিমিটিং সব ব্যবহারকারীকে একজন অত্যন্ত ব্যস্ত লোকাল ব্যবহারকারী হিসেবে গণ্য করে এবং সবাইকে একসাথে থ্রটল (throttle) করে।
location ~ ^(/_matrix|/_synapse/client) {
proxy_pass http://localhost:8008;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $host:$server_port;
client_max_body_size 50M;
proxy_http_version 1.1;
}Synapse ডকুমেন্টেশনে এই ব্লকটি নিয়ে একটি সতর্কবার্তা দেওয়া আছে যা অনেকের কয়েক দিনের পরিশ্রম নষ্ট করে। proxy_pass-এ পোর্টের পরে কোনো পাথ, এমনকি একটি /-ও যোগ করবেন না। nginx তখন URI-কে ক্যানোনিকাল (canonicalise) করে ফেলে, যা পাঠানো সার্ভারের স্বাক্ষরিত বাইটগুলোকে পরিবর্তন করে দেয়। ফলে সাধারণ ক্লায়েন্ট রিকোয়েস্ট কাজ করলেও ফেডারেশন রিকোয়েস্টগুলো সিগনেচার ভেরিফিকেশনে ব্যর্থ হয়।
client_max_body_size অবশ্যই Synapse-এর max_upload_size-এর সমান বা তার চেয়ে বড় হতে হবে। যদি nginx-এ ছোট সংখ্যা সেট করা থাকে, তবে তার চেয়ে বড় ফাইল আপলোড nginx দ্বারা 413 Request Entity Too Large এর মাধ্যমে প্রত্যাখ্যাত হবে। Synapse এই রিকোয়েস্ট পাওয়ার আগেই তা আটকে যায়, তাই ব্যর্থতার কারণ ব্যাখ্যা করার মতো কোনো Synapse লগ পাওয়া যায় না।
সার্টিফিকেটের জন্য, Certbot and Let's Encrypt on Ubuntu 24.04 অনুসরণ করুন। যদি প্রক্সি নির্বাচন নিয়ে দ্বিধা থাকে, তবে reverse proxy comparison দেখুন, সেখানে আপনার জন্য কোনটি TLS-এর কাজ করবে তা আলোচনা করা হয়েছে।
ডেলিগেশন হলো সেই প্রক্রিয়া যা server_name-কে example.com হিসেবে বহাল রাখে, যদিও Synapse matrix.example.com-এ চলে। বেয়ার ডোমেইন থেকে দুটি ফাইল সার্ভ করুন:
location /.well-known/matrix/server {
default_type application/json;
return 200 '{"m.server": "matrix.example.com:443"}';
}
location /.well-known/matrix/client {
default_type application/json;
add_header Access-Control-Allow-Origin '*';
return 200 '{"m.homeserver": {"base_url": "https://matrix.example.com"}}';
}সার্ভার ফাইলটি অন্য হোমসার্ভারগুলোকে জানায় ফেডারেশন ট্র্যাফিক কোথায় পাঠাতে হবে, যার মাধ্যমে ফেডারেশন ডিফল্ট পোর্ট 8448-এর পরিবর্তে 443 পোর্টে চলে। ক্লায়েন্ট ফাইলটি Matrix ক্লায়েন্টদের জানায় কোন URL @alice:example.com-কে ব্যাক করে। ক্লায়েন্ট ফাইলে Access-Control-Allow-Origin হেডারটি গুরুত্বপূর্ণ, কারণ ব্রাউজার-ভিত্তিক ক্লায়েন্টরা এটি ক্রস-অরিজিন (cross-origin) হিসেবে ফেচ করে। এই হেডার ছাড়া ব্রাউজার রেসপন্স ব্লক করে দেয় এবং ক্লায়েন্ট রিপোর্ট করে যে এটি আপনার হোমসার্ভার খুঁজে পাচ্ছে না।
উভয় ফাইলই অবশ্যই example.com থেকে বৈধ TLS-এর মাধ্যমে সার্ভ করতে হবে। এগুলো চেক করুন, তারপর বাইরের পৃথিবী কী দেখছে তা যাচাই করুন:
curl -s https://example.com/.well-known/matrix/server
curl -s https://matrix.example.com/_matrix/federation/v1/versionপ্রথমটি আপনার লেখা JSON রিটার্ন করবে। দ্বিতীয়টি সার্ভার ইমপ্লিমেন্টেশন এবং এর ভার্সনের নামসহ একটি JSON অবজেক্ট রিটার্ন করবে, যা প্রমাণ করে যে প্রক্সি ফেডারেশন পাথে Synapse-এর সাথে যোগাযোগ করতে পারছে। এরপর https://federationtester.matrix.org-এ Matrix ফেডারেশন টেস্টার ব্যবহার করে আপনার ডোমেইনটি পরীক্ষা করুন, যা একটি প্রকৃত রিমোট সার্ভার যে রুট অনুসরণ করে ঠিক সেই রুটেই পরীক্ষা চালায়।
Federate করবেন, নাকি করবেন না: সিদ্ধান্তটি উদ্দেশ্যপূর্ণভাবে নিন
Federation-ই Matrix-এর মূল বৈশিষ্ট্য, এবং খরচের প্রধান কারণও এটি। Federation চালু থাকা homeserver এমন server-এর সংযোগ গ্রহণ করে যেগুলোর কথা আপনি কখনও শোনেননি, সেগুলোর event গ্রহণ করে, media cache করে এবং ব্যবহারকারীরা যেসব room-এ অংশ নেন সেগুলোর state সংরক্ষণ করে। এটি threat model-এর সিদ্ধান্ত; ডিফল্ট সেটিং নয়।
ব্যবহারকারীদের অন্য homeserver-এর মানুষের সঙ্গে যোগাযোগ করতে হলে, অথবা portable identity-এর জন্য Matrix বেছে নিলে federation চালু রাখুন। Server-টি যদি একটি team-এর জন্য থাকে এবং এর প্রতিটি account আপনার নিয়ন্ত্রণে থাকে, তাহলে federation চালু করবেন না। একটি বন্ধ server কম data সংরক্ষণ করে, কম data গ্রহণ করে এবং abuse-এর জন্য অনেক কম আকর্ষণীয়।
Federation সম্পূর্ণ বন্ধ না করে সীমিত করতে Synapse allow list ব্যবহার করে:
federation_domain_whitelist:
- lon.example.com
- nyc.example.comDocumentation-এ federation listener-এও firewall প্রয়োগের পরামর্শ দেওয়া হয়েছে। এতে unwanted traffic Python-এর ভেতরে পৌঁছানোর আগেই network স্তরে থেমে যায়। Federation সম্পূর্ণ বন্ধ করতে একই option-এ একটি খালি list সেট করুন:
federation_domain_whitelist: []Synapse configuration manual-এ federation বন্ধ করার জন্য খালি list-কে প্রস্তাবিত পদ্ধতি বলা হয়েছে। Element-এর help center-এও একই setting দেওয়া আছে। ডিফল্টভাবে federation চালু থাকে, কারণ option unset রাখলে সব server অনুমোদিত হয়। Listener resources list থেকে federation সরানো, /.well-known/matrix/server publish না করা এবং port 8448 বন্ধ রাখা শুধু inbound federation traffic-কে Synapse-এ পৌঁছাতে বাধা দেয়। এগুলো আপনার server-এর outbound federation request বন্ধ করে না। তাই এগুলো এবং firewall-কে খালি list-এর ওপর অতিরিক্ত স্তর হিসেবে বিবেচনা করুন; খালি list-এর বিকল্প হিসেবে কখনও ব্যবহার করবেন না।
Matrix চালানোর কারণ যদি private team chat হয় এবং federation কখনও এর অংশ না হয়ে থাকে, Synapse ব্যবহারের সিদ্ধান্ত নেওয়ার আগে অন্যান্য self-hosted Slack alternatives-এর সঙ্গে চলমান খরচ তুলনা করুন। Docker Compose-এ Rocket.Chat ছোট machine-এ team chat চালাতে পারে, কারণ এটিকে অন্য কোনো organisation-এর room state সংরক্ষণ করতে হয় না।
মিডিয়া রিপোজিটরিই নীরবে ডিস্ক পূর্ণ করে
আপনার নিজস্ব ব্যবহারকারীরা যে ফাইল আপলোড করেন, সেগুলো স্থায়ীভাবে আপনার ডিস্কে থাকে। অন্য homeserver-এর ব্যবহারকারীরা পোস্ট করা ফাইল আপনার কোনো client প্রদর্শন করলেই আপনার ডিস্কে fetch ও cache হয়। Synapse ছবির thumbnail-ও তৈরি করে, তাই একটি ছবি একাধিক ফাইলে পরিণত হয়। ডিফল্টভাবে কোনো ফাইলের মেয়াদ শেষ হয় না।
স্টোরের অবস্থান খুঁজে বের করে এর আকার মাপুন:
grep media_store_path /etc/matrix-synapse/homeserver.yaml
sudo du -sh /var/lib/matrix-synapse/media_storeআপনার নিজস্ব configuration যে path দেখায়, সেটির আকার মাপুন। Debian package Synapse-এর data /var/lib/matrix-synapse-এর অধীনে রাখে, তাই store সাধারণত সেখানেই থাকে। এরপর conf.d-এ retention policy নির্ধারণ করুন:
media_retention:
local_media_lifetime: 90d
remote_media_lifetime: 14dএই দুটি line মনোযোগ দিয়ে পড়ুন, কারণ এগুলো একই ধরনের setting নয়। উভয় setting-ই কোনো ফাইল upload হওয়ার পর থেকে নয়, বরং শেষবার access হওয়ার পর কেটে যাওয়া সময় গণনা করে। remote_media_lifetime একটি cache-এর মেয়াদ শেষ করে। এটি যে ফাইল মুছে দেয়, সেই ফাইলের মালিক server থেকে আবার fetch করা যায়। local_media_lifetime আপনার নিজস্ব ব্যবহারকারীদের upload করা media একই নিয়মে স্থায়ীভাবে মুছে দেয়, যদি ওই সময়ের মধ্যে কেউ সেগুলো access না করে। কোনো team chat-এ document শেয়ার করে পরের বছরও তা খুঁজে পাওয়ার আশা করলে, তারা সেই document হারাবে। অনেক server শুধু remote value নির্ধারণ করে।
একবারের cleanup-এর জন্য admin API milliseconds-এ Unix timestamp গ্রহণ করে:
BEFORE_TS=$(date -d '30 days ago' +%s%3N)
curl -X POST -H "Authorization: Bearer $ADMIN_TOKEN" \
"https://matrix.example.com/_synapse/admin/v1/purge_media_cache?before_ts=$BEFORE_TS"POST /_synapse/admin/v1/purge_media_cache ওই timestamp-এর আগে সর্বশেষ access করা cached remote media মুছে দেয়। POST /_synapse/admin/v1/media/delete?before_ts=<ms> একই নিয়মে local media মুছে দেয়। আগে remote purge চালান এবং আবার মাপুন, কারণ federating server-এ remote cache সাধারণত মোট আকারের বড় অংশ।
দুটি setting একই ডিস্ক ব্যবহারে প্রভাব ফেলে। max_upload_size একটি upload-এর সর্বোচ্চ আকার নির্ধারণ করে এবং nginx-এর client_max_body_size-এর সঙ্গে সামঞ্জস্যপূর্ণ রাখতে হয়। url_preview_enabled: true আপনার server-কে remote page fetch করতে বাধ্য করে, যাতে client link preview দেখাতে পারে। এতে bandwidth ব্যবহৃত হয় এবং আপনার কাছে কেউ upload না করা content-এর thumbnail সংরক্ষিত হয়।
কেউ আপনার homeserver খুঁজে পাওয়ার আগেই registration বন্ধ করুন
Scanner-গুলো কয়েক দিনের মধ্যে একটি উন্মুক্ত homeserver খুঁজে পায়। Account তৈরি উন্মুক্ত থাকলে আপনার server যে প্রতিটি federated room-এর সঙ্গে যুক্ত, সেগুলোতে এটি spam-এর উৎস হয়ে যায়। অন্য পাশের administrator-রা তখন আপনার সম্পূর্ণ domain block করে। Cleanup শেষ হলেও এই reputation damage থেকে যায়, কারণ block list হাতে রক্ষণাবেক্ষণ করা হয়।
Synapse বন্ধ registration নিয়ে আসে। enable_registration-এর default হলো false এবং registration_requires_token-এর default হলো false। এছাড়া verification step ছাড়া registration enabled থাকলে Synapse start হতে অস্বীকার করে, যদি না আপনি অতিরিক্তভাবে enable_registration_without_verification: true সেট করেন। এই অস্বীকৃতি ইচ্ছাকৃত। তাই startup error দূর করার জন্য এটি চালু করবেন না।
প্রয়োজনীয় account হাতে তৈরি করুন:
sudo register_new_matrix_user -c /etc/matrix-synapse/homeserver.yaml http://localhost:8008এটি user name, password এবং account-টি server admin কি না—এই তথ্যগুলো জানতে চায়। আপনি -c দিয়ে যে config pass করেন, সেখান থেকে এটি registration_shared_secret পড়ে। তাই shared secret খুঁজে না পাওয়ার বার্তা দেখালে -c-কে সেই secret থাকা file-টির দিকে নির্দেশ করুন।
হাতে account তৈরি করা আর কার্যকর না থাকলে registration token মাঝামাঝি সমাধান হিসেবে ব্যবহার করুন। Token হলো এমন একটি string, যা নতুন user-কে signup-এর সময় দিতে হয়। প্রতিটি token কতবার কাজ করবে, তার limit নির্ধারণ করা যায়:
enable_registration: true
registration_requires_token: truecurl -X POST -H "Authorization: Bearer $ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"uses_allowed": 1}' \
https://matrix.example.com/_synapse/admin/v1/registration_tokens/newBody থেকে token বাদ দিলে Synapse নিজে একটি token তৈরি করে তা ফেরত দেয়। GET /_synapse/admin/v1/registration_tokens সব token দেখায়, যার মধ্যে expired বা ব্যবহারের limit শেষ হয়ে যাওয়া token-ও থাকে। এখনও কার্যকর token-গুলোই দেখতে ?valid=true যোগ করুন। উভয় call-এর জন্য server admin account-এর access token প্রয়োজন। উপরে তৈরি করা admin user হিসেবে login করলে এই access token পাওয়া যায়।
যে organisation অন্য কোথাও account পরিচালনা করে, তারা local password সম্পূর্ণ এড়িয়ে যেতে পারে। কারণ Synapse login-এর দায়িত্ব একটি OIDC (OpenID Connect) provider-এর কাছে দিতে পারে, যেমন self-hosted SSO provider হিসেবে Authentik। ফলে নতুন user যোগ করা এবং user সরিয়ে নেওয়া—দুই কাজই এক জায়গা থেকে পরিচালনা করা যায়।
একটি ব্যাকআপ যা দিয়ে সার্ভার পুনরায় তৈরি করা সম্ভব
একটি Synapse ব্যাকআপের তিনটি অংশ থাকে এবং এর কোনো একটি অংশ বাদ পড়লে এমন একটি সার্ভার রিস্টোর হবে যা কেউ ব্যবহার করতে পারবে না।
- Postgres ডাটাবেস, যেখানে প্রতিটি ইভেন্ট, অ্যাকাউন্ট এবং রুম সংরক্ষিত থাকে।
- মিডিয়া স্টোর ডিরেক্টরি, যেখানে প্রতিটি আপলোড করা ফাইল থাকে।
/etc/matrix-synapse, যেখানে আপনার কনফিগারেশন এবং সার্ভারের সাইনিং কি (signing key) থাকে।
সাইনিং কি-টি হলো সেই অংশ যা মানুষ প্রায়ই ভুলে যায়। এটি সেই প্রাইভেট কি যার মাধ্যমে আপনার হোমসার্ভার ইভেন্টগুলোতে স্বাক্ষর করে এবং রিমোট সার্ভারগুলো সংশ্লিষ্ট পাবলিক কি-এর বিপরীতে সেই ইভেন্টগুলো যাচাই করে। আপনার কি কোথায় আছে তা দেখতে grep signing_key_path /etc/matrix-synapse/homeserver.yaml চালান। এটি হারিয়ে ফেললে আপনি এমন একটি সার্ভার রিস্টোর করবেন যা প্রমাণ করতে পারবে না যে এটি সেই একই সার্ভার যাকে আপনার রুমগুলো আগে থেকেই চেনে।
sudo -u postgres pg_dump --format=custom --file=/var/backups/synapse-$(date +%F).dump synapse
sudo tar czf /var/backups/synapse-etc-$(date +%F).tgz -C /etc matrix-synapseপ্রথমে ডাটাবেস ডাম্প করুন, তারপর মিডিয়া স্টোর কপি করুন। মিডিয়া ফাইলগুলো একবারই লেখা হয় এবং আইডি দ্বারা রেফারেন্স করা হয়, তাই ডাম্পের পরে নেওয়া মিডিয়া কপিতে কেবল অতিরিক্ত ফাইল থাকতে পারে, কোনো ফাইল বাদ পড়ার সুযোগ নেই। উল্টো ক্রমে কাজ করলে রিস্টোর করা ডাটাবেস এমন কোনো ফাইলের দিকে নির্দেশ করতে পারে যা আপনার ব্যাকআপে নেই।
তিনটি অংশই VPS থেকে বাইরে পাঠিয়ে দিন। off-site snapshot সহ restic এই কাজের জন্য উপযুক্ত, কারণ মিডিয়া স্টোর হলো বড় অংশ এবং এটি রানগুলোর মাঝে খুব একটা পরিবর্তিত হয় না, তাই ডিডুপ্লিকেশন (deduplication) প্রতিটি স্ন্যাপশটকে ছোট রাখে।
এরপর রিস্টোর করার মহড়া দিন, কারণ যে ব্যাকআপ আপনি কখনো রিস্টোর করেননি তা কেবল একটি অনুমান মাত্র। একটি দ্বিতীয় VPS তৈরি করুন, একই প্যাকেজ ইনস্টল করুন, কনফিগারেশন রিস্টোর করুন, একই এনকোডিং এবং লোকেল (locale) দিয়ে ডাটাবেস তৈরি করুন, pg_restore ব্যবহার করে ডাম্পটি তাতে ইমপোর্ট করুন, মিডিয়া স্টোরটি কপি করে ফিরিয়ে আনুন এবং লগ-ইন করুন। এটি করতে কত সময় লেগেছে তা লিখে রাখুন। সেই সংখ্যাটিই আপনার প্রকৃত রিকভারি টাইম।
স্টেট টেবিল বড় হলে: compaction
Synapse room state-কে state group হিসেবে সংরক্ষণ করে। Federating server-এ state_groups_state প্রায়ই database-এর সবচেয়ে বড় object হয়ে ওঠে। কোনো পরিবর্তন করার আগে পরিমাপ করুন:
sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_database_size('synapse'));"
sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_total_relation_size('state_groups_state'));"এই একটি table যদি আপনার database-এর বেশিরভাগ জায়গা দখল করে, তাহলে project এটি সংকুচিত করার জন্য rust-synapse-compress-state প্রকাশ করেছে। এটি কোনো room-এর state-এর অর্থ পরিবর্তন না করে state group hierarchy-কে কম সংখ্যক row-তে পুনর্লিখন করে। এটি Rust দিয়ে তৈরি:
sudo apt install -y build-essential libssl-dev pkg-config git
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
git clone https://github.com/matrix-org/rust-synapse-compress-state.git
cd rust-synapse-compress-state/synapse_auto_compressor
cargo build --release./target/release/synapse_auto_compressor -p postgresql://synapse_user:secretpassword@localhost/synapse -c 500 -n 100-c একবারে কতটি state group নিয়ে কাজ করবে তা নির্ধারণ করে, আর -n এই run-এ সেই chunk-গুলোর কতটি process করবে তা নির্ধারণ করে। auto compressor কতদূর এগিয়েছে তা সংরক্ষণ করে। তাই পরের run সেখান থেকেই চালু হয়, এবং নির্ধারিত সময়ে এটি চালানো নিরাপদ হয়। Project-এর README-তে বলা হয়েছে, state_groups এবং state_groups_state append-only এবং পরিবর্তনগুলো transaction-এর ভেতরে করা হয়। এই কারণে Synapse চালু থাকা অবস্থায় এর SQL প্রয়োগ করা নিরাপদ। এই বক্তব্যটি auto compressor-এর নিজস্ব section-এ নয়, README-এর introduction-এ রয়েছে। তাই প্রথম run-এর আগে যেকোনো অবস্থায় database backup নিন।
এখানে Postgres-এর একটি বিষয় অনেককে অবাক করে। Row মুছে ফেললে space file system-এ ফেরত যায় না; Postgres সেটি পুনর্ব্যবহারের জন্য ধরে রাখে। তাই বড় compaction-এর পরেও df-এর আকার নাও কমতে পারে। VACUUM FULL সেই space file system-এ ফিরিয়ে দেয়। এটি table-এর ওপর exclusive lock নেয় এবং table-এর আকারের প্রায় সমপরিমাণ free disk space প্রয়োজন হয়। তাই এটি ইচ্ছেমতো চালাবেন না; maintenance window-এ schedule করুন।
সার্ভার সচল আছে কি না তা যাচাই করার পদ্ধতি
systemctl status matrix-synapse
curl -s https://example.com/.well-known/matrix/server
curl -s https://matrix.example.com/_matrix/federation/v1/version
sudo -u postgres psql synapse -c "SELECT pg_size_pretty(pg_database_size('synapse'));"
sudo du -sh /var/lib/matrix-synapse/media_storeসার্ভার সচল থাকার অর্থ হলো unit-টি active অবস্থায় আছে এবং বারবার restart হচ্ছে না, delegation file আপনার m.server মান প্রদান করছে, federation version endpoint থেকে JSON রেসপন্স আসছে এবং দুটি size সংখ্যা গত মাসের তথ্যের সাথে তুলনা করা যাচ্ছে। অনেকেই size যাচাই করার ধাপটি এড়িয়ে যান, কিন্তু ডিস্ক পূর্ণ হয়ে যাওয়া এমন একটি সমস্যা যা কোনো সতর্কতা ছাড়াই Synapse সার্ভারকে অচল করে দিতে পারে: volume পূর্ণ হয়ে গেলে Postgres আর কোনো ডেটা লিখতে পারে না, ফলে Synapse তখন ডেটাবেস সংশ্লিষ্ট প্রতিটি অনুরোধ প্রত্যাখ্যান করে।
FAQ
একটি Matrix Synapse server-এর কত RAM প্রয়োজন?
কয়েকজন ব্যবহারকারী, ছোট room এবং বড় public room না থাকা একটি private homeserver-এর জন্য 2 GB যথেষ্ট হতে পারে। August 2026 অনুযায়ী প্রকাশিত অধিকাংশ sizing page-এও এই পরিমাণই সুপারিশ করা হয়। আপনার ব্যবহারকারীরা যদি #matrix:matrix.org-এর মতো বড় public room-এ যোগ দেন, Synapse documentation অনুযায়ী বাকি প্রয়োজনের অতিরিক্ত অন্তত 1 GB free RAM রাখুন। কারণ তখন আপনার server ওই room-এর state সংরক্ষণ করে এবং তার traffic অবিরত process করে। 2 GB plan-এ swap যোগ করুন, যাতে একটি বড় join-এর সময় kernel process-টি বন্ধ করে না দেয়।
SQLite-এর পরিবর্তে কি PostgreSQL ব্যবহার করতেই হবে?
কয়েকজনের বেশি ব্যবহারকারী হলে, হ্যাঁ। SQLite এক সময়ে মাত্র একজন writer-কে অনুমতি দেয়। তাই load-এর সময় federation traffic এবং client request একে অপরকে block করে, ফলে request কয়েক সেকেন্ড করে আটকে থাকে। Synapse-এর worker process, যা একাধিক CPU core ব্যবহারের supported পদ্ধতি, Postgres প্রয়োজন করে। পরে migration করা যায়; এর জন্য synapse_port_db ব্যবহার করতে হয় এবং downtime হয়। তাই ব্যবহারকারী যোগ হওয়ার আগে --encoding=UTF8 --locale=C --template=template0 দিয়ে database তৈরি করুন।
আমার Synapse disk usage ক্রমাগত বাড়ছে কেন?
একটি directory এবং একটি table দায়ী। Media store আপনার server যে room-গুলোতে আছে, সেগুলোতে upload করা প্রতিটি file সংরক্ষণ করে। এর মধ্যে remote user-দের media-এর cached copy এবং তৈরি করা thumbnail-ও থাকে। আপনি media_retention নির্ধারণ না করা পর্যন্ত কোনো কিছু expire হয় না। Federation চালু থাকা server-এ room state বাড়ার সঙ্গে state_groups_state table-ও বড় হয়, আর rust-synapse-compress-state এটি কমায়। কোনটি নিয়ে কাজ করবেন তা ঠিক করার আগে du -sh দিয়ে আপনার media_store_path-এ এবং SELECT pg_size_pretty(pg_total_relation_size('state_groups_state')); দিয়ে উভয়টির পরিমাণ মাপুন।
আমার homeserver-এ অপরিচিত ব্যক্তিদের registration কীভাবে বন্ধ করব?
enable_registration-কে তার default false-এ রাখুন এবং register_new_matrix_user দিয়ে account তৈরি করুন। এই পদ্ধতি আর যথেষ্ট না হলে enable_registration: true-এর সঙ্গে registration_requires_token: true সেট করুন এবং POST /_synapse/admin/v1/registration_tokens/new দিয়ে তৈরি token বিতরণ করুন। শুধু Synapse-এর startup refusal বন্ধ করার জন্য enable_registration_without_verification: true সেট করবেন না। কারণ open homeserver spam source হয়ে যায় এবং অন্য administrator-রা আপনার সম্পূর্ণ domain block করে প্রতিক্রিয়া জানাতে পারে।
আমার homeserver-এর federation চালু করা উচিত কি?
Federation একটি exposure-সংক্রান্ত সিদ্ধান্ত; এটি default নয়। আপনার ব্যবহারকারীদের অন্য homeserver-এর মানুষের সঙ্গে যোগাযোগের প্রয়োজন হলে federation চালু করুন। Server-টি যদি একটি team-এর জন্য ব্যবহৃত হয়, তাহলে federation_domain_whitelist: [] দিয়ে federation বন্ধ রাখুন। এতে non-federating server কম data সংরক্ষণ করে, কম data গ্রহণ করে এবং অনেক কম abuse-এর লক্ষ্য হয়। মাঝামাঝি ব্যবস্থায় federation_domain_whitelist federation-কে নির্দিষ্ট partner domain-এ সীমাবদ্ধ করে। তবে Synapse documentation application-layer check-এর ওপর একা নির্ভর না করে federation listener-এ firewall প্রয়োগ করারও সুপারিশ করে।