基于docker搭建gitea私服仓库，并开启https访问、ssh访问和邮箱验证通知功能

已于 2023-07-14 09:43:31 修改
阅读量7.8k 收藏 24
点赞数 5
分类专栏： git docker Ubuntu 文章标签： docker gitea https
于 2023-07-13 17:02:11 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_44415928/article/details/131700249
版权
Ubuntu 同时被 3 个专栏收录
19 篇文章 0 订阅
订阅专栏
docker
6 篇文章 1 订阅
订阅专栏
git
2 篇文章 1 订阅
订阅专栏

系列文章目录

git常用命令大锦囊

文章目录

前言

团队需要多人协作开发，gitee，github等仓库管理协作人数有限，因此自己搭建基于gitea的仓库私服(最开始使用gitlab，鉴于gitlab功能庞大，占用内存太高，于是换成gitea搭建)。

一、gitea安装

gitea是基于Golang开发的极易安装、运行快速、内存占用小的代码托管服务平台，下面展示基于Docker快速安装gitea。

1. 安装docker compose

由于官方使用docker compose来启动gitea，本环境只有docker，因此需要安装docker compose plugin插件来使用docker compose

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
curl -SL https://github.com/docker/compose/releases/download/v2.19.0/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose

docker compose将会安装到~/.docker/cli-plugins,可自行替换。第三行的v2.19.0也是可以替换的，本文直接按照官网给的版本号安装。第三条命令可能因为外网问题执行不成功，可以先想办法下载下来文件，然后传到Linux上。v2.19.0版本可以从这个百度网盘取：

链接：https://pan.baidu.com/s/17-buewHwxMM5I2_awhuALQ
提取码：1234

安装完后赋予执行权限

chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

执行完后在bash输入docker compose version出现如下内容即安装成功
在这里插入图片描述
官网内容点此：https://docs.docker.com/compose/install/linux/#install-the-plugin-manually

2. 安装gitea

首先我们需要一个可以访问的MySQL服务，来存放gitea服务信息。如果没有MySQL也可以使用docker创建一个很方便，或者使用官方的带MySQL镜像的docker compose 脚本, 详情参考附录。

找一个干净的目录如/home/ubuntu/gitea(将来该目录会存放gitea配置文件) 新建docker-compose.yaml文件，里边内容如下：

version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:1.19
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=mysql      
      - GITEA__database__HOST=127.0.0.1:3306       # 可以访问到的MySQL的ip和port
      - GITEA__database__NAME=giteadb              # 给gitea用的数据库名，可自定义
      - GITEA__database__USER=gitea                # 给gitea用的用户名，可自定义
      - GITEA__database__PASSWD=gitea              # 给gitea用户的数据库密码，可自定义
    restart: always
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "10022:22"             # 将来22端口会映射到10022端口，10022端口可自定义

这里有一个小问题就是，你的数据库配置最好一开始就在docker-compose.yaml 中定好，因为如果等gitea容器创建好了之后再修改app.ini 配置文件，那么当容器重启的时候，他的配置项还是走的是docker-compose.yaml中的配置，所以修改配置的时候，记得把docker-compose.yaml 中的配置也修改了。

先初始化MySQL，创建gitea需要的账号等。下面的这个ip根据自己的服务器定，也可修改为%让任何ip都可访问。

CREATE USER 'gitea'@'192.0.2.10' IDENTIFIED BY 'gitea';    # ip位置可以改为%，表示任何人都可以访问
CREATE DATABASE giteadb CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_unicode_ci';

GRANT ALL PRIVILEGES ON giteadb.* TO 'gitea'@'192.0.2.10';  # ip可改为%
FLUSH PRIVILEGES;

官网位置：https://docs.gitea.com/installation/database-prep#mysql

执行docker compose up -d即可安装gitea。
在这里插入图片描述

安装完后就会看到启动了一个docker
在这里插入图片描述
我们访问IP:3000端口即可看到如下引导页面。可以自己修改一些基础信息，然后点击立即安装即可。
在这里插入图片描述
在这里插入图片描述
随后就可以进入登录页面，我们自己注册一个账号使用了。
在这里插入图片描述
官网内容点此：https://docs.gitea.com/installation/install-with-docker

