# Excalidraw

> Cài bảng vẽ Excalidraw từ Kho ứng dụng, hiểu bản vẽ được lưu ở đâu, đặt mật khẩu cho bảng vẽ và cập nhật lên bản mới.

Source: https://zopanel.net/vi/docs/app-excalidraw  
Updated: 2026-10-09

Excalidraw là bảng trắng ảo để vẽ sơ đồ, lưu đồ, wireframe và phác thảo theo phong cách vẽ tay. Bản trong Kho ứng dụng phục vụ ứng dụng web Excalidraw từ tên miền của bạn; bản vẽ được giữ trong trình duyệt của từng người dùng, không lưu trên server. Chọn Excalidraw cho workshop, giảng dạy hoặc vẽ sơ đồ nhanh khi bạn muốn bảng vẽ chạy trên tên miền riêng.

## Yêu cầu

| Mục | Giá trị |
| --- | --- |
| Image | `excalidraw/excalidraw:latest` |
| Giới hạn RAM | 256 MB, 1 CPU |
| Dung lượng trống khi cài | Khoảng 1,2 GB trên ổ chứa Docker (image cộng 1 GB chừa lại cho server) |
| Dữ liệu trên server | Không có: container không có thư mục dữ liệu |

Website được tính vào giới hạn số website của tài khoản. Nếu bạn là khách hàng, gói hosting phải cho phép ứng dụng Docker và còn trống 256 MB **RAM (MB)**.

## Excalidraw lưu bản vẽ thế nào

Hãy nắm rõ trước khi dựa vào ứng dụng:

- **Bản vẽ nằm trong trình duyệt.** Excalidraw tự lưu bản vẽ hiện tại vào bộ nhớ cục bộ (local storage) của trình duyệt. Trình duyệt khác, thiết bị khác hay cửa sổ ẩn danh đều bắt đầu với khung vẽ trống. Xoá dữ liệu trang web trong trình duyệt là mất bản vẽ.
- **File là bản sao lưu của bạn.** Dùng **Save to…** trong menu chính để tải file `.excalidraw`, **Export image…** để xuất PNG hoặc SVG, và **Open** để mở file trên thiết bị khác.
- **Vẽ cùng nhau và link chia sẻ dùng server công khai của Excalidraw.** Image chính thức được build với cùng cấu hình như excalidraw.com: phiên vẽ chung đi qua `oss-collab.excalidraw.com`, link chia sẻ được lưu ở `json.excalidraw.com`. Excalidraw mã hoá bản vẽ ngay trong trình duyệt trước khi gửi đi, khoá giải mã nằm trong link. Các tính năng này phụ thuộc vào dịch vụ của Excalidraw; server của bạn chỉ phục vụ ứng dụng. Nếu dữ liệu tuyệt đối không được rời hạ tầng của bạn, hãy dùng **Save to…** và chia sẻ file.
- Thư viện hình mẫu và tính năng AI cũng gọi dịch vụ trực tuyến của Excalidraw.

## Cài Excalidraw

1. Trỏ bản ghi A của tên miền (ví dụ `draw.example.com`) về server.
2. Mở **Kho ứng dụng**, bấm **Cài đặt** trên thẻ **Excalidraw**. Khách hàng thấy **Kho ứng dụng** trên menu của mình; thẻ trên cùng cho biết hạn mức ứng dụng và RAM của gói.
3. Điền các trường rồi bấm **Cài đặt**.

