# tunnels

> A simple SSL terminator written in NodeJS.

Latest version **0.0.2** (published 2013-09-18) · 0 weekly downloads

## Install

```sh
npm install tunnels
pnpm add tunnels
yarn add tunnels
bun add tunnels
```

Provides the command `tunnels`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.2 |
| Published | 2013-09-18 |
| First published | 2013-09-18 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | bobzoller |

## Links

- npm: https://www.npmjs.com/package/tunnels
- Homepage: http://goodeggs.github.com/tunnels/
- npm.io page: https://npm.io/package/tunnels

## Dependencies (1)

- [http-proxy](https://npm.io/package/http-proxy.md) *

## Recent versions

- 0.0.2 (latest) — 2013-09-18
- 0.0.1 — 2013-09-18

## README

# node-tunnels

A simple npm module and binary to terminate and forward SSL connections.

This is intended to be used to make local web development easier, not to be run in production.  tunnels was inspired by https://github.com/jugyo/tunnels

## Install

```
npm install -g tunnels
```

## Setup

### Generate Your Certificates

tunnels expects a `server.crt`, `server.key` and `ca.crt` in `~/.tunnels`.

Here's a set of commands that will give you certs good for 5 years:

```
mkdir ~/.tunnels
cd ~/.tunnels
openssl genrsa -out ca.key 4096
openssl req -new -x509 -days 1826 -key ca.key -out ca.crt
openssl genrsa -out server.key 4096
openssl req -new -key server.key -out server.csr
openssl x509 -req -days 1826 -in server.csr -CA ca.crt -CAkey ca.key -set_serial 01 -out server.crt
```

### Install Root CA

You'll also want to install your `ca.crt` in your browser.  On OSX you can add it to the keychain like so:

```
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/.tunnels/ca.crt
```

## Run it!

```
sudo tunnels
```

## Great in combination with

* [Pow](http://pow.cx/)

---
_Source: https://npm.io/package/tunnels · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._