SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Cài Cloudron trên VPS Ubuntu: DNS và yêu cầu

Cài Cloudron trên VPS Ubuntu mới với 3 lệnh và 1 lần reboot. Biết yêu cầu Ubuntu, DNS wildcard, RAM cho 2 đến 10 app, mail, TLS và backup.

Cài Cloudron trên VPS: bản tóm tắt

Để cài Cloudron trên VPS, bạn cần một máy chủ Ubuntu mới, ít nhất 2 GB RAM và một domain có thể chỉnh sửa bản ghi DNS. Quá trình cài đặt chỉ gồm 3 lệnh và 1 lần reboot. Hầu hết lỗi xảy ra trước bước này (chọn sai base image, sai loại virtualization) hoặc sau đó (DNS, mail, backup).

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

Cloudron cài đặt, cập nhật, backup và cấp chứng chỉ TLS (transport layer security) cho các app tự host. Mỗi app chạy trong Docker, nginx đứng trước toàn bộ các app và mỗi app có một subdomain riêng trong domain của bạn. Vì vậy, việc cấu hình DNS phải được thực hiện trước.

Vì sao Cloudron yêu cầu khắt khe về hệ điều hành nền

Script cài đặt kiểm tra server trước khi cài bất kỳ thành phần nào. Nếu một kiểm tra thất bại, bạn phải tạo server mới. Hãy đọc các yêu cầu này trước khi chọn image. Các kiểm tra của installer được trích dẫn trong phần này là từ ngày 13 tháng 10 năm 2026; tài liệu cài đặt hiện tại yêu cầu một server Ubuntu 26.04 mới.

  • Chỉ hỗ trợ Ubuntu và chỉ hỗ trợ 3 bản phát hành. Các hệ điều hành khác đều thoát với Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 bị từ chối, còn tài liệu cài đặt hiện yêu cầu một server Ubuntu 26.04 mới. Debian, Rocky và Alpine không được hỗ trợ. Ubuntu 24.04 cần Cloudron 8 hoặc mới hơn, và script sẽ tự kiểm tra điều đó.
  • Chỉ hỗ trợ Intel hoặc AMD 64-bit: Error: Cloudron only supports amd64/x86_64. VPS ARM không chạy được.
  • Chỉ hỗ trợ ảo hóa phần cứng đầy đủ. Trên VPS dựa trên container, script dừng với Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualization vì phát hiện container bằng systemd-detect-virt --container. KVM được hỗ trợ. OpenVZ và LXC không được hỗ trợ.
  • Root filesystem phải là ext4 hoặc xfs. Nếu dùng loại khác, bạn sẽ nhận Error: Cloudron requires '/' to be ext4 or xfs. Đây là lý do image btrfs và zfs thất bại.
  • Cần ít nhất 941 MB RAM, được đo bằng free -m, và 18 GB trên /, được đo theo kích thước của root filesystem. Thông báo lỗi yêu cầu 20GB, nhưng bản thân kiểm tra chấp nhận root filesystem 19 GB.
  • Server phải thực sự mới. Nếu nginx, docker hoặc node đã được cài đặt, script sẽ từ chối và trả về Error: Some packages like nginx/docker/nodejs are already installed.

Đây là kiểm tra thường gây tranh luận nhất, nên cần hiểu lý do. Cloudron cài các phiên bản cố định của Docker, nginx, Node.js và MySQL, ghi cấu hình nginx cho mọi app mà nó host, đồng thời tự quản lý các rule firewall của iptables. Docker bạn cài từ hôm qua có thể không đúng phiên bản, nên script sẽ thoát mà không thay đổi gì và yêu cầu bạn bắt đầu với một bản cài Ubuntu mới. Cloudron quản lý toàn bộ máy, vì vậy hãy cấp cho nó một VPS riêng.

Có một kiểm tra khác cũng dễ bị bỏ sót. Trên CPU cũ không có AVX (advanced vector extensions), script sẽ in CPU has no AVX support. MongoDB will be disabled, và mọi app cần MongoDB sẽ không thể cài đặt. Hãy kiểm tra CPU trước khi cam kết bằng grep -m1 -o avx /proc/cpuinfo. Lệnh này in avx trên host có khả năng tương thích và không in gì trên máy cũ.

