Docker部署Gitea服务的实现

更新时间：2026年03月27日 08:30:18 作者：Frostpine

本文主要介绍了Docker部署Gitea服务的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

一、前置准备

服务器已安装 Docker + Docker Compose（没装的看文末一键安装命令）
服务器开放端口：3000（Web） 、222（SSH 克隆）
建议创建一个单独目录存放配置（方便管理）

mkdir -p /opt/gitea && cd /opt/gitea

二、创建 docker-compose.yml 配置文件

在 /opt/gitea 目录下创建 docker-compose.yml，直接复制粘贴即可：

version: "3"
networks:
  webvibecoding:
    external: false
services:
  # 数据库（使用 SQLite 可省略，这里用 MySQL 更稳定）
  mysql:
    image: mysql:8
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=123321123b  # 数据库 root 密码（可修改）
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=123321123b
      - MYSQL_DATABASE=gitea
    volumes:
      - ./mysql:/var/lib/mysql
    networks:
      - webvibecoding
  # Gitea 主服务
  gitea:
    image: gitea/gitea:latest
    restart: always
    ports:
      - "3000:3000"    # Web 访问端口
      - "222:22"       # SSH 克隆端口
    environment:
      - USER_UID=1000
      - USER_GID=1000
    volumes:
      - ./gitea:/data  # 数据持久化
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    networks:
      - webvibecoding
    depends_on:
      - mysql

配置说明

数据存在当前目录 ./gitea 和 ./mysql，卸载容器数据不会丢失
Web 端口：3000，SSH 端口：222
数据库密码可自行修改

三、启动 Gitea

# 后台启动（-d 表示后台运行）
docker-compose up -d
# 查看启动状态
docker-compose ps

看到 gitea 和 mysql 状态为 Up 就说明启动成功。

四、Web 页面初始化配置

打开浏览器访问：http://你的服务器IP:3000

会进入 Gitea 初始化页面

按下面配置填写：

1. 数据库配置

配置	内容
数据库类型	MySQL
主机	mysql:3306
用户名	gitea
密码	123321123b
数据库名	gitea

2. 基础配置

配置	内容
站点名称	自定义（如：我的 Git 仓库）
仓库根路径	默认即可
Gitea 基础 URL	http://你的服务器IP:3000
SSH 端口	222

3. 管理员账号（必创建）

拉到页面最下方，创建管理员账号：

用户名：admin
密码：自定义
邮箱：自定义

点击 立即安装，完成后自动跳转到登录页。

五、使用 Gitea

登录：http://IP:3000
创建仓库 → 克隆使用
SSH 克隆示例：

git clone ssh://git@服务器IP:222/用户名/仓库名.git

HTTP 克隆示例：

git clone http://服务器IP:3000/用户名/仓库名.git

六、常用运维命令

# 停止服务
docker-compose down
# 重启服务
docker-compose restart
# 查看日志
docker-compose logs -f gitea
# 升级 Gitea（拉最新镜像 + 重启）
docker-compose pull
docker-compose up -d

七、Nginx 域名绑定（无 SSL 纯 HTTP 版）

前置要求

域名已解析到服务器公网 IP
服务器开放端口：80 (HTTP)
依旧在 /opt/gitea 目录操作

步骤 1：修改 docker-compose.yml

直接替换你原有的配置，仅保留 80 端口，无 SSL、无复杂配置，完美兼容原有 Gitea：

networks:
  webvibecoding:
    external: false
services:
  # 数据库（不变）
  mysql:
    image: mysql:8
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=123321123b
      - MYSQL_USER=gitea
      - MYSQL_PASSWORD=123321123b
      - MYSQL_DATABASE=gitea
    volumes:
      - ./mysql:/var/lib/mysql
    networks:
      - webvibecoding
  # Gitea 主服务（删除3000端口映射）
  gitea:
    image: gitea/gitea:latest
    restart: always
    ports:
      - "222:22"       # SSH克隆端口（保留不变）
    environment:
      - USER_UID=1000
      - USER_GID=1000
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    networks:
      - webvibecoding
    depends_on:
      - mysql
  # Nginx 极简配置（仅HTTP 80端口）
  nginx:
    image: nginx:alpine
    restart: always
    ports:
      - "80:80"  # 仅开放80端口
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - /etc/localtime:/etc/localtime:ro
    networks:
      - webvibecoding
    depends_on:
      - gitea

