hetsh/gitea Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Gitea

镜像概述和主要用途

Gitea是一个超小型代码托管平台，提供轻量级的自托管代码仓库管理功能，可作为GitHub的替代方案，适合个人开发者或小型团队使用。

核心功能和特性

• 轻量级设计，资源占用低
• 支持通过Web界面进行配置
• 内置SSH服务器，支持SSH访问代码仓库
• 提供配置向导，简化初始设置
• 支持持久化存储，确保数据不丢失
• 可通过systemd实现自动启动和关闭

使用场景和适用范围

• 个人开发者需要自托管代码仓库
• 小型团队内部代码管理和协作
• 对资源占用有严格要求的环境
• 需要自定义配置和数据持久化的场景

使用方法和配置说明

运行服务器

使用以下命令启动Gitea服务器：

bash
docker run --detach --name gitea --publish 3022:3022 --publish 3000:3000 hetsh/gitea

该命令会后台运行容器，映射3022端口（SSH）和3000端口（Web界面）。

停止容器

停止Gitea容器的命令：

bash
docker stop gitea

配置

Gitea通过Web界面进行配置。首次运行服务器时，会有配置向导引导完成初始设置。

如果要重用现有配置，配置文件需包含以下参数：

ini
[repository]
ROOT        = /gitea/repos ;修改此路径指向你的仓库存储位置
SCRIPT_TYPE = sh

[server]
START_SSH_SERVER = true
SSH_PORT         = 3022
STATIC_ROOT_PATH = /usr/share/webapps/gitea

[log]
ROOT_PATH = /var/log/gitea

挂载现有配置文件，并确保gitea用户（ID为1360）具有读写权限：

bash
docker run --mount type=bind,source=/path/to/config.ini,target=/etc/gitea/app.ini ...

创建持久化存储

创建持久化存储目录并设置权限：

bash
STORAGE="/path/to/storage"
mkdir -p "$STORAGE"
chown -R 1360:1360 "$STORAGE"

1360是运行服务器的用户ID（参见Dockerfile）。该用户必须对存储目录有读写权限。

启动服务器时添加挂载参数：

bash
docker run --mount type=bind,source=/path/to/storage,target=/gitea ...

时区同步

同步时区可确保日志中显示正确时间。通过以下挂载参数共享时区：

bash
docker run --mount type=bind,source=/etc/localtime,target=/etc/localtime,readonly ...

通过systemd实现自动启动和关闭

systemd服务单元文件可在GitHub 仓库中找到。启用并启动服务：

bash
systemctl enable gitea --now

默认情况下，systemd服务假设配置文件位于/apps/gitea/app.ini，存储目录位于/apps/gitea/data，时区文件位于/etc/localtime。由于这是个人系统服务单元文件，你可能需要调整部分参数以适应你的环境。

参与项目

这是一个托管在GitHub上的开源项目。欢迎提问、提交issue或贡献代码。