# Webmail, lịch và danh bạ

> Mở webmail từ panel không cần mật khẩu, đăng nhập SnappyMail trực tiếp, và đồng bộ lịch, danh bạ của từng hộp thư qua CalDAV/CardDAV với điện thoại và Thunderbird.

Source: https://zopanel.net/vi/docs/webmail-calendar  
Updated: 2026-10-09

ZoPanel bổ sung hai dịch vụ tuỳ chọn cho mail server: **webmail** (SnappyMail) để đọc và gửi thư trên trình duyệt, và **lịch và danh bạ** (Radicale), cho mỗi hộp thư lịch CalDAV và sổ địa chỉ CardDAV riêng. Cả hai đăng nhập bằng địa chỉ và mật khẩu hộp thư. Hãy cài khi người dùng cần đọc thư mà không cài phần mềm, hoặc muốn đồng bộ lịch và danh bạ giữa các thiết bị.

## Cài đặt (quản trị viên)

Cả hai dịch vụ cần mail server. Xem [Email](/vi/docs/email).

| Dịch vụ | Cài từ | Cổng | Yêu cầu |
| --- | --- | --- | --- |
| Webmail | **Email → Cài webmail**, hoặc **Thành phần → Webmail** | 2096 | Máy chủ đã cài ít nhất một phiên bản PHP |
| Lịch và danh bạ | **Thành phần → Lịch & danh bạ (CalDAV/CardDAV)** | 2080 | Mail server |

Bạn cũng có thể chọn chúng khi cài máy chủ: `--with webmail,dav` (xem [Cài đặt](/vi/docs/install)). Trình cài đặt tự mở cổng trên tường lửa. Webmail tải bản SnappyMail mới nhất từ GitHub; lịch dùng gói Radicale của bản phân phối Linux.

Cả hai dịch vụ dùng chứng chỉ của panel. Hãy cấu hình **Cài đặt → Tên miền & SSL cho panel** trước, và mở cả hai dịch vụ bằng tên miền panel hoặc hostname mail (chứng chỉ ghi cả hai tên khi hostname mail đã trỏ về máy chủ) để trình duyệt và thiết bị thấy chứng chỉ tin cậy. Xem [Cài đặt panel](/vi/docs/panel-settings).

## Webmail

### Mở webmail từ panel (không cần mật khẩu)

1. Mở **Email** và chọn tên miền.
2. Ở dòng của hộp thư, bấm biểu tượng phong bì **Mở webmail (không cần mật khẩu)**.

Webmail mở trong tab mới và đã đăng nhập sẵn vào hộp thư đó. Khách hàng, đại lý và quản trị viên đều dùng được với mọi hộp thư mình quản lý, và mỗi lần đăng nhập đều được ghi vào nhật ký hoạt động.

Cách hoạt động: panel không bao giờ biết mật khẩu hộp thư. Thay vào đó, máy chủ cấp một mã đăng nhập chỉ mở đúng hộp thư đó, hiệu lực 12 giờ, và SnappyMail đổi mã này thành đường dẫn dùng một lần, hiệu lực khoảng 10 giây. Không có mật khẩu chủ (master password) nào. Đổi mật khẩu hoặc xoá hộp thư sẽ thu hồi mã ngay lập tức.

### Đăng nhập trực tiếp

Người dùng không có quyền vào panel mở:

```text
https://<tên-miền-panel>:2096
```

và đăng nhập bằng địa chỉ email đầy đủ cùng mật khẩu hộp thư. Nút **Webmail** ở đầu trang **Email** và trong thẻ **Cấu hình phần mềm email** mở cùng địa chỉ này.

### Những điều cần biết về webmail

- Webmail tự kết nối tới IMAP và SMTP của máy chủ này, không cần cấu hình gì cho từng tên miền. Trang quản trị của SnappyMail bị tắt vì ZoPanel quản lý các tên miền.
- Mỗi lần tải lên, ví dụ một file đính kèm, tối đa 25 MB.
- Bộ lọc và trả lời tự động không chỉnh trong webmail. Hãy dùng **Quy tắc và trả lời tự động** trong panel; chúng có hiệu lực cả với webmail. Xem [Quy tắc và giới hạn email](/vi/docs/mail-rules).
- Thư gửi từ webmail tính vào giới hạn gửi mỗi giờ của tài khoản như mọi đăng nhập SMTP khác.
- Hộp thư của tài khoản hosting bị tạm ngưng không đăng nhập được.

## Lịch và danh bạ (CalDAV/CardDAV)

Mỗi hộp thư có lịch và sổ địa chỉ riêng tại:

```text
https://<tên-miền-panel>:2080/
```

Đăng nhập bằng địa chỉ email đầy đủ và mật khẩu hộp thư. Mỗi người chỉ thấy dữ liệu của mình, lưu dưới `https://<tên-miền-panel>:2080/<địa-chỉ>/`. Xoá hộp thư, hoặc tắt email của tên miền, sẽ xoá luôn lịch và danh bạ của hộp thư đó.

Mỗi hộp thư có sẵn một lịch tên **Calendar** (`…/<địa-chỉ>/calendar/`) và một sổ địa chỉ tên **Contacts** (`…/<địa-chỉ>/contacts/`), nên các ứng dụng chỉ dùng được bộ sưu tập đã có, như Thunderbird, đồng bộ được ngay. Hộp thư đã có dữ liệu lịch từ trước được giữ nguyên. Muốn thêm lịch hay sổ địa chỉ khác, hãy dùng ứng dụng tạo được chúng: Lịch và Danh bạ của Apple trên iPhone, iPad và Mac, hoặc DAVx⁵ trên Android.

