欢迎回来
登录你的知识库账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属知识库
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

notebasewww.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v0.8.7 · 知识库
笔记
KnowledgeBase
网络无边,知识有迹。
0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →
>
笔记
0
加载中...
工具
0
此页用于记录用户反馈问题后的每一次改进
笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势
// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

ngrok

ngrok — 把你的本地服务暴露到公网,让外网也能访问你的localhost。

如果你是个开发者,肯定遇到过这种场景:你在本地跑了一个项目,想给同事看看效果,或者想用微信/支付宝的支付回调测试,结果对方说“打不开啊,你发个localhost给我有什么用?”——这时候你就需要 ngrok。

这玩意到底能干嘛?

ngrok 的核心就一句话:内网穿透。它会在你的本地机器和 ngrok 的服务器之间建立一条加密隧道,然后给你一个公网可访问的 URL(比如 https://abc123.ngrok.io),所有访问这个 URL 的流量都会被转发到你本地的指定端口。

简单说:你本地跑了 localhost:3000,别人通过 https://xxx.ngrok.io 就能看到你的页面,就跟访问线上网站一样。

它解决的核心痛点就是:开发调试时,让外部网络能访问到你的本地环境。比如:

  • 微信/支付宝的回调接口调试(必须公网能访问)
  • 给远程的同事展示本地Demo
  • 测试Webhook(GitHub、Stripe等)
  • 在手机上调试本地开发的移动端页面
  • 甚至临时搭个HTTP服务让别人下载文件

下载方式

去官网下载对应系统的版本就行,支持 Windows / macOS / Linux,甚至还有 Docker 镜像。

ngrok 官网下载

如果你用 macOS 并且装了 Homebrew,更简单:

brew install ngrok/ngrok/ngrok

Windows 用户可以直接下载 exe 丢到 C:\Windows\System32 或者随便一个 PATH 目录里。

安装方法

其实 ngrok 不需要“安装”,它就是一个单文件可执行程序。下载解压后,你只需要做两件事:

  1. 把 ngrok 放到 PATH 里(方便在终端里直接敲命令)

    • macOS/Linux:把文件放到 /usr/local/bin/
    • Windows:放到一个文件夹,然后加到系统环境变量
  2. 注册账号获取 authtoken(免费版够用)

    • 去 ngrok 官网 注册个账号
    • 登录后进 Dashboard,找到你的 authtoken
    • 在终端执行:
    ngrok config add-authtoken 你的token
    

    这一步是为了绑定你的身份,免费版会有一些限制(比如每秒请求数),但个人开发完全够用。

基础使用教程

最基础用法:暴露一个 HTTP 服务

假设你本地跑了一个 Node.js 服务在 3000 端口:

ngrok http 3000

然后终端会显示:

Forwarding                    https://abc123.ngrok.io -> http://localhost:3000

现在,把 https://abc123.ngrok.io 这个链接发给任何人,他们就能看到你本地的页面了。

暴露 HTTPS 服务

如果你的本地服务是 HTTPS(比如用了自签名证书),加个 https 参数:

ngrok http https://localhost:3000

同时暴露多个端口

免费版只能同时运行一个隧道,但你可以通过配置文件搞多个。或者直接开多个终端窗口,每个跑不同的端口——不过免费版只允许一个活跃隧道,所以这个方法对免费用户无效。

查看请求详情

ngrok 最实用的功能之一是 Web 调试面板。启动隧道后,访问 http://localhost:4040,你能看到所有通过隧道的 HTTP 请求的详细信息,包括:

  • 请求头、响应头
  • 请求体(JSON、表单数据等)
  • 响应体
  • 耗时

这对调试 Webhook 简直是神器——比如微信支付回调,你可以在面板里看到微信到底发了什么数据过来,不用再 console.log 了。

进阶技巧

1. 自定义子域名(免费版有限制)

付费版可以自定义子域名,比如 mydemo.ngrok.io。免费版只能随机生成,但你可以通过配置文件指定一个固定的随机域名?不行,免费版每次重启都会变。不过有个小技巧:用 --hostname 参数(仅限付费版)。免费用户就别想了,老老实实复制链接吧。

2. 用配置文件管理多个隧道

在 ~/.ngrok2/ngrok.yml 里写:

tunnels:
  web:
    proto: http
    addr: 3000
  api:
    proto: http
    addr: 5000

然后启动:

ngrok start web api

注意:免费版只能同时开一个隧道,所以这个功能对免费用户只是方便切换,不能并行。

3. 添加基本认证

如果你不想让所有人都能访问你的隧道,加个用户名密码:

ngrok http 3000 --basic-auth="user:password"

访问时浏览器会弹出登录框。

4. 绑定自定义域名(付费版)

如果你有自己的域名(比如 dev.example.com),可以在 ngrok Dashboard 里添加域名,然后配置 CNAME 到 ngrok 的服务器。启动时:

ngrok http --hostname=dev.example.com 3000

这样别人访问你的域名就能看到本地服务,比用 ngrok 的随机域名专业多了。

5. 用 ngrok 调试 WebSocket

ngrok 原生支持 WebSocket,直接暴露 HTTP 端口就行。比如你的 WebSocket 服务在 8080:

ngrok http 8080

它会自动处理 WebSocket 的升级请求。

6. 静态文件服务器

如果你只是想临时分享一个文件夹里的文件,可以用 Python 或 Node 起个静态服务器,然后用 ngrok 暴露。比如:

# 先起个静态服务器
python3 -m http.server 8000
# 另一个终端
ngrok http 8000

这样别人就能通过 ngrok 链接下载你文件夹里的文件了。

注意事项

  • 免费版限制:每分钟 40 个请求,每次启动的域名随机,不能自定义。但对于开发调试完全够用。
  • 安全:别把 ngrok 隧道长时间开着暴露敏感服务,毕竟所有流量都经过 ngrok 的服务器。用完就关掉。
  • 速度:免费版带宽有限,不适合传输大文件或视频流。
  • 替代品:如果你被墙了或者觉得 ngrok 慢,可以试试 frp、localtunnel、serveo 等开源方案。

总结

ngrok 是每个开发者工具箱里都应该有的小工具。它不复杂,但能解决开发中很多“就差这一步”的尴尬。不管是调试支付回调、给同事展示进度,还是临时搭个外网可访问的服务,它都能让你少折腾很多。

最后提醒一句:用完记得关掉 terminal 或者按 Ctrl+C,不然你的本地服务就一直暴露在公网上了。别问我为什么知道。

编写使用方法
Markdown 格式 · Ctrl+Enter 确定
新建笔记
预览
数据表格
点击单元格编辑 · Tab 移动
A1fx
Sheet1
BIH1H2≡🔗</>
隐私提醒

取消
编辑工具
取消