跳到正文
原文
Simon Willison · TIL· Simon Willison·· 2026/01/23AI 评分20

用 Cloudflare 响应头转换规则让 .py 文件在浏览器中直接预览

原文标题：Cloudflare response header transform rules

AI 导读

Simon Willison 通过 Cloudflare 的响应头转换规则（Response Header Transform Rule），把托管在 GitHub Pages 上的 tools.simonwillison.net 子域名中 .py 文件的 content-type 从 application/octet-stream 改为 text/plain。

正文

当前语言的正文正在等待翻译，暂时显示原文。

I serve Python files from my tools.simonwillison.net subdomain, which is a GitHub Pages site that's served via Cloudflare. For example:

https://tools.simonwillison.net/python/q3_tts.py

This is meant to be used with uv as described here:

uv run https://tools.simonwillison.net/python/q3_tts.py \
  'I am a pirate, give me your gold!' \
  -i 'gruff voice' -o pirate.wav

By default files with .py extensions are served with a content-type: application/octet-stream header. This means browsers will download them rather than displaying them directly to the user.

For code that you're going to execute on your machine it's nice to be able to preview it in your browser first!

Here's that default content-type header:

~ % curl -I 'https://tools.simonwillison.net/python/q3_tts.py'
HTTP/2 200 
date: Fri, 23 Jan 2026 14:52:54 GMT
content-type: application/octet-stream

I can't control how GitHub Pages serves files, but since the site is behind Cloudflare I can fix the problem there instead.

Navigating the Cloudflare dashboard

The area to look for here is called "Rules". Within that area the "Create rule" button has an option to create a "Response Header Transform Rule":

Rules Overview page. The Create rule menu is open showing a list of different rule types, including Redirect Rule, URL Rewrite Rule, Request Header Transform rule and Response Header Transform Rule.

I created a rule that looks like this:

Edit HTTP Response Header Transform Rule form - the rule name is set to tools.simonwillison.net .py files to text/plain, it has a Custom filter expression for the incoming requests matching Hostname equals tools.simonwillison.net and URI Path ends with .py - this shows an expression preview of http.host eq "tools.simonwillison.net" and ends_with(http.request.uri.path, ""py")) - then it uses Set static of content-type to text/plain; charset=utf-8

The response header transform rule

My new rule has the following settings:

  • Rule name: tools.simonwillison.net .py files to text/plain
  • When incoming requests match: Custom filter expression
  • Filter expression:
    • Hostname equals tools.simonwillison.net
    • AND URI Path ends with .py
  • Then:
    • Set static content-type to text/plain; charset=utf-8

I clicked 'Deploy' and within a few seconds saw this result:

~ % curl -I 'https://tools.simonwillison.net/python/q3_tts.py'
HTTP/2 200 
date: Fri, 23 Jan 2026 14:52:58 GMT
content-type: text/plain; charset=utf-8

And now https://tools.simonwillison.net/python/q3_tts.py displays the Python code directly in my browser.

来源：Simon Willison · TIL · til.simonwillison.net

#教程/实践