Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edwinm/testproxy
Connect from (mobile) devices to your locally running, non public websites
https://github.com/edwinm/testproxy
docker node proxy testing vagrant
Last synced: about 2 months ago
JSON representation
Connect from (mobile) devices to your locally running, non public websites
- Host: GitHub
- URL: https://github.com/edwinm/testproxy
- Owner: edwinm
- License: mit
- Created: 2016-04-23T10:08:27.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-10-07T19:11:49.000Z (3 months ago)
- Last Synced: 2024-10-13T23:21:47.669Z (2 months ago)
- Topics: docker, node, proxy, testing, vagrant
- Language: JavaScript
- Homepage:
- Size: 116 KB
- Stars: 11
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Carbonium](https://raw.githubusercontent.com/edwinm/testProxy/master/illustration.jpeg)](#readme)
# testproxy
Connect from (mobile) devices to your locally running, non public websites
If you are running a webserver as localhost, with a local webserver or in a virtual machine or container like
VirtualBox, VMware, Vagrant or Docker,
you can't always access this webserver from other computers or mobile devices, even on the same network.Testproxy will create a proxy to this local webserver and makes them available to other devices on the
same (Wi-Fi) network. All without any configuration.## Running
Assuming http://localhost:8080/ is working in your local browser but nowhere else:
```bash
npx testproxy http://localhost:8080/
```The first time it will ask you to install testproxy. Press enter to proceed.
If the command npm is not found, you have to install the Node.js and npm combination.
Go to https://nodejs.org/ and install Node.js. Then type the command above again.Testproxy will respond with something like:
```
Listening on http://192.168.0.93:6239
```And it will show a QR code.
Type the URL in the browser on your mobile device or scan the QR code and the website will appear.
Make sure the computer and other device are connected by the same (WiFi) network.Type CTRL-C to stop testproxy.
## Parameters
```bash
npx testproxy [-l] [-noqr]
```**url**: the same url as you use for local development
**port** (optional): the port to listen to
**-noqr** turn off showing the QR code
## Example
To make your local website `test.mycompany` available on port 9000 without showing the QR code:
```bash
npx testproxy http://test.mycompany/ -l9000 -noqr
```You can connect different domain names to different port numbers at the same time.
Testproxy does not work with https connections.## Highly secured WiFi
Some WiFi networks are highly secured and prevent you from accessing other computers on the same network.
Here are some solutions to this problem:
- Connect the host computer and the other computer or mobile to the same guest Wi-Fi network.
- Configure one device as a hotspot and connect your other device to this hotspot.
- Use another, unprotected Wi-Fi network for development and test purposes,
installing a dedicated Wi-Fi access point if needed.## License
Testproxy is copyright 2023 Edwin Martin and MIT licensed.