alpinelinux/gitlab-shell

gitlab-shell 镜像文档

镜像概述

本镜像基于Alpine Linux构建，包含gitlab-shell组件。gitlab-shell是GitLab的SSH访问层，负责处理通过SSH协议进行的Git操作（如克隆、推送、拉取等），并与GitLab服务端进行认证和授权交互。Alpine Linux基础确保了镜像的轻量级和低资源占用特性。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源消耗低
• SSH协议支持：提供标准SSH服务，支持Git通过SSH协议进行操作
• GitLab集成：与GitLab服务端无缝集成，处理认证和授权逻辑
• 安全配置：包含基础的SSH安全配置，支持密钥认证
• 可扩展性：支持通过环境变量和挂载配置文件自定义行为

使用场景与适用范围

• GitLab服务器环境中需要提供SSH访问的场景
• 容器化部署的GitLab架构中作为SSH服务组件
• 需要轻量级Git SSH访问层的开发或测试环境
• 多节点GitLab部署中独立部署SSH服务的场景

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name gitlab-shell \
  -p 22:22 \
  -v /path/to/ssh/keys:/etc/ssh \
  -v /path/to/gitlab-shell/config:/etc/gitlab-shell \
  -e GITLAB_URL=http://gitlab-web:8080 \
  gitlab-shell:latest

Docker Compose配置示例

yaml
version: '3'
services:
  gitlab-shell:
    image: gitlab-shell:latest
    container_name: gitlab-shell
    ports:
      - "22:22"
    volumes:
      - ./ssh-keys:/etc/ssh
      - ./gitlab-shell-config:/etc/gitlab-shell
    environment:
      - GITLAB_URL=http://gitlab-web:8080
      - SSH_PORT=22
    restart: always

环境变量说明

数据卷挂载

配置文件说明

核心配置文件为/etc/gitlab-shell/config.yml，主要配置项包括：

yaml
# GitLab服务URL
gitlab_url: "http://gitlab-web:8080"
# API超时时间（秒）
api_timeout: 30
# 日志目录
log_directory: "/var/log/gitlab-shell"
# 日志级别
log_level: "info"
# SSH密钥文件路径
authorized_keys: "/etc/gitlab-shell/authorized_keys"

注意事项

• 确保GitLab服务端与gitlab-shell之间网络通畅
• SSH端口映射需避免与主机或其他容器冲突
• 首次启动前需确保挂载的SSH密钥目录包含有效的主机密钥
• 授权密钥文件需定期与GitLab服务端同步以确保访问权限正确