A simple proxy server created for https://postwoman.io
Find a file
2020-06-08 21:30:29 +01:00
.github/workflows Attempt build on individual respective platforms 2020-06-08 21:24:56 +01:00
dist Update goreleaser config 2020-06-07 19:05:44 +01:00
icons Update goreleaser config 2020-06-07 19:05:44 +01:00
inputbox Add Windows support 2019-12-18 18:08:52 +00:00
installers Improve build tooling. 2019-12-19 13:28:20 +00:00
libproxy Merge pull request #11 from gringofe/body-crash-fix 2020-01-17 16:44:06 -06:00
notifier Add Windows support 2019-12-18 18:08:52 +00:00
resources Start goreleaser conf 2020-06-07 17:57:42 +01:00
server Add Windows support 2019-12-18 18:08:52 +00:00
.gitignore Ignore out/ 2019-12-18 18:11:56 +00:00
build.sh String comparison in POSIX sh needs to be done via single eq symbols. 2020-04-20 17:32:50 +02:00
Dockerfile Changed to a non-root user. 2020-04-20 13:26:47 +02:00
go.mod Add session fingerprint to improve auto-discovery. 2019-12-19 22:58:57 +00:00
go.sum Add session fingerprint to improve auto-discovery. 2019-12-19 22:58:57 +00:00
main.go Add Windows support 2019-12-18 18:08:52 +00:00
README.md Update README.md 2020-06-07 17:06:17 +01:00

Postwoman

Postwoman Proxy

API request builder - Helps you create your requests faster, saving you precious time on your development.


A simple proxy server created by @NBTX for Postwoman and hosted by Apollo Software.

Demo 🚀

https://postwoman.io

Building 🏗️

These are bash scripts. In order to execute them on Windows, you will need to use some form of bash shell on Windows. We recommend Git Bash.

  • macOS:
# To build the desktop tray application:
$ ./build.sh darwin

# To build the server application:
$ ./build.sh darwin server
  • For Linux desktops:
# To build the desktop tray application:
$ ./build.sh linux

# To build the server application:
$ ./build.sh linux server
  • For Windows desktops:
# To build the desktop tray application:
$ ./build.sh windows

# To build the server application:
$ ./build.sh windows server

The build output is placed in the out/ directory.

Installers 🧙

The installers/ directory contains scripts for each platform to generate an installer application.
Each platform's installer directory, contains the relevant information for that installer.

Usage 👨‍💻

Desktops 🖥️

The proxy will add a tray icon to the native system tray for your platform, which will contain all of the options for the proxy.

Servers 🖧

To use the proxy on a server, clone the package, build the server using the instructions above, and use:

$ ./out/<platform>-server/server --host="<hostname>:<port>" --token="<token_or_blank>"

# e.g. on Linux
$ ./out/linux-server/server --host="<hostname>:<port>" --token="<token_or_blank>"

# or on Windows
$ ./out/windows-server/server.exe --host="<hostname>:<port>" --token="<token_or_blank>"
  • The host and token parameters are optional. The defaults are as follows:
  • host: localhost:9159
  • token: blank; allowing anyone to access (see below)

NOTE: When the token is blank it will allow anybody to access your proxy server. This may be what you want, but please be sure to consider the security implications.