ssh-socks5-proxy-connect(1)

名称

ssh-socks5-proxy-connect - 用于 SOCKS5 的安全 Shell 代理

用法概要

/usr/lib/ssh/ssh-socks5-proxy-connect 
     [-h socks5_proxy_host] 
     [-p socks5_proxy_port] connect_host connect_port

描述

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

该代理命令未提供任何 RFC 1928 中定义的 SOCKS5 验证机制。只可能进行匿名连接。

选项

支持以下选项：

–h socks5_proxy_host

指定通过哪个 Web 代理服务器建立连接。覆盖 SOCKS5_SERVER 环境变量。

–p socks5_proxy_port

指定 Web 代理服务器在哪个端口运行。如果未指定，则假定为端口 80。覆盖 SOCKS5_PORT 环境变量。

操作数

支持下列操作数：

socks5_proxy_host

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

socks5_proxy_port

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

connect_host

socks 网关要将您的计算机连接到的远程主机的名称。

connect_port

socks 网关要将您的计算机连接到的 connect_host 上的数字端口号。

示例

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

示例 1 在环境中设置代理

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

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

示例 2 覆盖代理环境变量

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

Host playtime.foo.com
    ProxyCommand /usr/lib/ssh/ssh-socks5-proxy-connect -h socks-gw \
        -p 1080 playtime.foo.com 22

示例 3 使用命令行

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

example$ ssh -o'ProxyCommand=/usr/lib/ssh/ssh-socks5-proxy-connect \
    -h socks-gw -p 1080 playtime.foo.com 22' playtime.foo.com

环境变量

SOCKS5_SERVER

使用 socks5_proxy_host 操作数指定缺省代理主机。

SOCKS5_PORT

使用 socks5_proxy_port 操作数指定缺省代理端口。

退出状态

将返回以下退出值：

0

成功完成。

1

出现错误。

属性

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

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

另请参见

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