| Trường | Nhập gì |
| --- | --- |
| **Tên miền** | Tên miền hoặc tên miền phụ cho bảng vẽ, không kèm `http://`. |
| **Chủ sở hữu** | Chỉ quản trị viên thấy: tài khoản hosting sở hữu ứng dụng. |
| **SSL miễn phí (Let's Encrypt)** | Giữ bật. Trình duyệt chỉ cho dùng clipboard và một số tính năng file trên `https://`. |

Excalidraw không có trường riêng và không có tài khoản quản trị.

**Không có khoá thiết lập.** Các ứng dụng khác bị khoá cho riêng chủ sở hữu tới khi thiết lập xong, vì người truy cập đầu tiên sẽ tạo tài khoản quản trị. Excalidraw không có tài khoản nên mở cho mọi người ngay khi chạy. Tab **Docker** không hiện thẻ khoá thiết lập.

## Sử dụng

1. Mở `https://<tên miền>`. Khung vẽ sẵn sàng ngay.
2. Vẽ, rồi thường xuyên dùng **Save to…** để giữ file.
3. Muốn vẽ cùng nhau, mở **Live collaboration…**, bắt đầu phiên và gửi link. Ai có link đều sửa được khi phiên còn mở.

## Giới hạn người được mở bảng vẽ

Ai biết địa chỉ đều dùng được ứng dụng. Server không lưu gì, nhưng bạn vẫn có thể muốn giữ riêng tư:

1. Mở website, vào tab **Công cụ**.
2. Ở mục **Thư mục có mật khẩu**, bấm **Bảo vệ thư mục**.
3. Nhập `/` vào ô thư mục để bảo vệ toàn bộ website, thêm một hoặc nhiều người dùng, rồi **Lưu**.

Khách truy cập phải đăng nhập (HTTP basic authentication) trước khi ứng dụng tải. Người mở link vẽ chung cũng cần đăng nhập để mở ứng dụng. Xem [Công cụ website](/vi/docs/website-tools).

## Dữ liệu và sao lưu

ZoPanel không tạo thư mục dữ liệu cho Excalidraw, nên trên server không có gì để sao lưu: thẻ **Sao lưu** trong tab **Docker** không có gì để lưu với Excalidraw, và **Sao lưu ngay** sẽ báo "this app has no data folder". Có thể xoá container và cài lại bất cứ lúc nào mà không mất bản vẽ, vì bản vẽ nằm trong trình duyệt và trong các file người dùng đã lưu. Hãy sao lưu các file `.excalidraw` bạn cần giữ.

| Nội dung | Vị trí |
| --- | --- |
| Bản vẽ đang mở | Local storage của trình duyệt cho `https://<tên miền>` |
| Bản vẽ đã lưu | File `.excalidraw` ở nơi người dùng lưu |
| Tên container | `zp-app-<instance>`, trong đó `<instance>` là tên miền với dấu chấm đổi thành gạch ngang |

**Lưu ý:** Local storage gắn với đúng địa chỉ website. Chuyển bảng vẽ sang tên miền khác sẽ bắt đầu với khung vẽ trống; hãy mở lại các file đã lưu ở đó.

## Cập nhật Excalidraw

Quản trị viên bấm **Cập nhật bản mới** ở tab **Docker**. ZoPanel kéo lại `excalidraw/excalidraw:latest` và tạo lại container. Bản vẽ trong trình duyệt không bị ảnh hưởng; người dùng có thể cần tải lại trang để nhận bản mới. Khách hàng nhờ nhà cung cấp cập nhật.

## Giới hạn mạng

Container ứng dụng không tới được mạng nội bộ của server (dải địa chỉ private, loopback, địa chỉ metadata của cloud) cũng như cổng của panel, database và Redis. Container Excalidraw chỉ phục vụ ứng dụng web nên không bị ảnh hưởng. Vẽ chung, link chia sẻ và thư viện được trình duyệt của từng người dùng gọi trực tiếp, không đi qua container.

## Xử lý sự cố

| Hiện tượng hoặc thông báo | Cách xử lý |
| --- | --- |
| Bản vẽ biến mất | Bản vẽ nằm ở trình duyệt khác, cửa sổ ẩn danh, hoặc dữ liệu trang web đã bị xoá. Mở file `.excalidraw` lưu gần nhất. |
| Vẽ chung không kết nối được | Trình duyệt không tới được `oss-collab.excalidraw.com` (mạng chặn, tường lửa hoặc tiện ích trình duyệt), hoặc dịch vụ đang gián đoạn. Lưu file và chia sẻ file thay thế. |
| Link chia sẻ mở ra bảng trống | Link phải đầy đủ, kể cả phần sau dấu `#` chứa khoá giải mã. |
| "This website is very busy right now" | Container đang khởi động hoặc khởi động lại. Trang tự tải lại. |
| "not enough disk space: this app needs about 1.2 GB free…" | Giải phóng dung lượng trên server rồi cài lại. |
| "your plan allows N application(s)" | Đã chạm giới hạn **Ứng dụng Docker** của gói. |

## Xem thêm

- [Kho ứng dụng và lưu trữ S3](/vi/docs/apps)
- [Từng ứng dụng dùng để làm gì](/vi/docs/app-catalog)
- [Công cụ website](/vi/docs/website-tools)
- [Chứng chỉ SSL](/vi/docs/ssl)
- [Excalidraw trên GitHub](https://github.com/excalidraw/excalidraw)
- [Tài liệu Excalidraw](https://docs.excalidraw.com)