Bắt đầu nhanh

Hướng dẫn này đi từ tài khoản mới tới issue đầu tiên. Phần lớn là bấm trong ứng dụng Belvador; code duy nhất bạn viết là phần cài SDK trong ứng dụng của bạn.

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

• Một địa chỉ email cho tài khoản Belvador.

• Một ứng dụng xác thực trên điện thoại (ví dụ Google Authenticator, 1Password hoặc Authy). Cần bật xác thực 2 lớp trước khi kết nối Hetzner.

• Một tài khoản Hetzner Cloud đã có phương thức thanh toán. Hetzner tính tiền máy chủ cho bạn theo giá giờ; Belvador miễn phí trong giai đoạn beta.

• Ứng dụng bạn muốn theo dõi, và quyền sửa code của nó.

1. Tạo tài khoản#

1. Trên belvador.dev, chọn Bắt đầu miễn phí.

2. Nhập tên, email và mật khẩu, rồi xác nhận email Belvador gửi tới (Kiểm tra email của bạn).

3. Đăng nhập. Khi chưa có workspace, Belvador mở màn hình Tạo workspace.

2. Tạo workspace#

Workspace chứa các project, cảnh báo, thành viên và một node trong tài khoản Hetzner của bạn.

1. Nhập Tên workspace.

2. Kiểm tra Địa chỉ workspace: 3–40 ký tự, chữ thường, chữ số và dấu gạch ngang. Địa chỉ này nằm trong mọi đường dẫn và không đổi được về sau.

3. Chọn Tạo workspace.

3. Bật xác thực 2 lớp#

Tiếp theo Belvador hiện màn hình Bảo vệ tài khoản. Cần xác thực 2 lớp trước khi kết nối Hetzner hoặc đổi vai trò, và các thao tác nhạy cảm sau này sẽ hỏi lại mã mới.

1. Quét mã QR bằng ứng dụng xác thực (hoặc gõ mã bí mật hiện bên dưới).

2. Nhập mã 6 số.

3. Cất Mã khôi phục ở nơi an toàn. Mỗi mã dùng được một lần và chỉ hiện lúc này.

Bạn có thể chọn Để sau, nhưng bước kết nối Hetzner sẽ yêu cầu lại. Chi tiết: Tài khoản, xác thực 2 lớp và vai trò.

4. Kết nối Hetzner#

Trong Belvador, mở Node → Kết nối Hetzner, rồi trong Hetzner Console:

1. Tạo project mới tên “Belvador”. Project riêng nghĩa là token chỉ điều khiển được máy của Belvador — đặt các máy chủ khác của bạn ở project khác.

2. Tạo API token: trong project đó mở Security → API Tokens → Generate API token, chọn quyền Read & Write.

3. Sao chép ngay. Hetzner chỉ hiện token một lần.

Dán token vào Belvador và chọn Chế độ giữ khoá:

• Managed (khuyên dùng) — két giữ token đã mã hoá, nên đổi cỡ, dựng lại và xoá máy chạy tự động.

• Strict — két xoá token ngay khi node sẵn sàng; các thao tác sau sẽ yêu cầu bạn dán token tạm. Chỉ owner được chọn Strict.

Token được gửi thẳng tới két của Belvador, không đi qua ứng dụng Belvador hay cơ sở dữ liệu. Thêm: Kết nối Hetzner và dựng node.

5. Dựng node#

Chọn Dựng node. Belvador chọn máy rẻ nhất phù hợp — cx23, hoặc cax11 (ARM) khi cx23 hết hàng — tại Falkenstein, Nuremberg hoặc Helsinki, và hiển thị từng bước: Kiểm token → Tạo tường lửa → Tạo máy → Khởi động máy → Ghi danh agent → Gia cố máy → Kết nối edge → Cài phần mềm node → Kiểm sức khoẻ → Sẵn sàng.

Trong thử nghiệm của chúng tôi việc này mất khoảng 90 giây; có thể lâu hơn khi Hetzner bận. Bạn có thể rời trang — việc dựng vẫn chạy ở nền. Nếu một bước lỗi, dòng thời gian chỉ rõ bước nào và có nút Thử lại từ bước này.

Node không mở cổng vào nào, kể cả SSH. Node chỉ kết nối ra ngoài.

6. Tạo project#

1. Mở Project → Tạo project.

2. Đặt tên ứng dụng và chọn nền tảng: JavaScript (trình duyệt), React (Vite / SPA), TanStack Start / Lovable, Node.js, Python hoặc Khác.

3. Belvador hiện ngay DSN của project và code cài đặt.

Mỗi ứng dụng một project. Xem Project và DSN.

7. Cài SDK#

Làm theo phần cài đặt trên trang project, hoặc bài hướng dẫn cho nền tảng của bạn — code giống nhau:

Làm cùng AI agent lập trình? Trang project có mục Dán vào AI agent, và Hướng dẫn cho AI agent nói rõ agent phải giữ nguyên những gì.

8. Kiểm tra kết nối#

Một issue đầu tiên chưa chứng minh mọi phần của app đều báo lỗi. Bước cuối của Cài SDK — và tab Kết nối của project — có phép kiểm cho nền tảng của bạn: chạy một lần từ mỗi môi trường (trình duyệt và, với TanStack Start, cả máy chủ). Mỗi môi trường chuyển sang Đã xác minh sau vài giây; nếu có gì sai, sự cố hiện kèm cách sửa. Xem Kiểm tra kết nối.

Muốn thấy một issue thật, hãy tạo một lỗi trong ứng dụng, ví dụ trong hàm xử lý của một nút bấm:

setTimeout(() => {  throw new Error("Belvador test error");}, 0);

Lỗi hiện trong Issue sau vài giây, kèm stack trace, tag và ngữ cảnh.

Việc tiếp theo#

• Mời đồng đội ở Cài đặt → Thành viên — xem vai trò.

• Kết nối bot Telegram, Slack hoặc email của bạn trong Cảnh báo.

• Tải source map lên từ CI để stack trace hiện code gốc.

• Đọc Bảo vệ dữ liệu trước khi gửi dữ liệu thật.

• Thêm monitor cho cron job, hàng đợi và worker, để cả job không hề chạy cũng được phát hiện.