ssh-http-proxy-connect(1)

名称

ssh-http-proxy-connect - 用于 HTTP 的安全 Shell 代理

用法概要

/usr/lib/ssh/ssh-http-proxy-connect [-h 
http_proxy_host] 
     [-p http_proxy_port] 
connect_host connect_port

描述

针对使用 HTTP CONNECT 的 ssh(1) 的代理命令。通常用于网络外部连接只允许通过 Web 代理服务器建立的情况。

选项

支持以下选项：

–h http_proxy_host

指定通过哪个 Web 代理服务器建立连接。如果设置了 HTTPPROXY 和 http_proxy 环境变量，则覆盖这两个变量。

–p http_proxy_port

指定 Web 代理服务器在哪个端口运行。如果未指定，则假定为端口 80。如果设置了 HTTPPROXYPORT 和 http_proxy 环境变量，则覆盖这两个变量。

操作数

支持下列操作数：

http_proxy_host

代理的主机名或 IP 地址（IPv4 或 IPv6）。

http_proxy_port

所要连接的 http_proxy_host 上的数字端口号。

connect_host

Web 代理服务器要将您的计算机连接到的远程主机的名称。

connect_port

Web 代理服务器要将您的计算机连接到的 http_proxy_host 上的数字端口号。

示例

代理连接命令的建议使用方法是在 ssh_config(4) 中配置 ProxyCommand（请参见示例 1 和示例 2）。示例 3 显示了在运行 ssh(1) 时如何在命令行中指定代理命令。

示例 1 在环境中设置代理

以下示例显示了在环境中设置代理时，如何在 ssh_config(4) 中使用 ssh-http-proxy-connect：

Host playtime.foo.com
    ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect \
        playtime.foo.com 22

示例 2 覆盖代理环境变量

以下示例显示了如何在 ssh_config(4) 中使用 ssh-http-proxy-connect 来覆盖代理环境变量（如果未设置则进行设置）：

Host playtime.foo.com
    ProxyCommand /usr/lib/ssh/ssh-http-proxy-connect -h webcache \
        -p 8080 playtime.foo.com 22

示例 3 使用命令行

以下示例显示了如何在 ssh(1) 命令行中使用 ssh-http-proxy-connect：

example$ ssh -o ProxyCommand="/usr/lib/ssh/ssh-http-proxy-connect \
    -h webcache -p 8080 playtime.foo.com 22" playtime.foo.com

环境变量

HTTPPROXY

使用 http_proxy_host 操作数指定缺省代理主机。如果还设置了 http_proxy，则覆盖 http_proxy。

HTTPPROXYPORT

使用 http_proxy_port 操作数指定缺省代理端口。如果未设置 HTTPPROXY，则忽略此项。

http_proxy

用于指定代理主机和端口的 URL 格式。

退出状态

将返回以下退出值：

0

成功完成。

1

出现错误。

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 network/ssh 接口稳定性 Committed（已确定）

另请参见

ssh(1)、ssh-socks5-proxy-connect(1)、ssh_config(4)、attributes(5)