TcpGate

Posted: July 30, 2012 in TCP Gateway

Introduction

TcpGate is a proxy server that proxies client request to backend server. It plays as a port forwarding server between client and server. It has the following features:

  • Proxies TCP and UDP requests to backend server
  • Act as a simple HTTP proxy server
  • Maintains a whitelist and a blacklist for IP address pass through or blocking
  • Offers a telnet console for user, port mapping, whitelist and blacklist administration
  • Trace message contents between the clients and server
  • Log message contents in a file

Installation  (Win32)

  • Download the TcpGate zip file Win32 version here and Unix version here.
  • Follow the steps below to install the software.
    • Extract all the files into directory c:\program files\tcpgate
    • Open Windows Command Prompt, enter the following commands to register the program as Windows Service
      • cd c:\program files\tcpgate
      • tcpgate -i
    • Open ODBC Setting, create System DSN called TCPGATECFG for Microsoft Access Driver and point to tcpgate.mdb which is located in the directory c:\program files\tcpgate
    • Start the Windows Service tcpgate
    • Telnet to localhost and port number 14001, enter username tcpgate and password tcpgate01 to access the program console
    • Enter the following command in the program console, you will receive debug information
      • trace on asc
    • Enter the following command in the program console, you will get the help message
      • help

Usage

  • Proxies TCP request to backend server, type the command in the telnet console
    • add tcp 8000 10.10.10.10 8001
    • Hint: Listen port 8000, when traffics via 8000 will finally redirect to IP address 10.10.10.1o port 8001
  • Proxies TCP request to backup server when first server failed
    • add tcp 8000 10.10.10.10 8001 bkup 10.10.10.11 8001 10.10.10.12 8001
    • Hint: Two backup servers defined, they are 10.10.10.11 and 10.10.10.12
  • Act as a simple HTTP proxy server
    • add tcp 8080 * * http
  • Allows white listed IP address connect to the server
    • add whitelist 10.10.11.11 ClientMachine11
    • Hint: IP address 10.10.11.11 CAN connect to the server ports that defined by the server
  • Blocks black listed IP address
    • add blacklist 10.10.11.12 BadMachine12
    • Hint: IP address 10.10.11.12 CANNOT connect to the server ports that defined by the server
  • Log client and server messages to a file
    • log on c:\debug.txt
    • Hint: The file will be using by the program until the following command is entered
    • log off

Uninstallation

  • Stop the Window Service tcpgate
  • Open Windows Command Prompt, enter the following commands to uninstall the program from Windows Service
    • cd c:\program files\tcpgate
    • tcpgate -u
Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s