https://github.com/equim-chan/koa-virtual-host
:zap: A name-based virtual host middleware for Koa2.
https://github.com/equim-chan/koa-virtual-host
javascript koa koa2 middleware nodejs server vhost
Last synced: 3 months ago
JSON representation
:zap: A name-based virtual host middleware for Koa2.
- Host: GitHub
- URL: https://github.com/equim-chan/koa-virtual-host
- Owner: Equim-chan
- License: mit
- Created: 2017-03-31T17:52:50.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-09-18T09:57:27.000Z (over 7 years ago)
- Last Synced: 2025-10-21T02:47:53.000Z (8 months ago)
- Topics: javascript, koa, koa2, middleware, nodejs, server, vhost
- Language: JavaScript
- Homepage:
- Size: 16.6 KB
- Stars: 16
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# koa-virtual-host
[](https://www.npmjs.com/package/koa-virtual-host)
[](https://www.npmjs.com/package/koa-virtual-host)
[](https://travis-ci.org/Equim-chan/koa-virtual-host)
[](https://coveralls.io/github/Equim-chan/koa-virtual-host?branch=master)
[](https://www.versioneye.com/user/projects/58deaba3d6c98d004405475e)
[](https://www.codacy.com/app/Equim-chan/koa-virtual-host)
[](https://github.com/Equim-chan/koa-virtual-host/blob/master/LICENSE)
A name-based virtual host middleware for Koa2.
## Installation
``` shell
$ npm i --save koa-virtual-host
```
## Example
``` javascript
const Koa = require('koa');
const vhost = require('koa-virtual-host');
// Import sub Koa apps
const api = require('./apps/api');
const apex = require('./apps/apex');
const blog = require('./apps/blog');
const forum = require('./apps/forum');
const resume = require('./apps/resume');
const unicode = require('./apps/unicode');
// Set up a host
const host = new Koa();
/**
* Configure vhosts
*/
// Support string patterns
host.use(vhost('blog.example.com', blog));
// Support regexp patterns
host.use(vhost(/^(?:pro.*|resume)\.example\.com$/i, resume));
// Support pattern-app mappings as object
host.use(vhost({
'example.org': apex,
'forum.example.com': forum
}));
// Support pattern-app mappings as array of objects
host.use(vhost([{
pattern: /^b(?:bs|oard)\.example\..+$/i,
target: forum
}, {
pattern: 'api.example.com',
target: api
}]));
// Support Unicode hostname
// Support many-to-one mappings
host.use(vhost('中文域名.com', unicode));
host.use(vhost(/(?:萌|moe)/, unicode));
host.use(vhost(/[\u4E00-\u9FFF]\.io/, unicode));
// Support basic global controls serving as a usual Koa app
host.use(async (ctx, next) => {
ctx.set('Server', 'Koa Virtual Host');
await next();
});
// Listen and enjoy
host.listen(80);
```
## API
### vhost(pattern, target)
* pattern (`String` | `RegExp`) - the pattern used to match the hostname
* target (`Object`) - the Koa app
Example:
``` javascript
const Koa = require('koa');
const vhost = require('koa-virtual-host');
// You can also import them from existing modules that export ones.
const a = new Koa();
const b = new Koa();
a.use(async (ctx, next) => {
ctx.body = 'Hello';
await next();
});
b.use(async (ctx, next) => {
ctx.body = 'World';
await next();
});
const host = new Koa();
// The requests that match the pattern will be forwarded to the corresponding app.
host.use(vhost(/localhost/i, a));
host.use(vhost('127.0.0.1', b));
host.listen(8000);
```
Try to request:
``` shell
$ curl http://localhost:8000/
Hello
$ curl http://127.0.0.1:8000/
World
```
### vhost(patterns)
* patterns (`Object` | `Array`) - the pattern-app map
Notes that if you pass an `Object` to `patterns`, RegExp patterns will not be supported. To enable RegExp support, you need to pass an `Array`.
Example:
``` javascript
const Koa = require('koa');
const vhost = require('koa-virtual-host');
const a = new Koa();
const b = new Koa();
const c = new Koa();
const d = new Koa();
a.use(async (ctx, next) => {
await next();
ctx.body += ' World';
});
b.use(async (ctx, next) => {
ctx.body = 'Hello';
await next();
});
c.use(async (ctx, next) => {
await next();
ctx.set('X-Powered-By', 'Koa');
});
d.use(async (ctx, next) => {
ctx.body = 'foobar';
await next();
ctx.set('X-Powered-By', 'vhost');
});
const host = new Koa();
host.use(vhost({
'localhost': a,
'127.0.0.1': c
}));
// Additionally, if the pattern is duplicated,
// the corresponding apps will be called in order
host.use(vhost([{
pattern: 'localhost',
target: b
}, {
pattern: /^127\.0\.0\.\d+$/,
target: d
}]));
host.listen(8000);
```
Try to request:
``` shell
$ curl http://localhost:8000/
Hello World
$ curl http://127.0.0.1:8000/
foobar
$ curl -I http://127.0.0.1:8000/ 2>&1 | grep "X-Powered-By"
X-Powered-By: Koa
```
## Test
``` shell
$ npm test
```
## License
[MIT](https://github.com/Equim-chan/koa-virtual-host/blob/master/LICENSE)