andevour/gitea

Gitea Rootless 镜像（集成Asciidoctor）

镜像概述

本镜像为Gitea的Rootless版本（docker.gitea.com/gitea:X.Y.Z-rootless），在原生Gitea轻量级Git服务基础上，集成了Asciidoctor工具，支持AsciiDoc格式文档的解析与渲染。Rootless架构确保服务以非root用户运行，提升容器环境安全性，同时保持Gitea的轻量特性与完整Git功能。

核心功能与特性

1. Rootless安全架构

• 以非root用户权限运行，减少容器逃逸风险
• 遵循最小权限原则，降低***面
• 兼容容器安全策略（如PodSecurityContext）

2. 完整Git服务能力

• 代码仓库管理（创建、克隆、分支、合并）
• 用户与权限管理（组织、团队、角色控制）
• 内置代码审查、Issue跟踪、Wiki功能
• 支持WebHook与第三方集成（CI/CD工具）

3. Asciidoctor集成

• 原生支持AsciiDoc文档渲染
• 可在Wiki、Issue及代码注释中解析AsciiDoc格式
• 支持文档目录、交叉引用、图表等高级功能

4. 轻量级与可扩展性

• 低资源占用（内存<100MB，CPU占用率低）
• 支持多种数据库后端（SQLite、MySQL、PostgreSQL）
• 可通过配置文件或环境变量自定义服务行为

使用场景与适用范围

• 个人开发者：搭建私有Git服务器，管理代码与技术文档
• 小型团队：轻量级代码协作平台，支持文档驱动开发
• 文档项目：需要AsciiDoc格式技术文档管理与预览的场景
• 安全敏感环境：对容器权限控制有严格要求的部署环境

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name gitea-rootless-asciidoctor \
  -p 3000:3000 \
  -p 2222:2222 \
  -v /path/to/gitea/data:/var/lib/gitea \
  -v /path/to/gitea/config:/etc/gitea \
  -e GITEA__server__DOMAIN=git.example.com \
  -e GITEA__server__HTTP_PORT=3000 \
  -e GITEA__server__SSH_PORT=2222 \
  docker.gitea.com/gitea:X.Y.Z-rootless

Docker Compose配置

yaml
version: '3'

services:
  gitea:
    image: docker.gitea.com/gitea:X.Y.Z-rootless
    container_name: gitea
    restart: always
    ports:
      - "3000:3000"  # HTTP端口
      - "2222:2222"  # SSH端口
    volumes:
      - ./data:/var/lib/gitea
      - ./config:/etc/gitea
      - ./ssh:/data/git/.ssh  # 可选：自定义SSH密钥目录
    environment:
      - GITEA__server__DOMAIN=git.example.com
      - GITEA__server__PROTOCOL=http
      - GITEA__database__TYPE=sqlite3  # 或mysql/postgres
      - GITEA__service__DISABLE_REGISTRATION=false  # 是否允许注册
      - GITEA__markup__ASCIIDOC_ENABLED=true  # 启用Asciidoctor渲染

关键环境变量说明

配置文件自定义

配置文件位于容器内/etc/gitea/app.ini，可通过挂载宿主机目录（如上述./config）进行持久化修改。关键配置项：

ini
[markup.asciidoc]
ENABLED = true
FILE_EXTENSIONS = .adoc,.asciidoc
RENDER_COMMAND = "asciidoctor -s -a showtitle --out-file=- -"
IS_INPUT_FILE = false

注意事项

• Rootless镜像需确保宿主机挂载目录权限正确（建议设置UID/GID为1000:1000）
• Asciidoctor渲染可能需要额外字体支持，可通过自定义Dockerfile添加
• 生产环境建议使用MySQL/PostgreSQL数据库替代默认SQLite
• SSH端口映射需避免与宿主机SSH服务冲突（默认2222）