Tính năng thời gian thực cho backend Go mà không phải tự vận hành máy chủ WebSocket
· Hibira
Gửi sự kiện thời gian thực, cấp quyền kênh private và presence, xác minh webhook từ Go bằng thư viện chính thức pusher-http-go, còn trình duyệt kết nối tới Hibira.

Go là ngôn ngữ rất hợp để viết máy chủ WebSocket, nên nhiều đội nghĩ ngay đến việc tự làm: một hub, mỗi kết nối một goroutine, có sự kiện là phát đi. Trên một máy, cách này chạy tốt. Nhưng khi phải chạy từ hai máy trở lên, làm presence (ai đang trực tuyến), xử lý kết nối lại và việc chuyển kết nối trong lúc deploy, WebSocket không còn là một tính năng mà trở thành một hệ thống phải vận hành.
Cách còn lại là để backend Go chỉ quyết định gửi gì, còn việc giữ hàng chục nghìn kết nối thì giao cho dịch vụ được lưu trữ sẵn. Hibira dùng giao thức Pusher Channels, nên bạn có thể dùng ngay thư viện Go chính thức của Pusher, pusher-http-go, và pusher-js trên trình duyệt. Bài này đi qua năm việc: tạo client, gửi sự kiện, cấp quyền cho kênh private và presence, kết nối front end, và nhận webhook.
Bước 1: Cài đặt và tạo client
go get github.com/pusher/pusher-http-go/v5Tạo một client khi khởi động, đọc App ID, key và secret từ biến môi trường (bạn sẽ thấy chúng sau khi tạo ứng dụng), rồi truyền nó cho các handler hoặc service cần gửi sự kiện:
import pusher "github.com/pusher/pusher-http-go/v5"
func newRealtime() *pusher.Client {
return &pusher.Client{
AppID: os.Getenv("HIBIRA_APP_ID"),
Key: os.Getenv("HIBIRA_APP_KEY"),
Secret: os.Getenv("HIBIRA_APP_SECRET"),
Host: "ws.hibira.io",
Secure: true,
// Đặt sẵn khi khởi động thay vì để thư viện tự tạo ở yêu cầu đầu tiên
HTTPClient: &http.Client{Timeout: 3 * time.Second},
}
}Dòng HTTPClient có lý do của nó. Nếu không đặt, pusher-http-go sẽ tạo một http.Client với thời gian chờ 5 giây ở yêu cầu đầu tiên rồi ghi ngược vào client. Nếu nhiều goroutine cùng gửi lần đầu một lúc, đó là data race, và go test -race sẽ phát hiện. Hãy tự đặt khi khởi động, nhân tiện chọn thời gian chờ phù hợp với dịch vụ của bạn.
Bước 2: Gửi sự kiện
Gửi là một lệnh gọi HTTP. Lấy ví dụ một đơn hàng vừa được giao đi:
func shipOrder(rt *pusher.Client, w http.ResponseWriter, r *http.Request) {
order := Order{ID: 1024, Status: "shipped"}
// … ghi trạng thái đơn hàng vào cơ sở dữ liệu trước …
socketID := r.Header.Get("X-Socket-ID") // do front end gửi lên, có thể rỗng
if err := rt.TriggerExclusive("private-user-42", "order-updated", order, socketID); err != nil {
log.Printf("realtime: %v", err) // gửi thất bại cũng không hủy đơn hàng
}
json.NewEncoder(w).Encode(order)
}Vài lưu ý thực tế:
- Ghi cơ sở dữ liệu trước, rồi mới gửi. Sự kiện thời gian thực là thông báo, không phải nguồn dữ liệu gốc. Client kết nối lại nên tải lại từ API của bạn thay vì dựa vào những sự kiện có thể đã bị lỡ.
- Bỏ qua người gửi. Truyền socket ID của front end cho
TriggerExclusivethì tab thực hiện thay đổi sẽ không nhận lại cập nhật của chính nó. Khi muốn gửi cho tất cả,Triggerthông thường là đủ. - Gửi nhiều cái một lần. Khi một yêu cầu cập nhật nhiều kênh, dùng
TriggerMulti(cùng một sự kiện cho nhiều kênh) hoặcTriggerBatch(các sự kiện khác nhau) để giảm số lượt đi về. - Đừng bắt yêu cầu phải chờ. Nếu việc gửi nằm trên đường xử lý nhạy cảm với độ trễ, hãy chuyển cho một goroutine nền hoặc hàng đợi tác vụ, nhưng vẫn phải xử lý lỗi và gửi nốt phần còn lại khi tắt dịch vụ.
Lưu ý bảo mật: X-Socket-ID chỉ là gợi ý để tránh gửi lại sự kiện về tab khởi tạo, không phải bằng chứng xác thực người dùng. Hãy phân quyền kênh dựa trên session hoặc JWT đã được máy chủ xác minh, kiểm tra dữ liệu biểu mẫu và từ chối yêu cầu quá lớn thay vì âm thầm cắt bớt.
Bước 3: Cấp quyền cho kênh private và presence
Trước khi đăng ký kênh bắt đầu bằng private- hoặc presence-, client sẽ xin máy chủ của bạn một chữ ký. Dịch vụ Go của bạn cung cấp endpoint này, nên ai được xem kênh nào hoàn toàn do code của bạn quyết định:
func pusherAuth(rt *pusher.Client) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
user, ok := currentUser(r) // bước kiểm tra session hoặc JWT của bạn
if !ok {
http.Error(w, "unauthorized", http.StatusUnauthorized)
return
}
body, err := io.ReadAll(http.MaxBytesReader(w, r.Body, 4096))
if err != nil {
http.Error(w, "bad request", http.StatusBadRequest)
return
}
form, err := url.ParseQuery(string(body))
if err != nil {
http.Error(w, "bad request", http.StatusBadRequest)
return
}
channel := form.Get("channel_name")
if (!strings.HasPrefix(channel, "private-") && !strings.HasPrefix(channel, "presence-")) || !user.CanJoin(channel) {
http.Error(w, "forbidden", http.StatusForbidden)
return
}
var resp []byte
if strings.HasPrefix(channel, "presence-") {
resp, err = rt.AuthorizePresenceChannel(body, pusher.MemberData{
UserID: user.ID,
UserInfo: map[string]string{"name": user.Name},
})
} else {
resp, err = rt.AuthorizePrivateChannel(body)
}
if err != nil {
http.Error(w, "forbidden", http.StatusForbidden)
return
}
w.Header().Set("Content-Type", "application/json")
w.Write(resp)
}
}Thư viện chỉ ký, không kiểm tra quyền, nên bạn phải tự viết bước CanJoin. Lỗi thường gặp là chỉ kiểm tra người dùng đã đăng nhập hay chưa, khiến bất kỳ ai đã đăng nhập cũng đăng ký được private-user-42. UserInfo của kênh presence được gửi tới mọi thành viên trong kênh, nên chỉ đặt vào những thông tin được phép chia sẻ.
Nối ba endpoint bằng các pattern của http.ServeMux từ Go 1.22 trở đi:
rt := newRealtime()
mux := http.NewServeMux()
mux.HandleFunc("POST /orders/{id}/ship", func(w http.ResponseWriter, r *http.Request) { shipOrder(rt, w, r) })
mux.HandleFunc("POST /pusher/auth", pusherAuth(rt))
mux.HandleFunc("POST /pusher/webhook", pusherWebhook(rt))
log.Fatal(http.ListenAndServe(":8080", mux))Bước 4: Kết nối front end
Trên trình duyệt, trỏ host của pusher-js tới Hibira và endpoint cấp quyền tới dịch vụ Go của bạn:
import Pusher from 'pusher-js';
const pusher = new Pusher('your-app-key', {
cluster: 'hkg',
wsHost: 'ws.hibira.io',
wsPort: 443,
wssPort: 443,
forceTLS: true,
enabledTransports: ['ws', 'wss'],
channelAuthorization: { endpoint: '/pusher/auth', transport: 'ajax' },
});
pusher.subscribe('private-user-42').bind('order-updated', (order) => {
renderOrder(order);
});
// Gửi socket ID kèm các lệnh gọi API của bạn để máy chủ bỏ qua tab này
await fetch('/orders/1024/ship', {
method: 'POST',
headers: { 'X-Socket-ID': pusher.connection.socket_id },
});Yêu cầu cấp quyền mang theo cookie của trình duyệt, nên nếu front end và dịch vụ Go dùng chung tên miền, session hiện có dùng được ngay. Nếu dùng JWT, thêm header Authorization trong channelAuthorization.headers. Ứng dụng di động cũng vậy: PusherSwift và pusher-java-client đều cho đặt host và endpoint cấp quyền.
Bước 5: Nhận webhook
Để biết khi nào một kênh có người đăng ký đầu tiên, hay ai vừa vào hoặc rời một kênh presence, hãy đặt URL webhook trên trang ứng dụng. pusher-http-go kiểm tra header X-Pusher-Key và chữ ký HMAC giúp bạn:
func pusherWebhook(rt *pusher.Client) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
body, err := io.ReadAll(http.MaxBytesReader(w, r.Body, 1<<20))
if err != nil {
http.Error(w, "bad request", http.StatusBadRequest)
return
}
hook, err := rt.Webhook(r.Header, body) // kiểm tra X-Pusher-Key và chữ ký
if err != nil {
http.Error(w, "invalid signature", http.StatusUnauthorized)
return
}
for _, e := range hook.Events {
switch e.Name {
case "member_added":
markOnline(e.UserID)
case "member_removed":
markOffline(e.UserID)
}
}
w.WriteHeader(http.StatusOK)
}
}Webhook gom các sự kiện trong một khoảng ngắn vào một yêu cầu. Nếu endpoint của bạn không trả về 2xx, Hibira sẽ gửi lại trong tối đa năm phút, nên việc xử lý phải idempotent: nhận cùng một member_added hai lần thì kết quả vẫn như nhau. Nếu xử lý lâu, hãy trả 200 trước rồi chuyển việc cho tác vụ nền.
Kiểm tra trước khi chạy thật
- Đã chạy code gửi sự kiện với
go test -race. - Việc cấp quyền kênh private kiểm tra người dùng này có được xem kênh này không, chứ không chỉ kiểm tra đã đăng nhập.
- App secret chỉ nằm trong biến môi trường hoặc dịch vụ quản lý bí mật, không có trong version control hay code front end.
- Trong bảng điều khiển gỡ lỗi trên trang ứng dụng, đã thấy sự kiện được gửi, lượt đăng ký và webhook.
Phần thiết lập Go cơ bản cũng có trong hướng dẫn tích hợp Go, và khi mở từ trang ứng dụng, host của bạn được điền sẵn. Nếu cần thông báo đẩy, hướng dẫn thông báo đẩy có ví dụ Go. Để xem trọn một tình huống, hãy tham khảo theo dõi đơn hàng và cộng tác và trạng thái trực tuyến. Nếu bạn viết code bằng Claude Code hoặc một trợ lý AI khác, bạn có thể để nó lấy hướng dẫn tích hợp Go qua máy chủ MCP của Hibira và sửa dự án giúp bạn.