pttde/git

Alpine-SSH-Git 镜像文档

镜像概述

Alpine-SSH-Git 是一个基于 Alpine Linux 的轻量级 Docker 镜像，集成了 SSH 服务和 Git 工具。该镜像旨在提供一个体积小、功能精简的环境，满足远程访问（通过 SSH）和版本控制（通过 Git）的基础需求，适用于开发、测试或小型部署场景。

核心功能与特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
• SSH 服务：内置 OpenSSH 服务器，支持密码或密钥认证
• Git 工具：集成 Git 客户端，支持常见版本控制操作（clone、commit、push 等）
• 简化配置：支持通过环境变量快速配置 SSH 访问参数

使用场景

• 开发环境：作为远程开发环境，支持通过 SSH 连接并使用 Git 管理代码
• CI/CD 节点：作为轻量级构建节点，执行 Git 代码拉取和基础操作
• 临时测试环境：快速部署包含 SSH 和 Git 的最小化环境，用于功能验证
• 边缘设备部署：适用于资源受限的环境，如嵌入式系统或边缘计算设备

使用方法与配置说明

基本使用（docker run）

通过以下命令快速启动容器：

bash
docker run -d -p 2222:22 --name alpine-ssh-git -e SSH_PASSWORD=your_secure_password alpine-ssh-git

• -p 2222:22：将容器的 22 端口映射到主机的 2222 端口
• -e SSH_PASSWORD=your_secure_password：设置 SSH 登录密码
• --name alpine-ssh-git：指定容器名称

环境变量配置

密钥认证配置

推荐使用 SSH 密钥认证替代密码认证，更安全且便于自动化：

bash
docker run -d -p 2222:22 \
  -e SSH_PUB_KEY="$(cat ~/.ssh/id_rsa.pub)" \
  --name alpine-ssh-git \
  alpine-ssh-git

上述命令会将本地 ~/.ssh/id_rsa.pub 公钥导入容器，之后可通过私钥免密登录：

bash
ssh -p 2222 root@localhost

持久化配置

如需持久化 SSH 配置或 Git 数据，可挂载本地目录：

bash
docker run -d -p 2222:22 \
  -v /path/to/ssh/keys:/root/.ssh \
  -v /path/to/git/repos:/repos \
  --name alpine-ssh-git \
  alpine-ssh-git

• /path/to/ssh/keys：本地 SSH 密钥目录，映射到容器内 root 用户的 .ssh 目录
• /path/to/git/repos：本地 Git 仓库目录，用于持久化代码数据

docker-compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  alpine-ssh-git:
    image: alpine-ssh-git
    ports:
      - "2222:22"
    environment:
      - SSH_PUB_KEY=ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ...  # 替换为实际公钥
    volumes:
      - ./ssh-keys:/root/.ssh
      - ./git-repos:/repos
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

验证与测试

1. 启动容器后，通过 SSH 连接：

   bash
   ssh -p 2222 root@localhost
   

2. 验证 Git 功能：

   bash
   git --version  # 输出 Git 版本信息
   git clone https://github.com/example/repo.git  # 测试代码克隆