hetsh/gitea

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 https://github.com/Hetsh/docker-gitea%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82%E5%90%AF%E7%94%A8%E5%B9%B6%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1%EF%BC%9A

bash
systemctl enable gitea --now

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

参与项目

这是一个托管在https://github.com/Hetsh/docker-gitea%E4%B8%8A%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E3%80%82%E6%AC%A2%E8%BF%8E%E6%8F%90%E9%97%AE%E3%80%81%E6%8F%90%E4%BA%A4issue%E6%88%96%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%E3%80%82