简介

Joppa 是一款适用于 macOS 和 Linux 的桌面应用，用来取代本地开发环境的繁琐配置。你只需交给它一个文件夹：它会找到其中运行的开发服务器，为它们分配一个和生产环境相似的 https:// 地址，并运行项目所需的数据库。

localhost:5173        →   https://app.kinosante.test   🔒
localhost:8000        →   https://api.kinosante.test   🔒
postgres (容器)        →   127.0.0.1:5432 · 数据库 kinosante · pgvector

从哪里开始

Joppa 能做什么

为你的项目

• HTTPS 的 .test 域名：每个开发服务器一个域名（app.myproject.test、api.myproject.test），并配有受信任的证书。
• 进程：Joppa 按正确的顺序启动你的开发服务器和 Compose 容器，内置终端，并在崩溃后重新启动。
• 环境变量：.env 会随域名和服务保持更新，写入前始终先显示 diff。
• Node、bun 和 PHP 版本：按项目固定。
• 分析：开发服务器的请求、延迟、错误和可用性。
• 从模板新建项目：Vite+、Next.js、Nuxt、Astro、SvelteKit、Laravel 或 GitHub 仓库。

为你的服务

• 数据库：PostgreSQL（含 pgvector、PostGIS…）、MySQL 和 MariaDB，每个项目一个数据库。
• 缓存、邮件和搜索：Redis、Valkey、Mailpit、Typesense 和 Meilisearch。
• 从 Docker Compose 导入：将你的数据复制到 Joppa，不改动源数据。

随处可用

• joppa 命令、一个 终端中的全屏应用，以及供 Claude 和 Cursor 使用的 MCP 服务器。
• ⌘K 命令面板，每个操作都有快捷键。

支持的系统

系统	状态
macOS	已推出（Apple Silicon 和 Intel）
Linux	已推出（.AppImage 和 .deb）
Windows	开发中

Joppa 免费支持最多 3 个项目和 1 个服务。Joppa Pro 解除这些限制。