elsdoerfer/gitolite
elsdoerfer
自动构建
运行SSH服务器并以git用户身份提供gitolite服务的Docker镜像，支持通过SSH密钥初始设置或使用现有gitolite-admin仓库，非root运行以增强安全性，适用于Git仓库的集中管理与访问控制。
33 次收藏下载次数: 0状态：自动构建维护者：elsdoerfer仓库类型：镜像最近更新：1 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
gitolite Docker镜像
镜像概述和主要用途
该镜像运行SSH服务器，以git用户身份提供gitolite服务，实现Git仓库的集中管理与访问控制。采用非root运行模式（sshd进程以git用户运行），提升安全性。首次启动时可通过提供SSH公钥初始化gitolite，或使用现有gitolite-admin仓库引导；后续启动会自动执行gitolite setup以集成外部变更。
核心功能和特性
- 非root运行：sshd进程以
git用户运行，降低权限风险 - 灵活初始化：支持通过SSH公钥新建gitolite实例，或挂载现有仓库目录迁移
- 配置定制：通过环境变量自定义gitolite.rc配置项
- 数据持久化：关键目录支持卷挂载，确保仓库数据和SSH配置持久化
- SSH主机密钥管理：提供多种方式保持主机密钥一致性，避免客户端警告
- 镜像支持：内置git用户SSH密钥生成机制，支持配置可信主机
使用场景和适用范围
- 新部署gitolite服务，快速搭建Git仓库管理系统
- 迁移现有gitolite实例，实现容器化部署
- 需严格权限控制的Git协作环境
- 需要持久化仓库数据和SSH配置的场景
使用方法和配置说明
快速启动示例
新安装
通过提供SSH公钥初始化gitolite：
bashdocker run -e SSH_KEY="$(cat ~/.ssh/id_rsa.pub)" elsdoerfer/gitolite
使用现有gitolite实例
挂载现有仓库目录启动：
bashdocker run -v /var/vcroot/git:/home/git/repositories elsdoerfer/gitolite
环境变量配置
| 环境变量 | 说明 | 示例值 |
|---|---|---|
SSH_KEY | 初始访问gitolite-admin仓库的SSH公钥，使用现有仓库时可省略 | $(cat ~/.ssh/id_rsa.pub) |
GIT_CONFIG_KEYS | 插入到gitolite.rc中的配置项 | - |
LOCAL_CODE | 插入到gitolite.rc中的本地代码路径 | $ENV{HOME}/local |
TRUST_HOSTS | 添加到known_hosts的主机名（目前仅支持单个） | github.com |
可挂载目录
/home/git/repositories：存储实际Git仓库数据，建议挂载以持久化/etc/ssh：存储SSH主机密钥，挂载可避免容器重建导致密钥变化，防止客户端警告
SSH主机密钥管理
容器首次启动时自动生成SSH主机密钥。若频繁重建容器，密钥变化会导致客户端安全警告，解决方案：
- 卷挂载
/etc/ssh：将SSH密钥存储在卷中，保持一致性 - 使用仓库内密钥：创建
/home/git/repositories/.ssh/host-keys目录并放入主机密钥，容器会自动使用（推荐，仅需单个卷） - （待实现）通过环境变量指定主机密钥
镜像功能
若需gitolite执行git push进行镜像同步，容器提供以下支持：
- 自动生成SSH密钥：git用户会生成SSH密钥对，可通过
docker cp <容器ID>:/home/git/.ssh/id_rsa.pub .获取公钥- 若需保持密钥不变，可挂载
/home/git/.ssh目录，或创建/home/git/repositories/.ssh/client目录并放入密钥文件（会自动复制到/home/git/.ssh）
- 若需保持密钥不变，可挂载
- 配置可信主机：通过
TRUST_HOSTS环境变量设置.ssh/known_hosts，容器启动时会覆盖该文件
进一步定制
如需自定义钩子等高级功能，可通过以下方式：
- 使用LOCAL_CODE：将
LOCAL_CODE指向$ENV{HOME}/.gitolite/local，通过gitolite-admin仓库管理自定义数据 - 挂载文件：直接挂载自定义文件到容器（注意需在setup执行前提供gitolite.rc等关键文件）
- 构建自定义镜像：基于本镜像添加所需文件（注意需在setup执行前提供gitolite.rc等关键文件）
- 手动交互：进入容器手动配置，但会失去容器的可处置性
变更日志
- 2020-09-30：
sshd进程不再以root用户运行，改为以git用户运行
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 gitolite 镜像标签
docker pull docker.xuanyuan.run/elsdoerfer/gitolite:<标签>
DockerHub 原生拉取命令
docker pull elsdoerfer/gitolite:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"