功能
本地基础设施，无需配置。
监听 :443 的 HTTPS 代理、本地证书颁发机构和你的服务，全部在一个窗口里管理。
01 — 域名
每个项目一个 .test 域名。
Joppa 会找出文件夹里的开发服务器，并为每个服务器分配域名：app.myproject.test、api.myproject.test。再也不用分辨一堆长得一样的 localhost:5173。
02 — https
受信任的 HTTPS，没有警告。
本地证书颁发机构只需在钥匙串中安装一次。每个域名都有自己的证书，浏览器会像在生产环境中一样显示锁形图标。
03 — 服务
数据库，一键即得。
PostgreSQL、MySQL 和 MariaDB 运行在你的容器运行时中，每个项目一个数据库，并带上你需要的扩展。
Joppa 的全部功能
一个应用，搞定整个本地环境。
每项功能在文档中都有专门的页面。
你的项目
选一个文件夹，剩下的交给 Joppa。
自动检测Vite、Next.js、Nuxt、Astro、Laravel、monorepo 和 Docker Compose：Joppa 自动找到开发服务器及其端口。阅读文档 →每个服务器一个 .test 域名app.myproject.test、api.myproject.test，以及 Mailpit、MinIO 或 pgAdmin 的网页界面，全部自动路由。阅读文档 →进程与内置终端Joppa 按顺序启动你的开发服务器和 Compose 容器，可在启动时自动运行，并重启崩溃的进程。阅读文档 →始终最新的 .envHTTPS 地址和服务连接按项目已在使用的变量名写入。总是先显示 diff，总是保留备份。阅读文档 →按项目设置 Node、bun 和 PHP通过 Vite+ 固定 Node 和包管理器版本，提供 PHP 8.1 至 8.5 的静态构建，以及跟随 .php-version 的 shim。阅读文档 →开发分析请求数、p95 延迟、错误、可用性、最慢路径和 N+1 突发请求，均由代理测量。阅读文档 →从模板新建项目Vite+、monorepo、Next.js、Nuxt、Astro、SvelteKit、Laravel 或 GitHub 仓库，自带版本和域名。阅读文档 →
你的服务
每种引擎一个服务器，每个项目一个数据库，运行在你的容器运行时中。
PostgreSQL、MySQL、MariaDB多个版本，每个项目一个数据库，以及你需要的扩展：pgvector、PostGIS、pgRouting…阅读文档 →Redis 与 Valkey缓存、会话和队列，重启之间数据保留在磁盘上。阅读文档 →Mailpit通过 SMTP 拦截所有开发邮件，并在网页收件箱中显示。不会真正发出任何邮件。阅读文档 →Typesense 与 Meilisearch本地即时搜索，可直接用于 Laravel Scout。阅读文档 →从 Docker Compose 导入将 Compose 中数据库和缓存的数据复制到 Joppa，再切换项目。源数据从不修改。阅读文档 →一键打开 TablePlus每个数据库都能在 TablePlus 中打开，连接已命名并标记为本地环境。阅读文档 →
HTTPS 与代理
和生产环境一样，无需任何配置。
开始
一分钟即可就绪。
- 01■□□
添加项目
把文件夹拖进窗口，按 N，或从模板开始：Vite+、Next.js、Astro、Laravel…
- 02■■□
Joppa 找到你的服务器
Vite、Next.js、Astro、Laravel、Docker Compose：Joppa 读取项目，并为每个端口建议一个域名。
- 03■■■
打开 https://
代理监听 :443 并转发到你的端口。Joppa 也可以替你启动开发服务器。
~/Code/myproject
$ joppa status › proxy :443 · CA joppa ok › myproject https://myproject.test → :5173 ■ 1/1 个域名在线 · postgres 17 运行中 $
下载
支持 macOS 和 Linux。Windows 即将推出。
一份许可证，适用于你的所有系统。
问题
常见问题
为什么使用 .test 域名？
.test 域名专门保留用于测试，永远不会在互联网上分配。Joppa 在本地把它解析到你的电脑。
需要安装 Docker 吗？
不需要。域名和 HTTPS 无需任何运行时。OrbStack、Docker Desktop、Colima 或 Podman 只用于服务：数据库、缓存、邮件和搜索。
Joppa 会修改我的文件吗？
不先给你看就绝不修改。对 .env 的更改都会先显示 diff 由你确认，原文件会保存到 .env.joppa-backup。
我已经有一个包含数据库的 docker-compose.yml。
Joppa 会读取它：既可以启动其中的服务，也可以把数据复制到 Joppa 自己的服务中并让 .env 指向它们，绝不修改源数据。
能和 Claude 或 Cursor 配合使用吗？
可以。joppa 命令内置 MCP 服务器：你的助手可以查看项目、启动服务、读取日志，还能创建项目。
支持哪些系统？
macOS 和 Linux。Windows 版本正在开发中。