You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
59 lines
1.7 KiB
59 lines
1.7 KiB
2 years ago
|
# hexo-server
|
||
|
|
||
|
[![Build Status](https://github.com/hexojs/hexo-server/workflows/Tester/badge.svg)](https://github.com/hexojs/hexo-server/actions?query=workflow%3ATester)
|
||
|
[![NPM version](https://badge.fury.io/js/hexo-server.svg)](https://www.npmjs.com/package/hexo-server)
|
||
|
[![Coverage Status](https://img.shields.io/coveralls/hexojs/hexo-server.svg)](https://coveralls.io/r/hexojs/hexo-server?branch=master)
|
||
|
|
||
|
Server module for [Hexo].
|
||
|
|
||
|
## Installation
|
||
|
|
||
|
``` bash
|
||
|
$ npm install hexo-server --save
|
||
|
```
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
``` bash
|
||
|
$ hexo server
|
||
|
```
|
||
|
|
||
|
Option | Description | Default
|
||
|
--- | --- | ---
|
||
|
`-i`, `--ip` | Override the default server IP. | `::` when IPv6 is available, else `0.0.0.0` (note: in most systems, `::` also binds to `0.0.0.0`)
|
||
|
`-p`, `--port` | Override the default port. | 4000
|
||
|
`-s`, `--static` | Only serve static files. | false
|
||
|
`-l`, `--log [format]` | Enable logger. Override log format. | false
|
||
|
`-o`, `--open` | Immediately open the server url in your default web browser. | false
|
||
|
|
||
|
## Options
|
||
|
|
||
|
``` yaml
|
||
|
server:
|
||
|
port: 4000
|
||
|
log: false
|
||
|
ip: 0.0.0.0
|
||
|
compress: false
|
||
|
cache: false
|
||
|
header: true
|
||
|
serveStatic:
|
||
|
extensions:
|
||
|
- html
|
||
|
```
|
||
|
|
||
|
- **port**: Server port
|
||
|
- **log**: Display request info on the console. Always enabled in debug mode.
|
||
|
- **ip**: Server IP
|
||
|
- **compress**: Enable GZIP compression
|
||
|
- **cache**: Enable cache for rendered content
|
||
|
- This can speed up server response. However, any changes will no longer take effect in real time.
|
||
|
- Suitable for production environment only.
|
||
|
- **header**: Add `X-Powered-By: Hexo` header
|
||
|
- **serveStatic**: Extra options passed to [serve-static](https://github.com/expressjs/serve-static#options)
|
||
|
|
||
|
## License
|
||
|
|
||
|
MIT
|
||
|
|
||
|
[Hexo]: http://hexo.io/
|