gitlab/ssh-tunnel

SSH隧道Docker镜像文档

概述

SSH隧道Docker镜像是GitLab质量团队开发的工具，用于在测试环境中创建安全的SSH隧道连接。该镜像提供了一种便捷的方式来建立加密的网络通道，实现不同服务或环境之间的安全通信。

核心功能和特性

• 快速创建SSH隧道连接
• 支持多种隧道模式（本地端口转发、远程端口转发、动态端口转发）
• 简化的配置流程
• 轻量级镜像设计
• 支持密钥认证和密码认证
• 容器化部署，易于集成到CI/CD流程

使用场景和适用范围

• GitLab CI/CD管道中的安全服务访问
• 测试环境中不同服务之间的安全通信
• 跨网络环境的服务访问控制
• 开发和测试环境中的端口转发需求
• 需要安全访问内部服务的场景
• 隔离环境中的服务互联

使用方法和配置说明

基本使用方法

使用以下命令启动SSH隧道容器：

bash
docker run --rm -d --name ssh-tunnel docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel \
  -L [本地地址:]本地端口:目标地址:目标端口 \
  [用户名]@[SSH服务器地址]

环境变量配置

该镜像支持以下环境变量进行配置：

Docker Compose示例

yaml
version: '3'
services:
  ssh-tunnel:
    image: docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel
    environment:
      - SSH_USER=testuser
      - SSH_HOST=remote-server.example.com
      - SSH_PORT=22
      - TUNNEL_TYPE=local
      - LOCAL_PORT=8080
      - TARGET_HOST=internal-service
      - TARGET_PORT=80
      - SSH_KEY=/ssh/id_rsa
    volumes:
      - ./ssh-keys:/ssh
    ports:
      - "8080:8080"
    restart: unless-stopped

高级配置

使用密钥认证

bash
docker run --rm -d --name ssh-tunnel \
  -v /path/to/ssh/key:/root/.ssh/id_rsa:ro \
  docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel \
  -i /root/.ssh/id_rsa \
  -L 8080:internal-service:80 \
  user@remote-server.example.com

远程端口转发

bash
docker run --rm -d --name ssh-tunnel \
  docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel \
  -R 8080:localhost:80 \
  user@remote-server.example.com

动态端口转发(SOCKS代理)

bash
docker run --rm -d --name ssh-socks-proxy \
  -p 1080:1080 \
  docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel \
  -D 1080 \
  user@remote-server.example.com

注意事项

• 在生产环境中使用时，请确保适当保护SSH密钥和凭证
• 定期更新镜像以获取最新安全补丁
• 在CI/CD环境中使用时，建议使用密钥认证而非密码认证
• 注意容器网络配置，确保隧道连接的稳定性

故障排除

如果遇到连接问题，可以通过以下命令查看容器日志：

bash
docker logs ssh-tunnel

如需更详细的调试信息，可以启用详细日志模式：

bash
docker run --rm -e VERBOSE=true docker.xuanyuan.run/gitlab-org/quality/ssh-tunnel ...

相关资源

• https://gitlab.com/gitlab-org/quality/ssh-tunnel
• SSH隧道使用指南
• https://docs.docker.com/