内网穿透使用指南
更新日期:2026-11-20 16:37:03
一句话概括:你在自己电脑上跑起来的东西,可以让别人通过一个网址打开它。不用买服务器、不用公网 IP、不用改路由器。
一、怎么用(三步搞定)
第一步:让 AI 自动装工具
把这句话直接发给你正在用的 AI 智能体(workbuddy、Trae、豆包、通义灵码等):
请阅读 https://hsk.oray.com/doc/cli-setup.md ,安装 @aweray/hsk-cli 并创建映射
AI 会自己去下载、安装、配置花生壳 CLI,你不用手动操作任何东西。
第二步:告诉 AI 要穿透哪个端口
等 AI 装好后,再发一句话,把你的本地端口号带上:
帮我把本机 3000 端口映射出去
把 3000 换成你自己的端口号。不确定端口号?回到启动程序的那个窗口,最后几行通常就写着。
第三步:打开链接、认领资源
AI 执行完会给你一条公网链接。打开链接,按页面提示扫码或登录你的贝锐账号,完成认领——认领后资源才真正归到你账号下,链接长期有效。
电脑已经登录过花生壳账号?那资源会自动认领,直接可用。
二、临时映射 vs 长期映射
| 对比项 | 临时映射 | 长期映射 |
|---|---|---|
| 适合场景 | 给客户演示、同事联调、临时协作 | 家里 NAS、自建服务、远程桌面 |
| 能用多久 | 默认 24 小时,到期自动回收 | 只要电脑开着、服务不停,一直有效 |
| 地址变化 | 重新开可能换一条新地址 | 创建后固定不变 |
| 能穿透什么 | 仅网页类服务 | 网页、远程桌面、数据库、非网页服务都行 |
| 安装要求 | 无 | 需要装本机引擎组件(可能要管理员权限) |
拿不准怎么选? 只用这一次、电脑会关 → 临时映射;机器一直开着、以后还要用 → 长期映射。
想换长期映射?跟 AI 说一声「改成长期映射」,它会带你装引擎组件。
三、常见问题
Q1:AI 说「创建成功」,但链接打不开?
大概率是没认领。AI 创建出来的是一条待认领链接,打开它、按页面提示扫码或登录,链接才会生效。认领后可以在 花生壳AI版控制台 查看和管理所有资源。
Q2:AI 问我「端口是多少」?
说明你刚才没说端口号,补一句就行:「是 3000 端口」,把数字换成你自己的。
Q3:打开是 404 或空白页?
常见原因:
服务只允许本机访问(绑定了 127.0.0.1,外部进不来)
入口路径不对(打开的不是真正的首页)
服务其实已经挂了
先在本机浏览器再打开一次,确认服务正常运行。
Q4:局域网能开、公网打不开?
先检查本机防火墙,把对应程序放行即可。
Q5:安全吗?数据会不会被传到云上?
不会。穿透只转发访问请求,文件和数据库始终留在你本机。但要注意:有了公网地址,拿到链接的人就能打开它。如果里面有客户资料、后台管理、内部数据,先在你自己的系统上把身份验证加好(比如登录),别只指望链接不被人转发。演示结束及时关闭。
Q6:用完怎么关?
临时映射:关掉 AI 对话里那个一直在输出日志的终端窗口,穿透就结束了 长期映射:在花生壳控制台删除对应映射即可
四、一句话总结
| 你的情况 | 用不用穿透 | 怎么做 |
|---|---|---|
| 给客户演示本地跑的系统 | ✅ 用 | 临时映射,30 秒出链接 |
| 同事联调你的本地接口 | ✅ 用 | 临时映射 |
| 手机真机调试本地页面 | ✅ 用 | 临时映射 |
| 家里 NAS、相册,人在外面想访问 | ✅ 用 | 长期映射 |
| 只是想发一个 HTML/PDF/报告给朋友 | ❌ 不用 | 用花生壳 Drop 或文件托管,更简单 |
| 网站要 7×24 长期对外 | ❌ 不用临时 | 用花生壳静态托管 |
核心判断:对方要「操作」你的服务 → 用内网穿透;对方只是「看」你的文件 → 用文件托管。
现在就可以开始:打开你的 AI 智能体,复制第一步里的那句话,回车。
请阅读 https://hsk.oray.com/doc/cli-setup.md ,安装 @aweray/hsk-cli 并创建映射
文档内容是否对您有帮助?
如果遇到产品相关问题,您可咨询 在线客服 寻求帮助。



相关问题
其他问题