Cloudron cần bao nhiêu RAM?

Trình kiểm tra của installer ngày October 13, 2026 từ chối chạy khi RAM dưới 941 MB, với Error: Cloudron requires atleast 1GB physical memory; tài liệu hiện tại yêu cầu 2 GB RAM và 20 GB disk. Cả hai con số này chỉ là mức tối thiểu cho platform, không phải cho platform cộng với các app của bạn. Cloudron chạy Docker, nginx, service box riêng và mail stack, đồng thời provision các database service dùng chung khi bạn deploy app. Chạy docker ps trên một bản cài mới rồi đếm chúng.

Giới hạn memory của app được tính thêm trên mức cơ sở đó. Mỗi app package có một giới hạn mặc định thấp; bạn tăng giới hạn này bằng slider trong mục Resources của app. Khi app vượt giới hạn, app sẽ restart và gửi notification OOM (out of memory). Vì vậy, một máy liên tục restart một app thường là do giới hạn memory, không phải do bug.

Đây là cấu hình tôi sẽ đặt mua. Đây là khuyến nghị cho một server mà bạn không phải rebuild vào tháng sau. Các con số này không phải kết quả benchmark đo thực tế.

Biểu đồCloudron VPS sizing floor by number of apps
Dữ liệu đằng sau biểu đồ này
[
  {
    "label": "2 apps (free tier)",
    "vcpu": 2,
    "ram_gb": 4,
    "disk_gb": 60
  },
  {
    "label": "5 apps",
    "vcpu": 4,
    "ram_gb": 8,
    "disk_gb": 120
  },
  {
    "label": "10 apps",
    "vcpu": 6,
    "ram_gb": 16,
    "disk_gb": 240
  }
]

Hai app chạy ổn với 4 GB RAM và 60 GB disk. Khoảng mười app cần 16 GB RAM và 240 GB disk, vì phần base của platform không giảm và mỗi app thêm một Docker image, một database cùng dữ liệu riêng. Disk đầy nhanh hơn nhiều người nghĩ: image, dữ liệu app và backup cục bộ dùng chung một volume cho đến khi bạn chuyển backup ra khỏi máy.

Cloudron cấp cho mỗi app swap không giới hạn, vì vậy giới hạn memory bạn đặt chỉ áp dụng cho RAM. Trên VPS image không có swap file, swapon --show không in ra gì, và áp lực memory chuyển thẳng thành các lần restart do OOM thay vì làm app chạy chậm. Thêm 2 GB swap là một biện pháp dự phòng rẻ, nhưng không thay thế RAM thực. Chênh lệch giữa các gói VPS nhỏ hơn nhiều so với số giờ bạn sẽ mất để tinh chỉnh giới hạn, vì vậy hãy xem chi phí thực tế của một VPS và mua gói lớn hơn kế tiếp.

DNS: bản ghi wildcard để các subdomain của app hoạt động

Cloudron đặt dashboard tại my.example.com và mỗi app trên một subdomain riêng, vì vậy DNS là điều kiện tiên quyết chứ không phải việc làm sau. Trỏ các bản ghi sau đến địa chỉ IP public của server trước khi mở dashboard lần đầu:

  • my.example.com dưới dạng bản ghi A. Đây là dashboard.
  • *.example.com dưới dạng bản ghi A. Đây là bản ghi giúp các subdomain của app hoạt động, vì vậy wiki.example.com và git.example.com sẽ phân giải ngay khi bạn cài các app đó.
  • example.com dưới dạng bản ghi A, chỉ khi bạn muốn chạy một app trên domain gốc.

Bản ghi wildcard có độ ưu tiên thấp hơn bản ghi cụ thể, nên bản ghi www.example.com hiện có và đang trỏ đến nơi khác vẫn tiếp tục hoạt động.

