Docker APIClient无法读取ssh/config端口，如何仅用配置占位符连接？

我的远程服务器地址为 admin@10.10.10.10:1234，已在 ~/.ssh/config 中配置如下：

remote_server:
HostName: 10.10.10.10
User: admin
Port: 1234

尝试用Docker APIClient连接时：

docker.APIClient('ssh://remote_server')

发现客户端能正确解析HostName和User，但始终使用默认端口22，而非配置文件中的1234。不想用docker.APIClient('ssh://remote_server:1234')这种硬编码端口的临时方案，希望仅通过配置文件中的别名完成连接。

原因 #

Docker Python SDK的APIClient在处理SSH连接时，解析ssh://格式地址的逻辑存在局限性：它会提取主机别名并读取SSH配置中的HostName和User，但不会自动加载配置里的Port字段，默认强制使用SSH的默认端口22，除非你在连接URL里显式指定端口。

这是因为SDK内部处理SSH连接的模块，仅部分读取~/.ssh/config的配置项，端口参数优先级被URL显式指定或默认值覆盖。

解决方法 #

方法1：手动读取SSH配置构造连接参数 #

借助第三方库读取~/.ssh/config，提取目标主机的端口后再构建连接：

import docker
from sshconf import read_ssh_config

# 读取SSH配置文件
ssh_config = read_ssh_config()
host_info = ssh_config.host('remote_server')
target_port = host_info['port']

# 用配置中的端口构建连接
client = docker.APIClient(f'ssh://remote_server:{target_port}')

需要先安装依赖库：pip install sshconf

方法2：通过SSH代理复用完整配置 #

利用SSH端口转发建立本地代理，让Docker客户端通过本地套接字连接，完全复用~/.ssh/config的所有配置：

import docker
import subprocess
import os

# 启动SSH代理，将远程Docker套接字映射到本地
proxy_process = subprocess.Popen(
    ['ssh', '-N', '-L', '/tmp/docker.sock:/var/run/docker.sock', 'remote_server'],
    stdout=subprocess.DEVNULL,
    stderr=subprocess.DEVNULL
)

# 通过本地套接字连接远程Docker服务
client = docker.APIClient('unix:///tmp/docker.sock')

# 使用完成后记得关闭代理进程
# proxy_process.terminate()

方法3：手动解析SSH配置文件（无依赖） #

如果不想安装额外库，可以自己解析~/.ssh/config提取端口：

import docker
import configparser
import os

def get_ssh_host_port(host_alias):
    config = configparser.ConfigParser()
    # 读取SSH配置并转换为configparser可识别的格式
    with open(os.path.expanduser('~/.ssh/config'), 'r') as f:
        raw_content = f.read()
    # 给每个Host条目添加section头
    formatted_content = []
    for line in raw_content.splitlines():
        if line.strip().startswith('Host '):
            formatted_content.append(f'[{line.split()[1]}]')
        else:
            formatted_content.append(line)
    config.read_string('\n'.join(formatted_content))
    return config.get(host_alias, 'Port', fallback='22')

target_port = get_ssh_host_port('remote_server')
client = docker.APIClient(f'ssh://remote_server:{target_port}')

内容的提问来源于stack exchange，提问作者Rm1