花生壳 CLI 内网穿透 · 使用帮助
更新日期:2026-11-13 18:15:11
适用对象:有自建网站需求,不想折腾服务器、日常依赖办公智能体的用户
一句话概括:你在自己电脑上跑起来的东西,可以让别人通过一个网址打开它。
一、内网穿透是什么
给一个「只在自己电脑上能打开」的服务,挂上一个公网地址。别人拿着这个地址就能访问它,而文件、数据、程序全程都留在你自己电脑里。
不用买服务器
不用申请公网 IP
不用做端口映射、不用开 DMZ
不用把代码或数据上传到任何云端
二、怎么用:一句话交给 AI
把这句话发给它
请阅读 https://hsk.oray.com/doc/cli-setup.md ,安装 @aweray/hsk-cli 并创建映射
AI 收到这句话后,会自己去读这份说明、把工具装好、完成创建,最后把一条公网链接交给你。安装、配置这些步骤你都不用管。
三、临时映射和长期映射
| 对比项 | 临时映射 | 长期映射 |
|---|---|---|
| 适合什么场景 | 演示、联调、临时给朋友看一眼 | 家里 NAS、自建服务、远程桌面、数据库这类要长期用的 |
| 能用多久 | 默认 24 小时,到期自动回收 | 只要那台电脑一直开着、服务不停,就一直有效 |
| 网址 | 重新开一般会换一条新地址 | 创建后固定不变,可以长期用同一个地址 |
拿不准就看两件事:只用这一次、机器会关 → 临时映射;那台机器一直开着、以后还得用 → 长期映射。
两种方式的网址前缀都由系统分配,不能自定义。
四、应用场景
| 你的情况 | 是否适用 | 建议做法 |
|---|---|---|
| 给客户或同事演示一个还在本地跑的系统 | 适用 | 用内网穿透,演示完就关 |
| 前端和后端联调,对方要访问你本机的接口 | 适用 | 用内网穿透 |
| 手机真机调试本地页面,需要手机能打开电脑上的地址 | 适用 | 用内网穿透 |
| 家里 NAS、自建相册、自建笔记,人在外面想访问 | 适用 | 用内网穿透,更适合长期映射 |
| 临时把一个接口给第三方回调(如小程序开发) | 适用 | 用内网穿透 |
| 只是想发一个 HTML 页面、PDF、报告给朋友看 | 不适用 | 用花生壳 Drop 或文件托管,更简单,而且不用一直开着电脑 |
| 网站要 7×24 长期对外提供服务 | 不适用(临时方式) | 推荐用花生壳 Drop 或文件托管 |
| 里面有隐私、客户数据,但现在谁点进来都能看 | 谨慎 | 先在你自己系统里把身份验证加好,再对外 |
一句话判断:如果对方要「操作」你的服务,用内网穿透;如果对方只是「看」你的文件,别用穿透。
五、注意事项
临时映射默认 24 小时,用完自动回收。 演示、联调、临时协作都够用;要长期对外,说一声换成长期映射即可。
那台电脑要保持运行。 演示、联调这几个小时别关机、别合盖休眠;长期映射也一样,机器得一直开着、服务不能停。
放隐私、重要信息,先加一道门。 有了公网地址,拿到链接的人就能打开它。如果里面有客户资料、后台管理、内部数据,先在你自己系统上把身份验证加好(比如登录),别只指望链接不被人转发;演示结束及时关闭。
公网可访问即受监管。 请不要用它承载违法违规内容。
地址会不会变,看用哪种。 临时映射重新开通常是新地址;长期映射只要那台电脑一直开着、服务不停,地址就不变。
局域网能开、公网打不开,先看本机防火墙。 有些安全软件会拦截外部连接,把对应程序放行即可。
用完主动关闭。 演示结束、联调完成就关掉,是个好习惯。
六、重难点解析
Q1:AI 说「创建成功」了,但链接打不开
先看认领做了没有。这台电脑已经登录花生壳账号的话,资源会自动归到你账号下,链接一般是直接可用的;如果当时还没登录,拿到的是一条待认领的链接,要打开它、按页面提示扫码或登录确认一次,链接才会生效。
Q2:AI 问我「端口是多少」
说明你的说法里少了端口。补一句「是 3000 端口」就行,换成你自己的数字。不确定数字的话,回到启动程序的那个窗口,最后几行通常就写着。
Q3:装到一半一直失败
通常是这台电脑缺少运行环境、没有安装权限,或者公司网络不允许装外部软件。让 AI 先检查一下运行环境,多数情况能解决;如果确实装不了,换一台电脑最省事。
Q4:打开是 404 或空白页
服务只允许本机访问,外部连接进不来
入口路径不对,打开的不是真正的首页
服务其实已经挂了(回到那个窗口看看还在不在)
先在本机浏览器再打开一次确认服务正常,再检查是不是只允许本机访问。
Q5:别人能打开,我自己打不开
你自己访问时可能走的是本地缓存或旧地址,用无痕窗口或手机流量再试一次。反之如果只有你自己能打开,那就是防火墙或服务绑定地址的问题。
Q6:想要长期可用怎么办
用长期映射:在这台电脑装上花生壳的本机引擎组件,把端口做成常驻映射。关掉 AI 对话不影响它;那台电脑一直开着、服务不停,地址就一直有效、也不会变。安装那一步可能会要求管理员权限,按提示同意即可;具体步骤让 AI 带你走,不用自己去找安装包。
Q7:安全吗,数据会不会被传到云上
穿透只转发访问请求,文件和数据库始终在你本机,不会上传到云端。要留意的是:有了公网地址,拿到链接的人就能打开它。所以带隐私、带重要信息的系统,先在你自己那边把身份验证加好(登录),别只指望链接不被人转发。
文档内容是否对您有帮助?
如果遇到产品相关问题,您可咨询 在线客服 寻求帮助。



相关问题
其他问题




