使用 Ngrok 快速搭建本地开发测试环境

发布时间：2026/10/19 23:31:23

使用 Ngrok 快速搭建本地开发测试环境
在软件开发过程中我们经常会遇到以下场景1. 第三方回调调试开发支付接口、微信开放平台或 Webhook 时服务商要求提供一个公网可访问的 HTTPS 域名。2. 移动端实机测试手机与电脑不在同一局域网下需要直接测试本地 API。3. 临时演示展示向客户或同事展示本地刚开发好的前端/后端 Demo无需打包部署到云服务器。Ngrok 是一款轻量级、跨平台的反向代理工具它可以建立一条安全的隧道Tunnel将公网流量安全地转发到你的本地端口完美解决上述痛点。二、Ngrok 工作原理简析Ngrok 的核心架构采用 **客户端-服务端C/S模式**[ 外网用户/第三方回调 ]│▼[ Ngrok 云端转发节点 ]│ (安全加密隧道)▼[ 本地 Ngrok 客户端 ]│▼[ 本地 Web 服务 (如 localhost:8080) ]1. 在本地运行 Ngrok 客户端并建立与 Ngrok 云端服务器的持久长连接。2. Ngrok 为你分配一个随机或自定义的公网 URL。3. 当外部请求访问该公网 URL 时流量会被封装并穿透 NAT/防火墙安全送达你的本地服务。三、Ngrok 快速上手指南1. 注册账号与获取 AuthToken1. 访问 Ngrok 官方网站注册免费账号。2. 进入控制台Dashboard在 **Your Authtoken** 页面复制你的专属身份验证令牌。2. 下载并安装客户端根据你的操作系统选择对应的版本解压Windows解压得到 ngrok.exe。macOS推荐通过 Homebrew 安装bashbrew install ngrok/ngrok/ngrokLinux使用官方软件包或二进制解压即可。3. 配置身份凭证打开终端或命令行工具运行以下命令绑定你的账号bashngrok config add-authtoken 你的AuthToken四、核心应用场景演练场景一暴露本地 HTTP Web 服务假设你的本地 Web 服务运行在 8080 端口如 Spring Boot、Vue、Node.js 项目bashngrok http 8080**运行效果**终端会输出如下控制面板信息textSession Status onlineAccount YourName (Plan: Free)Forwarding https://xxxx-xx-xx.ngrok-free.app - http://localhost:8080此时访问 [https://xxxx-xx-xx.ngrok-free.app](https://xxxx-xx-xx.ngrok-free.app) 即可直接访问你本地的 localhost:8080 服务场景二带 Header 重写的代理适用于微服务/网关如果本地服务对 Host 请求头有校验可以使用 --host-header 参数bashngrok http --host-headerrewrite 8080五、高级技巧与调试利器1. 本地请求监控面板 (Web Inspection)Ngrok 启动后默认会在本地开启一个强大的调试面板[http://127.0.0.1:4040](http://127.0.0.1:4040)。功能解析你可以实时查看传入的 HTTP 请求头、请求体、响应状态码甚至可以点击 **Replay** 按钮重新发送某个请求在调试 Webhook 回调时极其高效。2. 避免配置文件泄露注意不要将包含 authtoken 的配置文件提交到 Git 等公开仓库中。配置文件默认路径* Windows: %HOMEPATH%\AppData\Local\ngrok\ngrok.yml* Linux/macOS: ~/.config/ngrok/ngrok.yml

相关新闻

Node.js入门教程（十七）：Buffer（缓冲区）

Node.js入门教程（十七）：Buffer（缓冲区）

一、什么是 Buffer？JavaScript 语言自身只有字符串数据类型，没有二进制数据类型。Node.js 中的 Buffer 类是用于处理二进制数据的核心工具，提供了对二进制数据的高效操作。Buffer 类在处理文件操作、网络通信、图像处理等场景中特别有用。Buf…

2026/10/19 21:29:16 阅读更多 →
Java AI客户端源码拆解：从HTTP请求到流式响应的工程实践

Java AI客户端源码拆解：从HTTP请求到流式响应的工程实践

1. 项目概述：为什么我们要拆解一个AI对话客户端？最近在团队里做技术分享，聊到AI应用开发，发现一个挺有意思的现象：很多同事对调用ChatGPT、文心一言这类大模型的API接口很熟，但当你问他“从你点击发送按钮到…

2026/10/18 13:43:49 阅读更多 →
3分钟实现GitHub界面中文化：免费开源插件的完整指南

3分钟实现GitHub界面中文化：免费开源插件的完整指南

3分钟实现GitHub界面中文化：免费开源插件的完整指南 【免费下载链接】github-chinese GitHub 汉化插件，GitHub 中文化界面。 (GitHub Translation To Chinese) 项目地址: https://gitcode.com/gh_mirrors/gi/github-chinese 你是否曾经因为GitHub…

2026/10/19 17:22:43 阅读更多 →

最新新闻

AI率过高怎么办？九款降AI率工具与避坑指南

AI率过高怎么办？九款降AI率工具与避坑指南

