cmptstks/ssh

SFTP/SSH门户Docker镜像

概述

本镜像提供一个功能完备的SFTP/SSH门户容器，集成了多种常用系统工具、数据库客户端及开发环境，旨在简化Docker容器的远程访问与操作流程，满足开发调试和日常运维需求。

核心功能和特性

系统工具集

• 网络工具：curl、wget（支持HTTP/HTTPS请求与文件下载）
• 版本控制：git（代码仓库管理）
• 文本编辑：nano（轻量编辑器）、vim（全功能编辑器）
• 文件同步：rsync（高效文件传输与同步）
• 终端复用：tmux（支持会话保持与多窗口管理）

数据库客户端

• MySQL Client：支持连接MySQL/MariaDB数据库，执行查询、数据导入导出等操作

开发环境

• PHP环境：包含PHP运行时及Composer依赖管理工具，支持PHP项目开发与依赖安装
• NodeJS环境：提供Node.js运行时，支持JavaScript开发及npm包管理

使用场景和适用范围

开发调试

• 远程代码编辑：通过SSH直接访问容器内代码目录，使用vim/nano修改文件
• 依赖管理：利用Composer安装PHP依赖包、npm安装Node.js包
• 临时测试环境：快速搭建隔离的开发环境，避免本地工具版本冲突

运维操作

• SFTP文件传输：通过SFTP协议安全上传/下载容器内文件（如日志、配置文件）
• 跨环境数据同步：使用rsync在容器与主机/其他容器间同步数据
• 长时间任务执行：通过tmux保持会话，运行耗时操作（如数据备份、批量处理）

临时工具环境

• 替代本地工具安装：无需在主机配置多种工具，直接通过容器使用指定版本的git、curl等
• 轻量级跳板机：作为临时门户访问其他服务（需配置网络访问权限）

使用方法和配置说明

基础部署（docker run）

bash
docker run -d \
  --name ssh-portal \
  -p 2222:22 \  # 主机端口2222映射到容器SSH端口22（避免与主机SSH冲突）
  -v /path/on/host:/data \  # 挂载主机目录到容器/data，实现文件持久化
  -e SSH_USER=admin \  # 自定义SSH登录用户名（默认root）
  -e SSH_PASSWORD=SecurePass123 \  # 设置登录密码（生产环境建议使用密钥）
  [镜像名称]:[标签]

SSH密钥认证配置（推荐）

为提升安全性，优先使用SSH密钥认证：

1. 准备主机公钥文件（如~/.ssh/id_rsa.pub）
2. 启动容器时挂载公钥：

bash
docker run -d \
  --name ssh-portal \
  -p 2222:22 \
  -v /path/on/host:/data \
  -v ~/.ssh/id_rsa.pub:/root/.ssh/authorized_keys:ro \  # 只读挂载公钥文件
  [镜像名称]:[标签]

注意：确保挂载的公钥文件权限为600，所有者为root（可通过chmod 600 ~/.ssh/id_rsa.pub调整）

docker-compose配置示例

yaml
version: '3'
services:
  ssh-portal:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    container_name: ssh-portal
    ports:
      - "2222:22"  # 端口映射
    volumes:
      - ./host-data:/data  # 本地目录挂载
      - ./ssh-keys/id_rsa.pub:/root/.ssh/authorized_keys:ro  # 密钥认证
    environment:
      - SSH_USER=dev  # 登录用户名
    restart: unless-stopped  # 容器退出时自动重启（非必要）

连接容器

SSH连接

bash
ssh dev@localhost -p 2222  # 使用自定义用户（需替换dev为实际配置的SSH_USER）
# 或使用root用户（默认）
ssh root@localhost -p 2222

SFTP连接

bash
sftp -P 2222 dev@localhost  # SFTP连接（端口参数为大写P）

配置参数说明

注意事项

1. 安全性：生产环境必须禁用密码认证，仅使用SSH密钥；限制容器网络访问权限，避免暴露不必要端口
2. 数据持久化：关键数据需通过卷挂载持久化，防止容器删除后数据丢失
3. 权限管理：挂载主机目录时注意容器内用户权限（默认root用户可能对主机目录有写权限）
4. 镜像更新：定期更新镜像以获取工具安全补丁和版本更新