portless 今日发布

portless - 本地开发工具，稳定命名域名替代端口

产品简介

portless 是由 Vercel Labs 开发的本地开发工具，核心功能是将动态端口号替换为稳定的命名域名（例如 https://myapp.localhost），让人和 AI 编码助手都能通过固定 URL 访问本地服务，彻底解决端口冲突、记忆成本和跨应用 Cookie 污染等问题。

核心功能

• 稳定命名 URL：运行 portless myapp next dev，自动将 http://localhost:3000 替换为 https://myapp.localhost，URL 永久固定，项目重启后不变。
• 自动 HTTPS 与本地 CA：首次运行自动生成并信任本地 CA 证书，绑定 443 端口（HTTPS + HTTP/2 默认开启），无需手动配置证书。
• 智能端口分配：自动在 4000–4999 范围内分配空闲端口，并自动向 Vite、Next.js、Nuxt、Angular、React Router 等主流框架注入正确的 --port 和 --host 参数。
• Git Worktree 自动感知：在 linked worktree 中自动将分支名作为子域名前缀，每个 worktree 获得独立 URL（如 https://fix-ui.myapp.localhost），多分支并行开发互不干扰。
• 一键公网分享：集成 Tailscale Funnel 和 ngrok，一行命令将本地服务暴露到公网，团队成员或外部合作方可通过真实 HTTPS URL 访问你的本地项目。
• 跨平台服务化：支持将 HTTPS 代理注册为操作系统开机自启动服务（portless service install），后台常驻，开机即可直接用域名访问本地项目。

特色优势

• 零配置接入：不改变 package.json 的 dev 脚本，现有项目一行命令即可切换。
• 框架自动适配：支持 11 种主流前端框架的端口自动注入，无需手动指定端口参数。
• AI 编码助手友好：AI 代理不再因硬编码端口而访问错误目标，减少调试时间。
• 本地 HTTPS 真体验：完整 TLS 握手，在本地即可测试 Service Worker、PWA、推送通知等需要安全上下文的特性。
• 子域名组织多服务：用 portless api.myapp pnpm start 轻松构建 https://api.myapp.localhost 等多服务架构，本地模拟微服务间通信。

应用场景

• 多项目并行开发：同时跑 Next.js 前端（3000 端口）、Express API（4000 端口）、文档站点（5000 端口），各自有独立域名，不会互相干扰。
• AI 编码助手开发：Claude Code、Cursor、Windsurf 等 AI 工具调用本地服务时，依赖固定域名而非端口，协作更可靠。
• 团队协作与演示：通过 ngrok 或 Tailscale 将本地项目分享给同事或客户，无需部署到 staging 环境即可预览。
• 本地微服务架构：在 monorepo 中为每个 package 分配独立子域名，本地模拟生产环境的域名解析行为。
• 跨设备调试：手机、平板等与开发机在同一局域网时，用 --lan 模式让移动设备通过 http://myapp.localhost:1355 直接访问本地服务。

适用人群

• 前端/全栈开发者：需要同时跑多个项目或本地 API，减少端口管理负担。
• AI 辅助编程用户：使用 Claude Code、Copilot 等工具时，减少因端口猜错导致的调试时间。
• 技术团队负责人：为团队提供统一的本地开发域名规范，减少「端口冲突」类提问。
• 需要快速演示的开发者：不想部署到线上就能分享本地进展给外部人员。

出品方

Vercel Labs — Vercel 官方实验性项目团队，专注于提升开发者体验的工具链。

更新动态

• 2026 年 2 月：v0.4.1 发布，修复 Vite 支持问题，新增 11 种框架的端到端测试。
• 2025 年 5 月：首个公开版本发布，GitHub Star 突破 10,000。
• 持续活跃维护中，最新版本可通过 npm install -g portless 更新。

官网链接

• 官方网站：https://portless.sh
• GitHub 仓库：https://github.com/vercel-labs/portless