ebiwd/alpine-ssh

alpine-ssh

镜像概述和主要用途

基于https://hub.docker.com/_/alpine/%E6%9E%84%E5%BB%BA%E7%9A%84%E8%BD%BB%E9%87%8F%E7%BA%A7Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E4%B8%93%E4%B8%BACI/CD%E6%B5%81%E6%B0%B4%E7%BA%BF%E8%AE%BE%E8%AE%A1%E3%80%82%E9%9B%86%E6%88%90openssh%E5%92%8Crsync%E6%A0%B8%E5%BF%83%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%B9%B6%E5%86%85%E7%BD%AE%E5%A4%9A%E4%B8%AA%E5%AE%9E%E7%94%A8%E8%84%9A%E6%9C%AC%EF%BC%8C%E7%AE%80%E5%8C%96SSH%E5%AF%86%E9%92%A5%E7%AE%A1%E7%90%86%E3%80%81%E4%BA%91%E6%9C%8D%E5%8A%A1%E5%87%AD%E8%AF%81%E9%85%8D%E7%BD%AE%E5%8F%8A%E7%BD%91%E7%BB%9C%E5%8F%82%E6%95%B0%E8%AE%BE%E7%BD%AE%E7%AD%89%E6%93%8D%E4%BD%9C%EF%BC%8C%E6%BB%A1%E8%B6%B3%E6%8C%81%E7%BB%AD%E9%9B%86%E6%88%90/%E6%8C%81%E7%BB%AD%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%E4%B8%AD%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E9%9C%80%E6%B1%82%E3%80%82

核心功能和特性

基础环境

• 基于Alpine Linux 3.6，保持镜像体积小巧，资源占用低
• 预安装openssh（SSH服务与客户端）和rsync（文件同步工具）

实用脚本

• add-ssh-key <user> <key> [<user> <key>]
  为指定用户添加SSH公钥，支持同时配置多个用户-密钥对，自动完成密钥文件权限设置和用户目录配置。

• add-aws-key <user> <key> [region] [output]
  为指定用户配置AWS访问密钥，可选参数包括区域（region）和输出格式（output），自动生成AWS CLI配置文件。

• add-search-domain <domain>
  设置容器内DNS搜索域，简化短域名访问配置，适用于需要解析内部服务域名的场景。

使用场景和适用范围

• CI/CD流水线中通过SSH协议连接远程服务器执行部署操作
• 使用rsync进行代码或资源文件的增量同步
• 自动化配置构建环境中的SSH访问凭证
• 在容器化CI环境中快速配置AWS服务访问权限
• 需要自定义DNS搜索域的网络环境配置

使用方法和配置说明

基本运行方式

启动容器并保持运行：

bash
docker run -d --name alpine-ssh-runner alpine-ssh tail -f /dev/null

执行实用脚本

添加SSH密钥

将公钥内容直接传递给脚本：

bash
docker exec alpine-ssh-runner add-ssh-key deploy-user "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..."

从文件读取公钥（需先挂载密钥文件到容器）：

bash
docker run -d -v $(pwd)/id_rsa.pub:/keys/id_rsa.pub --name alpine-ssh-runner alpine-ssh
docker exec alpine-ssh-runner add-ssh-key deploy-user "$(cat /keys/id_rsa.pub)"

配置AWS密钥

基础配置（默认区域us-east-1，输出格式json）：

bash
docker exec alpine-ssh-runner add-aws-key aws-user "AKIAEXAMPLEKEY123"

指定区域和输出格式：

bash
docker exec alpine-ssh-runner add-aws-key aws-user "AKIAEXAMPLEKEY123" eu-west-1 table

设置DNS搜索域

bash
docker exec alpine-ssh-runner add-search-domain internal.example.com

docker-compose集成示例

yaml
version: '3.8'
services:
  ci-ssh-agent:
    image: alpine-ssh
    container_name: ci-ssh-agent
    volumes:
      - ./ci-keys:/ci-keys  # 挂载本地密钥目录
    command: >
      sh -c "add-ssh-key ci-user $(cat /ci-keys/id_rsa.pub) &&
             add-aws-key aws-ci $(cat /ci-keys/aws-access-key) us-west-2 json &&
             add-search-domain ci.example.com &&
             tail -f /dev/null"

通过以上配置，容器启动时将自动完成SSH密钥、AWS凭证和DNS搜索域的配置，可直接用于CI流水线中的后续操作。