Portless：用 .localhost 域名替代端口号的开发工具

本文介绍 Portless，一个由 Vercel Labs 开发的工具，可以将本地开发服务器的端口号替换为稳定的 .localhost 域名，让开发体验更加友好。

项目简介

Portless 是一个本地开发工具，旨在解决开发过程中端口号记忆和管理的痛点。它允许开发者使用类似 myapp.localhost 的域名来访问本地服务，而不是传统的 localhost:3000 这样的端口号地址。

该项目由 Vercel Labs 开发和维护，在 GitHub 上已获得 1.7k+ stars。

核心特性

• 稳定的 .localhost 域名 - 用易记的域名替代难记的端口号
• 支持人类和 AI Agent - 既方便开发者使用，也便于 AI Agent 理解和操作
• 自动端口映射 - 自动将自定义域名映射到对应的服务端口
• 零配置 - 简单易用，无需复杂的配置

技术栈

• TypeScript - 主要开发语言
• Vercel - 部署和托管平台
• 本地 DNS 解析 - 实现 .localhost 域名映射

使用场景

场景 1：多项目开发

当你同时开发多个项目时，不再需要记忆各个项目的端口号：

# 之前
http://localhost:3000  # 前端项目
http://localhost:3001  # API 服务
http://localhost:8080  # 后台管理

# 使用 Portless 后
http://frontend.localhost
http://api.localhost
http://admin.localhost

场景 2：团队协作

团队成员可以使用统一的域名访问本地服务，减少沟通成本。

场景 3：AI Agent 开发

AI Agent 可以更容易地理解和操作本地服务，无需处理动态端口号。

安装指南

前置要求

• Node.js 18+
• pnpm、npm 或 yarn

安装步骤

1. 克隆仓库

git clone https://github.com/vercel-labs/portless.git
cd portless

2. 安装依赖

pnpm install

3. 构建项目

pnpm build

4. 运行开发服务器

pnpm dev

快速开始

Portless 的使用非常简单。启动后，它会自动管理本地 .localhost 域名的解析，将你的服务映射到易记的域名上。

具体的使用方法请参考项目的官方文档和示例。

项目结构

portless/
├── apps/
│   └── docs/           # 文档应用
├── .agents/
│   └── skills/         # AI Agent 相关技能
├── .cursor/
│   └── skills/         # Cursor 编辑器技能
├── .github/
│   └── workflows/      # CI/CD 工作流
└── ...

项目链接

• GitHub 仓库：github.com/vercel-labs/portless
• 开发者：Vercel Labs
• 许可证：MIT

总结

Portless 是一个简单但实用的开发工具，它解决了本地开发中端口号管理的痛点。通过使用 .localhost 域名，开发者可以更轻松地管理和访问本地服务，同时也让 AI Agent 能够更好地理解和操作开发环境。如果你经常同时运行多个本地服务，Portless 值得一试。