Gitea:把代码仓放回自己口袋
Docker 自部署 国内可用轻量自建 Git 服务
编辑评价3.6编辑部综合整理,仅供参考
官方镜像
gitea/gitea
内存占用
512M
部署难度
低
维护活跃
活跃
工具介绍
Gitea:把代码仓放回自己口袋
Gitea 是用 Go 写的轻量自建 Git 服务:代码仓、Issue、PR、Wiki、CI 都装在一个几十 MB 量级的容器里,私有部署一杯茶的工夫就能起,团队代码从此不必寄存在别人的服务器上。
核心优势
- 资源门槛极低。Go 编译的单体服务,官方文档的最简模板就是几行 compose:一个卷、一个网络、SQLite 起库,低配设备就能常年跑;对比动辄数 GB 内存的重量级代码平台,它是「人人有条件自建」的那一档。
- 功能面出乎意料地全。代码托管之外,Issue、看板、PR 审查、Wiki、内建 CI(与 GitHub Actions 语法兼容)、Cargo/NPM/Container 等包管理都是开箱能力,从 GitHub 搬工作流的心智成本很低。
- 数据就是一个目录。SQLite 起步零依赖,长大后再按官方文档换 MySQL/Postgres;仓库与数据库都在 /data 卷里,备份等于拷目录,迁移等于搬目录,这种朴素在代码托管这种「家当型」服务上是实打实的优点。
- 迁移通道顺。GitHub、GitLab 等平台的仓库可以带 Issue 一并迁入,官方迁移界面填个令牌就能跑,搬家不再是劝退项。
适合谁
前提条件先说清:一台常开的机器装好 Docker,或者其他能常驻的 Linux 环境。它适合不想把私有代码交给第三方托管的小团队、家庭项目与个人开发者。「怕折腾程度」低:官方 compose 模板贴进目录、docker compose up -d,浏览器打开 3000 端口走安装向导就完事;难点不在装,而在角色定位——代码是重要家当,异地备份、SSH 端口规划与 HTTPS 访问控制要按生产标准来。只想本地版本管理的话,纯 Git 裸仓也够用;需要 Issue、CI 与多人协作,它就是轻量档位里最顺手的那个。
惊蛰 整理 · 2026-09 收录
评测视频
点击跳转 B 站观看原视频已聚合 2 条评测视频 ·2 位博主独立评测
部署速查
官方镜像gitea/gitea
内存占用512M
部署难度低
维护活跃活跃
部署前提
- Docker 与 Compose v2;rootful 与 rootless 镜像互不兼容,选定一种后不要在 compose 里换镜像类型(官方文档明确提醒)。
- 卷目录属主要与容器内 UID/GID(USER_UID/USER_GID)匹配,权限不对容器可能起不来。
- 稳定版镜像 tag 可选 :latest、:1 或具体版本号,开发版为 :main-nightly(官方文档字面)。
来源声明:compose 出自官方文档 docs.gitea.com/installation/install-with-docker。
安装与启动(官方最简模板,照抄)
networks:
gitea:
external: false
services:
server:
image: docker.gitea.com/gitea:28.0.0
container_name: gitea
environment:
- USER_UID=1000
- USER_GID=1000
restart: always
networks:
- gitea
volumes:
- ./gitea:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "222:22"
官方文档同页另给 MySQL/Postgres 双服务模板与改宿主端口的写法(如 8080:3000),按需取用。
部署之后
docker compose up -d 启动,浏览器打开 http://<服务器IP>:3000 完成安装向导;compose 里若带数据库服务,向导中数据库主机名填 db。SSH 走 222 端口映射,配置文件落在 /data/gitea/conf/app.ini。
快速上手
1装好 Docker 与 Compose v2,新建目录放入官方 docker-compose.yml(镜像 docker.gitea.com/gitea,端口 3000 与 222)。
2`docker compose up -d` 起容器。
3浏览器打开 http://<主机IP>:3000 走安装向导(用 compose 内数据库时主机名填 db),注册管理员后建第一个仓库。
本页由编辑 惊蛰 整理与维护 · 了解幕后


![[Gitea] Gitee不能用?手把手教你搭建git服务 评测视频封面](https://1820887968.cdn.123clouddisk.com/1820887968/yz/w2n/cv/web/92OJ/HabSds2h92OJ.jpg)
