A simple proxy server created for https://postwoman.io
Find a file
2020-06-09 22:43:59 +01:00
.github/workflows Ensure build script only runs on push to version tags 2020-06-09 22:43:59 +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 Rebrand to Proxywoman 2020-06-08 21:50:58 +01:00
libproxy Add linux support 2020-06-09 22:17:39 +01:00
notifier Add Windows support 2019-12-18 18:08:52 +00:00
resources Set up version number injection 2020-06-09 00:34:55 +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 Add branding to build script 2020-06-09 22:39:37 +01:00
Dockerfile Changed to a non-root user. 2020-04-20 13:26:47 +02:00
go.mod Rebrand to Proxywoman 2020-06-08 21:50:58 +01:00
go.sum Rebrand to Proxywoman 2020-06-08 21:50:58 +01:00
main.go Set up version number injection 2020-06-09 00:34:55 +01:00
README.md Ensure build script only runs on push to version tags 2020-06-09 22:43:59 +01:00
stale_outputs_checked Add linux support 2020-06-09 22:17:39 +01:00
version.properties Add linux support 2020-06-09 22:17:39 +01:00

Postwoman

Proxywoman

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.

Installation 📦

Proxywoman requires zenity on Linux. This is available in most distribution package managers.

We're still working on automated installers. For now, copy the binary to a user-writeable location and launch the application.
A dialog will open and explain the certificate installation process - there are more detailed instructions in our wiki.

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.