
Muru 开发服务器新增 --https 参数,本地运行支持 HTTPS
来源标题:Muru: HTTPS in Development
Muru 开发运行现在加 --https 参数即可同时以 HTTP 和 HTTPS 提供服务,无需再在前面挂 nginx 或 Caddy 代理。以 shop/wsgi.py 为例,执行 muructl run shop.wsgi:application --https 后,应用会监听 127.0.0.1:8080 和 127.0.0.1:8443。这样可在部署前提前发现仅 HTTPS 下才出现的行为差异。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
到目前为止,我展示的 Muru 的所有内容都是通过 8080 端口上的普通 HTTP 提供的。这几乎是所有人在开发 Python Web 应用时的做法,大多数情况下这没什么问题。不过生产环境中的应用会位于 HTTPS 之后,而有些东西在 HTTPS 下的行为会有所不同,只有部署之后才会发现。
在本地测试这些东西的常见做法是,在开发服务器前面放一个 nginx 或 Caddy 之类的代理,为它生成证书,然后配置应用去信任代理添加的、用来说明原始请求是 HTTPS 的请求头。这足够麻烦,以至于大多数人从来不去折腾。用 Muru 的开发运行,这是一个可选项。
假设 shop/wsgi.py 里有一个 WSGI 应用,启动时加上 --https:
muructl run shop.wsgi:application --https
muru.host[61235]: preloaded shop.wsgi:application in 1 ms
muru.host[61235]: shop.wsgi:application is served as WSGI
muru.host[61235]: worker 0 started as pid 61241
muru.host[61235]: worker 0 (pid 61241) is ready
muru: serving shop.wsgi:application on http://127.0.0.1:8080 and https://127.0.0.1:8443 with 1 worker of 4 threads
...
muru: certificate for localhost, 127.0.0.1, ::1 issued by the mkcert authority in /Users/graham/Library/Application Support/mkcert (created, /Users/graham/Library/Caches/muru/certs/dev.pem)
现在这次运行除了在 8080 上监听 HTTP,还会在 8443 上监听 HTTPS,并且已经创建了要用的证书。
证书的生成方式取决于你安装了什么。如果你使用 mkcert 并且曾经运行过 mkcert -install,那么你的机器上就有一个本地证书颁发机构,你的浏览器已经信任它。Muru 会找到它并从中签发证书,因此浏览器会毫无警告地接受该证书。如果没有安装 mkcert,Muru 会退而创建自签名证书,并打印出如何信任它,或者如何改为安装 mkcert。
无论哪种方式,证书都保存在你的用户缓存目录中,而不是项目中,因此不存在私钥被提交到仓库的风险。后续运行会复用它,同一行输出会显示 reused 而不是 created 来表明这一点;只有当它临近过期,或者被要求覆盖一个它尚不包含的名字时,才会被替换。如果你已经有自己的证书并希望使用它,--tls-cert 和 --tls-key 可以改用你的证书。
要了解 HTTPS 对应用有什么影响,下面是一个 WSGI 应用,它会报告请求的 URL scheme、协议以及请求发送到的主机:
def application(environ, start_response):
body = f"{environ['wsgi.url_scheme']} {environ['SERVER_PROTOCOL']} {environ['HTTP_HOST']}\n".encode()
start_response("200 OK", [("Content-Type", "text/plain")])
return [body]
分别向两个端口发起请求:
curl http://127.0.0.1:8080/
curl https://127.0.0.1:8443/
结果如下:
http HTTP/1.1 127.0.0.1:8080
https HTTP/2.0 127.0.0.1:8443
在 HTTPS 下,应用看到 wsgi.url_scheme 被设置为 https,并且请求是以 HTTP/2 到达的。这两点在普通 HTTP 下都无法测试。浏览器只在 TLS 上使用 HTTP/2,所以如果你想知道当页面通过同一个连接加载几十个资源时应用会如何表现,这是唯一能在本地弄清楚的办法。任何使用 wsgi.url_scheme 来构造绝对 URL 的代码(用于重定向或邮件中的链接),除非请求确实是通过 HTTPS 到达的,否则都会构造出错误的 URL。而标记为 Secure 的 cookie——生产环境中的任何会话 cookie 都应该是这样——在普通 HTTP 下浏览器根本不会回传。在生产设置中设置了 SESSION_COOKIE_SECURE 的应用,其行为可能与你一直在开发时针对的应用大不相同。
之所以能如此简单地提供这些功能,原因在于 Muru 的构造方式,我在《how it fits together》一文中详细讲过。TLS 和 HTTP/2 由 edge 处理,edge 是用 Rust 编写的,不运行任何 Python 代码。当请求到达 worker 时,它已经被解密并解析完毕,应用拿到的是一个普通的 WSGI environ,其中的 scheme 已经正确设置。不需要配置代理,也不需要告诉应用去信任 X-Forwarded-Proto 请求头。而且这与生产环境中在 daemon 下运行时终止 TLS 的是同一份代码,而不是仅为开发而存在的东西。
一旦你同时开发多个项目,所有东西都用 localhost 就会变得很别扭,因为 cookie 绑定的是主机名而不是端口。在 localhost 上登录一个项目,它的会话 cookie 也会被发送到你在 localhost 上运行的其他所有项目。
--host 选项会向证书中添加名字:
muructl run shop.wsgi:application --https --host shop.localhost
muru: certificate for localhost, 127.0.0.1, ::1, shop.localhost issued by the mkcert authority in /Users/graham/Library/Application Support/mkcert (created, /Users/graham/Library/Caches/muru/certs/dev.pem)
Chrome 和 Firefox 等现代浏览器以及 curl 都会把任何以 .localhost 结尾的名字解析到回环地址,因此无需编辑 /etc/hosts 就能使用它们。然后就可以通过 https://shop.localhost:8443/ 访问该项目,它的 cookie 与其他任何项目的 cookie 相互隔离,并且浏览器信任该名字对应的证书。
使用 --https 时,HTTP 和 HTTPS 都会提供服务,如果某个页面或重定向悄悄把你送回普通 HTTP,问题就可能被忽略。如果你要确保所有流量都走 HTTPS,就像生产环境中那样,请改用 --https-only:
muructl run shop.wsgi:application --https-only --host shop.localhost
muru: serving shop.wsgi:application on https://127.0.0.1:8443 (http://127.0.0.1:8080 redirects to it) with 1 worker of 4 threads
8080 端口仍然在监听,但现在对每个请求都返回重定向,指向 HTTPS 端口上的同一路径:
curl -i 'http://shop.localhost:8080/cart?item=42'
HTTP/1.1 307 Temporary Redirect
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。