# unb-reverso

> proxy reverso

Latest version **2.0.0** (published 2021-03-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install unb-reverso
pnpm add unb-reverso
yarn add unb-reverso
bun add unb-reverso
```

Provides the command `unb-reverso`.

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2021-03-23 |
| First published | 2021-03-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 13 |
| Unpacked size | 9 KB |
| Known vulnerabilities | 0 (+4 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 2 |
| Author | unb |
| Maintainers | welyngton |
| Keywords | proxy, reverso |

## Links

- npm: https://www.npmjs.com/package/unb-reverso
- Repository: https://github.com/welyngton/unb-reverso
- Homepage: https://github.com/welyngton/unb-reverso#readme
- Issues: https://github.com/welyngton/unb-reverso/issues
- npm.io page: https://npm.io/package/unb-reverso

## Dependencies (13)

- [uuid](https://npm.io/package/uuid.md) ^8.2.0
- [chalk](https://npm.io/package/chalk.md) ^4.1.0
- [piwik](https://npm.io/package/piwik.md) ^1.0.9
- [figlet](https://npm.io/package/figlet.md) ^1.4.0
- [nodemon](https://npm.io/package/nodemon.md) ^2.0.4
- [request](https://npm.io/package/request.md) ^2.88.2
- [fs-extra](https://npm.io/package/fs-extra.md) ^9.0.1
- [commander](https://npm.io/package/commander.md) ^5.1.0
- [http-proxy](https://npm.io/package/http-proxy.md) ^1.18.1
- [node-static](https://npm.io/package/node-static.md) ^0.7.11
- [proxy-agent](https://npm.io/package/proxy-agent.md) ^3.1.1
- [http-proxy-rules](https://npm.io/package/http-proxy-rules.md) ^1.1.3
- [https-proxy-agent](https://npm.io/package/https-proxy-agent.md) ^5.0.0

## Recent versions

- 2.0.0 (latest) — 2021-03-23
- 1.2.1 — 2021-03-23
- 1.1.1 — 2021-03-23
- 1.1.0 — 2021-03-23
- 1.0.1 — 2021-03-23
- 1.0.0 — 2021-03-23

## README

# unb-reverso

O objetivo deste aplicativo é fornecer um mecanismo de proxy reverso para ser utilizado durante o desenvolvimento e testes de aplicativos.
Por meio desse aplicativo é possível rodar uma aplicação com DNS de servidor localmente, evitando erros de CORS no navegador
## Instruções

Para utilizar este proxy, primeiramente clone o repositório na sua máquina:
```
git clone https://github.com/welyngton/unb-reverso.git
```

Será criado um arquivo de configuração de exemplo com o nome `unb-reverso-conf.json` na mesma pasta com seguinte formato:

```json
{
  "version": 1,
  "dominio.qa.fabrica.local": {
    "rules": {
      ".*/<minha-api>/": "http://localhost:80/api/",
      ".*/<meu-front>/pagina": "http://localhost:4200/pagina",
    },
    "default": "http://dominio.qa.fabrica.local"
  },
  "dominio2.qa.fabrica.local": {
    "rules": {
      ".*/<minha-api>/": "http://localhost:80"
    },
    "default": "http://localhost.st.fabrica.local"
  }
}
```
Em seguida o desenvolvedor deve ajustar este arquivo para os dados da aplicação que está trabalhando.

> Para mais formatos de regras consulte o projeto <https://github.com/donasaur/http-proxy-rules>

### Instalação

Dentro do diretório clonado rodar o comando 'npm install' para instalar o unb-reverso

```bash
> npm install
```

### Rodando o UNB-REVERSO
```bash
> npm start
```

#### Configurações adicionais

Adicionar no arquivo HOSTS, o domínio que se deseja rodar como LOCALHOST

Por exemplo para rodar o domínio 'dominio.qa.fabrica.local' localmente conforme o arquivo de configuração de exemplo 'unb-reverso-conf.json'

Deve-se incluir este arquivo no HOSTs do sistema operacional adicionando a linha abaixo no arquivo 'Hosts':
```
127.0.0.1  dominio.qa.fabrica.local
```

* No Windows
```
C:\Windows\System32\drivers\etc
```

* No Mac
```
/private/etc/hosts
```

* No Linux
```
/etc/hosts
```

### Desativando check host para o Angular
Caso ocorra erro de 'invalid check host' deve-se subir a aplicação com o seguinte comando
```
ng s --host 127.0.0.1 --port 4200 --disable-host-check
```

### Agradecimentos
Conheçam o trabalho do Tiago Lage Padua, responsável por toda a inspiração e orientação espiritual necessária para esta implementação
https://github.com/tiagolpadua

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