暫無描述

afrokick 8f3cdaec75 add info about account on docker hub		5 年之前
.github	279d43f49b Create dockerimage.yml	5 年之前
bin	dd0b60416e ref	5 年之前
dist	a956168f55 fix issue with expire messages	5 年之前
src	a956168f55 fix issue with expire messages	5 年之前
test	f2bb45b926 fix test	5 年之前
.eslintignore	42a626629b add eslint for ts	5 年之前
.eslintrc.json	c4f04b2ff8 add tests for WebSocketServer	5 年之前
.gitignore	dd0b60416e ref	5 年之前
.gitpod.yml	8c48d6092a Update .gitpod.yml	5 年之前
.travis.yml	1e09fcfb64 ref	6 年之前
Dockerfile	2ee176e690 fix Dockerfile	5 年之前
LICENSE	b8dbd1f249 license and updated package json	12 年之前
README.md	8f3cdaec75 add info about account on docker hub	5 年之前
app.json	bd101ab44f enable "Deploy to Heroku" Button	10 年之前
changelog.md	5e8d824ee4 fix npm audit	5 年之前
package-lock.json	5e8d824ee4 fix npm audit	5 年之前
package.json	f8720f3ee3 fix main field in package.json	5 年之前
tsconfig.json	7c23ed8351 fix warnings	5 年之前

PeerServer: A server for PeerJS

PeerServer helps broker connections between PeerJS clients. Data is not proxied through the server.

Run your own server on Gitpod!

https://peerjs.com

Run PeerServer

Install PeerServer from npm or github:

NPM

npm install peer

github

git clone https://github.com/peers/peerjs-server.git#master
npm install

Run the server:

$> peerjs --port 9000 --key peerjs --path /myapp

Or, create a custom server:

const { PeerServer } = require('peer');
const server = PeerServer({port: 9000, path: '/myapp'});

Check that server works: open browser with http://localhost:9000/myapp It should returns JSON with name, description and website fields.

Connecting to the server from PeerJS:

<script>
    const peer = new Peer('someid', {host: 'localhost', port: 9000, path: '/myapp'});
</script>

Using HTTPS: Simply pass in PEM-encoded certificate and key.

const fs = require('fs');
const { PeerServer } = require('peer');

const server = PeerServer({
  port: 9000,
  ssl: {
    key: fs.readFileSync('/path/to/your/ssl/key/here.key'),
    cert: fs.readFileSync('/path/to/your/ssl/certificate/here.crt')
  }
});

Running PeerServer behind a reverse proxy

Make sure to set the proxied option, otherwise IP based limiting will fail. The option is passed verbatim to the expressjs trust proxy setting if it is truthy.

const { PeerServer } = require('peer');
const server = PeerServer({port: 9000, path: '/myapp', proxied: true});

Combining with existing express app

const express = require('express');
const app = express();
const { ExpressPeerServer } = require('peer');

app.get('/', (req, res, next) => { res.send('Hello world!'); });

// =======

const server = app.listen(9000);

const options = {
    debug: true,
    path: '/peerjs'
}

const peerserver = ExpressPeerServer(server, options);

app.use(options.path, peerserver);

// == OR ==

const server = require('http').createServer(app);
const peerserver = ExpressPeerServer(server, options);

app.use(options.path, peerserver);

server.listen(9000);

// ========

Events

The 'connection' event is emitted when a peer connects to the server.

peerserver.on('connection', (client) => { ... });

The 'disconnect' event is emitted when a peer disconnects from the server or when the peer can no longer be reached.

peerserver.on('disconnect', (client) => { ... });

Running tests

npm test

Docker

We have 'ready to use' images on docker hub: https://hub.docker.com/r/peerjs/peerjs-server

To run the latest image:

docker run -p 9000:9000 -d peerjs/peerjs-server

You can build a new image simply by calling:

docker build -t myimage https://github.com/peers/peerjs-server.git

To run the image execute this:

docker run -p 9000:9000 -d myimage

This will start a peerjs server on port 9000 exposed on port 9000 with key peerjs on path /myapp.

Open browser with http://localhost:9000/myapp It should returns JSON with name, description and website fields.

Problems?

Discuss PeerJS on our Telegram chat: https://t.me/joinchat/ENhPuhTvhm8WlIxTjQf7Og

Please post any bugs as a Github issue.

README.md