https://github.com/chakrit/tcpmole

Commandline tool and CommonJS module for quickly creating tcp tunnel on localhost to another machine. Ease the pain of working with inter-machine services.
https://github.com/chakrit/tcpmole

Last synced: about 23 hours ago
JSON representation

Commandline tool and CommonJS module for quickly creating tcp tunnel on localhost to another machine. Ease the pain of working with inter-machine services.

• Host: GitHub
• URL: https://github.com/chakrit/tcpmole
• Owner: chakrit
• Created: 2012-12-10T17:56:55.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2012-12-11T09:37:04.000Z (almost 12 years ago)
• Last Synced: 2024-04-27T01:42:58.412Z (7 months ago)
• Language: CoffeeScript
• Homepage:
• Size: 109 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        

[![Travis CI badge](https://secure.travis-ci.org/chakrit/tcpmole.png)](http://travis-ci.org/chakrit/tcpmole)

# TCPMOLE

Creats quick-and-dirty ad-hoc local tcp connection tunnel / proxy to another port / machine.

```sh

$ npm install -g tcpmole

```

### How to

EXAMPLE: Create local tunnels to run your redis-based tests on production servers:

```sh

$ tcpmole 6379 your-amazon-host.amazon.com:6379

```

This will makes your local port 6379 actually connects to amazon! :)

### Also good for monitoring stuff

Wanna see all the live traffic going through the tunnel? Just add `--monitor`!

```sh

$ tcpmole --monitor 6379 your-amazon-host.amazon.com:6379

```

### Also works for websites as well.

Much easier than writing obscure package capture language for sure!

```sh

$ tcpmole --monitor 80 3000

```

Now sends something to port 80 and you should see the HTTP packets being sent.

### Uses as a module

Right now the mole exports a simple function that creates proxying server when invoked:

```js

var mole = require('tcpmole')

  , opts =

    { src: { port: 80 }

    , dest: { host: '0.0.0.0', port: 8080 }

    }

  , tunnel = mole(opts);

tunnel.on('connection', function() {

  // a connection has been made to the mole

});

```

# LICENSE

BSD

# SUPPORT / CONTRIBUTE

Just opens [a new GitHub issue](https://github.com/chakrit/tcpmole/issues/new),

pings me on Twitter [@chakrit](https://twitter.com/chakrit),

or if you see me on the node.js irc channel (by the name chakrit), just ask me there :)