README.zh-cn.md

httpany

English|中文

方便前端学习者使用的静态文件服务器

介绍

前端学习者经常需要在电脑上托管静态文件. 有时候一句 python3 -m http.server 就足够了, 但是很多情况下你会想让服务器返回特定的http header(例如CORS和Timing-Allow).

这个工具可以让你通过querystring来控制服务器响应的http header和状态码.

示例

$ npm install httpany -g
$ httpany yourDirectory
# "yourDirectory" is served on http://0.0.0.0:3000
# options is: {"root":"/path/to/yourDirectory","index":"index.html"}

访问 http://localhost:3000/?foo=bar , http响应的header中会包含 foo: bar.
访问 http://localhost:3000/?status=302&location=https://github.com/flowmemo , 会返回一个302页面跳转到我的GitHub.

你也可以在querystring中设置status来控制响应的http状态码.

用法

$ httpany <路径> [参数]

参数

--help, -h    显示端口
--port, -p    监听端口, 默认为3000
--address, -a 监听地址, 默认为0.0.0.0


下面的参数来自koa-static:
--maxage      Browser cache max-age in milliseconds. defaults to 0
--hidden      Allow transfer of hidden files. defaults to false
--index       Default file name, defaults to 'index.html'
--defer       If true, serves after return next(), allowing any downstream middleware to respond first.
--gzip        Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file with .gz extension exists. (defaults to true)
--extensions  Try to match extensions from passed array to search for file when no extension is sufficed in URL. First found is served. (defaults to false)

注意

Access-Control-Allow-Origin 默认设置为*. 你可以把此项设置为null来禁用它.

许可

MIT © flowmemo