GGitHub 趋势观察站
每日 07:00 更新
← 返回今日榜单

vercel-labs /

portless

用稳定命名的本地网址替代端口号,方便人与 Agent 访问开发服务。

访问 GitHub 仓库 ↗
最近上榜 · 2026-09-03#14

当日排名

+69当日新增 Star11,710总 Star

portless:用稳定本地域名替代开发端口号

一分钟看懂

portless 是本地开发代理工具,把 localhost:3000 之类的端口地址变成 https://myapp.localhost 这样的稳定名称,让人和 Agent 更容易识别多个服务。

你可以用它做什么

  • 为单个前端或后端服务分配固定的本地域名。
  • 在 monorepo 中同时启动多个应用并使用子域名区分。
  • 为 Git worktree 自动添加分支前缀,避免多个开发实例冲突。
  • 默认使用本地 HTTPS 和 HTTP/2 访问开发服务。

主要能力

  • 自动分配端口,并把 PORT 或已知框架的端口参数传给子进程。
  • 支持 Next.js、Express、Nuxt、Vite、Astro、Angular 等常见框架。
  • 可从 portless.json 或 package.json 读取项目和脚本配置。
  • 能识别 workspace、Turborepo 和 Git worktree。

适合哪些人

适合同时维护多个本地服务、monorepo 或并行 worktree 的 Web 开发者,也适合需要稳定服务地址的浏览器自动化和编程 Agent 工作流。

怎么开始使用

用 npm install -g portless 全局安装,然后执行 portless myapp next dev,或直接在带有 dev 脚本的项目中运行 portless。首次启用 HTTPS 时会创建并信任本地证书。

使用前需要知道

README 明确标注项目尚未到 1.0,状态目录格式可能变化。首次绑定 443 端口和信任本地 CA 时,macOS 或 Linux 可能请求提权;这会改变本机证书信任设置,应确认来源后操作。CI 等非交互环境不会弹出提示,而会直接报错。许可证以仓库文件为准。

官方资料