replocal

Proxy for replacing web contents with local files.

Replocal is a command line tool which runs local proxy server for web debugging. This proxy server intercepts HTTP requests and replaces web contents with local files.

$ replocal example.com

Getting started

Install

Install replocal CLI via npm. Make sure you install Node.js beforehand.

$ npm install -g replocal

Usage

$ replocal example.com

Then, proxy server will start on localhost:8888.

When you access http://example.com/ using this proxy, the web content should be replaced with index.html on your current working directory.
If you don't have index.html on local, the original content will be served.

You can also serve CSS, JavaScript, images, etc. from your local file system including subdirectories.

Command

replocal [options] <hostname> [<directory>]

Start proxy server for replacing web contents with local files.
Your current working directory will be mapped to the document root by default.
If you want to change the document root, set <directory> argument.

Options

• -p, --port <number>
  Port number of proxy server. (default: 8888)

• -u, --upstream <host:port>
  Upstream proxy between replocal and the Internet.

• --network <profile>
  Network throttling. (profiles: gprs, 2g, 3g, 4g, dsl, wifi)

• --silent
  Print nothing to stdout.

• -h, --help
  Output usage information.

• -V, --version
  Output the version number.

Example

$ replocal --port 9999 --upstream proxy:8080 --network 3g example.com path/to/docroot

# Proxy server is running on localhost:9999
#   Target website   : example.com
#   Document root    : /Users/htanjo/path/to/docroot
#   Upstream proxy   : proxy:8080
#   Network throttle : 3G (750kb/s, 40ms RTT)

License

Copyright (c) 2015-2017 Hiroyuki Tanjo. Licensed under the MIT License.