karcaw/nginx-createrepo

Nginx-Createrepo 镜像文档

镜像概述和主要用途

该镜像基于Nginx构建，集成了createrepo工具，旨在提供一个简单高效的YUM软件仓库托管解决方案。通过将Nginx的HTTP服务能力与createrepo的仓库元数据生成功能结合，用户可快速搭建本地或内部网络YUM源，实现软件包的集中管理与分发。

核心功能和特性

• Nginx集成：内置Nginx服务，提供稳定的HTTP文件访问能力，支持YUM客户端的仓库访问
• createrepo工具：预装createrepo软件，可直接在容器内生成和更新YUM仓库元数据（repodata）
• 轻量级设计：基于官方Nginx镜像构建，保持较小镜像体积，资源占用低
• 灵活挂载：支持通过数据卷挂载本地RPM包目录，无需重新构建镜像即可更新仓库内容
• 易于扩展：可通过挂载自定义Nginx配置文件，实现访问控制、SSL加密等高级功能

使用场景和适用范围

• 企业内部网络YUM源搭建，实现软件包集中管理
• 离线环境下的软件分发与版本控制
• 开发/测试环境中快速部署依赖包仓库
• 教学或演示环境中的YUM仓库示例搭建
• 需要频繁更新软件包的内部系统

使用方法和配置说明

基本使用流程

1. 准备本地RPM包目录
2. 启动容器并挂载RPM目录
3. 生成/更新仓库元数据
4. 配置客户端使用该仓库

Docker Run部署示例

bash
# 启动容器，映射80端口并挂载本地RPM目录
docker run -d \
  --name yum-repo-server \
  -p 80:80 \
  -v /path/to/local/rpms:/usr/share/nginx/html/yumrepo \
  nginx-createrepo:latest

生成仓库元数据

容器启动后，需执行createrepo命令生成仓库元数据：

bash
# 进入容器
docker exec -it yum-repo-server /bin/bash

# 在容器内生成元数据
createrepo /usr/share/nginx/html/yumrepo

# 如需更新仓库（添加新RPM后），执行：
createrepo --update /usr/share/nginx/html/yumrepo

客户端配置方法

在需要使用该YUM源的客户端服务器上，创建repo文件：

bash
# 创建repo配置文件
vi /etc/yum.repos.d/local-yum.repo

添加以下内容：

ini
[local-yum-repo]
name=Local YUM Repository
baseurl=http://<容器IP或主机名>/yumrepo
enabled=1
gpgcheck=0  # 若有GPG密钥可设为1并配置gpgkey

自定义配置

自定义Nginx配置

如需修改Nginx配置（如更改端口、添加认证等），可挂载自定义配置文件：

bash
docker run -d \
  --name yum-repo-server \
  -p 8080:8080 \  # 自定义端口
  -v /path/to/local/rpms:/usr/share/nginx/html/yumrepo \
  -v /path/to/custom/nginx.conf:/etc/nginx/nginx.conf \
  nginx-createrepo:latest

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  yum-repo:
    image: nginx-createrepo:latest
    container_name: yum-repo-server
    ports:
      - "80:80"
    volumes:
      - /path/to/local/rpms:/usr/share/nginx/html/yumrepo
      # 可选：挂载自定义Nginx配置
      # - ./nginx.conf:/etc/nginx/nginx.conf
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 确保挂载的RPM目录权限正确，容器内Nginx用户需有读取权限
• 每次添加新RPM包后，需重新执行createrepo --update更新元数据
• 生产环境建议配置GPG签名以确保软件包完整性和安全性
• 可结合HTTPS配置（通过挂载SSL证书和修改Nginx配置）增强传输安全性