# Truy cập từ xa

Cho agent đám mây gọi tới máy qua đường hầm hoặc tên miền HTTPS, hay chỉ chia sẻ trong một mạng riêng đáng tin cậy.

Source: https://muse4ai.lovable.app/vi/docs/remote-access · Cập nhật 2026-11-02

## Trước khi bắt đầu

- Bật API cho agent và tạo khoá riêng cho agent từ xa.
- Giữ máy thức và app hoạt động trong lúc agent từ xa cần kết nối.
- Địa chỉ công khai giúp gọi được máy chủ; nó không bỏ yêu cầu dùng khoá.

## 1. Chọn nơi được kết nối

Mở Cài đặt › API & agent. Các lựa chọn là Chỉ máy này, Mạng riêng, Đường hầm tạm thời và Đường hầm có tên.

## 2. Dùng đường hầm tạm thời

Xác nhận chia sẻ công khai và chờ đường hầm trực tuyến. App dùng cloudflared. Địa chỉ thay đổi mỗi lần app khởi động, nên bạn cần cập nhật agent đám mây sau khi mở lại.

## 3. Chọn địa chỉ cố định khi cần

Đường hầm có tên dùng cấu hình Cloudflare và tên miền của bạn. Phần tên miền riêng có thể phục vụ HTTPS trực tiếp bằng App tự chạy HTTPS với Caddy, hoặc Proxy HTTPS có sẵn như Caddy, nginx hay IIS. Làm theo bước kiểm tra DNS và kết nối; các cách này có thể chạy cùng đường hầm.

## 4. Chỉ chia sẻ riêng khi có đường kết nối

Mạng riêng dành cho thiết bị có thể gọi tới máy bạn qua LAN hoặc mạng riêng như Tailscale. Nó không tự trở thành liên kết công khai cho dịch vụ đám mây.

## 5. Chép địa chỉ và hạn chế chia sẻ

Dùng địa chỉ công khai hiện tại với /mcp cho MCP hoặc /v1 cho REST, kèm khoá của agent. Tắt chia sẻ khi không cần; nếu đã bật tên miền riêng, hãy tắt cả phần đó.

```text
https://your-tunnel.trycloudflare.com/mcp
Authorization: Bearer msk_YOUR_KEY
```

## Kiểm tra thành công

Agent từ xa cần dùng đọc được trạng thái bằng khoá riêng, còn các cách chia sẻ không cần thiết đã tắt.

## Nếu không chạy

### Vì sao liên kết hôm qua không còn dùng được?

Địa chỉ đường hầm tạm thời đổi khi app khởi động. Chép địa chỉ hiện tại vào agent lần nữa.

### Vì sao URL công khai vẫn cần khoá?

Đường hầm chỉ đổi khả năng kết nối, không đổi quyền truy cập. Thao tác được bảo vệ vẫn cần khoá còn hiệu lực.

### Tắt đường hầm có tắt tên miền không?

Tên miền được cấu hình riêng và có thể chạy cùng đường hầm. Kiểm tra cả hai hoặc tắt toàn bộ API.
