实用 localhost 分享指南
使用 Cloudflare 和 GhostlyShare 暴露 localhost
当客户需要预览，webhook 提供商需要回调 URL，或你想在手机上访问开发服务器时，需要一个本地运行的公共 URL。本指南先介绍终端优先的 Cloudflare 方案，再讲解 GhostlyShare 的重复分享流程。
快速决策
根据分享需求选择工具
误区是将每个本地预览当作托管。隧道适合临时访问，GhostlyShare 适合常规流程，真实部署适合用户依赖的 URL。
使用 cloudflared.exe
安装 Cloudflare 隧道客户端，运行一条命令，复制临时 URL，完成后用 Ctrl+C 停止。
使用 GhostlyShare
让桌面应用检测本地服务，开始分享，显示准备状态，复制 URL，并停止访问，无需查找终端输出。
部署应用
若 URL 需保证正常运行、监控、备份、稳定发布或支持归属，笔记本隧道不是合适的可靠边界。
方法一
Cloudflare EXE：最快捷简洁的命令行流程
Cloudflare 隧道客户端名为 cloudflared。Windows 可用 winget 安装或手动下载 EXE。快速隧道提供随机 HTTPS URL，无需路由器端口转发、Cloudflare DNS 区域或自定义域名，适合短期开发预览。
启动本地应用
先在浏览器打开本地 URL，应用本地无法运行，公共隧道也无法解决。
npm run dev在 Windows 上安装 cloudflared
Use winget when it is available. If you download the EXE manually, place it in a folder such as C:\Cloudflared\bin and call it cloudflared.exe.
winget install --id Cloudflare.cloudflared创建公共 URL
Use the exact local HTTP URL and port. In PowerShell from the EXE folder, use .\cloudflared.exe if the executable is not on PATH.
cloudflared.exe tunnel --url http://localhost:5173分享前测试
在隐私窗口或其他设备打开生成的 trycloudflare.com URL，检查登录、资源、重定向和 API 调用，再发送给他人。
https://example-random-name.trycloudflare.com主动停止隧道
演示或 webhook 测试结束后，停止终端进程。若设备休眠或断网，快速隧道也会停止工作。
Ctrl+C稳定的预览名称
随机 URL 还是自定义 Cloudflare 主机名？
测试后链接可消失时，随机 URL 很合适。预览需稳定时，自定义域名更合理，如 demo.example.com，且你已在 Cloudflare 管理该域名。
| 需求 | 使用 | 适用原因 |
|---|---|---|
| 五分钟演示或 webhook 回调 | 随机 URL | 无需账户或 DNS 配置，测试后链接可轻松丢弃。 |
| 客户评审应体现品牌形象 | 自定义域名 | 自定义主机名更易识别，但需配置 Cloudflare 区域、令牌权限、DNS 和隧道路由。 |
| 不应随意打开的预览 | 密码保护链接 | 公开前设置密码，并将链接和密码分别发送给需要访问的小组。 |
其他选项
暴露 localhost 的其他方式
不必为每种情况使用同一工具。最佳选择取决于你需要一次性链接、桌面流程、品牌预览、私有网络工具，还是专门加固的自托管方案。
| 工具 | 常用命令或操作 | 适用场景 | 注意 |
|---|---|---|---|
| Cloudflare 快速隧道 | cloudflared tunnel --url http://localhost:5173
|
无需路由器更改的快速一次性公共 HTTPS URL。 | 仅限开发测试；随机 URL；终端生命周期。 |
| GhostlyShare | 在桌面应用中选择公开
|
重复本地预览、webhook 测试、密码保护演示及可选 Cloudflare 自定义域名。 | 仍非生产托管；本地应用和设备需持续运行，链接才能有效。 |
| ngrok | ngrok http 5173
|
已使用 ngrok、保留域名、流量检测及供应商特定路由功能的团队。 | 账户和套餐信息重要，配置比临时快速隧道更复杂。 |
| Tailscale Funnel | tailscale funnel 3000
|
已使用 Tailscale，需为 tailnet 设备提供公共 HTTPS 端点的用户。 | 需配置 Tailscale 并启用 tailnet 的 Funnel。 |
| localtunnel | npx localtunnel --port 3000
|
基于 Node 的快速 localhost 分享，适合简单测试。 | 适合简单预览；处理敏感内容前请谨慎考虑。 |
| 路由器端口转发 | 配置路由器、DNS、TLS 和反向代理
|
有意运营基础设施时的永久自托管。 | 攻击面更大；补丁、防火墙规则、日志和 TLS 需自行维护。 |
Webhook 测试
节省 webhook 时间的细节
Webhook 提供商无法访问你笔记本的 http://localhost，只能访问公共隧道 URL。请将该 URL 视为真实外部集成：保持签名验证，使用准确回调路径，检查重定向和 CORS。
使用完整回调路径
接收器监听 /api/webhooks/stripe 时，粘贴包含完整路径的公共 URL，而非仅域名。
保持签名验证开启
公共隧道便于测试真实 webhook 签名，但不应因此关闭签名验证。
关注基础 URL 和转发头
公共 URL 重定向回 localhost 时，请配置公共基础 URL、转发头、可信代理或框架主机设置。
从干净浏览器会话测试
使用隐私窗口或第二设备，避免缓存的 localhost 状态掩盖 Cookie、CORS、重定向或混合内容问题。
故障排查
先解决常见隧道问题
隧道启动但页面空白
直接打开本地 URL，检查资源、API URL、WebSocket URL 或环境变量是否仍指向 localhost。
公共 URL 重定向到 localhost
许多框架基于请求主机构建重定向。请修正转发头、可信代理、公共源或强制开发重定向。
链接先出现，后生效
Cloudflare 路由、DNS、GhostlyShare 本地代理和源应用可能需短暂同步，等待几秒后刷新重试。
HTTPS localhost 证书导致错误
短期预览时，尽量隧道本地 HTTP 端点。长期使用请主动配置源 TLS，避免盲猜。
热重载或 WebSocket 失败
使用支持 WebSocket 的工具，确保应用从公共主机构建 ws 或 wss URL，而非硬编码 localhost。
安全
发送公共 URL 前
公开预览 URL 仍属公共访问，密码保护可减少误访问，但无法保障本地服务安全。请分享最小范围 URL，使用测试数据，评审或 webhook 测试后停止链接。
使用测试数据
切勿暴露真实客户记录、数据库管理界面、内部仪表盘、种子密钥或公司机密数据。
保持应用认证开启
功能通常需登录，则公共预览时也应要求登录。
私密预览使用密码保护
小型评审组请在公开前添加 GhostlyShare 密码，并与链接分开分享。
停止并更换链接
使用后停止临时链接。若 URL 或密码泄露至工单或聊天，请创建新预览，避免复用。
常见问题
常见问题解答
确切的 Windows 命令是什么？
安装 cloudflared 后，运行 cloudflared.exe tunnel --url http://localhost:PORT，替换 PORT 为应用本地端口，如 5173、3000、5080 或 8080。
GhostlyShare 只是 cloudflared 的包装器吗？
不是。GhostlyShare 使用 Cloudflare 隧道，但增加了应用检测、随机或自定义公共链接、准备状态、停止访问和可选密码保护的桌面流程。
GhostlyShare 能否为公共链接设置密码保护？
是的。公开前启用密码保护，访客需输入密码后 GhostlyShare 才转发流量，但这不能替代完善的应用安全。
需要路由器端口转发吗？
本指南中的隧道流程不需要。cloudflared、GhostlyShare、ngrok、Tailscale Funnel 等工具从机器发起出站连接，通常无需路由器入站转发。
可以通过本地隧道测试 webhook 吗？
是的。启动本地 webhook 接收器，通过隧道暴露，粘贴公共 HTTPS URL 及正确回调路径给提供商，发送测试事件并本地检查请求。
我应该暴露管理工具或数据库吗？
通常不建议。除非经过加固且设计为可从互联网访问，否则不要暴露数据库控制台、管理仪表盘、基础设施面板、调试端点或内部服务。
生产流量应使用笔记本隧道吗？
不是。请使用真实部署或托管隧道，运行在设计为持续在线、可更新、可监控和故障恢复的基础设施上。