portless
为本地开发提供稳定的命名URL，替代端口号。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：portless。 它的用途是：为本地开发提供稳定的命名URL，替代端口号。 完整的 Skill 内容见：https://321skill.com/skills/portless/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在当前Next.js项目中使用Portless启动开发服务器。”，它会引导你安装Portless，并生成如 `portless run next dev` 或 `portless myapp next dev` 的命令，让你的应用运行在 `https://myapp.localhost` 下。或者，你可以直接说：“为我的monorepo项目配置Portless，让web应用和API服务有独立的域名。”，AI会帮助你创建或修改 `portless.json` 配置文件。
介绍
Portless 解决了本地开发时端口号不固定、难以记忆和分享的问题。它将 localhost:3000 这样的地址转换为 https://myapp.localhost 这样的稳定、可读的URL，让开发环境更接近生产环境，也方便团队协作和演示。
使用非常简单，只需全局安装后，在启动命令前加上 portless run 或直接使用 portless myapp next dev 即可。它会自动处理HTTPS证书（首次运行需信任本地CA）、端口分配和代理启动，并智能适配Next.js、Vite、Express等多种主流框架的端口配置。
它非常适合需要频繁切换项目、进行演示或团队协作的前后端开发人员、全栈工程师以及需要稳定本地环境进行测试的QA人员。对于使用monorepo的项目，Portless也能很好地支持，可以统一管理多个子应用。
建议首次使用时全局安装以避免版本冲突。注意，在非交互环境（如CI）中，Portless会直接报错退出，因此不适合用于自动化部署流水线。其状态存储在 ~/.portless 目录下，跨sudo调用时也能保持一致。
核心特点
与同类工具（如 ngrok 的内网穿透或简单的 hosts 修改）相比，Portless 深度集成到开发工作流中，能自动识别并适配不同框架的端口配置（如为Vite自动注入 `--port` 参数），并为monorepo项目提供了开箱即用的多应用命名和配置管理。
注意事项
不适合在生产服务器或CI/CD自动化部署流水线中使用，主要用于本地开发环境。
常见问题
Portless 支持哪些开发框架？
支持 Next.js, Express, Nuxt, Vite, Astro, React Router, Angular, Expo 等主流框架，能自动识别并配置端口。
首次使用需要额外配置吗？
首次运行时会自动生成并提示信任本地CA证书，以启用HTTPS。在macOS/Linux上可能需要sudo权限绑定443端口。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/portless/raw/index.md 读取 portless 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/portless/raw/index.md（查看排版版本）