Control panel cho thời đại AI: vibe code xong, push lên GitHub là chạy.Khám phá →
Tài liệuKho ứng dụng và lưu trữ S3

Kho ứng dụng và lưu trữ S3

Chạy ứng dụng Docker 1-click như n8n, Nextcloud, Uptime Kuma sau tên miền, deploy từ image có sẵn và cấp bucket tương thích S3 cho khách.

Ngoài website PHP, ZoPanel chạy được ứng dụng trong container Docker và cung cấp kho lưu trữ đối tượng tương thích S3 ngay trên cùng server. Cả hai đều là thành phần tuỳ chọn. Mỗi thành phần đều tốn RAM, nên chỉ cài khi thật sự dùng.

Cài Docker

Docker là điều kiện để dùng Kho ứng dụng, deploy bằng image và lưu trữ S3. Có ba cách cài Docker:

  • Kho ứng dụng → Cài Docker;
  • Thành phần → Docker (menu quản trị);
  • thêm --with docker (hoặc --profile full) khi chạy bộ cài.

ZoPanel cấu hình Docker để container tách biệt với hệ thống và với các tài khoản hosting:

  • User namespace (userns-remap): UID trong container được ánh xạ sang một dải không trùng với tài khoản hosting nào.
  • Chỉ mở cổng nội bộ: container chỉ publish cổng trên 127.0.0.1, nên không thể vượt qua firewall. Khách truy cập ứng dụng qua nginx của website, có SSL.
  • Các container không giao tiếp trực tiếp với nhau (tắt inter-container communication).
  • Mỗi container chạy với no-new-privileges, tối đa 512 tiến trình, và bị bỏ một số capability Linux (NET_RAW, MKNOD, AUDIT_WRITE).
  • Mỗi ứng dụng có giới hạn RAM và CPU (xem bảng bên dưới; 1 CPU mỗi ứng dụng). Container của khách chạy trong nhóm tài nguyên của chính tài khoản đó, nên giới hạn của gói hosting cũng được áp dụng.
  • Dữ liệu ứng dụng nằm trong /var/lib/zopanel-apps/<instance>/. Chỉ root và container đó đọc được. Biến môi trường được truyền qua một file mà chỉ root đọc được, không qua dòng lệnh.
  • Log container được xoay vòng (3 file, mỗi file 10 MB).

Kho ứng dụng

Xem từng app dùng để làm gì và khi nào nên chọn ở trang Từng ứng dụng dùng để làm gì.

Kho ứng dụng liệt kê các ứng dụng cài 1-click. Khi bạn cài một ứng dụng, ZoPanel tạo website cho tên miền đã chọn, khởi động container và chuyển tiếp tên miền vào container đó. SSL được cấp tự động khi tên miền đã trỏ về server.

Ứng dụng Loại Giới hạn RAM
n8n Tự động hoá quy trình 1024 MB
Uptime Kuma Giám sát uptime, trang trạng thái 512 MB
Nextcloud Đồng bộ và chia sẻ file, lịch, danh bạ 1024 MB
Gitea Git hosting gọn nhẹ 512 MB
Vaultwarden Quản lý mật khẩu tương thích Bitwarden 256 MB
Metabase Dashboard phân tích dữ liệu 1536 MB
Ghost Blog và newsletter (SQLite) 768 MB
Memos Ghi chú gọn nhẹ 256 MB
Open WebUI Chat AI cho API tương thích OpenAI và các nhà cung cấp API công khai 2048 MB
OpenClaw Trợ lý AI trò chuyện qua ứng dụng chat (cần API key của LLM) 2048 MB
Excalidraw Bảng trắng cộng tác 256 MB

Mỗi ứng dụng có trang hướng dẫn riêng (cài đặt, đăng nhập lần đầu, sao lưu, cập nhật): n8n, Uptime Kuma, Nextcloud, Gitea, Vaultwarden, Metabase, Ghost, Memos, Open WebUI, OpenClaw, Excalidraw.

Ứng dụng cần API key sẽ hỏi key khi cài. Bạn tự trả phí cho nhà cung cấp model. Ứng dụng có dự án gốc đã ngừng nhận bản vá bảo mật sẽ không còn được cung cấp, nhưng bản đã cài vẫn quản lý được bình thường, và tab Docker của chúng báo dự án đã ngừng phát triển: File Browser (đã archive) và, từ 0.4.25, Flowise (ngừng phát triển từ tháng 8/2026).

