Dynamic DNS

Tự động giữ bản ghi DNS đồng bộ với địa chỉ IP thay đổi bằng một URL có token bảo mật.

Tổng quan​

Dynamic DNS cho phép bạn trỏ một tên miền phụ (ví dụ home.yourdomain.com) tới một thiết bị có địa chỉ IP thay đổi theo thời gian, như máy chủ tại nhà hoặc router. Thay vì cập nhật bản ghi thủ công, bạn gọi một URL riêng và bản ghi DNS được cập nhật ngay lập tức.

Cách hoạt động​

1. Tạo một mục Dynamic DNS cho tên miền phụ bạn sở hữu.
2. Bạn nhận được một URL cập nhật riêng chứa token bí mật.
3. Mỗi khi IP thay đổi, gửi một yêu cầu HTTP GET đơn giản tới URL đó: từ tác vụ cron, router hoặc bất kỳ HTTP client nào.
4. Bản ghi DNS A được tự động cập nhật thành địa chỉ IP của bên gọi.

Tạo mục​

1. Vào HiTechCloud > Tên miền > Dynamic DNS.

2. Nhấn Thêm mục.

3. Điền biểu mẫu:

   Trường	Mô tả
   Tên miền	Tên miền gốc bạn sở hữu (ví dụ yourdomain.com)
   Tên miền phụ	Tên miền phụ cần cập nhật (ví dụ home) — chỉ chữ cái, chữ số và dấu gạch ngang
   IP ban đầu	Địa chỉ IP khởi đầu. Mặc định là 0.0.0.0 và được thay thế ở lần gọi cập nhật đầu tiên

4. Nhấn Tạo. Mục của bạn sẽ xuất hiện trong bảng kèm URL cập nhật.

Cập nhật IP​

Gửi một yêu cầu HTTP GET thông thường tới URL cập nhật:

https://HITECHCLOUD_URL:2083/dynamic-dns/update?token=YOUR_TOKEN

Bản ghi được cập nhật thành địa chỉ IP của máy gửi yêu cầu.

Ví dụ yêu cầu curl:

curl "https://HITECHCLOUD_URL:2083/dynamic-dns/update?token=YOUR_TOKEN"

Ví dụ phản hồi:

{
  "status": "updated",
  "host": "home.yourdomain.com",
  "ip": "203.0.113.42",
  "updated": "2025-06-07T14:32:00Z"
}

Quản lý các mục​

Từ trang Dynamic DNS, bạn có thể:

• Sao chép URL cập nhật: nhấn biểu tượng sao chép bên cạnh token được rút gọn.
• Sửa một mục: đổi tên miền phụ hoặc đặt địa chỉ IP thủ công. Token được giữ nguyên.
• Xoá một mục: xoá bản ghi DNS và vô hiệu vĩnh viễn token. Không thể hoàn tác.

Ghi chú​

• Mọi bản ghi Dynamic DNS có TTL cố định là 300 giây (5 phút).
• Chỉ hỗ trợ bản ghi A (IPv4).
• Endpoint cập nhật không yêu cầu xác thực, vì vậy hãy giữ token bí mật.
• Nếu nghi ngờ token đã bị lộ, hãy xoá mục đó và tạo mục mới.

Khắc phục sự cố​

IP không cập nhật. Kiểm tra yêu cầu GET trả về phản hồi 200. 404 nghĩa là token không hợp lệ hoặc mục đã bị xoá. 400 nghĩa là thiếu tham số token.

IP bị ghi sai. Nếu thiết bị của bạn ở sau proxy hoặc NAT, request.remote_addr phản ánh IP của proxy. Hãy gửi yêu cầu cập nhật từ chính thiết bị có IP bạn muốn đăng ký, hoặc cấu hình router gọi URL trực tiếp.

Thay đổi DNS chưa lan truyền. TTL là 300 giây. Hãy chờ tối đa 5 phút để các resolver nhận bản ghi mới sau khi cập nhật.