ryodocx/docker-autossh

docker-autossh

概述

ryodocx/docker-autossh 是一个轻量级（仅8.07MB）的Docker镜像，旨在提供安全的SSH隧道建立方式，无需在镜像中嵌入密钥或直接链接主机。相比其他AutoSSH容器，它更小、更易定制且支持自动化构建，便于用户使用。

核心功能

• 监控SSH进程状态，异常终止或流量中断时自动重启；
• 支持远程转发（默认）和本地转发两种隧道模式；
• 通过卷或Docker Secrets挂载密钥/known_hosts文件，保障安全性；
• 可自定义隧道端口、目标地址等参数，高度灵活。

使用场景

适用于以下合法场景：

• 访问无公网IP的家庭LAN设备（如NAS、内部服务器）；
• 远程管理Docker主机上的服务；
• 跨网络安全转发内部服务（如Redis、Elasticsearch、HTTP等）。

配置说明

挂载项

/id_rsa

挂载Docker主机生成的SSH密钥文件（参考设置步骤），或通过SSH_KEY_FILE指定路径：

bash
-v /path/to/id_rsa:/id_rsa

/known_hosts

挂载known_hosts文件以启用严格密钥检查，或通过SSH_KNOWN_HOSTS指定路径：

bash
-v /path/to/known_hosts:/known_hosts

环境变量

设置步骤

在Docker主机生成独立SSH密钥（避免与用户密钥混淆）：

bash
ssh-keygen -t rsa -b 4096 -C "autossh"
# 按提示输入保存路径（如/home/user/.ssh/id_rsa）及密码（可选）

使用示例

docker-compose.yml

以下示例展示两种常见场景：

yaml
version: '2.1'

services:
  ssh-to-docker-host:
    image: ryodocx/docker-autossh
    container_name: autossh-ssh-to-docker-host
    environment:
      - SSH_HOSTUSER=sshuser
      - SSH_HOSTNAME=203.0.113.10  # 远程服务器IP
      - SSH_TUNNEL_REMOTE=2222     # 远程隧道入口端口
      - SSH_TUNNEL_HOST=172.17.0.1 # Docker主机内部IP
      - SSH_TUNNEL_LOCAL=22        # Docker主机SSH端口
    restart: always
    volumes:
      - /etc/autossh/id_rsa:/id_rsa
    dns:
      - 8.8.8.8
      - 4.2.2.4

  ssh-to-lan-endpoint:
    image: ryodocx/docker-autossh
    container_name: autossh-ssh-to-lan-endpoint
    environment:
      - SSH_HOSTUSER=sshuser
      - SSH_HOSTNAME=203.0.113.10    # 远程服务器IP
      - SSH_TUNNEL_REMOTE=22222      # 远程隧道入口端口
      - SSH_TUNNEL_HOST=192.168.123.45 # LAN设备IP
      - SSH_TUNNEL_LOCAL=22          # LAN设备SSH端口
    restart: always
    volumes:
      - /etc/autossh/id_rsa:/id_rsa
    dns:
      - 8.8.8.8
      - 4.2.2.4

说明：

• ssh-to-docker-host：通过远程服务器203.0.113.10:2222访问Docker主机；
• ssh-to-lan-endpoint：通过远程服务器203.0.113.10:22222访问LAN内设备。