Skip to main content

a tool tunneling ssh over http proxy;

Project description


a tool tunneling ssh over http proxy;

churchkey tunnels ssh sessions through http proxy, so that users can log into remote server via http proxy if direct access is not working; churchkey uses http connect method and only works with http proxies supporting this method;

churchkey supports two http authentication methods: basic and digest;

technical details are described in rfc 2817;

alternative projects include corkscrew and proxytunnel;


install via pip:

pip install churchkey


  1. create a file ~/.ssh/proxyauth with proxy username and password:

  2. edit ~/.ssh/config as follows:

    Host {host}
        HostName {hostname}
        Port {port}
        User {user}
        ProxyCommand churchkey {proxy_host} {proxy_port} %h %p ~/.ssh/proxyauth
  3. log into remote server as usual:

    ssh {host}


Copyright (C) 2016-2018 Cyker Way

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

churchkey-1.1.5.tar.gz (17.2 kB view hashes)

Uploaded source

Built Distribution

churchkey-1.1.5-py3-none-any.whl (17.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page