跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Javajava

基于内网穿透实现本地 WebSocket 服务公网访问

综述由AI生成演示了如何在无公网 IP 环境下,通过内网穿透工具将本地 Java WebSocket 服务端暴露至公网,并使用 Go 语言客户端进行连接测试。主要步骤包括配置 SpringBoot Netty 环境、安装并认证穿透工具、创建 TCP 隧道映射端口,以及编写客户端代码验证通信。解决了异地联调需部署云服务器的问题,简化了调试流程。

落日余晖发布于 2026/3/15更新于 2026/4/2616 浏览
基于内网穿透实现本地 WebSocket 服务公网访问

前言

本地 WebSocket 服务通常只能在局域网内使用,例如与异地同事联调时,需要对方连入同一局域网或部署到云服务器,费时费力。利用内网穿透工具可以将本地服务映射到公网,无需公网 IP 和复杂配置,方便实时通信应用的调试和多端联调。

1. Java 服务端 Demo 环境
  • JDK 1.8
  • 框架:SpringBoot + Maven
  • 工具:IDEA
2. 在 pom 文件引入第三包封装的 Netty 框架 Maven 坐标
<dependency>
    <groupId>io.github.fzdwx</groupId>
    <artifactId>sky-http-springboot-starter</artifactId>
    <version>0.10.6</version>
</dependency>

注意:pom 文件中需注释掉 SpringBoot Web 启动器,Web 启动器默认是 Tomcat 服务启动,会和 Netty 服务冲突。

3. 创建服务端,以接口模式调用,方便外部调用
@GetMapping("/getConnect")
public void getConnect(HttpServerRequest request) {
    request.upgradeToWebSocket(ws -> {
        ws.mountOpen(h -> {
            ws.send("连接成功,开始聊天吧!");
        });
        ws.mountText(s -> {
            System.out.println(s); // 对方回复
            System.out.println("客户端回复:" + s);
            Scanner scanner = new Scanner(System.in);
            String next = scanner.next();
            ws.send(next);
        });
    });
}
4. 启动服务,出现以下信息表示启动成功,暴露端口默认 9999
5. 创建隧道映射内网端口

这里使用内网穿透工具来映射内网端口,支持 HTTP/HTTPS/TCP 协议,不限制流量,无需公网 IP,也不用设置路由器。

  • 一键安装脚本(国内用户):
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
  • 查看版本信息:
cpolar version

如果正常显示,则安装成功。

  • Token 认证: 进入后台,点击左侧的'验证',可以查看到 token 码,复制并执行命令进行认证。
cpolar authtoken xxxxxxxxxxxxxxxxxx
  • 配置开机自启动:
sudo systemctl enable cpolar
  • 守护进程方式,启动 cpolar:
sudo systemctl start cpolar
  • 查看守护进程状态,如正常为 active,则为正常启动状态:
sudo systemctl status cpolar

安装成功后,默认会配置两个默认隧道,可自行删减或者修改。接着把本地服务通过工具暴露到公网,浏览器访问 http://127.0.0.1:9200,登录 Web UI 界面,创建一个 TCP 隧道,指向 9999 端口。

注意:该隧道选择的是临时 TCP 地址和端口,24 小时内会变化。如需固定 TCP 地址,可升级为专业套餐做 TCP 地址固定。

6. 查看状态->在线隧道,复制所创建隧道的公网地址加端口号

此时,WebSocket 服务端已经从本地 localhost 暴露至公网,接着我们创建一个客户端测试公网访问 Socket 服务端连接。

7. 以基于 Go 的 Socket 客户端为例,通过公网连接 Java Socket 服务端
  • Go 版本:1.19
  • 工具:VSCode
8. 通过 Git 下载 WebSocket 框架
go get github.com/gorilla/websocket
9. 创建客户端,注意:Host 值为上面复制的隧道公网地址!!
package main

import (
    "fmt"
    "log"
    "net/url"
    "github.com/gorilla/websocket"
)