Cài một ứng dụng

  1. Mở Kho ứng dụng và chọn ứng dụng.
  2. Nhập tên miền. Quản trị viên chọn thêm tài khoản hosting sở hữu ứng dụng.
  3. Bấm Cài đặt. Log tác vụ hiển thị quá trình tải image và khởi động.
  4. Trỏ bản ghi A của tên miền về server nếu chưa trỏ. SSL sẽ được cấp tự động sau đó.

Quản lý ứng dụng đã cài ở tab Docker của website. Ai có quyền vào website đều xem được trạng thái và output ở đây. Riêng quản trị viên còn có thể khởi động lại, dừng hoặc chạy ứng dụng, và dùng Cập nhật bản mới để chạy image mà phiên bản ZoPanel hiện tại ghim cho nhánh phiên bản của ứng dụng, vẫn giữ dữ liệu, và từ 0.4.28 dữ liệu được sao lưu trước (xem Cập nhật và bản vá bảo mật). Cập nhật bản mới chỉ cập nhật trong phiên bản chính của ứng dụng. Khi Kho ứng dụng chuyển một ứng dụng sang phiên bản chính mới (Ghost 6 và Uptime Kuma 2 từ 0.4.25), các bản cài trước đó giữ nguyên phiên bản, và tab Docker hiện thông báo (hết vòng đời, hoặc đã có phiên bản mới) kèm nút Nâng cấp lên …: dữ liệu của ứng dụng được sao lưu trước, phiên bản mới tự chuyển đổi dữ liệu, và Quay lại … khôi phục bản sao lưu đó trên phiên bản cũ. Hướng dẫn của từng ứng dụng nêu những gì cần kiểm tra trước khi nâng cấp. Tài khoản sở hữu ứng dụng cũng khởi động lại, dừng và chạy được; cập nhật và nâng phiên bản chỉ dành cho quản trị viên: hãy nhờ nhà cung cấp hosting. Nếu ứng dụng tạo token đăng nhập, token hiển thị trong mục Thông tin đăng nhập.

Cập nhật và bản vá bảo mật

Mọi image trong Kho ứng dụng đều được ghim vào một bản build cụ thể (digest) đã kiểm thử cùng bản phát hành ZoPanel; tag ở upstream có bị dời cũng không đổi thứ đang chạy. Một bản cập nhật ZoPanel có thể dời bản ghim sang bản phát hành mới hơn của cùng nhánh phiên bản. Ứng dụng đã cài giữ nguyên bản build đang chạy cho tới khi quản trị viên bấm Cập nhật bản mới: ZoPanel không bao giờ tự cập nhật ứng dụng, vì bản mới có thể chuyển đổi dữ liệu của ứng dụng (việc chuyển đổi database diễn ra bên trong ứng dụng) và chủ ứng dụng có thể muốn tự chọn thời điểm.

Cập nhật bản mới hỏi xác nhận trước. Khi ô Sao lưu dữ liệu ứng dụng trước được chọn (mặc định), dữ liệu của ứng dụng được nén lưu trước, giống Sao lưu ngay; nếu bước này lỗi (ví dụ ổ đĩa đầy) thì ứng dụng không bị động tới và tác vụ ghi rõ lý do. Chỉ bỏ chọn khi bạn đã có bản sao khác. Ứng dụng không lưu dữ liệu (Excalidraw) và lần cập nhật sang đúng bản build đang chạy thì bỏ qua bước sao lưu. Sau khi bản build mới khởi động, ZoPanel theo dõi nó trong một phút rưỡi: nếu nó dừng hoặc liên tục khởi động lại (lỗi ngay khi chạy, hoặc trên dữ liệu đã chuyển đổi), bản build chạy trước đó được khởi động lại với dữ liệu của bản sao lưu, và tác vụ báo lỗi ghi rõ điều đó; ứng dụng vẫn hiện bản cập nhật đang chờ. Muốn quay lại sau một lần cập nhật đã chạy tốt, bấm Khôi phục bản sao lưu trong thẻ Sao lưu.

