klingtdotnet/gogs

gogs 作为 Docker 服务

镜像概述和主要用途

gogs 是一个使用 Go 语言开发的类似 GitHub 的 Git 服务器，本 Docker 镜像提供了将 gogs 作为服务部署的便捷方式，支持数据持久化和灵活配置，适用于个人或小型团队搭建自托管的 Git 服务。

核心功能和特性

• 轻量级 Git 服务器，功能类似 GitHub
• 支持数据持久化存储，通过数据容器管理关键目录
• 提供 Web 界面进行初始配置和日常管理
• 可通过 Nginx 反向代理实现 HTTPS 访问

使用场景和适用范围

适用于需要自托管 Git 服务的个人开发者、小型开发团队或组织，尤其适合对数据隐私和服务器控制权有要求的场景。

使用方法和配置说明

创建数据容器

首先创建数据容器以持久化存储 gogs 数据：

sh
docker create --name gogs-data --volume /home/gogs --volume /etc/ssh --volume /opt/gogs/custom --volume /opt/gogs/log klingtdotnet/gogs

首次运行

通过以下命令启动 gogs 进行初始配置：

sh
docker run --rm --volumes-from gogs-data -p 8080:3000 -it klingtdotnet/gogs

初始配置注意事项：

• 将“运行用户”设置为 gogs
• 将 SQLite 数据库位置设置在 /home/gogs 目录下（该目录会挂载到数据容器）
• 警告：首次运行时会提供 Web 安装表单用于设置管理员账户，此时确保容器不对外可访问！完成初始设置后再公开服务。注意：不能使用 admin 作为管理员账户名，详见。
• 建议通过 SSH 隧道访问容器进行初始设置：ssh -L 本地端口:域名:远程端口 域名

配置优化

初始设置完成后，建议检查并优化 sshd 和 gogs 配置：

sh
docker run --rm --volumes-from gogs-data -it klingtdotnet/vim /bin/bash

可参考 gogs 配置指南 进行优化，如禁用 X11 转发、root 登录和密码认证等安全设置。

作为 SystemD 服务运行

待办...

HTTP(s) Nginx 配置示例

由于 SSH 服务器无法监听子路径（如 some.domain/git），建议使用子域名部署：

nginx
server {
    listen 80;
    listen [::]:80;
    server_name git.some.domain.name;
    return 301 [***]
}

server {
    listen       443 ssl spdy;
    listen       [::]:443 ssl spdy;
    server_name  git.some.domain.name;

    ssl_certificate         /etc/nginx/ssl/git_some_domain_name.crt;
    ssl_certificate_key     /etc/nginx/ssl/git_some_domain_name.key;

    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;

    location / {
        proxy_pass  http://localhost:***/;
    }
}