hiramsoft/gogs

Gogs 镜像（含符号链接修复）

镜像概述

本镜像基于Gogs（一款轻量级自助Git服务）构建，重点修复了符号链接（symlink）相关问题，确保数据目录可跨主机移动时避免符号链接错误，提升数据迁移的稳定性和可靠性。

核心功能与特性

• 轻量级Git服务：完整支持Git仓库管理、用户权限控制、代码审查、Issue跟踪等核心功能
• 符号链接修复：解决了原版Gogs中数据目录跨主机移动时可能出现的符号链接失效问题
• 跨主机数据迁移：支持将Gogs数据目录（含仓库、配置等）在不同主机间迁移，保持数据一致性
• 兼容性：与官方Gogs镜像接口兼容，可无缝替换使用

使用场景

• 需要在物理机、虚拟机或容器平台间迁移Gogs服务的场景
• 对数据备份与恢复有高要求的Git服务部署
• 需要跨环境（如开发、测试、生产）同步Gogs数据的场景
• 希望避免因符号链接问题导致数据迁移失败的Gogs用户

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name=gogs \
  -p 3000:3000 \
  -p 222:22 \
  -v /path/to/gogs/data:/data \
  gogs/gogs:latest-symlink-fix

说明：/path/to/gogs/data为宿主机数据目录，迁移时只需将此目录复制到新主机并保持挂载路径一致即可

Docker Compose 配置

yaml
version: '3'
services:
  gogs:
    image: gogs/gogs:latest-symlink-fix
    container_name: gogs
    ports:
      - "3000:3000"  # Web访问端口
      - "222:22"      # SSH访问端口
    volumes:
      - /path/to/gogs/data:/data  # 数据持久化目录
    restart: always

数据迁移步骤

1. 在源主机停止Gogs容器：docker stop gogs
2. 复制数据目录到目标主机：scp -r /path/to/gogs/data user@target-host:/path/to/gogs/data
3. 在目标主机使用相同命令启动容器，确保数据目录挂载路径一致
4. 启动后验证服务可用性及数据完整性

配置说明

环境变量

数据目录结构

挂载的/data目录包含以下关键子目录：

• gogs/conf：配置文件
• gogs/repos：Git仓库数据
• gogs/data：用户上传文件、头像等
• gogs/log：日志文件

注意事项

• 迁移前建议备份数据目录，避免数据丢失
• 确保目标主机Docker环境与源主机兼容（如架构一致）
• 迁移后首次启动可能需要重新配置域名或IP相关设置
• 如使用外部数据库，需确保数据库服务可被目标主机访问