Khi bản ghim mới vá các lỗ hổng đã công bố của bản đang chạy, ZoPanel báo rõ:

  • Tab Docker của ứng dụng hiện Bản vá bảo mật: <ứng dụng> <phiên bản> kèm danh sách lỗ hổng được vá và, với quản trị viên, nút Cập nhật lên <ứng dụng> <phiên bản>. Khách hàng cũng thấy thông báo này, kèm lời nhắn nhờ nhà cung cấp cập nhật.
  • Quản trị viên thấy Ứng dụng của <tên miền> có bản vá bảo mật đang chờ (hoặc N ứng dụng có bản vá bảo mật đang chờ) trong mục Cần bạn xử lý trên trang tổng quan.
  • GET /api/sites/{id}/docker trả về security_update (from, to, advisories) cho script và hệ thống giám sát.

Hãy cài bản vá bảo mật sớm. ZoPanel 0.4.34 có Gitea 28.3.0 (20 lỗ hổng của 28.2.0, 29 với bản cài đang chạy 28.1.0); 0.4.28 có Flowise 3.1.3 (27 trong 28 lỗ hổng của 3.1.2).

Ứng dụng chạy phiên bản sẽ không bao giờ được vá thì nhận cảnh báo: tab Docker liệt kê các lỗ hổng đã biết, và trang tổng quan hiện Ứng dụng của <tên miền> có lỗ hổng đã biết sẽ không được vá. Đó là trường hợp của ứng dụng đã ngừng phát triển (File Browser) và của phiên bản chính đã hết vòng đời (Ghost 5: 27 lỗ hổng đã công bố của 5.130.6 chỉ được vá trong Ghost 6; hãy dùng Nâng cấp lên Ghost 6).

File Browser (ngừng phát triển)

Repository của File Browser đã được lưu trữ (archive) từ tháng 7/2026; 2.63.23 là bản phát hành cuối cùng, và Kho ứng dụng không còn cung cấp nó. Bản đã cài vẫn chạy, vẫn quản lý, sao lưu và gỡ được, nhưng 18 lỗ hổng đã công bố cho 2.63.23 không có bản vá và sẽ không bao giờ có (trong đó GHSA-c4fr-5f24-4wrj, dọn dẹp sau khi upload lỗi xoá cả thư mục ngoài quyền của người dùng, GHSA-448h-jr2h-3vhp, làm cạn bộ nhớ, GHSA-xqp3-jq6g-x3qm, vượt qua xác thực khi dùng proxy authentication, và các lỗi vượt giới hạn thực thi lệnh GHSA-8c9q-7855-wfxq, GHSA-jvpw-637p-h3pw, GHSA-3q2w-42mv-cph4, GHSA-hc8f-m8g5-8362); tab Docker liệt kê đầy đủ. ZoPanel không thay đổi các bản cài này. Nên làm:

  1. Chuyển file sang nơi khác rồi gỡ ứng dụng (Gỡ ứng dụng ở tab Docker). Quản lý file của tài khoản hosting, SFTP và lưu trữ S3 đáp ứng phần lớn nhu cầu.
  2. Trong lúc chờ, hãy giới hạn người truy cập được: ở tab Công cụ của website, thêm Thư mục có mật khẩu với thư mục /, để khách phải nhập thêm một mật khẩu trước trang đăng nhập của File Browser. Đừng tạo người dùng File Browser mà bạn không tin tưởng, và giữ tính năng thực thi lệnh ở trạng thái tắt.

Sao lưu: dữ liệu của các ứng dụng cài từ Kho ứng dụng (thư mục /var/lib/zopanel-apps/<instance>/) không nằm trong bản sao lưu tài khoản hay snapshot gia tăng (restic) của ZoPanel. Mỗi ứng dụng có thẻ Sao lưu riêng ở tab Docker: Sao lưu ngay, và với quản trị viên thì có thêm Lịch hằng ngày hoặc hằng tuần, số bản Giữ lại, Khôi phục và xoá. Ứng dụng tạm dừng vài giây trong lúc sao chép dữ liệu. Bản sao lưu nằm trong /var/backups/zopanel-apps (chỉ root đọc được); hãy chép các bản quan trọng ra ngoài server. Xem Sao lưu ứng dụng và lưu trữ S3.

Giới hạn ứng dụng cho khách

