dockerfiles-fedora-ssh 镜像文档

镜像概述和主要用途

dockerfiles-fedora-ssh 是一个基于 Fedora 操作系统的 Docker 镜像，提供 SSH 服务功能。该镜像允许用户通过 SSH 协议安全连接到容器内部，支持密码认证方式，适用于需要临时或受控访问容器环境的场景，如开发测试、容器内部调试等。

核心功能和特性

• 基于 Fedora 系统：以 Fedora 为基础镜像，提供稳定的操作系统环境
• 内置 SSH 服务：预装并配置 SSH 服务，支持标准 SSH 连接流程
• 自动用户管理：默认创建名为 user 的系统用户，用于 SSH 登录
• 灵活密码配置：支持两种密码模式
  • 随机生成密码：启动时自动生成随机密码，可通过容器日志获取
  • 自定义密码：通过环境变量 SSH_USERPASS 设置指定密码
• 端口映射：默认将容器 22 端口（SSH 服务端口）映射到主机 2200 端口，避免与主机 SSH 服务冲突

使用场景和适用范围

• 开发测试环境中需要通过 SSH 访问容器内部文件系统或执行命令
• 临时调试容器内运行的应用程序
• 需要通过 SSH 协议与容器进行数据传输或远程操作的场景
• 对容器访问权限有基本控制需求的轻量级使用场景

详细使用方法和配置说明

构建镜像

如需从源码构建镜像，将源码复制到 Docker 主机后执行以下命令：

# docker build --rm -t <username>/ssh .

其中 <username> 为您的 Docker 镜像仓库用户名

运行容器

直接运行 Registry 中的镜像

无需本地构建，可直接运行 Docker Registry 中的官方镜像：

# sudo atomic run docker.io/fedora/ssh

使用 Docker 命令运行容器

默认配置（随机密码）

启动容器并绑定主机 2200 端口到容器 22 端口，自动创建用户 user 并生成随机密码：

# docker run --name ssh -d -p 2200:22 <username>/ssh

获取随机密码

随机密码会输出到容器日志，通过以下命令提取：

# docker logs ssh | grep 'ssh user password'
ssh user password: O2WXqqQ1CWwXHxrLZGip  # 示例输出

自定义密码配置

通过环境变量 SSH_USERPASS 设置用户 user 的登录密码：

# docker run --name ssh -d -p 2200:22 \
  -e SSH_USERPASS=secret <username>/ssh

其中 secret 为您指定的自定义密码

连接容器

使用 SSH 客户端连接到运行中的容器，命令格式如下：

# ssh -p 2200 user@localhost

执行后输入密码（随机密码或自定义密码），成功登录后将进入容器内部的命令行环境：

user@localhost's password:  # 输入密码
[user@d3a244022ca5 ~]$  # 容器内部命令行提示符