js-frp
v0.2.1
Published
A library written in TypeScript for managing FRP instances. FRP is a fast reverse proxy to help you expose a local server behind a NAT or firewall to the Internet.
Downloads
11
Readme
js-frp
js-frp
is a JavaScript library written in TypeScript for managing FRP instances. FRP is a fast reverse proxy to help you expose a local server behind a NAT or firewall to the Internet.
js-frp
provides complete type support for all FRP configuration.
Find out more about FRP on the official respository here.
Installing
Install js-frp using npm by running:
npm install js-frp
Usage
js-frp
exposes two classes: FRPClient
and FRPServer
. Both classes work very similarly. Whether you're running a server or a client you must provide your config. You can do this in three ways. The first way is the most practical way, when creating an instance you provide your config as an object. The second way is to use .setConfig(config)
after creating your instance and providing your config and the third way is running .setConfigRaw(rawConfig)
where you can input a raw ini formatted string.
Now you can start your instance with .start()
.
You can find all config fields in the FRP repository which can be accessed by clicking here. Each section should be a separate key in your object.
Example
Client example:
Find all available client configuration options by clicking here.
const { FRPClient } = require('js-frp');
const client = new FRPClient({
common: {
server_addr: '127.0.0.1',
server_port: 7000
},
ssh: {
type: 'tcp',
local_ip: '127.0.0.1',
local_port: 22,
remote_port: 6000
}
});
client.on('started', () => {
// Event is triggered when the FRP process begins to be launched, due to the fact the FRP executables will need to be downloaded if you haven't run FRP before, you should always wait for this event instead of assuming everything will be available instantly after calling frp.start()
// At this point client.process (and client.stdout) will become available.
});
client.on('spawned', () => {
// Event is trigged when the FRP process spawns succesfully
console.log('The FRP client process has been started.');
});
client.on('closed', () => {
console.log('The FRP process has stopped.');
// If you wish to be safe and you don't want the client to stop you can call client.start() on close to automatically restart the client.
});
client.on('message', (msg) => {
// An alternative to using client.stdout where the messages are parsed to strings for you.
console.log(msg);
});
client.start();
// You can use client.stop() if you need to stop the client at any point
Server example:
Server works almost exactly the same as client, all above events apply so will not be repeated in this example.
Find all available server configuration options by clicking here.
const { FRPServer } = require('js-frp');
const server = new FRPServer({
common: {
bind_port: 7000
}
});
server.start();
Find more examples using js-frp
by clicking here.
License
The code in js-frp
is licensed with an MIT license. FRP is licensed with Apache License.