Skip to content

marcus67/proxy_ping

Repository files navigation

ProxyPingLogo

Ping Through Proxy Utility ProxyPing

Overview

The utility ProxyPing is a simple tool to ping servers behind a firewall that will not let ICMP packages through. It provides a HTTP server answering to ping requests and returning the ping delay as a HTTP text result. The tool will have to be deployed on a server behind the firewall that can be reached by a configurable TCP connection (defaulting to port TCP 6666).

Suppose the tool is deployed on server my.proxy.behind.wall and the server to be pinged is called some.other.server the required HTTP query will have to look like this:

http://my.proxy.behind.wall/api/ping?host=some.other.server 

Change History

See here

GitHub Status

SourceForge Download Status

Download ProxyPing

Continuous Integration Status Overview

Status Main Release
CircleCI
Test Coverage
Snyk Vulnerability Known Vulnerabilities Known Vulnerabilities
Codacy Code Quality
Code Climate not available

Note: The vulnerability status is derived from the Python PIP packages found in requirements.txt.

Features

Tested Distributions

So far, ProxyPing has only been released as a Debian package. For other non-Debian based distributions there is some basic support using a generic installation script.

Distribution Version Architecture Comments Most Recent Test
Debian debian/sid amd64 2021-02-13

Quick Install (Debian Package)

This guide will take you through the steps required to install, configure, and run the ProxyPing application on your system.

Download the Software

The application is available as a Debian package from the release directory at SourceForge. The latest build is available from the main directory. Install it as you would install any other Debian package with

dpkg -i PACKAGE.deb
apt-get install -f

Note that the second command is required to install missing dependencies since dpkg does not run a dependency check. Instead, it will return with an error which will then be "fixed" by apt-get.

After installation use

systemctl start proxy-ping

to start the application right away. The application will successfully start up provided that the default port 6666 is available on the host.

Configuring the Application (Mostly Optional)

The application is configured using the file /etc/proxy-ping.config. The default values should work for most contexts. This will bring up the server on port 6666.

Credits

  • Thanks to all the people maintaining the wonderful script language Python and the libraries on PyPi.

About

Simple tool to ping servers behind a firewall that will not let ICMP packages through.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published