Toggle navigation


Gogs镜像手册

Version 0.11.34

Websoft9将Gogs程序及其运行组件等制作成一个预装环境,打包成虚拟机镜像,任何云用户均可一键获取、快速安装。

Gogs(gogs.io)Gogs是一款极易搭建的自助 Git 服务,相对于GitHub而言Gogs更加轻量级。任何 Go 语言 支持的平台都可以运行 Gogs,包括 Windows、Mac、Linux 以及 ARM。


本文档适用于通过主流云市场购买和部署了Websoft9镜像的用户,文档内容重点指导用户进行安装配置、系统基本操作和常见运维问题处理。

文档适用性说明:

  • 适用的主流云平台包括:阿里云、腾讯云、百度云、华为云、Azure、青云
  • 适用的操作系统包括:Linux,Windows
  • 适用的阅读者包括:初学者、学生、站长、运维人员、产品经理、开发者、UI

Application Software(Gogs)
Gogs程序路径:/data/wwwroot/gogs

Application Server(Nginx1.12,Go)
Nginx 配置文件:/etc/nginx/sites-available/default

Database(MySQL)
MySQL 数据库:/data/mysql

服务器配置要求

最低配置建议为1核2G内存1M带宽

  1. 镜像需要与服务器配套使用,获取Websoft9的镜像有两种方式:
    方式一:若没有可用的云服务器,登录主流云厂商的云市场,找到由Websoft9提供的“Gogs”相关免费镜像,点击“购买”(同时会配套购买云服务器,若只打算试用请选择“按量”方式购买,实现按小时使用,接近免费)
    方式二:若有可用的云服务器,登录到云厂商的控制面板,找到可用的云服务器,通过关机->更换系统盘(重装镜像),在更换过程中选取云市场镜像,获取本镜像
  2. 待镜像购买或更换完成后,镜像会自动安装到云服务器上,待实例处于“运行中”后,访问网址:http://服务器公网IP/,正常会出现Gogs前台界面
  3. 如果浏览器访问以上网址没有任何反应,请检查您的安全组设置,确保80端口是开放的。

镜像验证通过后,即可通过浏览器访问:http://服务器公网ip/完成剩余的应用安装过程。


具体安装向导如下:

  1. 通过Chrome或FireFox访问:http://服务器公网ip/,首先进行数据库设置
  2. 然后完成应用设置
  3. 点击安装后,系统进入登录界面
  4. 由于还没有账户,请先点击“还没账户?马上注册”链接,开始注册
  5. 注册后再次登录,进入Gogs后台

应用程序安装、使用和维护中需要用到三种账户:

1、Gogs账号和密码:默认账号是root,密码初始化访问时由自己设置的

2、MySQL账号和密码:root/123456


2、服务器操作系统账号和密码

Linux服务器账号和密码说明:

  • 账号:root
  • 密码:是安装镜像的时候客户自行设置的,若不记得此密码,请登录云服务器后台,修改服务器密码,重启后生效
  • 登录:下载一个putty工具,通过root账号登录,参考(服务器通用文档-Linux远程管理与FTP

网站的定期备份和重要操作之前的备份工作(如系统升级或重要修改)无比重要,可以做到防范于未然,让发生了意外而能够进行复原,这是网站运维工作的重中之重。

Gogs的备份有基于服务器快照自动备份、手动本地备份两种方式,两种凡是各有利弊,建议结合起来使用

服务快照自动备份

云服务器厂商都会提供一个叫“快照”的功能,快照是针对于服务器的磁盘来说的。快照工具可以记录指定时间点硬盘的数据,全部备份起来,并可以实现一键恢复。

如果您对磁盘进行了自动的快照设定,如下场景您便可以比较从容的面对:
1、工作了几天的成果,被误删了
2、黑客把把网站网站弄的面目全非
3、现在的内容已经乱七八糟了,我要回到一个正常的服务器状态

做了快照备份,一键恢复到备份时间点的状态。也就是现场还原,很好的功能。

不同的云厂商快照设置稍有差别,具体参考:

手工本地备份

手工本地备份主要是通过下载应用程序文件和备份导出数据库文件,建议备份周期每月一次,备份文件保存6个月左右。下面就具体的备份操作进行说明:

  1. 备份整个Redmine程序文件目录(/data/wwwroot/redmine
  2. 备份数据数据库

待续

远程连接之前,请确认您服务器使用的操作系统,Linux操作系统(CentOS、Ubuntu、Debian、SUSE Linux、OpenSUSE、AliyunLinux)与Windows操作系统的登录方式是完全不一样的。

Linux系统(CentOS,Ubuntu,AliyunLinux)

管理Linux系统,只需要用到两个工具即可满足大部分使用场景

  • WinSCP,可视化界面的SFTP工具,90%的Linux操作均可通过它来实现(下载WinSCP
  • Putty,远程登录&命令操作软件,需要用到命令操作的时候使用(下载Putty

具体参考:

Windows系统

Windows服务器的操作主要分为两个部分:

  • 远程桌面连接:通过PC自带的远程桌面工具远程连接到服务器,完全控制服务器的操作
  • FTP文件管理:通过FTP客户端和Windows服务器上的FTP服务端进行通讯,实现文件管理的操作的目的

具体参考:

运行命令:

~# systemctl restart gogs

 

域名设置分为两个步骤

步骤一、域名解析

如果您的域名备案(大陆之外无需备案),可以通过云厂商的域名控制台进行域名解析,操作如下:

  1. 登录域名控制台->域名解析,进入解析设置界面(以阿里云为例)
  2. 增加一条A记录,主机记录那里填写二级域名的前缀(如www,shop,test等)或通配符@,记录值填写您的服务器公网ip地址,保存
  3. 域名解析成功,等待解析生效(不同的厂商解析生效时间不一样,1分钟-24小时不等)

注意:解析生效之后,本地访问可能由于缓存问题导致仍然没有生效,请清空浏览器缓存,然后通过CMD命令行刷新本地DNS操作

步骤二、修改Redmine配置文件

修改配置文件/data/wwwroot/redmine/config/configuration.yml中与域名相关的值

待续…

本镜像建议使用第三方的SMTP镜像邮件发送,具体待续

下面列出Gogs使用中比较常见的问题以及对应的处理方案

  • 官网:https://gogs.io
  • GitHub:https://github.com/gogits/gogs
  • 文档:https://gogs.io/docs
  • 论坛:https://discuss.gogs.io

本文档由长沙网久软件有限公司原创,为了保证文档的严肃性和可用性,任何人不得盗用或修改后二次分发。需要转载请标注来源,否则我们保留给予法律追究的权利。

我们会定期更新文档,请访问在线文档以获取最新版本

本文档在线地址:http://www.websoft9.com/xdocs/gogs-image-guide
合作或技术支持:http://www.websoft9.com