步骤 2：创建 Nginx 配置目录 + 文件

# 创建配置文件夹
mkdir -p /opt/gitea/nginx/conf.d

在 /opt/gitea/nginx/conf.d 新建 gitea.conf，直接复制：

server {
    listen 80;
    # 你的专属域名
    server_name 域名;
    # 反向代理到Gitea容器
    location / {
        proxy_pass http://gitea:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

步骤 3：重启服务生效

cd /opt/gitea
# 重启所有容器
docker-compose down && docker-compose up -d
# 查看状态（3个服务都为Up即成功）
docker-compose ps

步骤 4：修改 Gitea 基础 URL（必做）

浏览器访问：http://域名
管理员登录 → 右上角头像 → 控制面板
左侧 基本设置
修改：
- Gitea 基础 URL：http://域名
- SSH 端口：222（保持不变）
拉到最下方保存

最终效果

✅ 访问地址：无端口，直接用域名

✅ SSH 克隆：git clone ssh://git@域名:222/用户名/仓库名.git

✅ HTTP 克隆：git clone http://域名/用户名/仓库名.git

附录：一键安装 Docker + Docker Compose

# Docker
curl -fsSL https://get.docker.com | bash
systemctl enable docker && systemctl start docker
# Docker Compose
apt install -y docker-compose  # Debian/Ubuntu
# 或 CentOS
yum install -y docker-compose

到此这篇关于Docker部署Gitea服务的实现的文章就介绍到这了,更多相关Docker部署Gitea内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Docker
Gitea

k8s官方镜像代理加速方式
这篇文章主要介绍了k8s官方镜像代理加速方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-06-06
使用Maven打包构建Docker镜像并推送到仓库
这篇文章主要介绍了使用Maven打包构建Docker镜像并推送到仓库问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-04-04
docker中运行PostgreSQL容器的简单步骤
这篇文章主要给大家介绍了关于docker中运行PostgreSQL容器的简单步骤,随着docker的广泛应用,为了提供便利的管理,PostgreSQL数据库也支持docker的安装方式,需要的朋友可以参考下
2023-08-08
详解docker容器分配静态IP
这篇文章主要介绍了详解docker容器分配静态IP,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-01-01
docker容器定时重启的实现步骤
本文主要介绍了docker容器定时重启的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-09-09
使用WSL修改docker文件存储位置具体步骤
这篇文章主要为大家介绍了使用WSL修改docker文件存储位置具体步骤,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-10-10
docker容器下配置jupyter notebook的操作
这篇文章主要介绍了docker容器下配置jupyter notebook的操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-03-03
CentOS7 Docker安装ELK全过程
文章详细介绍了在CentOS 7上使用Docker安装ELK（Elasticsearch, Logstash, Kibana）的准备工作和步骤,包括安装Docker、Docker Compose,创建相关挂载目录和配置文件,启动ELK服务,设置ES密码以及开放端口
2025-10-10
docker镜像管理命令详解
这篇文章主要介绍了docker镜像管理命令,我们也可以使用命令来搜索镜像，比如我们需要一个tomcat的镜像来作为我们的web服务，我们可以通过 docker search 命令搜索tomcat来寻找适合我们的镜像，本文给大家介绍的非常详细，需要的朋友参考下吧
2022-07-07
两台互通的服务器使用Docker部署一主两从MySQL8.0.35的方法
本文主要介绍了在两台服务器上使用Docker部署一主两从的MySQL 8.0.35架构,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2025-03-03