> App trên MONA Cloud có URL HTTPS và chứng chỉ Let’s Encrypt tự động. Thêm domain riêng qua MCP hoặc API, trỏ CNAME, chờ DNS rồi mới chuyển traffic.

Nguồn: https://monacloud.vn/docs/domain-va-ssl · Cập nhật: 2026-09-14

# Trỏ domain và chuẩn bị SSL

App từ repo public đã LIVE với URL HTTPS và chứng chỉ Let’s Encrypt tự động. Bạn thêm domain riêng bằng `cloud_app_domain_add` hoặc `POST /api/apps/{app_id}/domains`; API trả hướng dẫn CNAME. Chờ DNS và kiểm tra chứng chỉ trước khi chuyển traffic.

## App được cấp URL và SSL thế nào?

`POST /api/apps` deploy repo public lên app host riêng, cấp URL `https://<repo>-<mã>.app.monacloud.vn` có chứng chỉ Let's Encrypt. [Repo Node.js mẫu](https://github.com/themonagroup/monacloud-example-node) đã chạy tại [URL đang hoạt động](https://monacloud-example-node-3fb5b2.app.monacloud.vn).

**Số đo 05/09/2026:** host đầu tiên ~150 giây, deploy 10–20 giây.

## Thêm domain riêng bằng API thế nào?

Đặt API/token theo [bắt đầu nhanh](https://monacloud.vn/docs/bat-dau-nhanh), thay ID app và hostname bạn sở hữu:

Thêm domain riêng cho app

```
export APP_ID="<app-id-that>"
curl -sS -X POST "$MONACLOUD_API/api/apps/$APP_ID/domains" \
  -H "Authorization: Bearer $MONACLOUD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"host":"app.example.com"}'
```

MCP tương ứng là `cloud_app_domain_add` với `app_id` và `host`. API trả loại bản ghi, tên, đích CNAME và SSL đang chờ. Dùng đúng đích trả về; CNAME trỏ vào hostname, không trỏ vào IP.

## DNS đã đúng có nghĩa HTTPS đã xong chưa?

Chưa. Chờ DNS phân giải đúng và quá trình cấp chứng chỉ hoàn tất, sau đó kiểm tra HTTPS. Với VPS tự quản, đọc IP/hostname service và cấu hình web server, chứng chỉ theo dự án.

**Tránh xung đột bản ghi:** không tạo đồng thời A và CNAME cho cùng hostname.

## Kiểm tra gì trước khi đổi domain?

Thử đăng nhập, callback, upload, link tuyệt đối và chứng chỉ. Giữ cách quay lại bản cũ khi chuyển traffic. Sandbox trả URL/DNS mô phỏng; không trỏ domain thật vào đó. Xem [địa chỉ IP và mạng](https://monacloud.vn/docs/dia-chi-ip-va-mang).

## Prompt mẫu cho AI

Prompt thêm domain riêng · không chứa secret

```
Đọc cloud_app_get, kiểm tra URL HTTPS của app đang chạy. Sau khi tôi xác nhận domain, gọi cloud_app_domain_add với app_id và hostname tôi sở hữu. Đọc hướng dẫn CNAME, chờ DNS và kiểm chứng chỉ; không báo SSL đã xong khi còn pending.
```