Trong quá trình setup, bạn chọn cách Cloudron xử lý DNS từ thời điểm đó:

  • Một API provider. Cloudron lưu token cho Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS và các provider khác (tổng cộng 22 tích hợp API DNS, không bao gồm Wildcard, Manual và No-op), sau đó tự ghi mọi bản ghi, bao gồm cả các bản ghi mail.
  • Wildcard. Bạn tự thêm bản ghi * và Cloudron không ghi gì.
  • Manual. Cloudron hiển thị từng bản ghi và chờ bạn thêm bản ghi đó trước mỗi lần cài app.

Bản ghi DNS wildcard không phải là chứng chỉ wildcard. Provider chứng chỉ mặc định là Let's Encrypt Prod - Wildcard. Provider này xác minh quyền sở hữu qua DNS, nên chỉ hoạt động với API provider. Với backend Wildcard hoặc Manual, Let's Encrypt cấp từng chứng chỉ riêng và xác minh qua HTTP, nên cần cổng inbound 80 để cấp và gia hạn chứng chỉ. Bạn có thể tắt tích hợp Let's Encrypt và upload chứng chỉ wildcard tùy chỉnh, nhờ đó cổng 80 không còn là yêu cầu cố định để xác minh chứng chỉ. Nếu registrar hoặc DNS host của bạn có trong danh sách API, hãy dùng provider đó: các bản ghi mail và chứng chỉ đều không còn là việc bạn phải tự quản lý.

Hãy xác minh trước khi tiếp tục. dig +short my.example.com và dig +short anything.example.com đều phải in ra địa chỉ IP của server. Với backend Wildcard, nếu truy vấn wildcard không in ra gì, các app sẽ lỗi về sau trong khi dashboard vẫn hoạt động bình thường.

Nếu domain nằm sau Cloudflare, hãy đặt các bản ghi ở chế độ DNS only. Proxy chỉ chuyển tiếp HTTP và HTTPS, nên các cổng mail sẽ bị lỗi. Với các web app dùng proxy, mục Network của Cloudron hỗ trợ tin cậy các dải IP public của Cloudflare để lấy lại địa chỉ của visitor từ các forwarded header.

Chạy script thiết lập

wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setup

Chạy script với quyền root hoặc thông qua sudo, vì nếu không, dòng đầu tiên được in ra sẽ là This script should be run as root.. Quá trình cài đặt mất vài phút và không hiển thị nhiều trong lúc chạy, vì output của apt và các lần pull Docker được ghi vào một file log. Theo dõi log từ một phiên SSH thứ hai:

tail -f /var/log/cloudron-setup.log

Trong lần kiểm tra installer ngày 13 tháng 10 năm 2026, script in ra After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup., tiếp theo là địa chỉ của server, rồi hỏi The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Trả lời yes. Installer đó cũng cung cấp flag --skip-reboot để hoãn việc restart.

Khởi động lần đầu: domain, backend DNS và tài khoản admin

Mở https://<server-ip> và chấp nhận cảnh báo của trình duyệt. Certificate là self-signed vì Cloudron chưa biết domain của bạn, nên chưa có thông tin để yêu cầu certificate authority cấp certificate. Trong Chrome, nhấp vào Advanced, rồi Proceed to <ip> (unsafe). Trong Firefox, nhấp vào Advanced, rồi Accept the Risk and Continue.

Màn hình đầu tiên yêu cầu domain của bạn. Nhập example.com và dashboard sẽ dùng địa chỉ my.example.com. Bạn cũng có thể dùng một subdomain như cloudron.example.com; khi đó dashboard sẽ ở my.cloudron.example.com. Chọn backend DNS, dán API token nếu bạn có, rồi tạo tài khoản admin bằng địa chỉ email mà bạn thực sự kiểm tra thường xuyên. Cloudron dùng địa chỉ này để reset password và gửi thông báo của platform.

Khi bạn lưu, Cloudron sẽ yêu cầu cấp certificate và chuyển dashboard sang https://my.example.com. URL dùng IP address sẽ ngừng hoạt động từ thời điểm đó, nên hãy bookmark URL mới.

