Project

masquito

0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Masquito is a DNS masquerading server for rubists and their applications
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0

Runtime

 Project Readme

PLEASE NOTE, THIS PROJECT IS NO LONGER BEING MAINTAINED

Masquito

This gem is for DNS masquerading for rubists. Everyone knows Pow, but what I really don't like that it uses node.js to run Ruby applications. Sometimes we have to run our apps on the certain domain. Masquito allows you to do it, you can create dns records in the similar Pow's way by creating symbolic links to your apps or just empty files in .masquito directory.

Sponsored by Evrone

Getting Started

Prerequisites

Symbolic links were used by Pow in order to refer your application that will be run automatically, since Masquito doesn't run applications and does just DNS masquerading it's simplier to create just empty files. Check out another gem https://github.com/route/pump for full Pow's replacement.

Installation

First of all, uninstall Pow if you have it installed. I suppose you're on rbenv (honestly I haven't checked rvm support).

Install gem:

$ gem install masquito
$ rbenv rehash

Run this:

$ sudo masquito install

This command installs masquito server as a daemon that your system will start every boot. This daemon will respond on DNS queries from your system and monitor ~/.masquito directory for newly created domains.

Usage

Once you have installed masquito you can add domains to ~/.masquito

$ cd ~/.masquito
$ touch yoursite.com

It will create for you yoursite.com domain with the wild card for all subdomains and you can already ping and use it for the development.

$ ping yoursite.com
PING yoursite.com (127.0.0.1): 56 data bytes
64 bytes from 127.0.0.1: icmp_seq=0 ttl=53 time=1 ms

$ ping host.sub.yoursite.com
PING host.sub.yoursite.com (127.0.0.1): 56 data bytes
64 bytes from 127.0.0.1: icmp_seq=0 ttl=53 time=1 ms

Run your favorite application server manually, open up your browser and fill in address with port, that's all.

Contributing

Please read Code of Conduct and Contributing Guidelines for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License.