Gitea Docker 部署（Caddy 反向代理 + 自动 HTTPS）

使用 Docker Compose 部署 Gitea，通过 Caddy 反向代理实现自动 HTTPS（Let's Encrypt）。

架构

Client → Caddy (80/443, 自动 HTTPS) → Gitea (3000, Docker 内部网络)
                                       Gitea SSH (22 → 宿主机 2222)

• Caddy 处理 HTTPS 证书的自动申请、续期和 HTTP→HTTPS 重定向
• Gitea Web 流量通过 Docker 内部网络由 Caddy 代理，不直接暴露端口
• SSH 直接映射到宿主机 2222 端口，不经过 Caddy

快速开始

前提条件

• 域名已解析到服务器公网 IP
• 服务器 80、443、2222 端口可从外网访问

1. 配置环境变量

cp .env.example .env

编辑 .env，关键配置：

DOMAIN=git.example.com    # 你的域名（Caddy 将为此域名申请 HTTPS 证书）
SSH_PORT=2222             # SSH 端口（宿主机端口，容器内仍为 22）

GITEA__server__SSH_PORT 通过 .env 传递给容器，使 Web 界面中的 SSH clone 地址正确显示端口号。

2. 启动服务

docker compose up -d

Caddy 会自动为 DOMAIN 申请 Let's Encrypt 证书，稍等片刻后即可通过 HTTPS 访问。

3. 初始配置

首次访问 https://<DOMAIN> 会进入安装向导：

1. 设置管理员账户
2. 数据库已默认使用 SQLite

访问方式

方式	地址
Web 界面	https://<DOMAIN>
HTTPS 克隆	git clone https://<DOMAIN>/<用户>/<仓库>.git
SSH 克隆	git clone ssh://git@<DOMAIN>: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

# 查看 Caddy 日志
docker compose logs -f caddy

# 重启
docker compose restart

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