安装 Docker 和 Docker Compose
确保系统已安装 Docker 和 Docker Compose。可通过以下命令检查版本:
bash
docker --version
docker-compose --version
若未安装,参考官方文档安装对应版本。
创建 docker-compose.yml 文件
新建目录并创建文件,内容如下:
yaml
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 服务
运行以下命令启动容器:
bash
docker-compose up -d
-d 表示后台运行。
访问并初始化 Gogs
浏览器访问 http://localhost:3000,进入安装页面:
- 设置数据库类型(SQLite3 或 MySQL/PostgreSQL,需提前配置)。
- 配置应用 URL、仓库路径等。
- 创建管理员账户。





验证 SSH 访问
测试 SSH 克隆是否正常:
bash
git clone ssh://git@localhost:2222/username/repo.git
确保宿主机 2222 端口未被占用。
数据备份
定期备份 ./data 目录,或通过 Docker 卷管理工具导出数据。
更新 Gogs 版本
停止服务后拉取最新镜像并重启:
bash
docker-compose down
docker-compose pull
docker-compose up -d
常见问题
- 端口冲突 :修改
docker-compose.yml中的宿主机端口(如3001:3000)。 - 权限问题 :确保
./data目录可写(chmod -R 777 ./data)。 - 数据库配置:如需外部数据库,在安装页面填写对应连接信息。
通过以上步骤,可快速部署并维护 Gogs Git 服务。