https://github.com/jcmoraisjr/simple-proxy

TCP proxy using dynamic configuration
https://github.com/jcmoraisjr/simple-proxy

Last synced: 3 months ago
JSON representation

TCP proxy using dynamic configuration

• Host: GitHub
• URL: https://github.com/jcmoraisjr/simple-proxy
• Owner: jcmoraisjr
• Created: 2016-10-09T19:28:20.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-10-28T19:31:43.000Z (over 8 years ago)
• Last Synced: 2025-01-20T14:50:10.783Z (5 months ago)
• Language: Shell
• Homepage:
• Size: 2.93 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Simple-Proxy

A simple way to create a TCP proxy with dynamic configuration.

Simple Proxy uses HAProxy.

[![Docker Repository on Quay](https://quay.io/repository/jcmoraisjr/simple-proxy/status "Docker Repository on Quay")](https://quay.io/repository/jcmoraisjr/simple-proxy)

# Usage

Configure and run the proxy:

	docker run -d -p 1936:1936 -p : quay.io/jcmoraisjr/simple-proxy:latest --proxy-port= --server-list= --log-endpoint=

See options below.

# Options

* `--proxy-port` is the listening port of the proxy.

* `--server-list` is a comma-separated list of `IP:PORT`. If more than one `IP:PORT` is used, proxy will load balance the requests.

* `--log-endpoint` is an optional `ip:port` udp syslog endpoint. If not specified, Simple Proxy will start a syslogd daemon and write HAProxy logs to stdout.

Simple Proxy uses `1936` as the listening port of the status page.

# Deploy

The following unit deploys Simple Proxy as a systemd unit.

Change `` and `` to the listening port and list of servers.

Change `` to the `IP:PORT` of the external syslog daemon or remove the option `--log-endpoint`.

	[Unit]

	Description=Simple Proxy

	After=docker.service

	Requires=docker.service

	[Service]

	ExecStartPre=-/usr/bin/docker stop simple-proxy

	ExecStartPre=-/usr/bin/docker rm simple-proxy

	ExecStart=/usr/bin/docker run \

	  -p 1936:1936 \

	  -p : \

	  quay.io/jcmoraisjr/simple-proxy:latest \

		--log-endpoint= \

		--proxy-port= \

		--server-list=

	RestartSec=10s

	Restart=always

	[Install]

	WantedBy=multi-user.target