tmate/tmate-ssh-server

tmate-ssh-server镜像说明

镜像概述

tmate-ssh-server是tmate.io的服务端组件，用于搭建私有tmate会话服务器，支持终端会话的共享与协作，适用于需要远程访问或协作的场景。

核心功能

• 提供SSH终端会话共享服务
• 支持WebSocket协议（需配置HAS_WEBSOCKET），兼容HTML5客户端
• 支持代理协议（需配置USE_PROXY_PROTOCOL），可获取客户端真实IP
• 可自定义SSH主机名、监听端口及对外宣传端口

使用场景

• 团队成员间远程协作终端操作
• 技术支持人员远程协助解决问题
• 共享终端进行演示或教学

配置说明

以下环境变量用于配置服务器：

• SSH_KEYS_PATH（必填）：SSH密钥文件所在路径
• HAS_WEBSOCKET：设置为1启用WebSocket支持（用于HTML5客户端）
• USE_PROXY_PROTOCOL：设置为1启用代理协议（当服务器位于负载均衡器后时，可获取真实IP）
• SSH_HOSTNAME：配置对外宣传的SSH主机名
• SSH_PORT_LISTEN：SSH服务器监听端口
• SSH_PORT_ADVERTISE：对外宣传的SSH端口（默认与SSH_PORT_LISTEN一致）

注意：容器需添加SYS_ADMIN权限，以创建嵌套容器（命名空间）确保会话安全。

部署示例

Docker Run命令

bash
docker run -d \
  --name tmate-server \
  --cap-add SYS_ADMIN \
  -e SSH_KEYS_PATH=/path/to/ssh/keys \
  -e SSH_PORT_LISTEN=2222 \
  -p 2222:2222 \
  -v /host/path/to/keys:/path/to/ssh/keys \
  tmate/tmate-ssh-server

许可证

本镜像基于MIT许可证开源。