gitea/README.md

Gitea 局域网部署

使用 Docker Compose 部署的 Gitea Git 服务。

快速开始

1. 配置环境变量

复制并编辑 .env 文件：

cp .env.example .env

修改端口等配置：

HTTP_PORT=3000    # Web 界面端口
SSH_PORT=2222     # SSH 端口

2. 启动服务

docker compose up -d

3. 初始配置

首次访问 http://<服务器IP>:3000 会进入安装向导：

1. 设置管理员账户
2. 配置服务器域名（可选）
3. 数据库已默认使用 SQLite

访问方式

方式	地址
Web 界面	http://<IP>:3000
HTTP 克隆	git clone http://<IP>:3000/<用户>/<仓库>.git
SSH 克隆	git clone ssh://git@<IP>:2222/<用户>/<仓库>.git

Git LFS

已启用 Git LFS 支持，使用方法：

git lfs install
git lfs track "*.psd"
git add .gitattributes
git commit -m "Track PSD files with LFS"
git push

数据备份

备份 data/ 目录：

# 备份
tar -czvf gitea-backup-$(date +%Y%m%d).tar.gz data/

# 恢复
tar -xzvf gitea-backup-20260320.tar.gz

重要文件：

• data/gitea/gitea.db - 用户和配置数据
• data/git/repositories/ - 仓库数据
• data/git/lfs/ - LFS 文件

常用命令

# 启动
docker compose up -d

# 停止
docker compose down

# 查看日志
docker compose logs -f

# 重启
docker compose restart

# 更新版本
# 修改 .env 中的 GITEA_VERSION 后
docker compose up -d