• 配置与运行
    • 配置文件
      • 默认配置文件
      • 自定义配置文件
      • 为什么要这么做?
    • 运行 Gogs 服务
      • 开发者模式
      • 部署模式

    配置与运行

    配置文件

    默认配置文件

    默认配置都保存在 conf/app.ini,您 永远不需要 编辑它。该文件从 v0.6.0 版本开始被嵌入到二进制中。

    自定义配置文件

    那么,在不允许修改默认配置文件 conf/app.ini 的情况下,怎么才能自定义配置呢?很简单,只要创建 custom/conf/app.ini 就可以!在 custom/conf/app.ini 文件中修改相应选项的值即可。

    例如,需要改变仓库根目录的路径:

    1. [repository]
    2. ROOT = /home/jiahuachen/gogs-repositories

    当然,您也可以修改数据库配置:

    1. [database]
    2. PASSWD = root

    为什么要这么做?

    乍一看,这么做有些复杂,但是这么做可以有效地保护您的自定义配置不被破坏:

    • 从二进制安装的用户,可以直接替换二进制及其它文件而不至于重新编写自定义配置。
    • 从源码安装的用户,可以避免由于版本管理系统导致的文件修改冲突。

    运行 Gogs 服务

    开发者模式

    • 您需要在 custom/conf/app.ini 文件中将选项 security -> INSTALL_LOCK 的值设置为 true
    • 您可以使用超能的 make 命令:

      1. $ make
      2. $ ./gogs web

    部署模式

    脚本均放置在 scripts 目录,但请在仓库根目录执行它们

    • Gogs 支持多种方式的启动:
      • 普通:只需执行 ./gogs web
      • 守护进程:详见 scripts 文件夹
    • 然后访问 /install 来完成首次运行的配置工作