robertbeal/gogs

Gogs

镜像概述和主要用途

这是一个经过生产优化的https://github.com/gogits/gogs%E7%89%88%E6%9C%AC%EF%BC%8C%E8%83%BD%E5%A4%9F%E5%9C%A8%60--read-only%60%E6%A8%A1%E5%BC%8F%E4%B8%8B%E8%BF%90%E8%A1%8C%E3%80%82%E5%94%AF%E4%B8%80%E9%9C%80%E8%A6%81%E6%B3%A8%E6%84%8F%E7%9A%84%E6%98%AF%EF%BC%8C%E6%82%A8%E9%9C%80%E8%A6%81%E6%8C%82%E8%BD%BDs6%E5%8D%B7%EF%BC%88%E4%BD%BF%E5%85%B6%E5%8F%AF%E5%86%99%EF%BC%89%EF%BC%8C%E5%9B%A0%E4%B8%BAs6%E9%9C%80%E8%A6%81%E8%BF%9B%E8%A1%8C%E4%B8%80%E4%BA%9B%E5%86%99%E5%85%A5%E6%93%8D%E4%BD%9C%E3%80%82

核心功能和特性

• 支持--read-only模式运行，增强容器安全性
• 内置额外服务：crond和ssh（运行在22222端口）
• 以git:801用户运行，提供多种用户配置方案
• 支持自定义UID/GID，适应不同环境权限需求

使用场景和适用范围

适用于需要安全、轻量级Git服务的生产环境，特别适合对容器安全性有较高要求（如只读文件系统）的场景。

使用方法和配置说明

运行在只读模式

容器使用git:801用户运行，有以下两种运行方式：

1. 创建具有匹配UID的主机用户

首先创建UID为801的系统用户：

bash
sudo useradd --no-create-home --system --shell /bin/false --uid 801 foo

然后运行容器：

docker
docker run \
    --name gogs \
    --rm \
    --read-only \
    --tmpfs /tmp:rw,size=100000k \
    -v /var/gogs/config:/config:ro \
    -v /var/gogs/data:/data \
    -v /var/gogs/s6:/var/run/s6 \
    -p 127.0.0.1:22:22222 \
    -p127.0.0.1:3000:3000 \
    --cpus=".3" \
    --memory="250m" \
    --pids-limit 50 \
    --security-opt="no-new-privileges:true" \
    --health-cmd="curl --fail http://localhost:3000/healthcheck || exit 1" \
    --health-interval=5s \
    --health-retries=3 \
    robertbeal/gogs

2. 挂载/etc/passwd并创建匹配名称的主机用户

首先创建名为git的系统用户：

bash
sudo useradd --no-create-home --system --shell /bin/false git

然后运行容器：

docker
docker run \
    --name gogs \
    --rm \
    --read-only \
    --tmpfs /tmp:rw,size=100000k \
    -v /etc/passwd:/etc/passwd:ro \
    -v /var/gogs/config:/config:ro \
    -v /var/gogs/data:/data \
    -v /var/gogs/s6:/var/run/s6 \
    -p 127.0.0.1:22:22222 \
    -p 127.0.0.1:3000:3000 \
    --cpus=".3" \
    --memory="250m" \
    --pids-limit 50 \
    --security-opt="no-new-privileges:true" \
    --health-cmd="curl --fail http://localhost:3000/healthcheck || exit 1" \
    --health-interval=5s \
    --health-retries=3 \
    robertbeal/gogs

运行在可写模式

可通过环境变量定义UID和GID，但此时无法使用--read-only模式（因为会修改/etc/passwd）。这通过usermod（Alpine的shadow包提供）实现：

docker
docker run \
    --name gogs \
    --rm \
    -e UID=$(id -u) \
    -e GID=$(id -g) \
    -v /var/gogs/config:/config:ro \
    -v /var/gogs/data:/data \
    -p 127.0.0.1:22:22222 \
    -p 127.0.0.1:3000:3000 \
    --cpus=".3" \
    --memory="250m" \
    --pids-limit 50 \
    --health-cmd="curl --fail http://localhost:3000/healthcheck || exit 1" \
    --health-interval=5s \
    --health-retries=3 \
    robertbeal/gogs

构建时设置自定义UID/GID

如需在构建镜像时为git用户指定自定义UID和GID：

docker
docker build \
    --build-arg=UID=1234 \
    --build-arg=GID=5678 \
    -t gogs .