estantevirtual/common

SSH 端口转发镜像 (Forwarding)

镜像概述

本镜像提供了一种简单、轻量级的方案，用于通过 SSH 配置和实现端口转发（Port Forwarding）。它允许用户通过设置环境变量，快速建立本地端口到远程服务器端口的安全映射，适用于需要跨网络访问内部服务的场景。

核心功能与特性

• 基于 SSH 的安全转发：利用 SSH 协议进行加密的端口转发，保障数据传输安全。
• 环境变量驱动：无需修改配置文件，完全通过环境变量定义转发规则、目标服务器和认证信息。
• 多端口批量转发：支持在单个容器内同时配置和运行多个端口转发规则。
• 免密认证支持：通过直接注入 RSA 私钥内容实现自动化免密登录。

使用场景

• 开发环境中访问远程内网的数据库（如 MySQL、PostgreSQL）。
• 跨网络安全访问内部微服务或管理后台。
• 作为跳板机（Bastion Host）的客户端，建立安全的网络隧道。

配置说明

本镜像的运行依赖于以下 4 个核心环境变量：

1. FWD_SERVER

• 说明：作为端口转发基础的远程 SSH 服务器地址（IP 或域名）。

2. FWD_USER

• 说明：用于登录 FWD_SERVER 的 SSH 用户名，该用户需具备相应的访问权限。

3. FWD_RSA

• 说明：SSH RSA 私钥的完整内容。用于在连接 FWD_SERVER 时进行身份验证。
• 注意：为避免私钥泄露，建议通过 .env 文件或 Docker Secrets 传入，避免在命令行中直接暴露明文。

4. FWD_LIST

• 说明：端口转发规则列表，多个规则之间使用英文逗号 , 分隔。
• 格式：本地端口:目标服务器地址:目标端口
• 示例：3306:my_mysql_server:3306,5432:my_postgres_server:5432
  • 上述示例表示：将容器的 3306 端口转发至 my_mysql_server 的 3306 端口，将 5432 端口转发至 my_postgres_server 的 5432 端口。

部署示例

使用 Docker Run 部署

bash
docker run -d \
  --name ssh-forwarding \
  -p 3306:3306 \
  -p 5432:5432 \
  -e FWD_SERVER="jump.example.com" \
  -e FWD_USER="deployer" \
  -e FWD_RSA="$(cat ~/.ssh/id_rsa | awk '{printf "%s\\n", $0}')" \
  -e FWD_LIST="3306:db.internal.local:3306,5432:pg.internal.local:5432" \
  estantevirtual/forwarding

使用 Docker Compose 部署

推荐在生产环境中使用 docker-compose 结合 .env 文件来管理敏感信息（如 RSA 私钥）。

docker-compose.yml

yaml
version: '3.8'

services:
  ssh-forward:
    image: estantevirtual/forwarding
    container_name: ssh-forwarding
    restart: unless-stopped
    ports:
      - "3306:3306"
      - "5432:5432"
    env_file:
      - .env.forwarding

.env.forwarding

env
FWD_SERVER=jump.example.com
FWD_USER=deployer
FWD_LIST=3306:db.internal.local:3306,5432:pg.internal.local:5432
FWD_RSA="-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEA...\n-----END RSA PRIVATE KEY-----"

更多参考

如需了解更多底层实现细节或查看源码，请访问 https://github.com/estantevirtual/dockerhub/blob/master/forwarding/Dockerfile%E3%80%82