文件和文件夹

Joppa 的文件夹

系统	位置
macOS	~/Library/Application Support/joppa
Linux	~/.config/joppa

文件或文件夹	内容
config.json	项目、域名、服务和设置
processes.json	项目的进程（当它们不在 joppa.toml 中时）
running.json	Joppa 启动且正在运行的开发服务器，以便 Joppa 未停止它们就关闭时能再次找到
control.json	本地 API 的端口和令牌，供 joppa 命令使用（只有你可以读取）
ca/	证书颁发机构：rootCA.pem 及其密钥 rootCA-key.pem（只读）
analytics/	按域名统计的数据，每分钟一行，保留 7 天
php/<version>/	已下载的 PHP 构建
bin/	遵循 .php-version 的 php 和 composer 命令

许可证不在这个文件夹中：它保存在系统钥匙串中（服务 com.getjoppa.license）。

在你的项目中

Joppa 只会在项目中写入你确认过的内容：

文件	何时写入
.env	关联服务、HTTPS 地址、编辑（始终附带 diff）
.env.joppa-backup	首次写入时，原始 .env 的副本
joppa.toml	如果你与团队共享进程配置
.node-version、package.json	如果你固定了 Node 或包管理器
.php-version	如果你固定了 PHP
vite.config.*、astro.config.*	如果你点击了 修复文件

这些文件夹之外

• Shell 配置文件（~/.zshrc…）：只有 # >>> Joppa (PHP) >>> 代码块，并且仅在你启用时写入。
• joppa 命令：/usr/local/bin 或 ~/.local/bin 中的一个链接，仅在你安装时创建。
• AI 助手：其配置中的 mcpServers.joppa 项，仅在你接入时写入。
• 容器：你的运行时中的 joppa-<engine> 及其卷 joppa-<engine>-<version>。

完全移除

Joppa 目前还没有自动卸载功能。要从头开始：退出 Joppa，删除它的容器和卷（docker rm -f joppa-postgres、docker volume rm joppa-postgres-17…），删除 Joppa 的文件夹，并从钥匙串中移除 CA（macOS：钥匙串访问 › 系统 › “Joppa local CA”）。