@actra-development-oss/http-server 中文文档教程
http-server: a command-line http server
http-server
是一个简单的零配置命令行 http 服务器。 它对于生产用途来说足够强大,但它又足够简单和易于破解,可以用于测试、本地开发和学习。
Installing globally:
通过 npm
安装:
npm install http-server -g
这将安装 http-server
全局,以便它可以从命令行运行。
Usage:
http-server [path] [options]
如果文件夹存在,[path]
默认为 ./public
,否则为 ./
。
现在您可以访问 http://localhost:8080 来查看您的服务器
注意:默认情况下缓存是打开的。 添加 -c-1
作为禁用缓存的选项。
Available Options:
-p
要使用的端口(默认为 8080)
-a
要使用的地址(默认为 0.0.0.0)-d< /code> 显示目录列表(默认为“True”)
-i
显示自动索引(默认为“True”)
-f
或 -- fallback=
通过将失败的请求 (404) 重定向到给定的 URL
-g
或 --gzip
启用回退处理(默认为 ' False') 它会提供 ./public/some-file.js.gz
而不是 ./public/some-file.js
存在并且请求接受 gzip 编码。
-e [ext]
或 --ext[=ext]
如果未提供默认文件扩展名(当未指定 -e 或 --ext 时默认为 'html'一个扩展)
-s
或 --silent
从输出中抑制日志消息
--cors[=headers]
通过 Access 启用 CORS -Control-Allow-Origin
标头,可选地指定额外允许的标头作为逗号分隔列表
-o [url]
启动服务器后打开浏览器窗口,可选地指定完整的 URL(包括协议和主机)以打开
-c[seconds]
为缓存控制 max-age 标头设置缓存时间(以秒为单位),例如 -c10 为 10 秒(默认为“3600”)。 要禁用缓存,请使用 -c-1。
-U
或 --utc
在日志消息中使用 UTC 时间格式。
-P
或 --proxy=
将无法在本地解析到给定 url 的所有请求代理。 例如:-P http://someurl.com
-S
或 --ssl
启用 https。
-C [path]
或 --cert[=path]
ssl 证书文件的路径(默认值:cert.pem)。
-K [path]
或 --key[=path]
ssl 密钥文件的路径(默认值:key.pem)。
-r [string]
或 --robots[=string]
提供一个 /robots.txt(其内容默认为 'User-agent: *\nDisallow: /')
-h
或 --help
打印此列表并退出。
Magic Files
index.html
will be served as the default file to any directory requests.404.html
will be served if a file is not found. This can be used for Single-Page App (SPA) hosting to serve the entry page.
Development
在本地检查此存储库,然后:
$ npm i
$ node bin/http-server
现在您可以访问 http://localhost:8080 来查看您的服务器
您应该会在上面的屏幕截图中看到托管在该 URL 上的海龟图像。 看 用于演示内容的 ./public
文件夹。
http-server: a command-line http server
http-server
is a simple, zero-configuration command-line http server. It is powerful enough for production usage, but it's simple and hackable enough to be used for testing, local development, and learning.
Installing globally:
Installation via npm
:
npm install http-server -g
This will install http-server
globally so that it may be run from the command line.
Usage:
http-server [path] [options]
[path]
defaults to ./public
if the folder exists, and ./
otherwise.
Now you can visit http://localhost:8080 to view your server
Note: Caching is on by default. Add -c-1
as an option to disable caching.
Available Options:
-p <port>
Port to use (defaults to 8080)
-a <address>
Address to use (defaults to 0.0.0.0)
-d
Show directory listings (defaults to 'True')
-i
Display autoIndex (defaults to 'True')
-f <path>
or --fallback=<path>
Enable fallback handling by redirecting failed requests (404) to the given URL
-g
or --gzip
When enabled (defaults to 'False') it will serve ./public/some-file.js.gz
in place of ./public/some-file.js
when a gzipped version of the file exists and the request accepts gzip encoding.
-e [ext]
or --ext[=ext]
Default file extension if none supplied (defaults to 'html' when -e or --ext is specified without giving an extension)
-s
or --silent
Suppress log messages from output
--cors[=headers]
Enable CORS via the Access-Control-Allow-Origin
header, optionally specify additionally allowed headers as comma-separated list
-o [url]
Open browser window after starting the server, optionally specify the full URL (including protocol and host) to open
-c[seconds]
Set cache time (in seconds) for cache-control max-age header, e.g. -c10 for 10 seconds (defaults to '3600'). To disable caching, use -c-1.
-U
or --utc
Use UTC time format in log messages.
-P <url>
or --proxy=<url>
Proxies all requests which can't be resolved locally to the given url. e.g.: -P http://someurl.com
-S
or --ssl
Enable https.
-C [path]
or --cert[=path]
Path to ssl cert file (default: cert.pem).
-K [path]
or --key[=path]
Path to ssl key file (default: key.pem).
-r [string]
or --robots[=string]
Provide a /robots.txt (whose content defaults to 'User-agent: *\nDisallow: /')
-h
or --help
Print this list and exit.
Magic Files
index.html
will be served as the default file to any directory requests.404.html
will be served if a file is not found. This can be used for Single-Page App (SPA) hosting to serve the entry page.
Development
Checkout this repository locally, then:
$ npm i
$ node bin/http-server
Now you can visit http://localhost:8080 to view your server
You should see the turtle image in the screenshot above hosted at that URL. See the ./public
folder for demo content.