Chứng chỉ: thành phần nào gia hạn và khi nào quá trình dừng

Gia hạn chứng chỉ được thực hiện tự động theo ACME Renewal Information (ARI), tức lịch do certificate authority công bố. Trên thực tế, chứng chỉ thường được gia hạn khoảng một tháng trước khi hết hạn. Nếu gia hạn thất bại, hệ thống sẽ gửi email đến tài khoản quản trị. Nếu chứng chỉ hết hạn, hệ thống sẽ chuyển sang chứng chỉ self-signed tích hợp sẵn. Đây là nguyên nhân khiến trình duyệt hiển thị cảnh báo trên một site vẫn hoạt động bình thường vào hôm qua.

Phần lớn lỗi xuất phát từ hai nguyên nhân. HTTP validation cần port 80 cho lưu lượng đi vào. Vì vậy, đóng port 80 với lý do “mọi thứ đều dùng HTTPS” sẽ làm hỏng quá trình gia hạn đối với các app dùng Let's Encrypt HTTP validation trên backend Wildcard hoặc Manual DNS. DNS validation cần một API token vẫn còn quyền ghi. Vì vậy, xoay vòng hoặc thu hẹp quyền của token này sẽ âm thầm làm hỏng quá trình gia hạn cho đến khi email cảnh báo được gửi.

Trong chế độ xem Domains có nút Renew All để buộc thử gia hạn ngay lập tức và có provider Let's Encrypt Staging để kiểm thử. Trình duyệt cố ý không tin cậy các chứng chỉ Staging. Đây chính là mục đích của chúng: kiểm thử mà không tiêu tốn rate limit production. Staging có các giới hạn riêng, bao gồm 200 lỗi authorization cho mỗi identifier, mỗi account, mỗi giờ.

Có nên dùng mail server tích hợp sẵn không?

Cloudron cung cấp một mail stack hoàn chỉnh với mailbox IMAP, submission, bộ lọc sieve và chữ ký DKIM (domainkeys identified mail). Bạn bật tính năng này cho từng domain trong mục Email của dashboard. Phần khó là đưa mail đến nơi nhận, và Cloudron không chịu trách nhiệm cho những khó khăn đó.

  • Hầu hết nhà cung cấp VPS chặn port 25 để kiểm soát spam. Một số nhà cung cấp sẽ mở chặn sau khi bạn gửi support ticket. Kiểm tra từ server bằng nc -zv aspmx.l.google.com 25 (cài netcat-openbsd nếu máy chưa có command này). Lệnh báo cáo các port đang mở là succeeded. Khi port bị chặn, kết nối sẽ treo cho đến khi timeout.
  • Nhà cung cấp VPS thiết lập bản ghi PTR (reverse DNS), không phải DNS host của bạn. Khi gửi mail trực tiếp từ server, PTR phải khớp với mail hostname. Smart host loại bỏ yêu cầu PTR này.
  • Trên DNS backend có API, hệ thống tự tạo các bản ghi SPF, DKIM và DMARC cho bạn. Với backend Wildcard hoặc Manual, bạn phải tự thêm các bản ghi này. Nếu thiếu bản ghi DKIM, mọi message bạn ký đều không thể xác minh.
  • Cấu hình phù hợp với hầu hết người dùng là nhận mail trên Cloudron và gửi mail qua một relay như SendGrid, Postmark, Mailgun hoặc Amazon SES. Bạn cấu hình relay trong giao diện Email. Relay phải cho phép gửi mail bằng mọi địa chỉ thuộc domain của bạn. Nếu không, notification từ các app dùng sender khác nhau sẽ bị từ chối. Nếu mail là lý do chính khiến bạn mua server, hãy chạy một mail server riêng như Mailcow trên một máy riêng với IP reputation riêng.

Nếu không dùng Cloudron Email, hãy block các port 25, 465, 587, 993 và 4190 trong firewall của nhà cung cấp. Hãy block tại đó, không block trên server, vì Cloudron tự ghi các rule iptables và mặc định quản lý chúng. Điều này trái ngược với VPS thông thường, nơi bạn tự quản lý các rule ufw.