Khách tự cài được ứng dụng khi gói hosting cho phép. Đặt giới hạn tại Gói hosting → Ứng dụng Docker:

  • 0 nghĩa là không cho phép cài ứng dụng.
  • Số khác là số ứng dụng tối đa tài khoản được chạy.
  • Mỗi ứng dụng là một website riêng và được tính vào số Website của gói.
  • Giới hạn RAM của mỗi ứng dụng được tính vào RAM (MB) của gói, số tiến trình được tính vào Tiến trình (gồm cả luồng, xem bảng). Gói giữ lại PHP children + 40 tiến trình cho các website, cộng 64 cho mỗi Git deploy chạy server riêng (Node.js, Python, Docker; không tính deploy tĩnh hay PHP).
  • Lượt cài làm vượt bất kỳ mức nào sẽ bị từ chối kèm lý do. Kho ứng dụng cho khách thấy phần còn lại và lý do không cài được.
  • Các kiểm tra này áp dụng cho mọi lượt cài, khách tự cài hay quản trị viên cài hộ. Riêng số lượng ứng dụng là giới hạn của khách: quản trị viên có thể cài thêm cho khách.
  • Máy chủ cũng phải còn chỗ: RAM của ứng dụng phải nằm trong phần RAM dành cho tài khoản hosting (phần còn lại giữ cho hệ thống, tăng theo cỡ máy), và tổng RAM của mọi ứng dụng trên máy được phép tới 150% phần đó (ứng dụng hiếm khi cùng lúc dùng tối đa; giới hạn RAM của tài khoản vẫn luôn được giữ).
Ứng dụng RAM Tiến trình
Memos, Excalidraw, File Browser 256 MB 32
Ghost 768 MB 32
n8n 1024 MB 48
Uptime Kuma 512 MB 48
Gitea 512 MB 96
Vaultwarden 256 MB 96
OpenClaw 2048 MB 160
Open WebUI 2048 MB 176
Nextcloud 1024 MB 192
Metabase 1536 MB 320

Số tiến trình được đo lúc khởi động và khi có 50 request đồng thời, nhân 1,5. Container của mỗi ứng dụng bị giới hạn ở mức đó, nên một ứng dụng không chiếm được phần của website và ứng dụng khác. Ứng dụng chạy với một CPU và thư viện tính toán dùng một luồng cho mỗi CPU, nên chạy như nhau trên mọi cỡ máy chủ.

Khi tài khoản chạm giới hạn tiến trình hoặc RAM (ứng dụng bị dừng, PHP từ chối request), tài khoản và nhà cung cấp được thông báo; tài khoản có ứng dụng cần nhiều hơn gói được liệt kê trên dashboard của nhà cung cấp. Ứng dụng bị dừng hiện là "down" trong giám sát uptime.

Khách chỉ cài được ứng dụng có trong danh mục. Image tuỳ chỉnh chỉ dành cho quản trị viên.

Docker image tuỳ chỉnh

Quản trị viên có thể chạy bất kỳ image công khai nào sau một tên miền bằng Kho ứng dụng → Docker image tuỳ chỉnh. Nhập image, Cổng container, Đường dẫn dữ liệu (tuỳ chọn) và RAM.

Image ngoài danh mục bị tắt cho tới khi root bật trên server:

zopanel ctl feature enable custom-docker

Công tắc này chỉ đổi được trên server, không đổi được từ giao diện web. Nhờ vậy, một phiên đăng nhập panel bị chiếm quyền không thể tự chạy container tuỳ ý.

Deploy bằng image

Tab Deploy của website cũng chạy được mã của bạn trong container:

  • Container (Dockerfile): ZoPanel build từ Dockerfile trong repository.
  • Docker image có sẵn: nhập một image công khai như nginx:1.27 hoặc ghcr.io/owner/app:v2. Nên ghim tag cụ thể. Cổng lấy từ biến PORT hoặc từ EXPOSE của image.

Cả hai cách dùng chung quy trình deploy: health check, chuyển phiên bản không gián đoạn và Rollback về 5 bản release gần nhất. Container chỉ lắng nghe trên 127.0.0.1. Cả hai cách cũng cần chạy zopanel ctl feature enable custom-docker trên server.

Ai được dùng. Mã trong Dockerfile hay image là do khách chọn, nên hai chế độ này chỉ mở cho tài khoản của quản trị viên toàn quyền và cho các gói bật Ứng dụng Docker riêng (trong Gói dịch vụ, mặc định tắt). Đại lý chỉ cấp được khi gói của chính đại lý có quyền này. Tài khoản tạo trước 0.4.8 đang chạy container vẫn chạy tiếp, nhưng lần deploy sau cần bật công tắc trong gói.

