altcloud/gitea

dockerfiles-alt-gitea

镜像概述

ALT版本的Gitea Dockerfile，用于构建自托管Git服务镜像。Gitea是一款轻量级、开源的Git服务，可用于搭建私有代码仓库，支持代码管理、版本控制、协作开发等功能。

核心功能与特性

• 提供完整的自托管Git服务，支持代码仓库创建、分支管理、提交历史查看等
• 数据持久化：通过挂载卷实现Gitea数据的持久化存储
• 灵活配置：支持通过配置文件自定义Gitea参数、HTTPS证书、邮件证书等
• 集成SSH服务：包含OpenSSH服务器配置，支持SSH协议访问代码仓库

使用场景

• 个人开发者搭建私有代码仓库
• 小型团队内部代码协作与版本控制
• 需要本地部署Git服务的企业或组织

使用方法

构建镜像

将Dockerfile复制到本地目录，执行以下命令构建镜像：

bash
docker build --rm -t <username>/gitea .

运行容器

使用以下命令启动Gitea容器，映射必要端口并挂载数据卷：

bash
docker run -d -p 80:3000 -p 2222:22 -v <gitea_path>:/var/lib/gitea <username>/gitea

参数说明：

• -d：后台运行容器
• -p 80:3000：将容器的3000端口（Gitea Web界面）映射到主机的80端口
• -p 2222:22：将容器的22端口（SSH服务）映射到主机的2222端口
• -v <gitea_path>:/var/lib/gitea：挂载本地目录<gitea_path>到容器内的/var/lib/gitea，用于持久化存储Gitea数据

配置说明

挂载的<gitea_path>目录包含Gitea的所有可变数据，可通过该目录下的文件自定义配置。主要配置路径（相对于<gitea_path>）如下：

• 配置文件：custom/conf/app.ini - Gitea主配置文件，可自定义服务端口、数据库连接、邮件设置等
• HTTPS证书：custom/https/ - 存放HTTPS证书文件，用于启用HTTPS访问
• 邮件证书：custom/mailer/ - 存放邮件服务相关证书
• OpenSSH配置：openssh/ - OpenSSH服务器配置文件和密钥
• 数据库文件：data/gitea.db - SQLite3数据库文件（默认数据库）

修改配置后需重启容器使配置生效。