Tên menu của các ứng dụng bên dưới ghi theo giao diện tiếng Anh.

### iPhone và iPad

1. Mở **Settings → Calendar → Accounts → Add Account → Other** (trên iOS mới, Calendar nằm trong **Settings → Apps**).
2. Chạm **Add CalDAV Account**.
3. **Server**: `panel.example.com:2080`. **User Name**: địa chỉ đầy đủ. **Password**: mật khẩu hộp thư. Chạm **Next**.
4. Lịch **Calendar** hiện ra trong ứng dụng Calendar. Muốn thêm lịch khác, chạm **Calendars → Add Calendar** và chọn tài khoản này.

Với danh bạ, chạm **Add CardDAV Account** ở cùng chỗ và dùng cùng thông số.

### Mac

1. Mở **Calendar → Settings → Accounts**, bấm **+** rồi chọn **Other CalDAV Account**.
2. Đặt **Account Type** là **Advanced**.
3. Nhập địa chỉ đầy đủ và mật khẩu, **Server Address** `panel.example.com`, **Server Path** `/`, **Port** `2080`, và tích **Use SSL**.
4. Bấm **Sign In**. Thêm lịch khác bằng **File → New Calendar** và chọn tài khoản này.

Với danh bạ, vào **Contacts → Settings → Accounts** và thêm tài khoản CardDAV với cùng máy chủ, cổng và thông tin đăng nhập.

### Android (DAVx⁵)

Android không có sẵn CalDAV/CardDAV. Cài DAVx⁵ (Google Play hoặc F-Droid), rồi:

1. Chạm **+** và chọn **Login with URL and user name**.
2. **Base URL**: `https://panel.example.com:2080/`. Nhập địa chỉ đầy đủ và mật khẩu hộp thư, chạm **Login**.
3. Chọn **Create account**.
4. Ở màn hình tài khoản, tích các bộ sưu tập cần đồng bộ. Muốn thêm, dùng menu **Create calendar** hoặc **Create address book**.

Lịch và danh bạ sau đó hiện trong ứng dụng Lịch và Danh bạ của điện thoại.

### Thunderbird

- **Lịch:** chọn **New Calendar → On the Network**, nhập địa chỉ đầy đủ ở **Username** và `https://panel.example.com:2080/` ở **Location**, bấm **Find Calendars**, nhập mật khẩu và chọn lịch.
- **Danh bạ:** trong sổ địa chỉ, chọn **New Address Book → Add CardDAV Address Book**, nhập tên đăng nhập và `https://panel.example.com:2080/` làm địa chỉ, rồi chọn sổ địa chỉ.

### Outlook

Outlook không tự hỗ trợ CalDAV hay CardDAV. Cần cài add-in bên thứ ba đồng bộ CalDAV/CardDAV, ví dụ Outlook CalDav Synchronizer (mã nguồn mở).

## Xử lý sự cố

| Thông báo hoặc hiện tượng | Nguyên nhân và cách xử lý |
| --- | --- |
| "webmail is not installed" | Cài bằng **Email → Cài webmail** hoặc ở **Thành phần**. |
| Cài webmail báo "install a PHP version first" | Cài một phiên bản PHP bất kỳ ở **Thành phần**, rồi cài lại webmail. |
| "webmail did not create a login link" / "webmail PHP version not found" | Dịch vụ webmail không chạy đúng. Quản trị viên kiểm tra `systemctl status zp-webmail` và cài lại webmail nếu cần. |
| Tab đăng nhập một chạm lại hiện màn hình đăng nhập | Đường dẫn chỉ dùng được một lần trong vài giây. Bấm lại biểu tượng; đừng dùng lại hay lưu địa chỉ đó. |
| Trình duyệt cảnh báo chứng chỉ ở cổng 2096 hoặc 2080 | Mở dịch vụ bằng tên miền panel hoặc hostname mail, sau khi đã cấu hình **Cài đặt → Tên miền & SSL cho panel**. |
| Cổng 2096 hoặc 2080 không tải được | Mạng bạn đang dùng có thể chặn cổng không chuẩn (thường gặp ở văn phòng, khách sạn). Thử mạng khác. |
| Đăng nhập lịch liên tục thất bại | Dùng địa chỉ đầy đủ và mật khẩu hộp thư hiện tại. Sau 6 lần sai, Fail2ban khoá IP; quản trị viên gỡ bằng **Bỏ chặn** ở trang **Bảo mật**. Hộp thư chuyển từ panel khác có thể cần đặt mật khẩu mới (biểu tượng chìa khoá) trước khi lịch chấp nhận. |
| Thêm tài khoản được nhưng không thấy lịch hay danh bạ | Hộp thư đã có dữ liệu lịch từ trước khi được tạo bộ sưu tập mặc định, hoặc các bộ sưu tập đã bị xoá. Hãy tạo lịch hoặc sổ địa chỉ bằng Lịch, Danh bạ của Apple hoặc DAVx⁵. |

## Xem thêm

- [Email](/vi/docs/email)
- [Phần mềm email](/vi/docs/email-clients)
- [Quy tắc và giới hạn email](/vi/docs/mail-rules)
- [Thành phần](/vi/docs/components)
- [SnappyMail](https://github.com/the-djmaze/snappymail)
- [Tài liệu Radicale](https://radicale.org/v3.html)
- [Hướng dẫn DAVx⁵](https://www.davx5.com/manual)