Tài liệu

Hướng dẫn

Kết nối Hetzner và mở máy chạy tài khoản

Kết nối project Hetzner của bạn để ứng dụng tự tạo và quản lý máy chạy tài khoản Telegram.

Xem Markdown

Bạn kết nối project Hetzner của mình để ứng dụng tự mở máy và cài worker. Hetzner tính tiền hạ tầng trực tiếp cho bạn.

Ai làm được

Chỉ Chủ workspace được kết nối hoặc gỡ token Hetzner. Sau khi đã kết nối, Chủ hoặc Quản lý có thể mở và quản lý máy.

Cần chuẩn bị

Tài khoản Hetzner Cloud đã xác minh thanh toán. Tạo project riêng cho Telegram-Auto để token không có quyền với hạ tầng khác.

Bắt đầu ở đâu

Mở Máy chủ, rồi chọn Kết nối Hetzner.

Các bước

  1. Mở Hetzner Console.

  2. Tạo project riêng cho Telegram-Auto.

  3. Trong project, mở Security → API tokens.

  4. Tạo token có quyền Read & Write.

  5. Sao chép token vào ô Dán token Read & Write của ứng dụng.

  6. Điền Tên project (để bạn nhận ra).

    Hộp kết nối project Hetzner với token được che kín
    Dùng token của project riêng

  7. Bấm Kiểm & kết nối.

  8. Sau khi kết nối thành công, bấm Thêm máy.

  9. Chọn Vùng phù hợp.

  10. Kiểm tra cấu hình, giá và sức chứa dự kiến.

Ứng dụng lấy giá từ Hetzner và chọn loại máy rẻ nhất trong vùng đã chọn, trong số các loại đáp ứng yêu cầu bộ nhớ tối thiểu. Đây không phải cam kết chọn máy rẻ nhất trên toàn bộ các vùng.

Giá hiển thị gồm máy và IPv4, chưa VAT. Không lấy con số giới thiệu cố định làm báo giá. Sức chứa mặc định của máy Hetzner là 40 tài khoản, theo DEFAULT_CAPACITY_HETZNER; hãy đối chiếu sức chứa và mức sử dụng thực tế trên màn hình.

  1. Bấm Mở máy.
  2. Mở chi tiết máy để theo dõi Nhật ký cài đặt.
  3. Chờ tới bước Worker đã kết nối trước khi gắn tài khoản.

Xoá máy

  1. Chuyển tài khoản khỏi máy nếu máy còn tài khoản.
  2. Mở chi tiết máy cần xoá.
  3. Bấm Xoá máy.
  4. Nhập tên máy vào Gõ lại tên máy để xác nhận.
  5. Xác nhận Xoá máy.

Truy cập SSH của hỗ trợ

Trang Máy chủ có thể hiển thị Đội hỗ trợ đang truy cập SSH khi có phiên hỗ trợ tạm thời đang hoạt động.

Giao diện workspace hiện không có bước cấp quyền SSH cho bạn bấm. Công cụ mở và đóng phiên nằm trong khu vực quản trị nền tảng, không phải nút trong chi tiết máy của workspace.

Kết quả

Máy mới xuất hiện trong workspace, được cài worker và có thể nhận tài khoản khi kết nối thành công, còn chỗ và không bị ngừng nhận tài khoản mới.

Kiểm tra

Đối chiếu vùng, giá, trạng thái kết nối và số tài khoản đang dùng. Trong chi tiết máy, kiểm tra nhật ký cài đặt và số đo tài nguyên khi có dữ liệu.

Khi có lỗi

Nếu tạo máy thất bại, đọc nhật ký trước khi dùng Thử tạo lại máy. Nếu token đã bị gỡ, máy có thể vẫn chạy nhưng ứng dụng không còn quản lý Hetzner được; Chủ cần kết nối lại.

Xem máy mất kết nối.

Làm bằng API hoặc MCP

Kết nối và gỡ token Hetzner chỉ dành cho người thao tác trong ứng dụng, không có trang thao tác công khai.

Sau khi kết nối, dùng hetzner.offers, nodes.create_hetzner và nodes.delete. Tên MCP: hetzner_offers, nodes_create_hetzner, nodes_delete.