首页Node.jsvercel-labs/portless
// archived 2026-05-02
vercel-labs

portless

DevOps#Localhost#Proxy#Development#HTTPS#Node.js
前往 GitHub →
34

// 项目简介

Portless 使用稳定的命名 .localhost URL 替代动态本地端口号,从而简化开发工作流。它能自动管理 HTTPS 证书,处理各种框架的代理,并支持 monorepo 集成和 Tailscale 共享等高级功能。该工具通过自动分配端口并将必要的配置注入到开发环境中,确保了无缝的开发体验。

// 技术分析

Portless 是一款开发者工具,旨在用稳定且易于阅读的 .localhost URL 替换临时端口号,以用于本地开发环境。通过充当本地代理,它能自动管理 HTTPS/TLS 证书、处理端口分配,并支持 monorepo 和 git worktrees 等复杂设置。这种方法解决了管理多个开发服务器端口以及基于浏览器的 CORS 或身份验证问题所带来的困扰,同时通过自动注入环境变量与现有框架实现无缝集成。

// 核心亮点

01
提供稳定的命名 HTTPS URL(如 https://myapp.localhost),无需依赖随机的本地端口。
02
自动生成并信任本地 CA,实现无缝的 HTTPS/HTTP/2 开发,且不会出现浏览器警告。
03
支持 monorepo 架构,通过自动发现工作区包并为其分配唯一的子域名。
04
与 Git worktrees 集成,通过在 URL 前添加分支名称,允许开发者同时运行同一项目的多个版本。
05
通过 mDNS 提供 LAN 模式,使本地开发服务器可从同一网络上的其他设备访问。
06
支持通过 Tailscale 与团队成员轻松共享本地开发服务器,或通过 Tailscale Funnel 进行公开访问。

// 典型使用场景

01
使用 https://myapp.localhost 等稳定且易于阅读的 URL 替换动态的 localhost 端口。
02
启用支持 HTTP/2 和本地 CA 信任的自动 HTTPS,以实现安全开发。
03
通过 Tailscale 网络安全地共享本地开发服务器,或通过 Tailscale Funnel 进行公开共享。

// 快速开始

使用 'npm install -g portless' 全局安装该包。安装完成后,您可以在命令前加上 'portless' 来运行开发服务器,例如 'portless run next dev'。该工具将自动处理应用程序的代理设置、端口分配和 URL 生成。