Kinh doanh email hosting với WisMail
Hướng dẫn này dành cho reseller hosting: bạn mua WisMail, chạy trên máy chủ của mình và bán hộp thư, tên miền cho khách hàng của bạn. Hướng dẫn đi từ gói dịch vụ đầu tiên đến việc cấp phát tự động từ hệ thống thanh toán, theo đúng thứ tự bạn sẽ làm. Dành khoảng một buổi cho khách thử đầu tiên, lâu hơn nếu bạn tự viết tích hợp. Bạn cần có máy chủ chạy sẵn: làm theo hướng dẫn cài đặt và hướng dẫn DNS.
1. Các thành phần phối hợp như thế nào
Bạn chạy một hoặc nhiều máy chủ WisMail. Khách hàng mang tên miền riêng (client1.com) và nhận hộp thư trên đó. Ba thành phần phối hợp:
- Máy chủ WisMail của bạn: lưu thư, chạy SMTP, IMAP, webmail và quản trị web. Máy chủ áp dụng các giới hạn của gói.
- Hệ thống thanh toán của bạn (WHMCS, bảng điều khiển hoặc mã của bạn): nhận đơn hàng và tiền, rồi báo cho máy chủ cần tạo, tạm ngưng hay xóa gì qua API cấp phát (provisioning API).
- Tên miền của khách: bản ghi DNS tại nhà đăng ký của khách hoặc của bạn trỏ tên miền về máy chủ (MX, SPF, DKIM, DMARC).
API cấp phát là giao diện REST có sẵn trong máy chủ. Nó chạy đúng các thao tác như quản trị web, nên quy tắc mật khẩu, giới hạn license và nhật ký kiểm tra hoạt động như nhau dù người hay hệ thống thanh toán thực hiện thay đổi. Mỗi hộp thư bạn tạo cho khách tính vào số người dùng của license WisMail; khi license đã đầy, việc tạo hoặc bật hộp thư bị từ chối (license_limit_reached). Hãy xác nhận điều khoản license cho việc bán lại với chúng tôi trước khi mở bán; xem kích hoạt license và bảng giá.
2. Xác định các gói và giới hạn
Gói là một tập giới hạn áp dụng cho tên miền của khách khi tạo. WisMail hỗ trợ:
| Giới hạn | Điều khiển gì | Giá trị khởi đầu |
|---|---|---|
| Dung lượng tên miền | Tổng ổ đĩa cho mọi hộp thư của tên miền. Thư làm vượt giới hạn bị từ chối với 5.2.2 User quota exceeded và người gửi nhận thư báo lỗi |
10 GB |
| Hạn mức hộp thư | Ổ đĩa cho mỗi hộp thư, áp dụng cho hộp thư mới | 2 GB |
| Số hộp thư tối đa | Tên miền được có bao nhiêu hộp thư (đang bật và đang tạm ngưng) | 5 |
| Chuyển tiếp | Hộp thư có được chuyển tiếp sang địa chỉ khác qua API hay không | cho phép |
| Tốc độ gửi mỗi hộp thư | Số thư một hộp thư được gửi mỗi giờ và mỗi ngày | 50 mỗi giờ, 500 mỗi ngày |
| Tốc độ gửi cả tên miền | Giới hạn tùy chọn cho tất cả hộp thư cộng lại | tắt (0) |
0 luôn nghĩa là không giới hạn. Một thang gói để bạn điều chỉnh:
| Gói | Hộp thư | Dung lượng tên miền | Mỗi hộp thư | Mỗi giờ / mỗi ngày |
|---|---|---|---|---|
| Starter | 5 | 10 GB | 2 GB | 50 / 500 |
| Business | 25 | 50 GB | 5 GB | 100 / 1.000 |
| Pro | 100 | 250 GB | 10 GB | 200 / 2.000 |
Đây là gợi ý, không phải mặc định của sản phẩm: hãy điều chỉnh theo chi phí và khách hàng của bạn.
Vì sao cần giới hạn tốc độ gửi. Một hộp thư bị chiếm quyền của một khách có thể gửi hàng nghìn thư rác trong một giờ và đưa IP máy chủ của bạn vào danh sách đen, làm hại mọi khách khác. Giới hạn tốc độ gửi là lưới an toàn của bạn. Nó đếm một đơn vị cho mỗi người nhận của mọi thư gửi qua SMTP, webmail, ActiveSync hoặc EWS, theo cửa sổ trượt 60 phút và 24 giờ. Vượt giới hạn, máy chủ trả lỗi tạm thời (452 4.7.25 Sending rate limit exceeded, retry later), máy khách giữ thư và thử lại sau, và sự việc được ghi vào nhật ký bảo mật. Hãy bắt đầu chặt và nới cho khách nào yêu cầu. Mỗi hộp thư có thể có giá trị riêng ghi đè giá trị của tên miền.
Nơi đặt giới hạn:
- Thủ công: trong quản trị web mở Cấu hình, Tên miền, sửa tên miền, dùng thẻ Hạn mức (dung lượng ổ đĩa tên miền) và thẻ Thư (giới hạn tốc độ gửi, theo hộp thư và theo cả tên miền).
- Tự động: cùng các giá trị đó nằm trong lệnh gọi API tạo tên miền, hoặc trong sản phẩm WHMCS của bạn (mục 4 và 5).
Cần biết giới hạn của các giới hạn: số hộp thư tối đa do API cấp phát và module WHMCS thực thi; hộp thư bạn tạo tay trong quản trị web không bị chặn bởi giới hạn này (nhưng vẫn được tính). Công tắc chuyển tiếp chỉ quản lý các chuyển tiếp đặt qua API; nó không ngăn người dùng tự thêm chuyển tiếp bằng quy tắc webmail. Đổi hạn mức hộp thư mặc định của tên miền chỉ áp dụng cho hộp thư mới, không áp dụng cho hộp thư đã có.
3. Bật tự động hóa: tạo khóa API
- Đăng nhập quản trị web bằng tài khoản quản trị đầy đủ và mở Cấu hình, Khóa API.
- Chọn Tạo khóa. Đặt nhãn như
whmcs-prod, chọn phạm vi, và giữ giới hạn yêu cầu mỗi phút mặc định trừ khi cần nhiều hơn. - Sao chép khóa ngay. Khóa có dạng
wmk_1a2b3c4d_...và chỉ hiện một lần; máy chủ chỉ lưu giá trị băm và không thể hiện lại. Nếu mất, hãy thu hồi và tạo khóa khác.
Phạm vi: Đọc và ghi (provisioning) cho hệ thống thanh toán tạo và thay đổi dữ liệu; Chỉ đọc (provisioning.read) cho công cụ đo lường hoặc báo cáo chỉ đọc mức sử dụng (thao tác ghi bằng khóa này bị từ chối). Dùng khóa riêng cho từng hệ thống để thu hồi một khóa mà không làm hỏng các hệ thống khác.
Quy tắc với khóa:
- Đó là mật khẩu cho toàn bộ hệ thống hosting của bạn. Giữ trong cài đặt máy chủ của hệ thống thanh toán, không bao giờ đặt trong trang web, mã trong kho công khai hay phiếu hỗ trợ.
- Chỉ dùng HTTPS. API từ chối HTTP thường từ mọi nơi trừ chính máy chủ. Hãy cài chứng chỉ thật trước: SSL với Let's Encrypt.
- Mỗi lệnh gọi được ghi vào nhật ký cấu hình với nhãn của khóa là người thực hiện, nên bạn biết ai đã làm gì. Nút Thu hồi trong cùng màn hình vô hiệu hóa khóa ngay lập tức.
- Mỗi khóa có giới hạn tốc độ yêu cầu; vượt giới hạn sẽ nhận
429kèm tiêu đềRetry-After.
4. Cách A: bán qua WHMCS
Nếu bạn đã tính cước bằng WHMCS 8, hãy dùng module máy chủ làm sẵn. Cần PHP 7.4 đến 8.3 với phần mở rộng curl.
- Tải module: wismail-whmcs-1.0.0.zip. Giải nén vào thư mục gốc WHMCS để có
modules/servers/wismail/wismail.php. Gói zip có kèmREADME.mdmô tả đầy đủ. - Trong WHMCS mở System Settings, Products/Services, Servers, Add New Server. Đặt Hostname là tên máy chủ thư của bạn, Module là WisMail Email Hosting, dán khóa API vào Password. Tích Secure. Chọn Test Connection: lệnh này gọi điểm cuối trạng thái của máy chủ và cho biết khóa hay phạm vi của nó có sai không.
- Tạo sản phẩm: Products/Services, Create, loại Hosting Account, rồi Module Settings, module WisMail Email Hosting. Ánh xạ gói của bạn trong Config Options:
- Max Mailboxes, Storage GB (cả tên miền), Per-mailbox Quota GB
- Send rate/hour và Send rate/day (mỗi hộp thư)
- Allow Forwarding, Admin Mailbox Name (mặc định
admin) 0nghĩa là không giới hạn. Chọn thiết lập tự động sau lần thanh toán đầu tiên.
- Đặt một đơn thử. Khách nhập tên miền thư vào ô Domain. WHMCS tạo tên miền với giới hạn của gói và hộp thư đầu tiên
admin@<tên miền>, đồng thời là quản trị viên được ủy quyền (mục 6).
Module làm gì cho từng thao tác WHMCS:
| Trong WHMCS | Trên máy chủ thư |
|---|---|
| Create | Tạo tên miền với gói, rồi hộp thư quản trị |
| Change Package | Áp dụng giới hạn gói mới cho tên miền |
| Change Password | Đặt lại mật khẩu hộp thư quản trị |
| Suspend / Unsuspend | Tạm ngưng hoặc bật lại tên miền (mục 8) |
| Terminate | Xóa tên miền, hộp thư và thư, không thể hoàn tác |
| Thẻ dịch vụ, khu vực khách | Hiện trạng thái, hộp thư, dung lượng và số thư đã gửi |
| Usage update | Đọc dung lượng đã dùng của từng dịch vụ |
Thử lại là an toàn: tên miền hoặc hộp thư có sẵn từ lần làm dở được đối chiếu lại, và tạm ngưng hai lần không gây hại. Module Log của WHMCS ghi mọi lệnh gọi, khóa và mật khẩu được che. Mật khẩu dịch vụ phải đạt chính sách mật khẩu của tên miền (độ dài tối thiểu, ba trong bốn nhóm ký tự, không chứa tên người dùng hoặc tên miền). Lưu ý module này đã được kiểm chứng với API thật bằng bộ kiểm thử riêng; hãy chạy các đơn đầu tiên trên bản WHMCS thử nghiệm trước khi nhận tiền thật.
5. Cách B: gọi trực tiếp REST API
Với bảng điều khiển hoặc mã tính cước của riêng bạn, dùng API tại https://<máy-chủ-của-bạn>/api/provisioning/v1 (cổng 443, hoặc 4040). Hợp đồng đầy đủ là tài liệu OpenAPI 3, phục vụ không cần khóa tại https://<máy-chủ-của-bạn>/api/provisioning/v1/openapi.json; hãy sinh client từ đó bằng ngôn ngữ bạn dùng. Yêu cầu và phản hồi là JSON, dung lượng tính bằng byte, 0 là không giới hạn, và trường không biết sẽ bị từ chối để lỗi chính tả không lọt qua âm thầm.
KEY=wmk_1a2b3c4d_THAY_BANG_KHOA_CUA_BAN
BASE=https://mail.example.com/api/provisioning/v1
# Kiểm tra khóa
curl -sS $BASE/status -H "Authorization: Bearer $KEY"
# Tạo tên miền khách với gói (10 GB, 5 hộp thư, 2 GB mỗi hộp, 50/giờ, 500/ngày)
curl -sS -X POST $BASE/domains -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{
"name": "client1.com",
"limits": {"max_mailboxes": 5, "storage_bytes": 10737418240, "default_mailbox_quota_bytes": 2147483648,
"allow_forwarding": true, "send_rate": {"per_mailbox_hour": 50, "per_mailbox_day": 500}}}'
# Tạo hộp thư đồng thời là quản trị viên của tên miền
curl -sS -X POST $BASE/mailboxes -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
-d '{"address": "[email protected]", "password": "Zq7!kTr82vLp", "full_name": "Info", "domain_admin": true}'
# Đọc mức sử dụng để lập hóa đơn
curl -sS $BASE/usage/client1.com -H "Authorization: Bearer $KEY"
Lỗi luôn có dạng {"error": {"code": "...", "message": "..."}}; hãy xử lý theo code (ví dụ mailbox_limit_reached, domain_suspended, weak_password). Tạo thứ đã tồn tại trả 409, client thử lại có thể coi là đã xong sau khi đọc lại. Đổi gói về sau bằng PATCH /domains/<tên miền>, chỉ các trường bạn gửi mới thay đổi.
6. Cấp quản trị viên tên miền cho từng khách
Để bạn không phải tạo mọi hộp thư cho khách, hãy đặt một hộp thư trong tên miền của họ làm quản trị viên tên miền (vai trò AccountAdmin): tích chọn khi tạo hộp thư qua API ("domain_admin": true, module WHMCS làm việc này cho hộp thư quản trị), hoặc mở người dùng trong quản trị web, thẻ Quyền.
Người đó đăng nhập quản trị web tại https://<máy-chủ-của-bạn>:4040/admin/ bằng địa chỉ hộp thư và mật khẩu, chỉ thấy mục Tài khoản của tên miền của họ: người dùng, nhóm, bí danh, danh sách thư và tài nguyên. Họ thêm, xóa hộp thư của mình và đặt lại mật khẩu. Họ không đổi được giới hạn gói, không thấy tên miền khác và không thấy cài đặt máy chủ, nên gói luôn nằm trong tầm kiểm soát của bạn. Tài khoản quản trị toàn máy chủ không bao giờ bị API động đến.
Những người còn lại dùng webmail tại https://<máy-chủ-của-bạn>/webmail/ hoặc ứng dụng thư; gửi họ hướng dẫn webmail và hướng dẫn cài trên điện thoại. Nếu muốn địa chỉ riêng cho giao diện quản trị, đặt reverse proxy phía trước cổng 4040.
7. Thư đến được hộp thư đến: DNS cho mọi tên miền khách
Hộp thư chỉ có ích khi thư đến được hộp thư đến. Mỗi tên miền khách cần bản ghi riêng, mà API không tạo giúp bạn:
- MX trỏ về máy chủ của bạn để thư đến nhận được.
- SPF cho phép máy chủ của bạn gửi thay tên miền.
- DKIM: bật ký thư cho tên miền trong quản trị web và đưa khách bản ghi TXT để khai báo.
- DMARC để nơi nhận biết chính sách của bạn.
- PTR (DNS ngược) cho IP máy chủ. Bản ghi này chỉ bạn làm được, một lần cho máy chủ, khách không tự sửa được.
Hướng dẫn DNS liệt kê từng bản ghi kèm lệnh dig kiểm tra. Trong quản trị web, Trạng thái, Setup & Health cho biết các bản ghi cần khai báo và mức sẵn sàng của máy chủ. Hãy đưa mục "bản ghi DNS cần thêm" vào email hoặc trang chào mừng khách để họ khai báo ngay ngày đầu, và đọc chống spam và virus để bảo vệ thư đến. Nếu IP máy chủ uy tín thấp hoặc cổng 25 bị chặn, hãy gửi qua relay: SMTP relay.
8. Vòng đời: tạm ngưng, mở lại, hủy và tính cước
Nối các sự kiện thanh toán với API (module WHMCS đã làm sẵn):
- Tạm ngưng (hóa đơn chưa trả): tạm ngưng một tên miền sẽ vô hiệu hóa mọi hộp thư đang hoạt động trong đó và ghi nhớ những hộp nào, đồng thời không thể tạo hộp thư mới. Bật lại chỉ kích hoạt đúng các hộp đó. Thư, thư mục và cài đặt được giữ nguyên.
- Xóa (hủy dịch vụ): xóa tên miền cùng hộp thư và thư không thể hoàn tác. Hãy quyết định chính sách lưu giữ và sao lưu trước khi cho khách tự hủy (sao lưu và khôi phục).
- Mức sử dụng để lập hóa đơn:
GET /usagetrả một dòng cho mỗi tên miền,GET /usage/<tên miền>thêm một dòng cho mỗi hộp thư: số hộp thư và giới hạn, dung lượng đã dùng và giới hạn, lần đăng nhập cuối, số thư đã gửi trong giờ và ngày gần nhất.
Các giới hạn hiện tại, nói thẳng:
- Hộp thư bị tạm ngưng là tài khoản bị vô hiệu hóa. Đăng nhập và gửi thư bị từ chối, còn thư đến địa chỉ đó bị từ chối với thư báo "hộp thư không tồn tại". Hiện chưa có chế độ giữ thư (hold mail), nên trong lúc khách bị tạm ngưng, người gửi được báo là địa chỉ không tồn tại. Hãy báo trước cho khách và giữ thời gian tạm ngưng ngắn.
- Phiên đang mở kết thúc khi máy khách ngắt kết nối; chúng không bị cắt ngay.
- Bộ đếm thư đã gửi nằm trong bộ nhớ: chỉ có khi một giới hạn tốc độ gửi đang áp dụng và khởi động lại máy chủ sẽ đặt về 0. Số liệu dung lượng và số hộp thư là chính xác. Muốn tổng số thư gửi hàng tháng chính xác, hãy đọc nhật ký thư.
- Tên miền chính của máy chủ không thể bị tạm ngưng hoặc xóa qua API.