跳到主要内容
版本：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://公网IP 或 http://域名:端口

  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 钩子