当前位置：首页 > 文章列表 > Golang > Go教程 > Golang搭建跨域WebSocket服务教程

Golang搭建跨域WebSocket服务教程

2025-09-28 12:12:34 0浏览收藏

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《Golang打造跨域WebSocket服务教程》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

利用 Golang 构建支持跨域 WebSocket 服务

WebSocket 协议与 HTTP 协议不同，其跨域机制也不同于基于 HTTP 的 CORS (Cross-Origin Resource Sharing)。CORS 主要依赖于服务器返回的 HTTP 头部来控制跨域访问，而 WebSocket 则依赖于客户端发送的 "origin" 头部。

理解 WebSocket 的 Origin 头部

当客户端（通常是浏览器中的 JavaScript 代码）发起 WebSocket 连接时，浏览器会自动添加一个名为 "origin" 的 HTTP 头部。这个头部的值就是包含该 JavaScript 代码的 HTML 页面的源（协议、域名和端口）。服务器可以读取这个 "origin" 头部，并根据自身的策略来决定是否允许该连接。

Golang WebSocket 服务器的实现

使用 Golang 构建 WebSocket 服务器通常会使用 golang.org/x/net/websocket 包。以下是一个简单的例子，展示了如何读取 "origin" 头部并做出相应的处理：

package main

import (
    "fmt"
    "log"
    "net/http"

    "golang.org/x/net/websocket"
)

func echoHandler(ws *websocket.Conn) {
    origin := ws.Request().Header.Get("Origin")
    fmt.Println("Origin:", origin)

    // 在这里可以根据 origin 的值来决定是否允许连接
    allowedOrigins := []string{"http://example.com", "http://localhost:8080"}
    allowed := false
    for _, allowedOrigin := range allowedOrigins {
        if origin == allowedOrigin {
            allowed = true
            break
        }
    }

    if !allowed {
        log.Println("拒绝来自", origin, "的连接")
        ws.Close()
        return
    }


    var message string
    err := websocket.Message.Receive(ws, &message)
    if err != nil {
        log.Println("Receive error:", err)
        return
    }

    fmt.Println("Received message:", message)

    err = websocket.Message.Send(ws, message)
    if err != nil {
        log.Println("Send error:", err)
        return
    }
}

func main() {
    http.Handle("/echo", websocket.Handler(echoHandler))
    log.Println("Server started on :12345")
    log.Fatal(http.ListenAndServe(":12345", nil))
}

代码解释：

ws.Request().Header.Get("Origin") 用于获取客户端发送的 "origin" 头部的值。
allowedOrigins 变量定义了一个允许的源列表。
代码遍历 allowedOrigins 列表，检查客户端的 "origin" 是否在允许列表中。如果不在，则拒绝连接。
如果 "origin" 在允许列表中，则继续处理 WebSocket 连接。

注意事项：

在生产环境中，allowedOrigins 列表应该从配置文件或其他数据源中读取，而不是硬编码在代码中。
应该对 "origin" 的值进行严格的验证，以防止恶意攻击。

PhoneGap/WebView 环境下的问题

在使用 PhoneGap 或其他 WebView 环境时，需要注意以下几点：

"origin" 头部可能为空： 如果 HTML 页面是从本地文件系统加载的（例如 file:/// 协议），某些 WebView 可能会省略 "origin" 头部。
调试： 使用开发者工具（例如 Safari 的 Web Inspector）来检查 PhoneGap 应用发送的 WebSocket 请求的头部信息。可以使用网络抓包工具（如 Wireshark）来查看更详细的网络流量。

解决方案：

服务器端放宽限制： 如果确定 "origin" 头部为空是由于 WebView 的限制，可以在服务器端允许空的 "origin"。但是，这会降低安全性，应该谨慎使用。
```
if origin == "" {
    // 允许空的 origin (不推荐，降低安全性)
    allowed = true
}
```
使用代理服务器： 在客户端和服务器之间设置一个代理服务器，代理服务器可以修改或添加 "origin" 头部。
使用 Cordova 插件： 有些 Cordova 插件可以帮助你配置 WebSocket 连接的头部信息。

总结

构建支持跨域的 WebSocket 服务需要理解 WebSocket 的 "origin" 头部，并根据实际情况进行配置。在使用 PhoneGap 或其他 WebView 环境时，需要特别注意 "origin" 头部可能为空的问题，并采取相应的解决方案。请始终牢记安全性，谨慎处理跨域请求。

以上就是《Golang搭建跨域WebSocket服务教程》的详细内容，更多关于的资料请关注golang学习网公众号！