Bỏ qua, đến nội dung chính
WisMail

Cài đặt WisMail 1.0.4 trên Debian hoặc Ubuntu

Hướng dẫn này đưa bạn từ một máy chủ Debian hoặc Ubuntu mới đến một máy chủ email tự host hoạt động. Mất khoảng 30 phút nếu DNS đã sẵn sàng. Bạn cần gói cài ở trang Tải về và một khóa license (xem Bảng giá hoặc bắt đầu dùng thử).

Trước khi bắt đầu

  • Máy chủ 64-bit (amd64) chạy Debian 11 hoặc 12, hoặc Ubuntu 22.04 hoặc 24.04, tối thiểu 2 GB RAM (khuyến nghị 4 GB), có quyền root hoặc sudo.
  • Một tên máy chủ như mail.example.com có bản ghi A trỏ về IP máy chủ, và bản ghi MX của tên miền trỏ về tên máy chủ đó. Xem Cấu hình DNS.
  • Một bản ghi PTR (reverse DNS) cho IP máy chủ, phân giải ra tên máy chủ của bạn. PTR được đặt ở nhà cung cấp hosting, không phải trong vùng DNS của bạn. Thiếu PTR, nhiều nơi nhận sẽ coi thư của bạn là spam.
  • Không có máy chủ thư khác trên máy: Postfix hoặc Exim chiếm cổng 25. Dừng và tắt chúng:
sudo systemctl disable --now postfix exim4

(Lỗi kiểu "unit not found" chỉ có nghĩa là chương trình đó chưa được cài.)

  • Đặt hostname của máy chủ trùng với tên trong bản ghi A:
sudo hostnamectl set-hostname mail.example.com
  • Nhà cung cấp cho phép kết nối cổng 25. Nhiều dịch vụ đám mây chặn cổng này theo mặc định; hãy yêu cầu họ mở.
  • Máy chủ kết nối được HTTPS ra máy chủ license license.mailselfhost.com.

Bước 1. Tải về và kiểm tra

Tải gói ở trang Tải về, hoặc tải thẳng trên máy chủ:

wget https://wismail.vn/downloads/wismail_1.0.4_amd64.deb
echo "c2fb256da287bc64304a49bc15a6678425e9da7870abc1b0e9926d33a658a01a  wismail_1.0.4_amd64.deb" | sha256sum -c -

Lệnh kiểm tra phải in ra wismail_1.0.4_amd64.deb: OK. Nếu không, xóa tệp, tải lại, và liên hệ chúng tôi nếu vẫn khác.

Bước 2. Cài gói

sudo apt-get install -y ./wismail_1.0.4_amd64.deb

Nếu môi trường không có apt-get, dùng dpkg rồi để apt bổ sung các gói phụ thuộc còn thiếu:

sudo dpkg -i ./wismail_1.0.4_amd64.deb
sudo apt-get install -f -y

Gói cài vào /opt/wismail, đăng ký dịch vụ systemd wismail và khởi động. Chờ khoảng 15 giây ở lần chạy đầu trong khi dịch vụ tạo cấu hình và một chứng chỉ tự ký.

Bước 3. Xác nhận dịch vụ đang chạy

sudo systemctl status wismail
sudo ss -tlnp | grep -E ':(25|465|587|143|993|110|995|80|443|4040)\b'

Trạng thái phải là active (running), lệnh thứ hai liệt kê các cổng thư và web mà máy chủ đang lắng nghe. Nếu có lỗi, xem nhật ký:

sudo journalctl -u wismail -e

Bước 4. Mở tường lửa

Cho phép các cổng thư và web. Với UFW:

sudo ufw allow 25,465,587,143,993,110,995,80,443,4040/tcp
Cổng Dịch vụ
25, 465, 587 SMTP, SMTPS, Submission
143, 993 IMAP, IMAPS
110, 995 POP3, POP3S
80, 443 HTTP, HTTPS (webmail, CalDAV, CardDAV, ActiveSync)
4040 Quản trị web (nên giới hạn trong mạng của bạn nếu có thể)