二、给gitea配置https访问

如不需要配置https可以跳过

首先我们需要准备一个域名和申请好的ssl证书，可以去云厂商自己申请免费证书
在这里插入图片描述
然后下载证书文件，本文讲解如何使用nginx代理gitea配置https。
首先把下载好的Nginx证书文件放到一个可以访问到的目录中
在这里插入图片描述
然后在nginx配置文件中配置

server {
    listen 443 ssl;
    server_name git.nideyuming.com; 
    ssl_certificate /etc/nginx/ssl/cert/git.nideyuming_nginx/git.nideyuming_bundle.pem;
    ssl_certificate_key /etc/nginx/ssl/cert/git.nideyuming_nginx/git.nideyuming.key;
    ssl_session_cache shared:SSL:1m;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;

    location / {
        proxy_pass http://127.0.0.1:3000;
    }
}

server_name位置放置你的域名
ssl_certificate填写你的证书所在位置
ssl_certificate_key 填写你的证书密钥所在位置
location / 的位置是你要代理的地址
然后就可以开启https访问了。

三、gitea配置ssh方式拉取代码

注册登录进入gitea会发现页面十分简约，创建仓库的方式也是跟github等一样，我们首先创建一个仓库。在这里插入图片描述
在这里插入图片描述
可以看到页面和gitee, github等都是类似的。下面我们绑定一个SSH公钥
具体如何生成参考SSH公钥生成方式
在这里插入图片描述
在这里插入图片描述
然后我们使用git clone git@192.168.43.246:kylin/gitea-test.git 下载结果如下：在这里插入图片描述
理论上来说我们绑定了ssh公钥，就不应该再去输入密码，因此我们需要调整。

我们在配置gitea的时候，把gitea的22端口映射到了物理机的10022端口，因此我们git clone 的时候也应该去修改成10022端口，但是我们的gitea给我们自动显示的还是22默认端口，我们需要修改gitea的配置信息。

在/home/ubuntu/gitea/gitea文件中，我们映射了docker内部的/data 目录，因此可以在/home/ubuntu/gitea/gitea 中找配置文件：/home/ubuntu/gitea/gitea/gitea/conf/app.ini
打开该文件内容如下：
在这里插入图片描述
在server配置中，我们需要把这里边的两个22改成我们自己定义的10022端口，然后重启gitea容器即可：docker restart gitea

在这里插入图片描述
可以发现我们的ssh访问方式也加上了10022端口，再次测试：
在这里插入图片描述
发现这次访问我们没有输入密码，直接拉取成功。

四、给gitea配置可发送的邮箱

我们可以选择自己搭建属于自己的邮箱服务，也可以选择例如QQ邮箱，163邮箱的smtp服务来发送邮件。下面介绍如何给gitea绑定qq邮箱，其他邮箱同理。

登录邮箱，选择设置
在这里插入图片描述
然后点击账户列，会发现有一个POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务
在这里插入图片描述
如果你的服务是关闭状态，记得开启一下，需要收验证码等操作。开启之后点击管理服务，页面如下：
在这里插入图片描述
点击生成授权码，会生成一串乱码，这一串乱码就是我们的密码，需要记住。
然后回到gitea的配置项中：/home/ubuntu/gitea/gitea/gitea/conf/app.ini, 找到[mailer] 选项，按照下面的格式填写自己的内容，填写完成重启docker容器即可。

[mailer]
ENABLED = true
SMTP_ADDR = smtp.qq.com         # 这里是固定的qq邮箱smtp地址
SMTP_PORT = 465                 # 端口也固定
FROM = 123456789@qq.com         # 这里是你的QQ邮箱号
USER = 123456789@qq.com         # 这里是你的QQ邮箱号
PASSWD = cnslgzhabcfededh       # 这里是生成的授权码
MAILER_TYPE = smtp              # 这里是固定的smtp
IS_TLS_ENABLED = true           # 这里是固定的true