Cô lập. Mọi container, kể cả ứng dụng App Store và lúc build image, bị chặn khỏi mạng nội bộ của máy chủ: các dải địa chỉ private và shared, địa chỉ link-local (dịch vụ metadata của cloud tại 169.254.169.254 và fd00:ec2::254) và loopback đều bị từ chối. Các container cũng không thể mở kết nối tới nhau, nên container của khách này không thể gọi thẳng ứng dụng của site khác mà bỏ qua nginx, WAF và khóa cài đặt; điều này đúng bất kể icc trong /etc/docker/daemon.json là gì (ZoPanel cũng đặt nó về false). Trên chính máy chủ, container chỉ tới được các cổng mà internet cũng tới được (web 80/443, mail 25/465/587 và DNS), không tới được cơ sở dữ liệu, Redis hay panel. Nếu không áp được các luật tường lửa này, ZoPanel không chạy và không build container. Container riêng của khách còn bị bỏ mọi Linux capability trừ một danh sách ngắn, không thể nâng quyền, dùng hồ sơ seccomp và AppArmor mặc định của Docker và không bao giờ thấy Docker socket hay thư mục của máy chủ.

Lưu trữ đối tượng S3

Lưu trữ S3 cấp cho khách các bucket tương thích Amazon S3 ngay trên server của bạn. Bucket dùng để lưu ảnh, file tải lên, media hoặc làm đích sao lưu. Engine là Garage, chạy trong container, nên cần có Docker.

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

  1. Mở Lưu trữ S3 và bấm Cài đặt, hoặc cài Lưu trữ S3 trong Thành phần. Dữ liệu nằm tại /var/lib/zopanel-storage.
  2. S3 API chỉ lắng nghe trên 127.0.0.1. Để dùng từ bên ngoài server, trỏ bản ghi A của một tên miền về server rồi dùng Mở ra tên miền. ZoPanel tạo một website reverse proxy có SSL tự động cho tên miền đó.
  3. Ứng dụng kết nối tới https://<tên miền đó> với region us-east-1. Bật path-style trong S3 client.

Gỡ cài đặt xoá container. Dữ liệu được giữ lại, trừ khi bạn tích Xoá luôn toàn bộ dữ liệu và bucket.

Sau khi cài, trang Lưu trữ S3 có thẻ Sao lưu cho toàn bộ bucket, với Sao lưu ngay, lịch và Khôi phục, giống như với ứng dụng. Xem Sao lưu ứng dụng và lưu trữ S3.

Bucket

Mọi tài khoản hosting đều tạo được bucket tại Lưu trữ S3 → Tạo bucket:

  • Tên bucket gồm 3–63 ký tự: chữ thường, số và dấu gạch ngang.
  • Mỗi bucket có khoá truy cập riêng, chỉ dùng được cho bucket đó. Secret chỉ hiển thị một lần. Nếu mất secret, dùng Xoay khoá; khoá cũ ngừng hoạt động ngay.
  • Mỗi bucket bị giới hạn ở phần dung lượng gói còn lại lúc tạo (không bao giờ quá dung lượng đĩa của gói; phải còn ít nhất 64 MB). Bucket tính vào dung lượng đĩa của tài khoản; khi tài khoản vượt mức, bucket không nhận thêm gì cho tới khi giải phóng chỗ.
  • Mỗi tài khoản tạo tối đa 10 bucket. Quản trị viên không bị giới hạn.
  • Gói Free có 1 bucket trên toàn server. Gói Pro không giới hạn.

Trong Cài đặt bucket, bạn có thể khai báo các origin CORS cho website gọi trực tiếp vào bucket. Bạn cũng có thể đặt Tự xóa file sau (ngày) cho log hoặc bản sao lưu xoay vòng. Upload dang dở luôn được dọn sau 7 ngày. Duyệt file cho phép tải lên, tải xuống, xoá file và tạo Link chia sẻ có thời hạn.

Bucket công khai

Tích Công khai để ai cũng đọc được file mà không cần khoá, ví dụ ảnh trên website. Bạn có thể bật hoặc tắt lại bất cứ lúc nào. Khi lưu trữ đã được mở ra tên miền, file công khai có địa chỉ:

https://<tên miền lưu trữ>/<bucket>/<file>

Bucket riêng tư cần khoá hoặc link chia sẻ. File tải xuống từ trình duyệt file của panel luôn được trả về dạng tệp đính kèm.

Khoá bucket dùng được với mọi SDK hoặc plugin S3, như WP Offload Media, driver S3 của Laravel hay AWS SDK.


← Deploy bằng Docker Từng ứng dụng dùng để làm gì →