Nếu nhà cung cấp hosting có tường lửa riêng (security group), hãy mở cùng các cổng đó ở đó.

Bước 5. Mở trang quản trị web

Trong trình duyệt mở https://<IP-VPS>:4040/admin/, thay <IP-VPS> bằng IP hoặc tên máy chủ. Lần đầu sẽ có cảnh báo chứng chỉ tự ký: đây là bình thường, hãy chấp nhận và tiếp tục. Sau này bạn có thể thay bằng chứng chỉ Let's Encrypt.

Bước 6. Chạy trình hướng dẫn cài đặt

Trình hướng dẫn đi qua thỏa thuận license, tên máy chủ và kiểm tra MX, tên miền thư chính, tài khoản quản trị và vị trí kho thư. Hoàn tất; máy chủ khởi động lại một lần.

Trình hướng dẫn cài đặt trong quản trị web: tên máy chủ, tên miền chính và tài khoản quản trị

Bước 7. Nhập khóa license

Ở bước License, dán khóa license và tiếp tục. Lấy khóa trong tài khoản khách hàng (mục License) hoặc trong email xác nhận đơn hàng. Chưa có khóa? Hãy dùng thử hoặc mua license. Chi tiết ở Kích hoạt license.

Trình hướng dẫn cài đặt trong quản trị web, bước Giấy phép: dùng thử 30 ngày, nhập số giấy phép hoặc nhập tệp khóa

Kiểm tra máy chủ kết nối được tới máy chủ license:

curl -sS https://license.mailselfhost.com/healthz

Phản hồi như ok nghĩa là kết nối hoạt động. Báo lỗi nghĩa là HTTPS ra máy chủ đó đang bị chặn.

Để dùng máy chủ license khác (ví dụ máy chủ riêng), ghi URL vào tệp dưới đây rồi khởi động lại:

echo "https://your-license-server.example.com" | sudo tee /opt/wismail/license/license-server.url
sudo systemctl restart wismail

Bước 8. Gửi thư thử

  1. Trong quản trị web tạo một hộp thư cho tên miền của bạn (Tài khoản → Người dùng).
  2. Đăng nhập webmail tại https://mail.example.com/, gửi thư tới một địa chỉ bên ngoài (ví dụ Gmail), rồi trả lời lại để thử chiều nhận.
  3. Theo dõi gửi nhận ở Trạng thái → Hàng đợi và Trạng thái → Nhật ký, hoặc trên máy chủ bằng sudo journalctl -u wismail -e.

Xử lý sự cố và câu hỏi thường gặp

Không mở được cổng 4040 hoặc trang quản trị. Kiểm tra dịch vụ (bước 3), tường lửa trên máy chủ và tường lửa của nhà cung cấp (bước 4). Trình duyệt báo hết thời gian nghĩa là cổng bị chặn; cảnh báo chứng chỉ là bình thường (bước 5).

Thư gửi đi không ra khỏi máy chủ. Nhiều nhà cung cấp chặn cổng 25. Thử từ máy chủ bằng nc -vz gmail-smtp-in.l.google.com 25; nếu treo, hãy yêu cầu nhà cung cấp mở cổng.

Thư của tôi vào spam. Đặt bản ghi PTR khớp tên máy chủ, rồi SPF, DKIM và DMARC trong DNS. Hướng dẫn DNS liệt kê từng bản ghi. Nên dùng địa chỉ IP sạch.

Trình duyệt báo cảnh báo chứng chỉ. Chứng chỉ đầu tiên là tự ký. Cài chứng chỉ thật từ Let's Encrypt; cổng 80 phải truy cập được.

Đăng ký license thất bại. Chạy lệnh curl ở bước 7. Nếu lỗi, cho phép HTTPS ra license.mailselfhost.com rồi thử lại bước License.

Bước tiếp theo