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 等非交互环境不会弹出提示,而会直接报错。许可证以仓库文件为准。