imba-tjd/simple-asgi-static-proxy

🌐 A simple proxy for static resources

Simple ASGI Static Proxy

• A proxy designed for static resources
• No security protection
• Support GET(Strong cache), HEAD(no cache), DELETE(remove cache)
• The client
  • Query string and request headers are ignored
  • Must support gzip
• The server
  • Upstream must support HTTPS
• For browser: Use forward-proxy tools like Header Editor

Usage

Install: pip install git+https://github.com/imba-tjd/simple-asgi-static-proxy

from simple_asgi_static_proxy import SimpleASGIStaticProxy as App
from simple_asgi_static_proxy import Option
app = App('mode1' --or-- {'mode2'}, Option())

if __name__ == '__main__':
    import uvicorn
    uvicorn.run('main:app')

Mode1

Works like a normal reverse proxy.

• Server: app = App('example.com')
• Client: curl 127.0.0.1:8000/index.html

Mode2

The first part of path is parsed as domain.

• Server: app = App({'example.com', 'example.org', 'whitelist_domain'}). Or set{} to allow any domain
• Client: curl 127.0.0.1:8000/example.com/index.html

Options

• Response HTTP Headers: By default it returns upstream headers combined with ex_resp_headers which you can override
• Disk cache: cacher = shelve.open('cache')
• Allow subdomain in mode2: subdomain = True
• Size limit: maxsize = n (bytes). Defaults to 8MB. 0 indicates no limit. Upstream must response with Content-Length in order to use this
• Throttle: max requests count per 2 seconds

TODO

• X-Forwarded-For：增加前一跳
• 测试304能否被浏览器接受