HTTPS 代理
Joppa 内置的反向代理:端口、协议、转发的请求头、错误页面和自动启动。
代理接收所有发往你的 .test 域名的请求,用该域名的证书解密,然后转发给开发服务器。
端口和地址
| 端口 | 作用 |
|---|---|
| 443 | HTTPS |
| 80 | 重定向到 HTTPS |
代理监听 127.0.0.1(IPv6 可用时还有 ::1)。它只接受来自本机的连接。
支持的内容
- HTTP/2 和 HTTP/1.1。
- WebSocket:Vite、Next.js 或 Astro 的热重载(HMR)可以正常工作。
- Server-Sent Events:数据流保持打开。
- 请求头:保留原始
Host;添加X-Forwarded-Proto: https、X-Forwarded-Host、X-Forwarded-Port: 443和X-Forwarded-For。
错误页面
| 情况 | 响应 |
|---|---|
Joppa 不认识的 .test 域名 |
一个「域名未配置」页面(而不是证书错误) |
| 开发服务器没有响应 | 一个 502 页面「开发服务器无响应」 |
启动和停止
- 设置 › 代理:状态、启动 / 停止,以及 打开 Joppa 时启动代理(默认开启)。
- ⌘ K 命令面板:「重启 HTTPS 代理」「停止代理」。
- 菜单栏:启动代理 / 停止代理。
- 终端:
joppa proxy start/joppa proxy stop。
代理停止时,窗口顶部会有横幅提醒,程序坞中的图标也会变成红色。
在后台运行的 Joppa
关闭窗口不会退出 Joppa:代理会继续为你的域名提供服务,Joppa 也会留在菜单栏中。它的菜单会列出你的项目及其域名(点击即可打开)、代理状态、打开 Joppa… 和 退出 Joppa。同一时间只运行一个实例:再次启动应用会调出已有的窗口。