Cấu hình đích backup trước khi cần dùng

Mặc định, backup được lưu trên filesystem cục bộ tại /var/backups, cùng ổ đĩa với mọi thành phần khác. Tài liệu nêu rất rõ: "Lưu backup trên cùng ổ đĩa vật lý với server platform là nguy hiểm." Một ổ đĩa hỏng sẽ làm mất cả ứng dụng lẫn backup.

Mở Backups, sau đó chọn Backup Sites, rồi cấu hình đích lưu trữ khác ngay từ ngày đầu tiên. Object storage tương thích với S3 là lựa chọn phổ biến (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces hoặc một bucket MinIO trên server thứ hai). Ngoài ra, hệ thống cũng hỗ trợ các đích SSHFS, NFS, CIFS và filesystem thông thường.

Ba thiết lập quyết định backup đó có thực sự hữu ích hay không:

  • Định dạng. tgz tạo một compressed archive cho mỗi app và upload lại toàn bộ archive ở mỗi lần chạy. rsync chỉ upload các file đã thay đổi, giúp giảm chi phí đáng kể với một instance Nextcloud lớn, nhưng tạo ra nhiều request hơn đến storage API.
  • Mã hóa. Tùy chọn này dùng AES-256 để mã hóa cả nội dung file và filename. Cloudron không lưu bản sao password, vì vậy nếu mất password thì không ai có thể giải mã backup, kể cả bạn. Hãy lưu password trong password manager tự host trước khi bấm save.
  • Chính sách lưu giữ. Giá trị được nhập dưới dạng số lượng, chẳng hạn 7 bản daily và 4 bản weekly. Thời gian lưu giữ dài trên object storage sẽ phát sinh phí hàng tháng, nên hãy chọn số lượng mà bạn sẵn sàng tiếp tục trả phí.

Sau đó, hãy kiểm tra việc restore. Cài một app nhỏ, restore app đó từ dashboard và theo dõi quá trình khôi phục cùng dữ liệu của app. Một bản backup chưa từng được restore chỉ là một giả định.

Giới hạn của gói miễn phí

Tính đến tháng 10 năm 2026, gói miễn phí giới hạn ở 2 ứng dụng đã cài đặt. Gói này vẫn bao gồm mọi thứ khác: cập nhật ứng dụng, backup riêng cho từng ứng dụng, firewall, mail server và single sign-on. Khi thêm ứng dụng thứ 3, bạn cần mua licence. Các gói trả phí bỏ giới hạn số lượng ứng dụng. Gói cao hơn còn thêm user group và role, directory server và nhiều site backup. Giá có thể thay đổi, vì vậy hãy xem trang giá Cloudron thay vì dựa vào một con số trong tutorial.

Một licence chỉ áp dụng cho 1 Cloudron install. Vì vậy, 2 server nhỏ sẽ có chi phí gấp đôi 1 server lớn. Cách tính giá này khiến phần lớn người dùng chọn 1 VPS lớn hơn, trái với khuyến nghị thường thấy là phân tán các service trên nhiều máy. Hãy tính kích thước server dựa trên điều đó, vì nếu tách các service sau này, bạn sẽ phải trả chi phí 2 lần.

Khi có lỗi

Bắt đầu bằng công cụ kiểm tra tích hợp sẵn. Công cụ này lần lượt kiểm tra DNS, certificate, disk, memory và từng service, đồng thời cho biết test nào không đạt:

sudo cloudron-support --troubleshoot

Sau đó, dùng các công cụ systemd (system và service manager) thông thường. systemctl status box hiển thị trạng thái của chính Cloudron service, journalctl -u box -n 100 hiển thị log gần đây của service này, còn journalctl -u docker kiểm tra container runtime bên dưới. Mọi lỗi xảy ra trong quá trình cài đặt đều được ghi trong /var/log/cloudron-setup.log.