上个月帮一位在外地项目上常驻的在职朋友看论文。他发来一张截图，检测系统提示“疑似AI生成内容占比接近四成”，导师在批注里连续写了好几遍——这几段请你按自己的话重写。他挺委屈：内容确实是自己对着调研材料一点一点整理出来的&#xff0…

2026/10/19 23:26:19 阅读更多 →
开源代码评审工作流：本地化、可审计、可定制的LLM实践方案

开源代码评审工作流：本地化、可审计、可定制的LLM实践方案

1. 项目概述：这不是一个“工具”，而是一套可落地的开源代码评审工作流“open-code-review”这个名字乍一听像某个新发布的 CLI 工具，或者某家大厂刚开源的 AI 代码审查平台。但实际翻遍 GitHub、Hugging Face 和主流技术社区，你会…

2026/10/19 23:26:19 阅读更多 →
基于YOLO11的无人机检测识别系统设计与实现

基于YOLO11的无人机检测识别系统设计与实现

一提到毕设做深度学习目标检测，十个里有八个都在刷COCO、VOC数据集，真正能落到现实问题上的反而不多。但“空域安全无人机检测识别”这个方向不一样，它直接对准了一个真实且刚需的场景——机场周边、重要场馆、活动安保都需要防范低空慢速小目…

2026/10/19 23:23:08 阅读更多 →
BP-PID残差补偿控制：Simulink中可解释的神经网络增强型PID实现

BP-PID残差补偿控制：Simulink中可解释的神经网络增强型PID实现

简介：本资源是一套基于Simulink实现BP神经网络自整定PID控制器的完整工程实践材料，面向自动化、控制工程及人工智能交叉领域的高校学生、科研人员与工业控制工程师，解决传统PID参数依赖经验整定、适应性差、动态响应不足等实际问题。压缩包共…

2026/10/19 23:18:58 阅读更多 →
STM32 SD卡数据落盘实战：fatfs移植与CSV文件生成

STM32 SD卡数据落盘实战：fatfs移植与CSV文件生成

简介：这份资源面向嵌入式开发学习者与STM32工程师，聚焦在STM32F429平台上集成FatFS文件系统、驱动SD卡写入数据并生成.csv文件，同时结合以太网驱动搭建TCP服务器接收网络数据。内容覆盖FatFS的移植与参数配置、SDIO或SPI方式下的SD卡初始化与…

2026/10/19 23:16:55 阅读更多 →
AI视频生成工作流：从产品拆解到批量成片的完整指南

AI视频生成工作流：从产品拆解到批量成片的完整指南

去年年底接了一个电商代运营团队的活儿，帮他们把带货短视频从“每周人工憋3条”改成“一天批量出20条成片”。项目做完以后，团队里负责剪辑的同事跟我说了一句话，让我印象特别深：以前最怕的不是剪片子，而是想不出脚本、…

2026/10/19 23:05:36 阅读更多 →

日新闻

频率跟踪型PWM电源设计：臭氧发生器谐振点漂移与软开关实现

频率跟踪型PWM电源设计：臭氧发生器谐振点漂移与软开关实现

简介：本资源为电源技术方向的学术研究文档，聚焦介质阻挡放电型臭氧发生器电源的频率跟踪型PWM控制策略，面向电力电子、高压电源及臭氧应用领域的科研人员与工程技术人员。针对负载呈容性、等效电容随外加电压升高而增大、谐振频率随之漂移的难…

2026/10/19 0:00:47 阅读更多 →
Vibe Coding 遇上 TaoToken：把开发者思维圣殿的灵感流接入统一 Key 通道

Vibe Coding 遇上 TaoToken：把开发者思维圣殿的灵感流接入统一 Key 通道

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/19 0:00:47 阅读更多 →
HundredCV-Chat话题建模实战教程：利用4,871个内置话题标签构建主题分析系统

HundredCV-Chat话题建模实战教程：利用4,871个内置话题标签构建主题分析系统

【免费下载链接】HundredCV-Chat 项目地址： https://ai.gitcode.com/hf_mirrors/Jax-dan/HundredCV-Chat 点击查看 免费下载 HundredCV-Chat 是一个由 100 位青年简历数据开发而来的中文多轮对话数据集，共包含 24,750 组日常闲聊对话和 4,871 个话题标签…

2026/10/19 0:00:47 阅读更多 →

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型（GMM）的语音识别系统，很多人第一反应就是一堆数学公式，觉得门槛很高。但如果你真的在MATLAB里把它落地跑通，会发现核心其实就是三件事：把声音变成特征向量，用GMM给每个类别…

2026/10/19 10:02:04 阅读更多 →
数字图像处理入门：反白、灰度化、调色板修改与导出txt实践

数字图像处理入门：反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人，但落到具体操作上，无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程：对图像做反白、改调色板、彩色转灰度，最后把像素数据导出成txt文件。单看每一…

2026/10/19 17:32:41 阅读更多 →
机器人大脑技术盘点：具身智能的感知、决策与数据闭环

机器人大脑技术盘点：具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词，你会发现一个很有意思的现象：每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型，有人指的是运动控制系统，还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/19 1:30:52 阅读更多 →

月新闻

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/19 2:54:50 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/19 9:10:22 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/18 12:16:16 阅读更多 →