whilp/ssh-agent

whilp/ssh-agent镜像说明

镜像概述

本镜像将ssh-agent工具容器化，提供了在Docker环境中安全管理SSH密钥的解决方案。通过卷共享密钥套接字，实现跨容器的密钥访问，避免在多个容器中重复加载密钥，提升开发和部署效率。

核心功能

1. 运行长期存在的ssh-agent容器，通过卷(ssh:/ssh)共享密钥套接字
2. 支持临时容器加载本地SSH密钥到agent中
3. 允许其他容器通过环境变量SSH_AUTH_SOCK访问agent中的密钥

使用场景

• CI/CD流程中，多个步骤需要访问Git仓库或远程服务器时共享SSH密钥
• 开发环境中，多个容器（如代码编译、测试容器）需要使用相同SSH密钥认证
• 避免在容器中直接存储敏感SSH密钥文件，提升安全性

配置说明

1. 启动长期运行的ssh-agent容器

指定UID（如1001）确保非root用户可访问，创建卷ssh存储套接字：

console
docker run -u 1001 -d -v ssh:/ssh --name=ssh-agent whilp/ssh-agent:latest

2. 添加SSH密钥到agent

使用临时容器加载本地密钥（替换$HOME/.ssh/id_rsa为实际密钥路径）：

console
docker run -u 1001 --rm -v ssh:/ssh -v $HOME:$HOME -it whilp/ssh-agent:latest ssh-add $HOME/.ssh/id_rsa

3. 其他容器访问密钥

通过卷共享和环境变量SSH_AUTH_SOCK访问agent：

console
docker run --rm -v ssh:/ssh -it alpine:edge /bin/sh -c "apk add --update runit && chpst -e /ssh/env /usr/bin/env | grep SSH_AUTH_SOCK"

示例：列出已加载的密钥

console
docker run --rm -it -v ssh:/ssh -e SSH_AUTH_SOCK=/ssh/auth/sock ubuntu /bin/bash -c "apt-get update && apt-get install -y openssh-client && ssh-add -l"

注意事项

• 本镜像仅提供ssh-agent功能，不包含known_hosts管理等其他SSH功能
• 兼容性已验证：OSX/docker-machine、OSX/docker for mac环境