安装前的准备
服务器
支持安装有Mac、linux、Windows系统的电脑或虚拟机
本教程使用的是CentOS 7
数据库
支持以下数据库:
- MySQL:版本 >= 5.7(__本教程使用__)
- PostgreSQL
- MSSQL
- TiDB(实验性支持,使用 MySQL 协议连接)
- 或者 什么都不安装 直接使用 SQLite3
Git支持
- 服务端和客户端均需版本 >= 1.7.1
- Windows 系统建议使用最新版
SSH服务器配置
如果您只使用 HTTP/HTTPS 的话请忽略此项
- 如果您选择在 Windows 系统使用内置 SSH 服务器,请确保添加
ssh-keygen
到您的%PATH%
环境变量中 - Windows系统推荐使用 Cygwin OpenSSH 或 Copssh
二进制安装
- 前往GitHub下载服务器对应版本的二进制包,本教程应该下载的包为:linux_amd64.tar.gz
- 解压安装包,使用命令
cd
进入安装目录,执行./gogs web
来运行gogs,或执行nohup ./gogs web
在后台运行gogs。
初始化配置
【一】新建gogs数据库
- 数据库名:gogs(可自行修改)
- 字符集:utf8
- 排序规则:utf8_general_ci
【二】进入配置页面
在浏览器输入 http://localhost:3000/ 进入Gogs,第一次进入会自动跳转到__首次运行安装程序__页面
Gogs默认端口为3000
如果进入页面样式404或者后续配置中有提示权限不足的,请赋予gogs文件夹操作权限:
sudo chmod -R 777 gogs/
【三】配置数据库:
- 数据库类型:MySQL
- 数据库主机:Mysql主机地址,如127.0.0.1:3306
数据库用户名:root
- 数据库用户密码
- 数据库名称:第一步时新建的数据库名称
【四】应用基本设置
新手可全部默认,请注意运行系统用户必须是当前用户,且具有操作权限

【五】可选设置
- 邮件服务设置(可选,内部使用的话可以不设置)
- 服务器和其他服务设置(请根据个人需求自行选择)
- 管理员帐号设置(建议设置)
【六】完成设置
点击__立即安装__保存配置,安装完成后自动进入首页,安装完成。