安装 Docker 和 Docker Compose

确保系统已安装 Docker 和 Docker Compose。可通过以下命令检查版本：

docker --version
docker-compose --version

若未安装，参考官方文档安装对应版本。

创建 docker-compose.yml 文件

新建目录并创建文件，内容如下：

version: '3'

services:
  gogs:
    image: gogs/gogs:latest
    container_name: gogs
    ports:
      - "3000:3000"
      - "2222:22"
    volumes:
      - ./data:/data
    restart: unless-stopped

• ports 将容器 3000（Web）和 22（SSH）映射到宿主机。
• volumes 持久化数据到本地 ./data 目录。

启动 Gogs 服务

运行以下命令启动容器：

docker-compose up -d

-d 表示后台运行。

访问并初始化 Gogs

浏览器访问 http://localhost:3000，进入安装页面：

• 设置数据库类型（SQLite3 或 MySQL/PostgreSQL，需提前配置）。
• 配置应用 URL、仓库路径等。
• 创建管理员账户。

验证 SSH 访问

测试 SSH 克隆是否正常：

git clone ssh://git@localhost:2222/username/repo.git

确保宿主机 2222 端口未被占用。

数据备份

定期备份 ./data 目录，或通过 Docker 卷管理工具导出数据。

更新 Gogs 版本

停止服务后拉取最新镜像并重启：

docker-compose down
docker-compose pull
docker-compose up -d

常见问题

• 端口冲突：修改 docker-compose.yml 中的宿主机端口（如 3001:3000）。
• 权限问题：确保 ./data 目录可写（chmod -R 777 ./data）。
• 数据库配置：如需外部数据库，在安装页面填写对应连接信息。

通过以上步骤，可快速部署并维护 Gogs Git 服务。