QQ邮箱官网说明：https://wx.mail.qq.com/list/readtemplate?name=app_intro.html#/agreement/authorizationCode
gitea官网说明：https://docs.gitea.com/administration/email-setup#using-smtp

下面我们可以到gitea测试一下
点击管理后台 -> 应用配置
在这里插入图片描述
在这里插入图片描述
我们可以在此填入一个正确的其他邮箱地址，来给这个邮箱发送测试内容，发送成功后，填写的邮箱会收到一个来自gitea的测试消息。
在这里插入图片描述
到此给gitea配置邮箱完成

五、gitea注册开启邮箱验证和邮箱通知

打开gitea配置文件/home/ubuntu/gitea/gitea/gitea/conf/app.ini, 把REGISTER_EMAIL_CONFIRM 设置成true，这个是打开注册需要邮箱验证；把ENABLE_NOTIFY_MAIL设置成true，这个是开启邮箱通知。

[service]
DISABLE_REGISTRATION              = false
REQUIRE_SIGNIN_VIEW               = false
REGISTER_EMAIL_CONFIRM            = true
ENABLE_NOTIFY_MAIL                = true
ALLOW_ONLY_EXTERNAL_REGISTRATION  = false
ENABLE_CAPTCHA                    = false
DEFAULT_KEEP_EMAIL_PRIVATE        = false
DEFAULT_ALLOW_CREATE_ORGANIZATION = true
DEFAULT_ENABLE_TIMETRACKING       = true
NO_REPLY_ADDRESS                  = noreply.localhost

随后重启gitea容器即可。

六、限制所有仓库只有登录后才能访问

我们搭建好gitea私服之后，如果是在公司内网，那么只能内部人访问，如果是在公有云服务器，任何人只要点击你搭建好的gitea私服首页的探索 , 就会访问到私服里边的公开仓库
在这里插入图片描述
在这里插入图片描述
为了只允许有本公司账号的人登录进入查看，我们需要限制仓库只能登录后看到，找到gitea的配置文件/home/ubuntu/gitea/gitea/gitea/conf/app.ini , [server] 中有一个REQUIRE_SIGNIN_VIEW 字段，默认是false 就是说不登录也可以查看，我们改为true，然后重启gitea容器即可。
在这里插入图片描述
改完重启后我们发现如果点击探索 就会自动跳转到登录页。

同时为了进一步限制只有本公司的人查看，我们可以关闭gitea注册功能，然后谁需要账号，就用管理员账号给分配，如何关闭看下条。

七、关闭gitea的注册功能

为了防止不是本公司的人注册自己搭建的gitea私服，我们可以关闭gitea注册功能，改为使用管理员账号分配账号的形式。

gitea似乎并没有gitlab那样的开启注册完毕 需要审核的功能

在这里插入图片描述
配置文件中DISABLE_REGISTRATION 字段就是禁用注册的功能，改为true 即可。另外一个ENABLE_CAPTCHA 其实是开启注册的时候展示验证码的功能，打开后，注册的时候就需要输入一个验证码。

总结

本文主要介绍什么是gitea，如何通过docker compose的方式去安装，如何开启https访问，以及如何绑定邮箱，开启注册邮箱验证等功能。

附录

针对gitea配置MySQL，gitea官方提供了docker方式的MySQL配置，一键部署，docker-compose 文件如下：

version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=mysql
      - GITEA__database__HOST=db:3306
      - GITEA__database__NAME=gitea
      - GITEA__database__USER=gitea
      - GITEA__database__PASSWD=gitea
    restart: always
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "222:22"
    depends_on:
      - db

  db:
    image: mysql:8
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=gitea
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=gitea
      - MYSQL_DATABASE=gitea
    networks:
      - gitea
    volumes:
      - ./mysql:/var/lib/mysql

核心配置是depends_on 配置里边的db ，根据自己的需要定制配置即可。

