设置
Joppa 设置中的每个部分及其控制的内容，从代理到外观。
用 ⌘ , 或从侧边栏打开设置。各部分带有编号，在较大的窗口中还会显示目录。
代理
监听 127.0.0.1：端口 443（HTTPS）和 80（重定向到 HTTPS）。状态、启动 / 停止，以及 打开 Joppa 时启动代理（默认开启）。如果其他服务器占用了 80 端口，该部分会指出它的名字并提供 释放端口 80。参见 HTTPS 代理 和 80 和 443 端口被占用。
证书颁发机构
为每个域名即时签发证书。显示主题、来源（「Joppa」或「mkcert（共享）」）、证书路径、信任状态、批准颁发机构 按钮（系统会要求输入密码）以及等效的终端命令。参见 证书。
.test 解析
*.test 如何指向你的机器：Joppa DNS 服务器（127.0.0.1:15353）的状态、把这些名称交给它的系统文件（Joppa 的，或其他工具如 Laravel Herd 的），以及 .test 名称是否真的解析到这台机器。配置（或 修复、使用 Joppa 的解析器）会用你的密码写入该文件；移除 会删除它。还有等效的终端命令，以及 测试域名，它会告诉你某个域名为什么打不开。参见 解析 .test 域名。
迁移到 Joppa
从 Lerd、Herd、DDEV 或 Sail 迁移… 会打开它们站点的迁移：项目、域名、数据库和 .env。参见 从 Lerd、Herd、DDEV 或 Sail 迁移。
容器
- 运行时：自动（第一个已运行的）、OrbStack、Docker Desktop、Colima 或 Podman。
- 自定义启动命令：由「启动」按钮执行，替代运行时自带的命令。
参见 容器运行时。
Node
- Vite+ 的版本、上次检查时间和 更新（缺失时为 安装 Vite+ / 重试）。Joppa 在首次启动时安装它，并每天更新。
- 在我的终端中使用 Joppa 的 Node：在你的 shell 配置文件中添加或移除 Joppa (Node) 代码块。如果你的配置文件已加载 Vite+，开关显示为开启且不可更改。
PHP
- 在我的终端中使用 Joppa 的 PHP：在你的 shell 配置文件中添加或移除 Joppa 代码块。
- 未固定版本的项目：系统 PHP 或 Joppa 的某个版本。
- 已安装的版本，以及 Composer（下载 Composer）。
php.ini 和 Xdebug 按项目设置，在项目的 运行时 标签页中：参见 项目的 php.ini 和 Xdebug。Xdebug 的设置保存在 config.json（项目的 xdebug 字段）中，仅限本机。
命令行
- 安装 joppa / 重新安装：将命令加入
PATH。 - 接入助手：在 Claude Code、Claude Desktop 和 Cursor 中注册 MCP 服务器。
许可证
当前方案、账户、密钥、设备、最近一次验证。登录、输入密钥、验证、停用这台 Mac。参见 许可证与方案。
语言
English、Français、Español 或 中文。更改应用及其菜单栏菜单的语言。
外观
| 设置 | 选项 |
|---|---|
| 主题 | 跟随系统、浅色、深色（默认） |
| 边框 | 玻璃（原生模糊）或不透明 |
| 图标 | Halo、天空或抖动，用于程序坞和侧边栏（访达仍使用 Halo） |
更新
显示已安装的版本、上次检查时间以及 检查更新 按钮。Joppa 会在启动时和每次重新打开窗口时检查新版本，之后每六小时检查一次。
| 设置 | 默认值 |
|---|---|
| 自动下载新版本 | 开启。关闭后，侧边栏的卡片会提供 下载并安装 |
参见 安装 › 更新。
隐私
Joppa 为改进自身而发送的内容（仅在你同意时），以及它自己的日志。首次启动后不久，Joppa 会在 帮助改进 Joppa 窗口中询问一次：两项设置默认关闭，不用了 保持关闭，保存我的选择 保存你打开的选项。若未作答就关闭窗口，下次启动时会再次询问。
| 设置 | 默认 | 发送的内容 |
|---|---|---|
| 发送崩溃报告 | 关闭 | 当 Joppa 或其界面崩溃时：错误信息、出错的 Joppa 代码位置、Joppa 版本和你的系统。同一错误每次启动只发送一次 |
| 分享匿名使用统计 | 关闭 | 打开的界面和执行的操作（添加项目、创建服务、开始分享…），最多附带几个标签（服务的引擎、项目的模板），以及启动时的项目数和服务数。分批发送，每分钟一次 |
绝不包含项目名称、域名、路径、文件内容或 .env：错误信息中你的个人文件夹显示为 ~。数据发送到托管在欧盟的 PostHog，使用随机 ID（telemetry.json），与你的许可证和设备无关，不建立个人档案，也不做地理定位。崩溃报告会先写入 crashes/ 再发送：若未能发出，会在下次启动时发送。关闭崩溃报告会删除等待中的报告。另见 隐私政策。
Joppa 日志：Joppa 的操作及其遇到的错误，保存在 logs/joppa.log（5 MB 后转为 joppa.1.log，最多 10 MB）。日志只保存在这台电脑上；显示日志 会在文件管理器中打开它们，报告错误 可以附上最近的几行。
卸载
卸载 Joppa… 会移除 Joppa 在这台电脑上安装的内容，包括 joppa 命令：由你勾选要移除的项。参见文件和文件夹 › 完全移除。
无界面的设置
config.json 还包含代理的端口（443、80）和顶级域名（test）。这些无法在应用中修改。
每个数据库保留的快照数量（snapshotsKeep，默认 10）在数据库的 快照… 窗口中设置：参见 快照。