Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcus67/proxy_ping

Simple tool to ping servers behind a firewall that will not let ICMP packages through.
https://github.com/marcus67/proxy_ping

debian firewall ping python3 remote service

Last synced: 9 days ago
JSON representation

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

Awesome Lists containing this project

README

        

![ProxyPingLogo](doc/proxy_ping_logo_256x256.png)

# 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](CHANGES.md)

## 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`](https://sourceforge.net/projects/proxy-ping/files/release/) directory at SourceForge.
The latest build is available from the [`main`](https://sourceforge.net/projects/proxy-ping/files/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`](etc/proxy-ping.template.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](https://www.python.org/)
and the libraries on [PyPi](https://pypi.org/).