一口木桶饭
关注
  • 5
    点赞
  • 踩
  • 24
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
专栏目录
Linux系统：第十四章：安装Docker，java面试编译原理
m0_54861402的博客
12-28 733
systemctl restart docker #centos开放端口宿主机访问 firewall-cmd --add-port=9004/tcp --permanent firewall-cmd --reload #查询端口是否开启命令 firewall-cmd --query-port=9004/tcp #除此之外还可以开机自启动，将firewalld起起来即可，并且允许其自启动 systemctl start firewalld systemctl enable firewalld #如果出现Fai
docker安装nginx并配置通过https访问的方法
09-30
主要介绍了docker安装nginx并配置通过https访问的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
【Docker】搭建一个轻量级项目代码管理平台 - Gitea
小小笔记大大用处
03-23 941
Gitea是一个开源的 Git 服务软件，旨在提供一个轻量级、易于安装和使用的自托管Git服务。它是用 Go 语言编写的，这意味着 Gitea 能够在多种平台上运行，包括 Windows、macOS、Linux 和 ARM 设备等。Gitea 的设计哲学是保持简单和高效，同时提供必要的特性来支持团队协作和代码管理。主要特点：开源和自由：Gitea 是完全开源的，遵循 MIT 许可证，允许用户自由使用、修改和分发。轻量级和高性能。
使用docker搭建最新版本的gitea，并配置HTTPS访问
归子莫的博客
07-05 3268
使用docker搭建最新版本的gitea，并配置HTTPS访问 文章目录使用docker搭建最新版本的gitea，并配置HTTPS访问简介官网docker拉取镜像运行镜像参数命令运行新建仓库配置HTTPS 博客说明 文章所涉及的资料来自互联网整理和个人总结，意在于个人学习和经验汇总，如有什么地方侵权，请联系本人删除，谢谢！ 简介 之前有搭建过gitlab，不过配置要求高，而且使用docker搭建之后各种问题，所以还是使用轻一点的git服务器，也够用了。 官网 gitea docker拉取镜像 默认会拉
ubuntu docker 安装 git服务器 gitea
最新发布
fedorayang的专栏
04-22 432
在浏览器中访问 http://your_server_ip:3000，将 your_server_ip 替换为你服务器的实际 IP 地址，这样就能看到 Gitea 的安装页面。进入安装页面后，配置管理员信息，然后安装即可。完成安装后，就可以使用创建的管理员账户登录 Gitea 并开始管理 Git 仓库。
在Docker中安装Gitea
qq_34844710的博客
01-12 2176
在docker中安装gitea
搭建gitea CICD
lhc-soul
06-24 189
假设我当前的服务器ip为1.1.1.1，后面可以改成自己的云服务器ip,以下文档都是部署在同一服务器内，记得开放防火墙端口。DRONE_GITEA_CLIENT_SECRET 是Gitea oauth 客户端密钥。DRONE_GITEA_CLIENT_ID 是 Gitea oauth 客户端 ID。创建Gitea oauth 客户端 ID和 Gitea oauth 客户端密钥。DRONE_RPC_SECRET 是上文说的hex_value。运行drone-runner-docker容器。
docker安装gitea
HELLO WORLD
04-17 2429
docker安装gitea
Docker环境下Jenkins结合Gitee搭建流程总结
qq_42394166的博客
12-07 1915
jenkins实现了项目CI/CD，更好的体现了持续交付，解决了在手动打包部署项目的繁杂
Docker搭建简单的应用栈与容器Hello World访问详解
09-30
主要介绍了Docker搭建简单的应用栈与容器Hello World访问,结合实例形式详细分析了Docker应用容器栈的获取、互联、启动、配置以及应用访问测试相关操作技巧,需要的朋友可以参考下
Docker搭建私有镜像仓库的方法
01-10
和Mavan的管理一样，Dockers不仅提供了一个中央仓库，同时也允许我们使用registry搭建本地私有仓库。 使用私有仓库有许多优点： 节省网络带宽，针对于每个镜像不用每个人都去中央仓库上面去下载，只需要从私有仓库...
详解用Docker搭建外部可以访问的mysql
09-09
主要介绍了详解用Docker搭建外部可以访问的mysql，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
基于Docker的DevOps搭建
02-23
一直对DevOps感兴趣，最近心血来潮，搭乘Docker搞一搞，Let‘sGo！！！这一步很慢，要好几分钟，可以查看log，看到ok再访问，host必须要设置，不然会是docker生成的一个数字，现在你就可以访问http://localhost看到...
GitLab安装使用(SSH+Docker两种方式)
冲出仁川，走出马德里，故事还会再继续
01-03 1382
gitlab安装(ssh和docker两种方式)
docker容器内安装git服务端
qq_34631220的博客
12-10 3845
# 创建容器 # --privileged 获得完整的root权限 # /usr/sbin/init 启动容器执行的第一个命令 以便可以使用systemctl命令 # 将容器的ssh服务22端口映射到宿主的65002端口 docker run -itd --privileged --name mygitenv -p 65002:22 centos /usr/sbin/init # 在容器里安装软件 yum install openssh-server git passwd -y #..
window 设置gitea ssh key
奶酪的博客
05-21 3511
window 设置gitea ssh key 桌面按住SHIFT键 然后鼠标右击，出现弹框选择 在此处打开 Powershell 然后找到 .ssh 文件夹 PS C:\Users\SHAPEJOY-YY\Desktop> cd … //回到上一级目录 PS C:\Users\SHAPEJOY-YY> cd …ssh\ // 进入.ssh 目录 （这里...
Docker+Jenkins+Gitee自动化部署maven项目，加入Nexus镜像仓库（补充篇）
StoNENee的博客
06-03 1204
Docker+Jenkins++Nexus+Gitee自动化部署maven项目
Win 下 Docker 安装 Gitea 实践
小子宝丁的博客
09-13 854
本文介绍了 使用 Docker 部署 Gitea 的一个实践过程，其中选用了MySQL数据库，同时使用了 Docker-Compose 容器编排技术。
Gitea服务搭建指南
xiliuhu的专栏
05-28 2754
常用的私有Git服务器包含GitLab、Gitea、Gogs等。相对来说，GitLab功能最为全面，内置CI，但对内存和CPU的要求比较高，而Gogs和Gitea均比较轻量化。根据实际需求与条件最终选择了Gitea，Gitea是Gogs的社区版本，足够轻量化，并且包含LFS的支持。 2|0环境准备 2|1安装数据库：采用SQLite数据库 Windows安装: 下载网址：https://sqlite.org/download.html，如下图下载预编译版本中的sqlite-dll-win.
docker搭建gitea
05-24
要在 Docker 中搭建 Gitea，可以按照以下步骤进行操作： 1. 下载 Gitea 的 Docker 镜像。 ``` $ docker pull gitea/gitea ``` 2. 创建一个 Docker 数据卷，用于持久化 Gitea 数据。 ``` $ docker volume create gitea-data ``` 3. 使用 Docker Compose 创建一个 Gitea 容器。 创建一个名为 `docker-compose.yml` 的文件，内容如下： ``` version: '3' services: gitea: image: gitea/gitea restart: always volumes: - gitea-data:/data ports: - 3000:3000 - 22:22 environment: - USER_UID=1000 - USER_GID=1000 - DB_TYPE=sqlite3 - DISABLE_REGISTRATION=true - ROOT_URL=http://localhost:3000 - SSH_PORT=22 - SSH_LISTEN_ADDRESS=0.0.0.0 - SSH_DISABLE_PASSWORD_AUTH=true - GITEA_CUSTOM=/data/gitea volumes: gitea-data: ``` 运行以下命令启动容器： ``` $ docker-compose up -d ``` 4. 访问 Gitea 网站。 打开浏览器，访问 `http://localhost:3000`，即可进入 Gitea 网站。初次访问时，需要设置管理员账号和密码，并进行一些基本的配置。 注意：如果要在生产环境中使用 Gitea，建议使用 PostgreSQL 或 MySQL 数据库，而不是默认的 SQLite3。可以参考 Gitea 的官方文档进行配置。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值