func main() {
    // 定义服务端的地址
    u := url.URL{
        Scheme: "ws",
        Host: "3.tcp.vip.cpolar.cn:10793", // 地址为复制隧道的公网地址
        Path: "/eth/getConnect",           // 服务端 controller 映射地址
    }

    // 与服务端建立连接
    c, _, err := websocket.DefaultDialer.Dial(u.String(), nil)
    if err != nil {
        log.Fatal("dial:", err)
    }
    defer c.Close()

    // 阻塞主线程
    down := make(chan byte)

    // 启动一个线程,读取从服务端发送过来的数据
    go func() {
        for {
            _, message, _ := c.ReadMessage()
            fmt.Println("服务端回复:" + string(message))
        }
    }()

    // 启动一个线程输入消息
    go func() {
        for {
            var input string
            fmt.Scanln(&input)
            c.WriteMessage(websocket.TextMessage, []byte(input))
        }
    }()

    for {
        <-down
    }
}
10. 接着启动服务,与服务端连接,出现服务端返回的字样表示连接成功
11. 客户端在控制台输入信息,回车
12. 服务端出现客户端发送的信息
13. 服务端控制台输入消息,回车
14. 客户端收到服务端回复的消息,连接成功

需要注意,免费使用内网穿透工具所生成的公网地址为随机临时地址,24 小时内会发生变化。如果需要长期远程连接,建议为其配置固定的 TCP 端口地址。即登录后,点击预留,保留一个固定 TCP 端口地址,然后将其配置到相应的隧道中即可。

目录

  1. 前言
  2. 1. Java 服务端 Demo 环境
  3. 2. 在 pom 文件引入第三包封装的 Netty 框架 Maven 坐标
  4. 3. 创建服务端,以接口模式调用,方便外部调用
  5. 4. 启动服务,出现以下信息表示启动成功,暴露端口默认 9999
  6. 5. 创建隧道映射内网端口
  7. 6. 查看状态->在线隧道,复制所创建隧道的公网地址加端口号
  8. 7. 以基于 Go 的 Socket 客户端为例,通过公网连接 Java Socket 服务端
  9. 8. 通过 Git 下载 WebSocket 框架
  10. 9. 创建客户端,注意:Host 值为上面复制的隧道公网地址!!
  11. 10. 接着启动服务,与服务端连接,出现服务端返回的字样表示连接成功
  12. 11. 客户端在控制台输入信息,回车
  13. 12. 服务端出现客户端发送的信息
  14. 13. 服务端控制台输入消息,回车
  15. 14. 客户端收到服务端回复的消息,连接成功
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • InnoExtract 高级技巧:自定义编译选项与静态链接配置
  • Python 使用 Streamlit 提取 PDF 文档文字
  • OPENWEBUI 与传统手工开发电商详情页效率对比
  • ESP32 小智 AI 机器人语音对话系统设计与云端部署
  • Python 基于大数据的手机商品数据分析
  • 大模型书籍精选:从理论到工程实践的快速选型指南
  • AI 产品经理入门指南:核心职责、技能体系与实战路径
  • 自动化批量挖掘 SRC 漏洞实战指南
  • React 与 Ant Design 4.5.4 Modal 表单验证实战
  • JWT 详解:原理、流程与 Spring Boot 实战
  • 二叉树核心算法实战:深度计算与先序遍历还原
  • 基于大模型的自然语言数据库查询与数据分析
  • 世界职业院校技能大赛人工智能赛道解析
  • CLion + MSYS2 MinGW64 C++ 开发环境配置指南
  • 深入理解链表:从基础到实践
  • 基于 ESP32-C5 的 Moji 2.0 小智 AI 桌面机器人开源方案
  • 链表带环检测与入口定位:快慢指针法原理及实现
  • AI 领域今日动态:NVIDIA GTC 发布 GR00T N2 与 Claude Code 上下文突破
  • Quartus Prime FPGA 开发入门:从安装到工程落地
  • 从三年前端到韩国 CS 硕士:留学复盘与回归前端之路

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online