域名

域名 标签页（D）列出项目的域名。每个域名均通过 HTTPS 提供，并转发到对应的本地服务器。

域名表格

列	内容
状态	域名的健康状态指示点
域名	https://app.myproject.test ↗，可点击
目标	→ localhost:5173
启动者	为该端口提供服务的 进程（如果有）
启用	一个开关：停用的域名不再响应，但不会被删除

每一行的操作：启动或停止进程、复制 URL、删除域名。

状态

状态	含义
在线	开发服务器在其端口上响应
离线	端口上没有任何程序在监听
已停用	域名已关闭（启用 开关）
无代理	代理已停止：所有域名都不响应
启动中…	为该端口提供服务的进程正在启动
进程失败	进程已崩溃
已停止	进程已停止

添加域名

在表格下方填写两个字段，然后点击 + 添加（快捷键 A 跳到该字段）：

• 子域名或完整域名：admin 会变成 admin.myproject.test；带点的名称（docs.autre.test）则按原样使用。
• 端口：3000 会成为目标 http://localhost:3000。

名称可使用字母 a–z、数字和连字符，每段最多 63 个字符，总长最多 253 个字符。两个项目不能使用相同的域名。

框架设置

在域名下方，项目中待处理 区块会指出会妨碍项目在其域名上响应的问题，并给出需要添加的代码。

Vite 和 Astro：allowedHosts

Vite（以及基于它的 Astro）会拒绝发往未知域名的请求。Joppa 会建议添加：

// vite.config.ts
export default defineConfig({
  server: { allowedHosts: [".myproject.test"] },
});

// astro.config.mjs
export default defineConfig({
  vite: { server: { allowedHosts: [".myproject.test"] } },
});

修复文件 会打开预览，然后 写入文件 只插入这几行；文件其余部分保持不变。如果配置的写法不常见，Joppa 不会修改它：请点击 复制代码 并自行粘贴。另一种不改动文件的方法：使用变量 __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS=.myproject.test。

重启开发服务器以重新读取配置。

Laravel 与反向代理

Laravel 必须信任代理，才能生成 https:// 开头的 URL。在 bootstrap/app.php 中：

->withMiddleware(fn ($m) => $m->trustProxies(at: '*'))

这项设置不会自动写入：请复制它。

转发的请求头

代理会保留原始的 Host 请求头（app.myproject.test），并添加 X-Forwarded-* 请求头：X-Forwarded-Proto: https、X-Forwarded-Host、X-Forwarded-Port: 443 和 X-Forwarded-For。参见 HTTPS 代理。