fj0rd/io

SSHD Docker镜像文档

镜像概述和主要用途

本镜像提供轻量级SSHD服务部署能力，同时支持通过环境变量自定义运行用户（可指定用户名、UID及GID），适用于需要快速搭建SSH访问环境且需灵活控制运行身份的场景。

核心功能和特性

• 内置SSHD服务，支持标准SSH连接
• 支持通过环境变量启用root用户SSH访问
• 支持自定义运行用户，可单独指定用户名或同时指定用户名、UID和GID
• 支持挂载公钥文件配置SSH密钥认证

使用场景和适用范围

• 开发/测试环境临时SSH服务部署
• 需要非root用户运行以遵循最小权限原则的场景
• 需匹配宿主机用户权限的容器SSH访问场景
• 快速搭建临时SSH跳板或管理节点

详细使用方法和配置说明

运行SSHD服务

通过以下命令启动SSHD服务，映射SSH端口并配置授权密钥：

bash
docker run \
    -p 2222:22 \  # 将容器SSH端口(22)映射到主机2222端口
    -e SSH_ENABLE_ROOT=true \  # 启用root用户SSH访问
    -v <本地公钥文件路径>:/etc/authorized_keys/root \  # 挂载root用户的授权公钥
    fj0rd/io sshd

参数说明：

• -p 2222:22：端口映射，格式为主机端口:容器端口
• -e SSH_ENABLE_ROOT=true：启用root用户SSH访问（默认可能禁用，需显式启用）
• -v <本地公钥文件路径>:/etc/authorized_keys/root：挂载本地公钥文件到容器，用于root用户SSH密钥认证

指定用户运行

通过user环境变量指定容器运行用户，支持两种格式：

仅指定用户名

bash
docker run -e user=dev docker.xuanyuan.run/fj0rd/io

同时指定用户名、UID和GID

bash
docker run -e user=dev:1000:1000 docker.xuanyuan.run/fj0rd/io

参数说明：

• user环境变量格式：用户名 或 用户名:UID:GID
• UID和GID需为整数，用于指定用户的用户ID和组ID

配置参数说明

使用示例

1. 启动SSHD服务并启用root访问

bash
# 将本地公钥文件挂载到容器，启用root SSH访问
docker run \
    -p 2222:22 \
    -e SSH_ENABLE_ROOT=true \
    -v /local/path/to/root_pubkey:/etc/authorized_keys/root \
    docker.xuanyuan.run/fj0rd/io sshd

2. 指定用户运行容器（仅用户名）

bash
# 以用户"dev"身份运行容器
docker run -e user=dev docker.xuanyuan.run/fj0rd/io

3. 指定用户、UID和GID运行容器

bash
# 以用户"dev"（UID=1000，GID=1000）身份运行容器
docker run -e user=dev:1000:1000 docker.xuanyuan.run/fj0rd/io