HTTPS 与代理

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。同一时间只运行一个实例:再次启动应用会调出已有的窗口。

getjoppa.com › support

加载中

发送不了?请写信至 [email protected]。只是简单的问题:[email protected]。