跳到主要内容
版本:1.0

快速入门

Gogs 是一款极易搭建的自助 Git 仓库系统,相对于 GitLab 而言 Gogs 更加轻量级。Gogs 的目标是打造一个最简单、最快速和最轻松的方式搭建自助 Git 服务。使用 Go 语言开发使得 Gogs 能够通过独立的二进制分发,并且支持 Go 语言支持的 所有平台,包括 Linux、Mac OS X、Windows 以及 ARM 平台。

部署 Websoft9 提供的 Gogs 之后,请参考下面的步骤快速入门。

准备

  1. 在云控制台获取您的 服务器公网IP地址
  2. 在云控制台安全组中,确保 Inbound(入)规则 下的 TCP:80和10022 端口已经开启
  3. 在服务器中查看 Gogs 的 默认管理员账号和密码
  4. 若想用域名访问 Gogs,务必先完成 域名五步设置 过程

Gogs 安装向导

详细步骤

  1. 使用本地电脑浏览器访问网址:<http://域名> 或 <http://服务器公网IP>, 进入初始化页面。进入页面底部选择合适的语言。

  2. 设置数据库连接(查看预装的数据库账号密码

    • 数据库类型: MySQL
    • 主机名:gogs-db

  3. 设置 Gogs 的应用基本参数

    • 域名:公网IP 或 真实域名
    • SSH 端口: 10022, 可从 Gogs 根目录 .env 文件中查询
    • HTTP 端口: 80
    • 应用 URL:http://公网IPhttp://域名:端口

  4. 设置管理账号

  5. 安装成功后,进入系统后台

出现问题?

若碰到问题,请第一时刻联系 技术支持。也可以先参考下面列出的问题定位或 FAQ 尝试快速解决问题。

安装的时候忘记设置管理账号?

创建管理员帐号并不是必须的,因为用户表中的第一个用户将自动获得管理员权限。

Gogs 常用操作

设置语言

进入页面下方设置语言

Gogs 参数

Gogs 应用中包含 Docker, MySQL 等组件,可通过 通用参数表 查看路径、服务、端口等参数。

通过运行 docker ps,查看 Gogs 运行时所有的服务组件:

CONTAINER ID   IMAGE              COMMAND                  CREATED          STATUS                    PORTS                                                                                NAMES
1146da16e5e7 mysql:5.7 "docker-entrypoint.s…" 18 minutes ago Up 18 minutes 3306/tcp, 33060/tcp gogs-db
2ad58951f177 gogs/gogs:latest "/app/gogs/docker/st…" 18 minutes ago Up 18 minutes (healthy) 0.0.0.0:10022->22/tcp, :::10022->22/tcp, 0.0.0.0:9001->3000/tcp, :::9001->3000/tcp gogs

路径

Gogs 安装目录: /data/apps/gogs
Gogs 数据目录: /data/apps/gogs/data/gogs_data

端口

除 80, 443 等常见端口需开启之外,以下端口可能会用到:

端口号用途必要性
10022Gogs SSH 端口可选

版本

sudo docker exec -it gogs ./gogs --version

服务

sudo docker start | stop | restart | stats gogs

命令行

$ sudo docker exec -it gogs ./gogs -h
NAME:
Gogs - A painless self-hosted Git service

USAGE:
gogs [global options] command [command options] [arguments...]

VERSION:
0.13.0+dev

COMMANDS:
web Start web server
serv This command should only be called by SSH shell
hook Delegate commands to corresponding Git hooks
cert Generate self-signed certificate
admin Perform admin operations on command line
import Import portable data as local Gogs data
backup Backup files and database
restore Restore files and database from backup
help, h Shows a list of commands or help for one command

GLOBAL OPTIONS:
--help, -h show help
--version, -v print the version

API

参考:Web 钩子