How To Install HOPM

Introduction

HOPM (Hybrid Open Proxy Monitor) is an open-proxy monitoring bot designed to monitor an individual server (all servers on the network have to run their own bot if the IRCD does not support `farconnect` user mode) with a local operator {} block and monitor connections. When a client connects to a server, HOPM will scan the connection for insecure proxies. Insecure proxies are determined by attempting to connect the proxy back to another host (usually the IRC server in question). HOPM is written ground-up in C language and it is an improved fork of BOPM (blitzed open proxy monitor), which is a concept derived from wgmon. It improves on wgmon with HTTP support, faster scanning (it can scan clients simultaneously), better layout (scalability) and DNSBL support.


Requirements

* An IRCD, which presents connection notices in a format, which HOPM recognizes;

* A host with full connectivity for all the ports you wish to scan. i.e. is NOT transparently proxied -- many domestic Internet connections have port 80 transparently proxied and this produces completely unpredictable results, sometimes as severe as 100% of clients being K:lined;

* A UNIX OS with GNU make, a C99 compiler, etc.;
* Permission from your users to portscan them for open proxies;
* For HTTPS proxy detection, a working LibreSSL/OpenSSL library is required.

Compatibility

* ircd-hybrid 8.2.x
* ircd-ratbox 3.0.x
* ircu 2.10.x
* InspIRCd 2.0.x
* UnrealIRCd 3.2.x, 4.0.x
* ngIRCd 22
* Bahamut 2.0.x
* Charybdis 3.4.x

HOPM is easily suitable for any other IRCD with little modification (`connregex` in hopm.conf). However, if an IRCD does not send IP addresses in a connection notice, HOPM will not work.


Installation

    wget http://serbiancafe.ws/hopm-1.1.3.tgz
    tar xvzf hopm-1.1.3.tgz
    cd hopm1.1.3
    ./configure
    make
    make install
    cd $HOME/hopm
    edit $HOME/hopm/etc/hopm.conf to suit
    $HOME/hopm/bin/hopm or cd hopm/bin and ./hopm