sshproxyd(8)
NAME
sshproxyd - sshproxy daemon
SYNOPSIS
sshproxyd [--config-dir cfgdir] Normal run (in the foreground). sshproxyd [--config-dir cfgdir] --daemon [--user user] [--pid pidfile] Run daemonized (in the background).
DESCRIPTION
sshproxyd acts as an authenticating proxy gateway for SSH2 connections.
It does not use ssh(1) nor sshd(8) but implements its own SSH2 stack
with the paramiko library.
OPTIONS
- --config-dir (-c)
- Specify a configuration directory where sshproxyd will find the main configuration file sshproxy.ini(5) and the private DSA private key id_dsa. Default value is ~/.sshproxy.
- --daemon (-d)
- Run sshproxyd in daemon mode. In daemon mode, sshproxyd puts itself in the background and runs forever, waiting for incomming connections.
- --user (-u)
- Run sshproxyd as user. This option is mandatory if sshproxyd is run as root.
- --pid (-p)
- Record the process id of the daemon in the file pidfile. Default is /var/run/sshproxyd.pid.
FILES
- ~/.sshproxy/sshproxy.ini
- The main configuration file. See sshproxy.ini for further details.
- ~/.sshproxy/id_dsa
- The private hostkey file. This hostkey is automatically generated by sshproxyd at startup if it doesn't exist.
- /var/run/sshproxyd.pid
- The pid file, mostly useful when sshproxyd is run with the -d option.
ENVIRONMENT
- SSHPROXY_CONFIG
- If non-null the full path to the configuration directory. Equivalent to the -c option.
DIAGNOSTICS
Two debug logs are generated when sshproxyd is running:
- ~/.sshproxy/log/paramiko.log
- This file contains paramiko's debug messages, relative to the SSH2 protocol.
- ~/.sshproxy/log/sshproxy.log
- This file contains sshproxy's debug messages, relative to authentication, ACLs and proxying.
BUGS
- Not all features of sshd(8) are implemented yet. sshproxyd currently
provides the following features:
- Remote shell
Remote command execution
X11 forwarding
scp file transfer
remote port forwarding
local port forwarding - You can report any bug found on the sshproxy mailing list:
sshproxy@penguin.fr
AUTHOR
David Guerizec <david@guerizec.net>
SEE ALSO
sshproxy-setup(1), pssh(1), pscp(1), sshproxy.ini(5),
The paramiko home page: <http://www.lag.net/paramiko/>
The sshproxy home page: <http://sshproxy-project.org/>
- The sshproxy online documentation:
- <http://sshproxy-project.org/documentation/>