Cài đặt Stalwart Mail Server trên VPS: Hướng dẫn chi tiết
Tìm hiểu cách Stalwart thay thế Postfix và Dovecot bằng một binary Rust duy nhất. Bài viết phân tích ưu nhược điểm, cấu hình systemd và khi nào bạn nên dùng Mailcow.
Những thành phần mà Stalwart gộp vào một binary duy nhất
Stalwart là một mail server mà bạn chạy trên một VPS dưới dạng một binary Rust duy nhất. Nó xử lý SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV và WebDAV từ cùng một tiến trình, đồng thời tích hợp sẵn bộ lọc spam, kho lưu trữ tin nhắn và client ACME riêng. Một stack truyền thống thực hiện công việc tương tự với Postfix, Dovecot, Rspamd, một database cho tài khoản và một công cụ quản lý chứng chỉ riêng biệt. Stalwart thay thế tất cả những thành phần đó bằng một service unit và một file cấu hình tại /etc/stalwart/config.json.
Mọi số liệu, tên thiết lập và lệnh dưới đây đều được trích dẫn từ tài liệu, trang phát hành và script cài đặt của chính Stalwart. Chúng tôi đọc chúng lần đầu vào ngày 28 tháng 8 năm 2026 dựa trên bản phát hành v0.16.19 (công bố ngày 24 tháng 8 năm 2026) và kiểm tra lại vào ngày 12 tháng 10 năm 2026, khi bản phát hành mới nhất là v0.16.26. Chúng tôi đã kiểm tra lại vào ngày 27 tháng 10 năm 2026, một ngày sau khi Stalwart v1.0.0 được công bố (26 tháng 10 năm 2026). Chúng tôi kiểm tra lại các nguồn vào ngày 29 tháng 10 năm 2026, khi bản phát hành mới nhất là v1.0.1, công bố ngày 28 tháng 10 năm 2026. Chúng tôi kiểm tra lại các nguồn vào ngày 11 tháng 11 năm 2026, khi bản phát hành mới nhất là v1.1.0, công bố ngày 9 tháng 11 năm 2026. Đây là các lệnh để bạn chạy trên máy chủ của mình. Mỗi lệnh đều đi kèm với bước kiểm tra để xác nhận xem nó có hoạt động hay không.
Stalwart được cấp phép kép theo GNU Affero General Public License v3.0 (AGPL-3.0) và Stalwart Enterprise License v2. Một số tính năng chỉ dành cho bản enterprise. Danh sách HTTP endpoint được tài liệu hóa đánh dấu /scim/v2/* cho các tính năng này. Hãy đọc các điều khoản cấp phép trước khi bạn lên kế hoạch triển khai dựa trên một tính năng mà bạn chưa từng tự mình chạy thử.
Một binary duy nhất thực sự cắt giảm được các thành phần chuyển động. Nó không cắt giảm hai yếu tố quyết định việc email của bạn có đến nơi hay không.
Cổng 25 và uy tín DNS không phụ thuộc vào phần mềm bạn chạy
Cổng TCP 25 chiều outbound là chốt chặn đầu tiên. Nhiều nhà cung cấp VPS chặn cổng này theo mặc định trên các tài khoản mới, và khi cổng 25 bị chặn, server của bạn không thể gửi mail trực tiếp đến server mail của bất kỳ ai khác. Hãy kiểm tra nó trước khi cài đặt bất cứ thứ gì.
sudo apt update && sudo apt install -y netcat-openbsd
nc -vz -w 5 alt1.aspmx.l.google.com 25Kết quả bình thường sẽ in ra Connection to alt1.aspmx.l.google.com ... 25 port [tcp/smtp] succeeded! trong khoảng một giây. Nếu bị chặn, kết quả sẽ hiển thị theo một trong hai cách. Nếu các gói tin bị drop ở upstream, không có phản hồi reset nào gửi lại cho bạn, nên nc sẽ treo trong năm giây rồi in ra nc: connect to alt1.aspmx.l.google.com port 25 (tcp) failed: Connection timed out. Nếu firewall từ chối (reject), nó sẽ gửi lại một lỗi ICMP (netfilter mặc định gửi port unreachable trừ khi được cấu hình để gửi thông báo khác, ví dụ như administratively prohibited), nên lỗi sẽ xuất hiện ngay lập tức, thường là Connection refused hoặc No route to host. Dù là trường hợp nào, hãy mở ticket yêu cầu nhà cung cấp hỗ trợ.
Nếu nhà cung cấp không mở cổng, cách duy nhất để vượt qua là dùng relay. Stalwart có thể chuyển toàn bộ mail outbound đến một smarthost thông qua Relay route, với cổng mặc định là 25 nhưng chấp nhận bất kỳ giá trị nào từ 1 đến 65535, cùng với tùy chọn implicitTls và các trường authUsername, authSecret để xác thực relay trên cổng 465 hoặc 587. Khi đó, mail của bạn sẽ được gửi đi dưới uy tín của relay, không phải của chính bạn.
Chốt chặn thứ hai là cách các mạng nhận mail đánh giá địa chỉ IP và domain của bạn. Điều này bao gồm reverse DNS trên IP, SPF, DKIM, DMARC và lịch sử gửi mail của dải IP mà bạn đang sử dụng. Trang thiết lập DNS của Stalwart, tính đến ngày 28 tháng 8 năm 2026, đã nêu rõ nơi thực hiện công việc đó: các bản ghi reverse DNS "thường được cấu hình bởi nhà cung cấp hosting, không phải bởi chính Stalwart". Stalwart có thể công bố và duy trì các bản ghi DNS khác thông qua API của nhà cung cấp DNS được hỗ trợ, nhưng reverse DNS và uy tín IP vẫn phụ thuộc vào nhà cung cấp của bạn.
Vì vậy, trang này không hướng dẫn lại các bản ghi đó. Chúng tôi đã có một bài viết riêng: Thiết lập SPF, DKIM và DMARC một lần cho mọi dịch vụ gửi mail. Nếu bạn vẫn chưa quyết định có nên tự host email hay không, hãy bắt đầu với góc nhìn khách quan của chúng tôi về việc liệu tự host email có còn đáng giá hay không. Việc chọn Stalwart không làm thay đổi các yếu tố đó.
Một VPS nhỏ cần gì để chạy mail server Stalwart
Trang yêu cầu hệ thống của Stalwart, được xem vào ngày 27 October 2026, không còn đưa ra con số theo từng user. Trang này cho biết server idle “stays well below” các giới hạn bộ nhớ, còn mức dùng CPU phụ thuộc vào lưu lượng mail và số lần sign-in, không phụ thuộc vào số account. Password hashing được thiết kế để chạy chậm, vì vậy server có nhiều lần sign-in cần nhiều core hơn. Ví dụ sizing duy nhất trên trang là một host có 2 GiB RAM, trong đó các giới hạn mặc định cộng lại khoảng 2.4 GiB. Tổng này bao gồm hai vùng reservation 512 MiB dành cho các account rất lớn; các vùng này sẽ để trống nếu bạn không có account như vậy. FAQ cho biết thêm rằng không có số liệu đo được nào về số user trên mỗi node được công bố.
Số connection được giới hạn theo từng listener, không phải theo toàn server. maxConnections mặc định là 8,192 trên mỗi listener không có setting riêng, vì vậy giới hạn file descriptor của process phải đủ lớn, thường cao hơn nhiều lần con số đó. Install script tăng giới hạn này lên 65536. Service được khởi động theo cách khác thường nhận giá trị 1024, và trang này đánh giá mức đó là quá thấp cho production.
Trang này không nêu dung lượng disk tối thiểu. Benchmark đo được khoảng 0.95 GB disk cho mỗi GB mail trên RocksDB và lưu ý rằng các attachment đã được nén, như image và PDF, có thể cần nhiều dung lượng hơn. Hãy sizing disk dựa trên lượng mail bạn dự kiến giữ lại, cộng thêm headroom để store thực hiện compact.
Ba outbound path phải hoạt động; nếu không, server có thể trông như bị lỗi dù nguyên nhân không liên quan đến mail. Khi khởi động, server tải bundle của web interface từ https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip. Server truy cập https://acme-v02.api.letsencrypt.org/directory để lấy certificate của Let's Encrypt. Server cần DNS trên UDP và TCP port 53 để tra cứu MX và authentication record, trừ khi resolver được cấu hình dùng DNS over HTTPS hoặc TLS. Các rule của spam filter cùng danh sách IP-to-ASN và country cũng được tải từ GitHub. Egress firewall bị khóa chặt và chặn path đầu tiên sẽ tạo ra một mail server đang chạy nhưng các trang /admin và /account trả về 404.
Cài đặt một bản release cụ thể, không dùng "latest"
Trình cài đặt chính thức là một shell script. Hãy đọc nó trước khi chạy.
curl --proto '=https' --tlsv1.2 -sSf https://get.stalw.art/install.sh -o install.sh
less install.sh
sudo sh install.shĐọc script đó vào ngày 27 tháng 10 năm 2026 cho thấy chính xác những gì nó thực hiện. Nó tạo một tài khoản dịch vụ stalwart và các thư mục cần thiết. Sau đó, nó tải xuống từ https://github.com/stalwartlabs/stalwart/releases/latest/download. File binary được đặt tại /usr/local/bin/stalwart với mode 0755. Cấu hình được lưu tại /etc/stalwart/config.json, dữ liệu tại /var/lib/stalwart, log tại /var/log/stalwart, cả ba thư mục đều có mode 0750 và thuộc sở hữu của stalwart. Một file môi trường được ghi vào /etc/stalwart/stalwart.env với mode 0640 và thuộc sở hữu của root:stalwart. Script nhận một tiền tố cài đặt tùy chọn và một flag --fdb cho bản build FoundationDB. Nó không nhận đối số phiên bản.
Điểm cuối cùng đó rất quan trọng. Script luôn tải về bản release mới nhất. Hai máy chủ được cài đặt cách nhau một tuần sẽ chạy cùng một bản release nếu không có bản nào mới được phát hành giữa các lần cài đặt. Vào ngày 26 tháng 10 năm 2026, bản release mới nhất trở thành v1.0.0, và bản này đã thay đổi cấu trúc cơ sở dữ liệu. Ghi chú phát hành của nó cho biết các bản triển khai v0.16.x hiện tại "không thể nâng cấp tại chỗ", và thông báo v1.0 cho biết máy chủ v1.0 sẽ không mở được kho dữ liệu được tạo bởi phiên bản cũ hơn. Trong dòng 1.x, trang nâng cấp của Stalwart cho biết việc chạy lại script cài đặt sẽ "thay thế binary, giữ lại config.json và file môi trường, sau đó khởi động lại dịch vụ", và FAQ khuyên nên sao lưu các kho dữ liệu và config.json trước mỗi lần nâng cấp minor hoặc major. Chỉ riêng dòng 0.16 đã có bảy bản patch được phát hành từ ngày 24 tháng 8 đến ngày 11 tháng 10 năm 2026, trong đó có một số bản vá bảo mật, vì vậy hãy ghim bản release mới nhất và chủ động thay đổi phiên bản ghim khi cần.
Khi nâng cấp bản cài đặt 1.x hiện tại lên v1.1.0, hãy khởi động lại một lần với STALWART_UPDATE_ROLE_PERMISSIONS=true để thêm các quyền được giới thiệu từ sau bản v1.0.0, sau đó xóa biến này đi. Việc nâng cấp từ v1.0.0 hoặc v1.0.1 cũng vô hiệu hóa tính năng mã hóa dữ liệu lưu trữ (encryption at rest) cho từng tài khoản: hãy chọn lại public key của mỗi tài khoản để kích hoạt lại, nếu không các tin nhắn mới sẽ không được mã hóa. Các key đã đăng ký và tin nhắn đã được mã hóa trước đó không bị ảnh hưởng.
STALWART_TAG=v1.1.0
curl -fsSLO "https://github.com/stalwartlabs/stalwart/releases/download/${STALWART_TAG}/stalwart-x86_64-unknown-linux-gnu.tar.gz"
tar zxf stalwart-x86_64-unknown-linux-gnu.tar.gz
sudo systemctl stop stalwart
sudo install -m 0755 -o root -g root stalwart /usr/local/bin/stalwart
sudo systemctl start stalwart
systemctl is-active stalwartsystemctl is-active stalwart sẽ in ra active. Nếu là kết quả khác, hãy đọc journalctl -u stalwart -n 50. Bản release cho Linux đi kèm với một bundle .sigstore.json tương ứng, vì vậy chữ ký của file tải xuống có thể được xác minh trước khi bạn cài đặt.
Nếu máy chủ đang chạy bản release 0.16, đừng ghi đè binary 1.x lên trên. Hãy cập nhật lên v0.16.27 trước, sau đó làm theo lộ trình di chuyển trong phần hướng dẫn chuyển dữ liệu mail cũ ở bên dưới.
Unit mà script tạo ra chạy dưới quyền User=stalwart, thiết lập AmbientCapabilities=CAP_NET_BIND_SERVICE và thiết lập LimitNOFILE=65536. Capability này là lý do tại sao một tài khoản không đặc quyền có thể bind các cổng 25, 443, 465 và 993. Nếu sau này bạn tự viết unit riêng và bỏ qua dòng đó, các listener trên các cổng đặc quyền sẽ không thể bind; Stalwart sẽ bỏ qua các listener đó, khởi động các listener còn lại và ghi log một sự kiện registry.build-error cho mỗi listener bị lỗi. Hãy sao chép cả giới hạn file (file limit) vì lý do đã nêu trong phần yêu cầu.
Nơi in mật khẩu quản trị viên đầu tiên
Stalwart khởi động ở chế độ bootstrap và ghi một tài khoản tạm thời có tên admin, kèm mật khẩu ngẫu nhiên 16 ký tự, vào log của dịch vụ. Nó in mật khẩu mới mỗi khi khởi động ở chế độ bootstrap, vì vậy chỉ khối log gần nhất mới có giá trị.
sudo journalctl -u stalwart -n 200 | grep -A8 'bootstrap mode'Trình hướng dẫn thiết lập lắng nghe trên HTTP thường tại cổng 8080, và trang Docker của Stalwart lưu ý rằng nó không có cơ chế bảo vệ chống đoán mật khẩu, vì vậy đừng public cổng đó. Khi cài đặt bằng script, hãy chặn cổng TCP 8080 trong firewall của host trước khi thiết lập; chỉ dùng SSH tunnel là không đủ để đóng quyền truy cập công khai. Thay vào đó, hãy tunnel từ laptop của bạn qua SSH:
ssh -N -L 8080:127.0.0.1:8080 you@your-vpsSau đó mở http://127.0.0.1:8080/admin và đăng nhập với tư cách admin bằng mật khẩu từ log. Trình hướng dẫn sẽ hỏi hostname của máy chủ, domain mail mặc định, TLS, bộ nhớ, thư mục tài khoản, logging và cách xử lý DNS. Với thư mục nội bộ, màn hình cuối cùng sẽ hiển thị quản trị viên mới của bạn, admin@<domain>, cùng một mật khẩu ngẫu nhiên mà máy chủ sẽ không bao giờ hiển thị lại hoặc ghi vào log, vì vậy hãy lưu nó lại tại đó. Khởi động lại dịch vụ khi hoàn tất, sau đó sử dụng https://<your-host>/admin từ thời điểm đó trở đi.
Nếu mật khẩu đã trôi khỏi log, hãy đặt một mật khẩu cố định thay thế. /etc/stalwart/stalwart.env cung cấp các mục đã comment sẵn cho việc này, bao gồm STALWART_RECOVERY_ADMIN=admin:changeme, STALWART_RECOVERY_MODE=true và STALWART_RECOVERY_MODE_PORT (mặc định là 8080). Hãy bỏ comment, khởi động lại, đăng nhập, sau đó comment lại. Trang bảo mật máy chủ của Stalwart cảnh báo rằng một biến bị quên là "thông tin xác thực có toàn quyền vĩnh viễn", vì vậy hãy xóa nó ngay khi tài khoản quản trị viên vĩnh viễn đã đăng nhập thành công. Trang này cũng khuyến cáo chỉ sử dụng tài khoản quản trị viên cho mục đích quản trị, không dùng làm hộp thư trong các client IMAP, JMAP hoặc DAV.
Ở chế độ bootstrap, Stalwart không khởi động các dịch vụ mail và chỉ mở một listener HTTP thường, mặc định là cổng 8080. Sau khi thiết lập và khởi động lại, các listener thông thường sẽ bắt đầu trên các cổng 25, 465, 993, 995, 4190, 443 và 8080. Cổng 25 phải luôn mở để nhận mail, và cổng 443 là cần thiết cho hầu hết các client cũng như cho ACME challenge mặc định. Tài liệu khuyến cáo xóa cổng 995 khi không có client nào dùng POP3, cổng 4190 khi không ai quản lý bộ lọc Sieve từ client ManageSieve, và cổng 8080 sau khi thiết lập xong và HTTPS trên cổng 443 đã hoạt động. Các cổng 587, 143 và 110 sẽ không có listener trừ khi bạn tự tạo.
Chạy dưới Docker với một tag cố định
Image được tài liệu hóa là stalwartlabs/stalwart, cũng được phát hành dưới tên ghcr.io/stalwartlabs/stalwart. Vào ngày 29 tháng 10 năm 2026, Docker Hub chứa v1.0.1, v1.0 và v1, mỗi loại có một biến thể -alpine. Trang Docker của Stalwart khuyến nghị sử dụng tag phiên bản chính v1, theo sát bản phát hành 1.x mới nhất, và khuyên không nên dùng latest, vì một bản phát hành chính trong tương lai có thể yêu cầu quy trình nâng cấp khác. Hãy ghim phiên bản patch thay vào đó, vì lý do tương tự như với file binary ở trên.
services:
stalwart:
image: stalwartlabs/stalwart:v1.1.0
container_name: stalwart
init: true
restart: unless-stopped
ports:
- "25:25"
- "465:465"
- "993:993"
- "443:443"
- "127.0.0.1:8080:8080"
volumes:
- stalwart-etc:/etc/stalwart
- stalwart-data:/var/lib/stalwart
volumes:
stalwart-etc:
stalwart-data:File đó là lệnh docker run được tài liệu hóa dưới dạng Compose, với các cổng POP3S và ManageSieve bị lược bỏ và cổng setup được bind vào localhost, giống như lệnh được tài liệu hóa cũng bind nó. Hãy khởi chạy nó và đọc cùng một dòng bootstrap:
docker compose up -d
docker compose logs stalwart 2>&1 | grep -A8 'bootstrap mode'Trang Docker cũng tài liệu hóa STALWART_RECOVERY_ADMIN=admin:<password> như một cách để đặt mật khẩu đã biết khi khởi động, đây là key environment: trong Compose nếu bạn thích cách đó hơn là đọc log. Nó lưu ý rằng các biến môi trường được cố định khi container được tạo, vì vậy một lệnh restart thông thường sẽ không nhận thay đổi. docker compose up -d sẽ tạo lại container khi môi trường thay đổi. Hãy xóa biến này sau khi thiết lập xong.
Danh sách cổng đầy đủ được tài liệu hóa, và lý do file này ngắn hơn
Trang Docker của Stalwart công bố các cổng 25, 465, 993, 995, 4190 và 443 trên tất cả các interface, và 8080 chỉ trên loopback (127.0.0.1:8080:8080). Nó không công bố 587, 143 hoặc 110, vốn không có listener trừ khi quản trị viên tạo ra một cái. Trang về bảo mật máy chủ của nó nói rằng hãy xóa listener POP3S trên 995 khi không có client nào sử dụng POP3, listener ManageSieve trên 4190 khi không ai quản lý bộ lọc Sieve từ client, và listener 8080 sau khi thiết lập xong và HTTPS trên 443 hoạt động. Chỉ thêm lại những gì client của bạn thực sự yêu cầu. Nếu điện thoại yêu cầu STARTTLS submission, hãy tạo một listener trên 587 và sau đó công bố nó. Nếu người dùng của bạn viết các rule Sieve từ một desktop client, hãy công bố 4190.
Nếu Compose còn mới với bạn, hướng dẫn Docker Compose cho VPS của chúng tôi bao gồm bố cục file và mô hình named-volume mà cách này sử dụng. Một cảnh báo đặc biệt quan trọng với các mail server: Docker công bố các cổng bằng cách tự ghi các rule firewall của riêng nó, và các rule đó được khớp trước các rule của ufw, vì vậy ufw deny 8080 không đóng được cổng mà Compose đã công bố. Với Docker Engine 28.0.0 hoặc mới hơn và cấu hình bridge network mặc định, việc bind vào 127.0.0.1 trong port mapping sẽ hạn chế quyền truy cập vào Docker host, đó là lý do tại sao file trên làm như vậy và SSH tunnel vẫn được áp dụng. Docker cảnh báo rằng các bản phát hành cũ hơn 28.0.0 cho phép các host trên cùng một phân đoạn mạng L2 truy cập vào các cổng được công bố tới localhost, vì vậy hãy nâng cấp Docker trước khi dựa vào cơ chế bảo vệ này.
TLS không dùng certbot và cái giá phải trả
Stalwart triển khai trực tiếp ACME (automatic certificate management environment), nên không cần certbot và cũng không có renewal hook. Tài liệu liệt kê 4 phương thức xác thực. HTTP-01 trả lời challenge request trên port 80. TLS-ALPN-01, là phương thức mặc định, cung cấp một chứng chỉ được tạo riêng trên port 443 bằng giao thức ALPN dành cho ACME. DNS-01 tạo các bản ghi TXT tạm thời và là một trong 2 phương thức có thể cấp wildcard. DNS-PERSIST-01 dùng các bản ghi TXT ủy quyền có thời hạn dài thay vì ghi một bản ghi mới sau mỗi lần gia hạn.
Đổi lại, Stalwart muốn tự xử lý TLS handshake. TLS-ALPN-01 hoạt động bằng cách tự hoàn tất handshake, nên không thể chạy sau reverse proxy đã termination TLS thay bạn. Nếu nginx hoặc Caddy đang giữ port 443 trên máy đó, bạn có 3 cách xử lý. Guide nginx của Stalwart chạy nginx ở chế độ TCP passthrough, với listen 443; proxy_pass 127.0.0.1:10443; proxy_protocol on;, để kết nối TLS đến Stalwart mà không bị thay đổi. Cách này chuyển mọi kết nối trên port 443 cho Stalwart, nên phù hợp với máy mà nginx không phục vụ dịch vụ nào khác trên port đó. Nếu không, hãy chuyển Stalwart sang DNS-01 hoặc HTTP-01, hoặc cấp cho nó một địa chỉ IP riêng.
DANE và MTA-STS, cùng các thiết lập mặc định bạn cần biết
Cả hai đều được cấu hình theo chiến lược TLS trên đối tượng MtaTlsStrategy, tại mục Settings, MTA, Outbound, TLS Strategies trong giao diện web. Trường dane mặc định là optional, thực hiện xác thực DANE khi người nhận công bố bản ghi TLSA và quay lui về STARTTLS thông thường nếu không có. Nếu đặt thành require, việc gửi mail chỉ tiếp tục khi có bản ghi TLSA xác thực được. Trường mtaSts hoạt động tương tự, mặc định là optional. Các timeout liên quan là tlsTimeout (mặc định 3 phút) và mtaStsTimeout (mặc định 5 phút).
Ở phía inbound, Stalwart có thể công bố chính sách MTA-STS của riêng bạn tại https://mta-sts.<domain>/.well-known/mta-sts.txt, yêu cầu mở cổng 443. Singleton MtaSts có các tùy chọn mode (mặc định testing), maxAge (mặc định 7 ngày) và mxHosts, tùy chọn này ghi đè các MX host được cho phép và nếu để trống, nó sẽ lấy từ thiết lập hệ thống. Bạn cần cung cấp hai bản ghi DNS: một bản ghi CNAME mta-sts trỏ đến mail host, và một bản ghi TXT _mta-sts chứa định danh chính sách.
dig +short TXT _mta-sts.example.org
curl -s https://mta-sts.example.org/.well-known/mta-sts.txtTruy vấn TXT phải trả về chuỗi v=STSv1; id=... và lệnh curl phải trả về nội dung chính sách. Nếu curl không trả về gì, cổng 443 đang đóng hoặc chứng chỉ cho mta-sts.example.org chưa được cấp.
Hãy để mode ở chế độ testing cho đến khi cả hai kiểm tra trên đều thành công. Một chính sách ở chế độ enforce với chứng chỉ bị lỗi sẽ chặn các máy chủ khác gửi mail đến bạn, và bạn sẽ biết về vấn đề này từ người dùng thay vì từ log. DANE cũng có một cái bẫy tương tự: nó yêu cầu các zone được ký DNSSEC cho cả domain mail và các MX host của nó, đồng thời các bản ghi TLSA được công bố thủ công phải luôn đồng bộ với chứng chỉ hoặc key mà chúng ghim. Stalwart cập nhật các bản ghi TLSA sau khi gia hạn nếu tính năng quản lý DNS tự động được bật và tlsa được bao gồm trong publishRecords của domain; mặc định nó bị loại trừ. Đối với các bản ghi được công bố thủ công, reuseKey giúp tránh việc phải thay đổi ghim public-key mỗi khi gia hạn, hoặc bạn có thể ghim CA cấp phát thay thế.
Mã hóa dữ liệu lưu trữ (Encryption at rest) không phải là mã hóa đầu cuối (end-to-end)
Đây là tính năng thường bị hiểu sai nhất, vì vậy dưới đây là chính xác những gì tài liệu đề cập. Mã hóa dữ liệu lưu trữ được bật theo từng tài khoản. Người dùng xuất public key từ mail client của họ, dán key OpenPGP định dạng ASCII-armored hoặc chứng chỉ S/MIME định dạng PEM vào trình quản lý tài khoản tại /account trong mục Account, Public Keys, sau đó chọn key đó trong cài đặt mã hóa của tài khoản. Kể từ đó, máy chủ sẽ mã hóa từng tin nhắn đến bằng key đó trước khi lưu trữ, dưới dạng tin nhắn OpenPGP/MIME hoặc S/MIME. Công tắc atRestEnable trên toàn hệ thống tại singleton Encryption được bật theo mặc định, và khi nó tắt, không có gì được mã hóa bất kể cài đặt tài khoản ra sao. Cài đặt encryptOnAppend cho từng tài khoản bị tắt theo mặc định. Nó mở rộng việc mã hóa cho các tin nhắn được thêm vào qua JMAP và IMAP, và khi nó tắt, các tin nhắn đó sẽ không bao giờ được mã hóa. Trong v1.0.1, các tin nhắn JMAP chứa $draft và các bản sao Sent được tạo bởi JMAP submission vẫn không được mã hóa ngay cả khi tính năng append encryption được bật. Kể từ v1.0.2, thuật toán được chọn dựa trên key của người dùng, và tùy chọn chọn cipher cho từng tài khoản đã bị loại bỏ.
Do đó, nó bảo vệ dữ liệu trong trường hợp bị đánh cắp image ổ đĩa, bản sao lưu bị đánh cắp, và ngăn quản trị viên đọc dữ liệu lưu trữ sau khi tin nhắn đã được chuyển phát. Private key không bao giờ được gửi đến máy chủ, vì vậy nếu không có nó, nội dung được lưu trữ sẽ không thể đọc được và quản trị viên cũng không thể giải mã chúng.
Nó không bảo vệ tin nhắn trong quá trình truyền tải. Tin nhắn đi qua internet theo bất kỳ giao thức TLS nào mà hai máy chủ đã thỏa thuận, đến nơi dưới dạng văn bản thuần (plain text), và Stalwart sẽ mã hóa nó tại thời điểm đó. Người gửi, nhà cung cấp của người gửi và bất kỳ chặng trung gian nào đã loại bỏ TLS đều đã thấy nội dung văn bản thuần.
Bốn giới hạn khác cần được nêu rõ, và tính đến ngày 11 tháng 11 năm 2026, tài liệu đã nêu rõ tất cả các giới hạn này. Các thư mục Sent và Drafts của bạn được ghi bởi client, đây là một thao tác append, và cài đặt encryptOnAppend cho từng tài khoản bị tắt theo mặc định; các bản nháp JMAP và bản sao Sent được tạo bởi JMAP submission vẫn không được mã hóa khi tính năng này được bật. Việc mã hóa chỉ bao gồm nội dung (body) và tệp đính kèm: các header như From, To, Subject và Date vẫn ở dạng văn bản thuần, và envelope cũng như log chuyển phát không bị ảnh hưởng. Mã hóa "không có tính hồi tố theo cả hai chiều", vì vậy thư được lưu trữ trước khi bạn đăng ký key vẫn có thể đọc được, và việc tắt mã hóa không giải mã những gì đã được lưu trữ trong khi nó đang bật. Ngoài ra, việc tìm kiếm trong nội dung hoặc tệp đính kèm của một tin nhắn đã mã hóa sẽ không trả về kết quả, qua JMAP hoặc IMAP, trong khi tìm kiếm theo người gửi, người nhận hoặc chủ đề vẫn hoạt động.
Việc huấn luyện bộ lọc spam có thể để lại một bản sao văn bản thuần riêng biệt: cài đặt allowSpamTraining cho từng tài khoản, bị tắt theo mặc định, cho phép lưu mẫu trước khi mã hóa, trong khi tính năng tự động học trên toàn hệ thống có thể giữ lại các mẫu bất kể cài đặt mã hóa của tài khoản.
Và nếu người dùng làm mất private key, thư của họ sẽ mất vĩnh viễn. Theo thiết kế, không có lộ trình khôi phục.
Kể từ v1.0.3, Stalwart cũng cung cấp tính năng mã hóa blob riêng biệt với các khóa đối xứng do máy chủ nắm giữ. Điều đó bảo vệ backend lưu trữ blob, nhưng máy chủ có thể giải mã nó, vì vậy nó không cung cấp sự bảo vệ tương tự trước việc quản trị viên đọc thư đã lưu trữ.
WKD là tác vụ của web server, không phải tác vụ của mail server
WKD (Web Key Directory) là nửa còn lại của OpenPGP và giải quyết một vấn đề khác. Nó công bố public key của bạn tại một URL HTTPS cố định dưới domain của bạn, để mail client của người gửi có thể tìm thấy key đó và mã hóa thư trước khi thư rời khỏi máy của họ. Đó là mã hóa đầu cuối. Mã hóa at-rest của Stalwart áp dụng cho bản sao đang nằm trên disk của bạn. Cấu hình một loại không có nghĩa là bạn đã có loại còn lại.
Stalwart không phục vụ WKD. Các HTTP endpoint được ghi trong tài liệu của nó, được đọc vào ngày 27 October 2026, liệt kê các path well-known cho jmap, caldav, carddav, oauth-authorization-server, openid-configuration, oauth-protected-resource, user-agent-configuration.json, autoconfig, mail-v1.xml, mta-sts.txt và acme-challenge. Không có path openpgpkey. Hãy phục vụ nó từ một web server static thông thường.
Specification định nghĩa 2 layout. Phương thức advanced dùng https://openpgpkey.example.org/.well-known/openpgpkey/example.org/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Phương thức direct dùng https://example.org/.well-known/openpgpkey/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Chuỗi 32 ký tự đó là giá trị SHA-1 của local part đã chuyển thành chữ thường và được mã hóa bằng z-base-32. Vì vậy, bạn không bao giờ tự tạo các filename này. GnuPG sẽ tạo chúng cho bạn.
gpg --export --armor you@example.org > you.asc
gpg-wks-client --print-wkd-url you@example.org
gpg-wks-client --install-key you.asc you@example.org--print-wkd-url in ra URL mà client sẽ fetch, dùng dạng sub-domain. --install-key ghi key vào một directory tree cục bộ phản chiếu layout của WKD, bên dưới directory cấp cao nhất có tên openpgpkey theo mặc định và có thể thay đổi bằng -C dir. Copy tree đó vào web root, thêm file policy bắt buộc bên cạnh directory hu (file rỗng là hợp lệ), rồi fetch URL của chính bạn bằng curl để xác nhận rằng nó trả về dữ liệu key thay vì 404.
Lưu trữ trên một VPS đơn lẻ
Stalwart chia lưu trữ thành bốn vai trò: data store cho các bản ghi có cấu trúc như tài khoản, cấu trúc hộp thư và cài đặt; blob store cho dữ liệu thô của email và tệp đính kèm; search store cho chỉ mục toàn văn (full-text index); và in-memory store cho dữ liệu tồn tại ngắn hạn như bộ đếm rate-limit, mục nhập greylisting, khóa và token. Mỗi loại có thể trỏ đến một backend khác nhau. Danh sách hỗ trợ bao gồm RocksDB, FoundationDB, PostgreSQL, MySQL và MariaDB, SQLite, filesystem, object storage tương thích S3, Azure Blob Storage, Redis, ElasticSearch và Meilisearch.
Trên một VPS, câu trả lời rất ngắn gọn. Tài liệu gọi RocksDB là "data store mặc định và được khuyến nghị cho các cài đặt đơn node", và hướng dẫn lưu trữ cho biết RocksDB với tất cả các store khác để ở mặc định là cấu hình đơn giản nhất cho một máy chủ duy nhất. Redis "không thể đóng vai trò là data store, blob store hoặc search store". Nó chỉ phục vụ như in-memory store, điều phối cụm (cluster coordinator) hoặc tầng cache, vì vậy không cần container Redis riêng để bắt đầu. Hãy chuyển blob store sang S3 sau này nếu hộp thư vượt quá dung lượng ổ cứng.
Việc sao lưu phụ thuộc vào backend. FAQ, đọc vào ngày 27 tháng 10 năm 2026, cho biết máy chủ không tự thực hiện sao lưu, việc copy các tệp của một data store đang chạy không phải là sao lưu, và tính năng export tích hợp sẵn là một bản dump offline của máy chủ đã dừng, dùng để di chuyển dữ liệu giữa các backend. Hãy sao lưu từng store bằng các công cụ riêng của backend đó. Với RocksDB trên một máy chủ đơn lẻ, hướng dẫn lưu trữ lưu ý rằng tất cả dữ liệu nằm trong một thư mục, đó là /var/lib/stalwart trên bản cài đặt bằng script. Hãy copy thư mục này khi dịch vụ đã dừng, hoặc từ một bản snapshot của filesystem hoặc volume, và giữ một bản sao của config.json cùng với tệp môi trường đi kèm. Việc copy ở cấp độ tệp của một key-value store đang chạy có thể khiến dữ liệu bị lỗi trong quá trình ghi, và bạn sẽ không phát hiện ra cho đến khi thử khôi phục.
Bộ lọc spam thay thế Rspamd
Việc lọc chạy bên trong cùng một process, nên không có daemon thứ hai cần duy trì hoạt động. Classifier được cấu hình trên singleton SpamClassifier trong Settings, Spam Filter, Classifier. Classifier sử dụng thuật toán FTRL-Proximal cùng feature hashing. FtrlFh là model mặc định. FtrlCcfh chuyển sang cuckoo feature hashing và dành cho các server mà hash collision làm giảm độ chính xác của classifier, đổi lại mỗi message sẽ tốn thêm memory và processing. Classifier học từ những message mà người dùng đánh dấu là spam hoặc mail hợp lệ. Classifier mới cần ít nhất 100 mẫu spam và 100 mẫu ham trước lần training đầu tiên. AI spam classifier riêng, chạy trên các AI model, là tính năng Enterprise.
Xung quanh classifier còn có DNS blocklist, greylisting, phát hiện phishing, spam trap và Pyzor, cùng tùy chọn gọi SpamAssassin qua milter nếu bạn có những rule nhất quyết không muốn bỏ.
Khi nào mailcow vẫn là lựa chọn phù hợp
Stalwart không có webmail. Đây là thiếu sót lớn nhất và không có gì thay thế được. Tài liệu của mailcow, đọc vào ngày 12 tháng 10 năm 2026, liệt kê mười sáu thành phần bao gồm SOGo, cung cấp cho người dùng hộp thư trên trình duyệt cùng giao diện CalDAV và CardDAV ngay khi cài đặt. Bài viết về lộ trình của Stalwart ngày 20 tháng 6 năm 2025 cho biết webmail chuyên dụng nằm trong kế hoạch nhưng "hiện không phải là ưu tiên hàng đầu", sẽ được xây dựng bằng Rust với Dioxus sau khi đạt phiên bản 1.0, "nhiều khả năng là vào năm 2026". Phiên bản 1.0 được phát hành vào ngày 26 tháng 10 năm 2026, và cả ghi chú phát hành lẫn thông báo đều không đề cập đến webmail. Tính đến ngày 27 tháng 10 năm 2026, blog của dự án không có bài viết nào thông báo về tính năng này. Vì vậy, với Stalwart, bạn phải tự triển khai Roundcube hoặc yêu cầu mọi người dùng tự cấu hình mail client.
Stalwart có giao diện quản trị web, nên đó không phải là khoảng trống như mọi người vẫn nghĩ. Khoảng trống thứ hai là độ mới của dòng stable. Stalwart đã duy trì ở mức 0.x cho đến khi v1.0.0 được công bố vào ngày 26 tháng 10 năm 2026. FAQ hiện ghi "Phiên bản 1.0 là bản phát hành ổn định", và thông báo cho biết schema hiện đã ổn định, các bản phát hành tương lai sẽ hỗ trợ nâng cấp tại chỗ. Lời hứa đó mới chỉ có 16 ngày tính đến thời điểm kiểm tra này, và mọi máy chủ 0.16 đều phải thực hiện migration thay vì nâng cấp trực tiếp để đạt được phiên bản này.
Khoảng trống thứ ba là điều không ai đưa vào danh sách tính năng. Postfix, Dovecot và Rspamd có cả thập kỷ tài liệu giải đáp đi kèm. Vào lúc hai giờ sáng, khi mail bị xếp hàng (queue) và người dùng đang chờ đợi, một kết quả tìm kiếm trả về đúng chuỗi lỗi có giá trị hơn nhiều so với một kiến trúc thanh lịch. Nếu bạn đang ở tình huống đó, hướng dẫn cài đặt mailcow của chúng tôi đi qua toàn bộ stack từ đầu đến cuối và nó sẽ giúp bạn có một đêm ngắn hơn.
Hãy chọn Stalwart khi bạn muốn một binary duy nhất, một file cấu hình duy nhất và JMAP, đồng thời bạn thoải mái với việc là người dùng sớm. Hãy chọn mailcow khi bạn cần webmail ngay hôm nay và một kho dữ liệu giải đáp khổng lồ đã có sẵn.
Di chuyển thư hiện có vào
Cách phổ biến là IMAP sang IMAP bằng imapsync, không phụ thuộc vào phần mềm đang chạy ở hai đầu. Trước tiên, hãy chạy thử.
imapsync --dry \
--host1 old.example.org --user1 you@example.org --passfile1 /root/.old.pw \
--host2 mail.example.org --user2 you@example.org --passfile2 /root/.new.pw--dry khiến imapsync “không thực hiện thay đổi thật; chỉ in ra những gì lệnh sẽ thực hiện”, vì vậy hãy đọc phần output đó trước khi bỏ flag này. Mỗi file mật khẩu chứa mật khẩu ở dòng đầu tiên, nên chmod 600 cả hai file và xóa chúng sau đó.
Stalwart cũng đã phát hành các công cụ mới hơn mà hầu hết tài liệu hướng dẫn của bên thứ ba chưa cập nhật. Blog của Stalwart có tài liệu về Vandelay, một JMAP importer và exporter (29 May 2026), cùng migration proxy để nâng cấp không downtime (10 June 2026). Hãy đọc cả hai trước khi lập kế hoạch di chuyển lớn, vì chúng mới hơn hầu hết mọi thông tin bạn có thể tìm thấy ở nơi khác.
Nếu server cũ cũng là Stalwart 0.16, tài liệu hiện tại đưa ra 2 cách để lên 1.0. Tool stalwart-migrate chỉ hoạt động từ v0.16.27 và sao chép toàn bộ deployment vào một data store 1.0 mới. Downtime chỉ giới hạn ở lần chạy cuối, khi mọi node 0.16 đã dừng. Cách này cần đủ dung lượng disk cho bản sao thứ hai của data store. Cách di chuyển theo từng account dùng migration proxy, chuyển từng account một trong khi cả hai server vẫn chạy. Đổi lại, client sẽ phải tải lại dữ liệu của các account đã chuyển. Tài liệu khuyến nghị stalwart-migrate cho các deployment nhỏ và vừa có thể chấp nhận một khoảng maintenance ngắn.
Các chế độ lỗi và thông báo bạn sẽ gặp
Giao diện quản trị không tải được. Trang yêu cầu hệ thống của Stalwart nêu rõ vấn đề này: gói giao diện web được tải về từ GitHub khi khởi động, và cho đến khi quá trình tải thành công, /admin và /account sẽ trả về lỗi 404. Hãy kiểm tra bằng curl -sI https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip từ máy chủ; nếu nhận được redirect nghĩa là thành công, nếu bị timeout thì do firewall chặn kết nối ra ngoài. Trang khắc phục sự cố bổ sung thêm hai nguyên nhân nữa. Sau khi thiết lập, việc đăng nhập chỉ hoạt động qua HTTPS tại /admin, còn HTTP thường sẽ bị lỗi với Unknown client id. Khi đứng sau reverse proxy hoặc sử dụng cổng HTTPS khác 443, máy chủ phải được cấu hình đúng URL mà client sử dụng.
Không có mật khẩu bootstrap trong log. Mật khẩu này được in ra mỗi khi khởi động trong chế độ bootstrap, và chỉ block mới nhất mới có hiệu lực. Hãy mở rộng cửa sổ terminal bằng sudo journalctl -u stalwart --since today | grep -A8 'bootstrap mode'. Nếu wizard vẫn xuất hiện sau khi bạn đã hoàn tất, nghĩa là file cấu hình bị thiếu, hãy khôi phục hoặc mount lại nó. Nếu bạn không muốn phụ thuộc vào log, hãy thiết lập STALWART_RECOVERY_ADMIN trong /etc/stalwart/stalwart.env rồi khởi động lại.
Các cổng đặc quyền (privileged ports) không phản hồi sau khi bạn tự viết unit file. Nếu thiếu AmbientCapabilities=CAP_NET_BIND_SERVICE, người dùng stalwart không thể bind vào cổng 25, 443, 465 hoặc 993. Stalwart sẽ bỏ qua các listener bị lỗi, khởi động các listener còn lại và ghi log sự kiện registry.build-error với Failed to bind to <address>: <error>. Hãy sao chép dòng capability từ unit file mà trình cài đặt đã tạo. Nếu một mail server khác đang chiếm cổng 25, hãy dừng và disable nó. Unit file của trình cài đặt xung đột với Postfix, Sendmail và Exim, vì vậy việc khởi động một trong các dịch vụ này sẽ làm dừng Stalwart.
Chứng chỉ không được cấp. HTTP-01 yêu cầu cổng 80 phải truy cập được và được forward đến một HTTP listener của Stalwart. TLS-ALPN-01 yêu cầu chính Stalwart phải phản hồi TLS handshake trên cổng 443. Nếu một tiến trình khác chiếm cổng yêu cầu mà không forward challenge, ACME sẽ thất bại và ghi log sự kiện acme.auth-error hoặc acme.order-invalid. Với DNS thủ công, trang khắc phục sự cố cũng yêu cầu mta-sts, autoconfig, autodiscover và ua-auto-config dưới domain mặc định của bạn phải phân giải về máy chủ, vì chúng sẽ nằm trong chứng chỉ. Các lỗi về mạng, DNS và xác thực sẽ được tự động thử lại theo chính sách retry task; các yêu cầu không hợp lệ và challenge không được hỗ trợ sẽ không được thử lại.
FAQ
Stalwart có thay thế được Postfix, Dovecot và Rspamd trên một VPS không?
Có. Một binary duy nhất viết bằng Rust xử lý SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV và WebDAV, đồng thời tích hợp sẵn bộ lọc spam, kho lưu trữ tin nhắn và client ACME. Bạn chỉ cần một unit systemd và một file cấu hình tại /etc/stalwart/config.json thay vì phải quản lý bốn daemon cùng các thành phần kết nối rời rạc. Những gì nó không thay thế được là zone DNS hoặc chính sách cổng 25 của nhà cung cấp VPS, đây mới là yếu tố quyết định việc tự host email thành công hay thất bại.
Stalwart mail server cần bao nhiêu RAM?
Tính đến ngày 27 tháng 10 năm 2026, trang yêu cầu hệ thống của Stalwart không đưa ra con số cụ thể cho mỗi người dùng, và FAQ cũng cho biết chưa có số liệu đo lường chính thức về số lượng người dùng trên mỗi node. Trang này ghi rằng một server ở trạng thái nhàn rỗi (idle) tiêu tốn rất ít tài nguyên, và mức sử dụng CPU phụ thuộc vào lưu lượng mail và số lần đăng nhập thay vì tổng số tài khoản. Ví dụ thực tế duy nhất là trên một host 2 GiB, nơi các giới hạn bộ nhớ mặc định cộng lại khoảng 2.4 GiB, bao gồm hai phần dự phòng 512 MiB sẽ không được sử dụng trừ khi bạn host các tài khoản rất lớn. maxConnections mặc định là 8,192 cho mỗi listener. Không có dung lượng đĩa tối thiểu được công bố, vì vậy hãy tính toán dung lượng đĩa dựa trên lượng mail bạn lưu trữ.
Chuyển sang Stalwart có cải thiện khả năng gửi email không?
Không. Khả năng gửi email (deliverability) được quyết định bởi việc cổng TCP 25 chiều outbound có mở trên VPS của bạn hay không, bởi reverse DNS trên IP của bạn, và bởi các bản ghi SPF, DKIM, DMARC trên domain của bạn. Stalwart có hỗ trợ DANE, MTA-STS và SMTP TLS reporting, đồng thời có thể tự publish chính sách MTA-STS cho bạn, nhưng các tính năng này quản lý bảo mật truyền tải chứ không quyết định việc mạng nhận có tin tưởng địa chỉ của bạn hay không. Hãy kiểm tra cổng 25 bằng nc -vz -w 5 alt1.aspmx.l.google.com 25 trước khi cài đặt bất cứ thứ gì.
Stalwart có bao gồm webmail không?
Tính đến ngày 27 tháng 10 năm 2026 thì chưa. Nó cung cấp một giao diện quản trị web, đây là một tính năng khác. Bài viết về lộ trình phát triển của dự án ngày 20 tháng 6 năm 2025 cho biết việc phát triển webmail sẽ bắt đầu sau khi đạt phiên bản 1.0, được xây dựng bằng Rust với Dioxus, "nhiều khả năng là vào khoảng năm 2026". Phiên bản 1.0 đã phát hành vào ngày 26 tháng 10 năm 2026 mà không có webmail, và blog của dự án vẫn chưa có thông báo nào về tính năng này. Nếu người dùng của bạn cần hộp thư trên trình duyệt ngay bây giờ, hãy triển khai Roundcube song song hoặc sử dụng một stack có tích hợp sẵn SOGo.
Tính năng mã hóa dữ liệu lưu trữ (encryption at rest) của Stalwart bảo vệ được những gì?
Nó mã hóa các tin nhắn đến của người dùng (nếu được chọn) bằng public key OpenPGP hoặc S/MIME của chính họ trước khi ghi vào đĩa, vì vậy nếu đĩa bị đánh cắp, bản backup bị lộ hoặc quản trị viên truy cập vào kho lưu trữ cũng không thể đọc được nội dung tin nhắn. Đây không phải là mã hóa đầu cuối (end-to-end encryption): tin nhắn đến dưới dạng văn bản thuần (plain text) và chỉ được mã hóa khi lưu vào hệ thống, do đó mọi chặng trung gian trước đó đều có thể đọc được nội dung. Cài đặt encryptOnAppend cho mỗi tài khoản mặc định là tắt, vì vậy các tin nhắn do client gửi thêm vào sẽ ở dạng rõ (clear) trừ khi server cho phép mã hóa dữ liệu lưu trữ và tài khoản đó kích hoạt mã hóa cho các tin nhắn gửi thêm; trong phiên bản v1.0.1, các bản nháp JMAP và bản sao tin nhắn đã gửi (Sent) tạo bởi JMAP submission vẫn không được mã hóa. Tài liệu ghi rõ rằng các header như người gửi, người nhận và chủ đề vẫn ở dạng đọc được, mail đã lưu trữ trước khi key được đăng ký sẽ không được mã hóa lại, và việc tìm kiếm trong nội dung hoặc file đính kèm sẽ không trả về kết quả đối với các tin nhắn đã mã hóa. Việc huấn luyện bộ lọc spam có thể giữ lại các mẫu văn bản thuần riêng biệt trước khi mã hóa.