在 VPS 上用 Gitea 自建 Git 服务 - Docker Compose 部署

在 12 € 的 VPS 上运行 GitHub 风格的 Git 服务器:Gitea + PostgreSQL + HTTPS,docker compose、Caddy 反向代理、SSH 推送与备份。

Gitea 是轻量级 Git 服务,支持 Issue、Pull Request 和 CI 钩子:该有的都有,只占几百 MB 内存。在 16 欧元的 VPS 上就能服务整个团队。

1. 安装 Docker

apt update && apt install -y docker.io docker-compose-v2 git
systemctl enable --now docker

含 Compose 基础的完整教程:Docker 指南。

2. Compose 文件

mkdir -p /opt/gitea && cd /opt/gitea
cat > docker-compose.yml <<'EOF'
services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: gitea
      POSTGRES_PASSWORD: change-me-db
      POSTGRES_DB: gitea
    volumes:
      - ./db:/var/lib/postgresql/data
  gitea:
    image: gitea/gitea:1
    restart: unless-stopped
    depends_on: [db]
    environment:
      GITEA__database__DB_TYPE: postgres
      GITEA__database__HOST: db:5432
      GITEA__database__NAME: gitea
      GITEA__database__USER: gitea
      GITEA__database__PASSWD: change-me-db
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "127.0.0.1:3000:3000"
      - "2222:22"
EOF
docker compose up -d

注意端口绑定:网页界面只监听 localhost,而用于 `git push` 的 SSH 在 2222 端口。请让该端口可访问:要么在防火墙开放 2222,要么稍后改用 HTTPS 提供 Git 服务。

3. 用 Caddy 启用 HTTPS

apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
git.example.com {
    reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy

Caddy 会自动申请证书。请先把域名的 A 记录指向服务器,再在浏览器中完成安装向导:第一个注册的账户即为管理员。

4. 推送代码

git remote add origin ssh://[email protected]:2222/you/project.git
git push -u origin main

只需在 Gitea 设置中添加一次公钥,之后每次推送都无需密码。

5. 真正能恢复的备份

docker compose exec -u git gitea gitea dump -c /data/gitea/conf/app.ini
# the dump lands in /opt/gitea/data/gitea, then ship it off-site:
restic backup /opt/gitea/data --exclude-caches

`gitea dump` 命令会把数据库、仓库和配置打包成一个归档文件。异地备份请参阅 restic 指南。

常见问题

Gitea 需要多少内存?

容器空闲时约占 150–250 MB,PostgreSQL 再占 100–200 MB。小团队用 2 GB 服务器很宽裕;如果还要运行 CI 执行器或大量大型仓库,建议 4 GB。

可以从 GitHub 导入仓库吗?

可以。在 Gitea 中选择“新建迁移”,粘贴仓库 URL,即可复制代码、Issue 和 Pull Request。私有仓库需要 GitHub 访问令牌。

代码放在 VPS 上安全吗?

安全程度取决于您的服务器管理:SSH 密钥、防火墙、更新和异地备份就能覆盖现实中的风险。对许多团队来说,这比把一切托付给第三方更可控。

Gitea 加 PostgreSQL 在 Core VPS 6(€16/月)上运行绰绰有余。

相关内容

查看套餐指南常见问题