还在记端口号？Vercel这个7000+星项目让本地开发彻底改头换面

## 传统的端口管理方式——像密码一样难记
alias be1="cd /app/backend1 && npx vite --port 5123"
alias fe2="cd /app/frontend2 && npm run dev -- --port 8081"
alias doc="cd /app/docs && pnpm docs:dev -- --port 3005"

## 全局安装（推荐，版本统一，团队协作更方便）
npm install -g portless

## 或者作为项目开发依赖（注意：不同开发者可能版本不同）
npm install -D portless

## 给应用命名并启动，自动分配到 https://myapp.localhost
portless myapp next dev

## 访问 -> https://myapp.localhost

{
  "scripts": {
    "dev": "portless run next dev",
    "dev:api": "portless api.myapp pnpm start",
    "dev:docs": "portless docs.myapp next dev",
    "dev:lan": "portless proxy start --lan",
    "proxy:start": "portless proxy start --foreground --tld test",
    "proxy:stop": "portless proxy stop",
    "test": "NEXT_TELEMETRY_DISABLED=1 vitest --coverage",
    "lint": "eslint --cache .",
    "type-check": "tsc --build --noEmit",
    "format": "prettier --write ."
  }
}

## 启动API微服务，访问 -> https://api.myapp.localhost
portless api.myapp pnpm start

## 启动文档项目，访问 -> https://docs.myapp.localhost
portless docs.myapp next dev

## 启动代理并指定`.test`后缀（官方推荐，无冲突风险）
portless proxy start --tld test
portless myapp next dev
## -> https://myapp.test

// Vite配置 vite.config.ts
export default {
  server: {\n    proxy: {\n      "/api": {\n        target: "https://api.myapp.localhost",\n        changeOrigin: true,  // 重写Host头，关键配置\n        ws: true             // 支持WebSocket\n      }\n    }\n  }\n}

// next.config.js
module.exports = {\n  allowedDevOrigins: ["myapp.local", "*.myapp.local"]\n}

## 主分支工作树 -> https://myapp.localhost\nportless run next dev\n\n# 创建fix-ui分支的工作树 -> https://fix-ui.myapp.localhost\ngit worktree add -b fix-ui\nportless run next dev\n# 自动用分支名作为子域名，无需额外配置\n```

## 设计模式和性能优化

从设计模式角度看，Portless主要用了：**代理模式**（监听80/443端口，转发到不同应用）、**工厂模式**（自动生成不同框架的启动命令）、**观察者模式**（自动检测端口变化和网络状态）。

性能方面，HTTP/2的引入是个大亮点：传统HTTP/1.1每个域名限制6个并发连接，对现代前端框架（特别是Unbundled开发服务器如Vite）是瓶颈。Portless启用HTTP/2后，所有请求可以复用单一连接，理论上性能更好。

## 踩坑指南

上手难度极低，基本就是"安装-运行"模式。但有几个小坑需要注意：

1. **首次运行需要sudo权限**：绑定443端口在macOS和Linux上需要管理员权限；

2. **Safari用户可能需要手动配置**：虽然Chrome、Firefox、Edge都能自动解析`.localhost`，但Safari依赖系统DNS解析，可能需要运行`portless hosts sync`；

3. **项目内安装要注意版本**：如果项目安装而不是全局安装，不同开发者可能运行不同版本，导致状态目录格式变化，可能需要重新运行`portless trust`；

4. **LAN模式需要额外依赖**：Linux上需要安装`avahi-utils`。

## 一个后端老兵的真实感受

说实话，刚看到这个项目时我内心有点复杂。作为一个从Tomcat端口配置一路走过来的后端开发者，我已经习惯了`server.xml`中修改`<Connector port="8080">`那一套。但这种"命名替代端口号"的理念，真的更符合现代开发体验。

特别是微服务架构下，多个服务同时运行，每个服务有自己的端口号，每次调试都要查文档才能知道哪个服务跑在哪个端口，这种日子我过够了。Portless的出现让我看到了一种可能性：**基础设施应该服务人，而不是让人迁就基础设施**。

而且这个项目不是纸上谈兵，细节打磨得很到位。比如非交互式环境（CI环境或没有TTY的场景）会直接退出并给出明确错误，而不是卡在那里等待输入；比如自动注入`NODE_EXTRA_CA_CERTS`让Node.js信任Portless的CA；比如自动检测并提示无限循环代理配置。

如果让我现在重新规划一个新的微服务项目，我会认真考虑把Portless纳入开发工具链。特别是配合Docker容器化部署：用`portless alias <name> <port>`注册静态路由，容器内服务也能通过命名方式访问。

当然，这个项目目前还是0.x版本，生产环境使用需要谨慎。但作为一个开发期间的工具，它已经非常成熟了。特别是来自Vercel Labs，后续更新和维护应该有保障。

总的来说，这是一个"小而美"的项目：解决了一个真实存在的痛点，实现得干净利落，细节处理专业。星数7000+也证明了它的受欢迎程度。我给它打8.5分，扣掉的1.5分是因为目前还不是1.0版本，以及Windows下的体验可能需要进一步验证。

最后说一句：**如果你还在用数字记忆端口号，试试Portless，相信我，回不去了。**