Nếu dashboard không tải được, nguyên nhân thường là DNS hoặc firewall của nhà cung cấp, không phải Cloudron. Chạy dig +short my.example.com từ laptop của bạn và xác nhận các cổng 80 và 443 đã được mở trong network firewall của nhà cung cấp. Đây là một lớp kiểm soát riêng với rule của chính server. Trong lần kiểm tra của installer ngày October 13, 2026, lần chạy thứ hai bị từ chối với Error: Cloudron is already installed. To reinstall, start afresh; cách xử lý đúng là rebuild server.

Khi Cloudron không phù hợp

Cloudron phù hợp khi bạn muốn chạy các ứng dụng thay vì tự quản lý hạ tầng. Cloudron không phù hợp khi bạn muốn tự quản lý các container theo cách của mình, vì nó quản lý nginx, Docker và firewall, đồng thời sẽ ghi đè các cấu hình bạn đặt tại đó. Nếu kế hoạch của bạn là quản lý một thư mục chứa các file compose, Traefik đứng trước các stack Docker Compose của bạn sẽ cung cấp TLS tự động và định tuyến subdomain tương tự mà không thêm một platform bên trên. Nếu bạn chưa chọn giải pháp, so sánh Cloudron, CasaOS và Coolify sẽ đặt chúng cạnh nhau, còn danh sách đầy đủ hơn về những gì có thể tự host là điểm bắt đầu phù hợp hơn so với một hướng dẫn cài đặt.

FAQ

Cloudron cần bao nhiêu RAM trên VPS?

Bản kiểm tra installer ngày 13 tháng 10, 2026 từ chối chạy khi RAM dưới 941 MB; tài liệu hiện tại yêu cầu 2 GB, nhưng đó chỉ là mức tối thiểu cho platform khi chưa cài app nào. Cloudron chạy Docker, nginx, service box riêng và mail stack, đồng thời provision các database service dùng chung khi bạn deploy app. Dành 4 GB cho hai app và 16 GB cho khoảng mười app, đồng thời tạo swap file, vì Cloudron cho phép app dùng swap không giới hạn và máy không có swap sẽ biến áp lực bộ nhớ thành các lần restart.

Tôi có thể cài Cloudron trên Debian hoặc trên server đã chạy Docker không?

Cả hai trường hợp đều không được. Trong lần kiểm tra installer ngày 13 tháng 10, 2026, script dừng khi gặp release không được hỗ trợ với Cloudron requires Ubuntu 22.04, 24.04, 26.04 và từ chối các server đã có nginx, docker hoặc node. Tài liệu cài đặt hiện tại yêu cầu image Ubuntu mới và không hỗ trợ Debian, Rocky hoặc Alpine. Hãy bắt đầu với một image Ubuntu mới trên KVM VPS.

Tại sao các app subdomain không hoạt động trong khi dashboard vẫn hoạt động?

Trên backend Wildcard, hãy kiểm tra wildcard DNS record. Quy trình setup tạo hoặc yêu cầu một A record cho my.example.com, nên dashboard phân giải được, trong khi wiki.example.com trả về NXDOMAIN và browser báo không tìm thấy site. Thêm A record cho *.example.com trỏ đến IP của server, rồi xác nhận bằng dig +short wiki.example.com trước khi cài app.

Tôi có bắt buộc phải dùng mail server của Cloudron không?

Không. Bạn có thể tắt email đến và gửi email qua một relay bên ngoài như Postmark, Mailgun hoặc Amazon SES. Đây là lựa chọn an toàn hơn khi provider chặn outbound port 25 hoặc địa chỉ IP chưa có uy tín gửi mail. Nếu bỏ qua hoàn toàn Cloudron Email, hãy đóng các port 25, 465, 587, 993 và 4190 trong firewall của provider thay vì trên server.

Điều gì xảy ra khi tôi đạt giới hạn hai app trong free plan?

Bạn cần subscription trả phí để cài app thứ ba. Các app đang chạy không bị ảnh hưởng: chúng vẫn được update, vẫn được backup và vẫn giữ certificate. Thêm subscription sẽ gỡ giới hạn mà không cần cài lại, nên free plan là cách hợp lý để thử platform trước trên một domain thật.

Bài viết này có hữu ích không?