• 故障排查
    • 安装
    • SSH
      • SSH 链接挂起 60 秒
      • Update 钩子指向错误的二进制路径
      • 推送成功但控制面板没有活动更新
        • 可能原因
        • 解决方案
  • Git
    • 公钥使用冲突
    • Gogs 无法调用 ‘git’ 命令
  • Cache
  • 数据库
    • 使用错误的 MySQL 存储引擎
    • 过时的 MySQL 密码设置
    • 连接到错误的 SQLite3 数据库
  • 邮件服务
  • Windows
  • 其它

    故障排查

    安装

    • 错误描述：../gosrc/src/github.com/gogits/gogs/cmd/cert.go:79: undefined: elliptic.P224
    • 可能原因：Go 语言的 RHEL/CentOS 官方发行版中因专利问题移除了相关加密算法的代码
    • 解决方案：从 golang.org/dl 下载安装 Go 语言

    SSH

    SSH 链接挂起 60 秒

    • 可能原因：Gogs 会在每次 SSH Push 完成之后请求自身的 Web 服务，您的防火墙或服务器提供商未允许该操作

    Update 钩子指向错误的二进制路径

    • 可能原因：您升级 Gogs 后将其移动到了和之前安装位置不同的目录
    • 解决方案：到管理员控制面板（/admin）执行以下操作：
      • 重新生成 '.ssh/authorized_keys' 文件
      • 重新同步所有仓库的 pre-receive、update 和 post-receive 钩子

    推送成功但控制面板没有活动更新

    可能原因

    在使用 SSH 推送时，Gogs 依赖通过执行钩子脚本（Hook Script）来更新仓库和最近活动。但出于某种原因，执行脚本的权限被拒绝了，尤其是在使用挂载（Mount）设备时。

    解决方案
    • 请确保挂载设备时没有启用 noexec 选项，必要时需要明确指定 exec 选项。
    • 如果使用 vfat（或者 cifs）类型的挂载，请确保 uid、gid 和 fmask 选项允许运行 Gogs 的用户在挂载设备上执行脚本。
    • 如果使用网络类型的挂载，请确保服务器（NFS 或 Samba）没有禁止远程文件系统的执行脚本权限。

    Git

    公钥使用冲突

    • 错误描述：
      • fatal: 'XX/XX.git' does not appear to be a git repository
      • 推送代码提交后依旧显示为空仓库
    • 可能原因：~/.ssh/authorized_keys 文件中存在重复的 SSH 密钥，可能是由于您曾经或正在通过同一个系统用户使用 GitLab。
    • 解决方案：删除除了属于 Gogs 自动添加以外的所有密钥。

    Gogs 无法调用 ‘git’ 命令

    • 错误描述：repo.NewRepoContext(fail to set git user.email):
    • 可能原因：该错误会发生在 Windows 安装 Git Bash 时未启用 cmd 选项。
    • 解决方案：重装并启用 cmd 选项。

    Cache

    • 错误描述：cache: unknown adaptername "memcache" (forgotten import?)
    • 可能原因：为了减少不必要的导入，您需要使用构建 tags 来启用某个缓存适配器。
    • 解决方案：
      • 下载：go get -tags memcache github.com/gogits/gogs
      • 构建：go build -tags memcache
      • 如果要启用 redis 也是一样的步骤。

    数据库

    使用错误的 MySQL 存储引擎

    • 错误描述：Error 1071: Specified key was too long; max key length is 1000 bytes
    • 可能原因：这是由于数据库引擎为 MyISAM 导致的。

    • 解决方案：在使用 config/mysql.sql 创建完数据库后，进入数据库然后执行：

      1.   use gogs;
      2.   set global storage_engine=INNODB;

    最后，访问 http://localhost:3000/install 即可（感谢 @linc01n）。

    过时的 MySQL 密码设置

    • 错误描述：Database setting is not correct: This server only supports the insecure old password authentication. If you still want to use it, please add 'allowOldPasswords=1' to your DSN. See also https://github.com/go-sql-driver/mysql/wiki/old_passwords
    • 可能原因：只更新了 @localhost 的密码，但 @% 用户依旧使用旧密码
    • 解决方案：GitHub 讨论

    连接到错误的 SQLite3 数据库

    • 错误描述：推送仓库显示仓库所有者（Owner）未注册或 user 数据表不存在。
    • 可能原因：您以服务形式启动 Gogs 的时候，Gogs 可能会使用和您预期所不同的 SQLite3 数据库文件。
    • 解决方案：使用绝对路径配置 SQLite3 数据库文件路径。

    邮件服务

    • 错误描述：Gmail 发送返回 Error 534: Please log in via your web browser and then try again
    • 可能原因：这是因为 Google 不信任您的服务器导致的。
    • 解决方案：
      • 访问 https://accounts.google.com 并登录。
      • 访问 https://accounts.google.com/DisplayUnlockCaptcha 单击 continue。
      • 重试发送。

    Windows

    • 错误描述：
    1. 2014/09/18 15:04:40 [repo.go:115 CreatePost()] [E] CreatePost: initRepository: initRepository(git clone): cygwin warning:
    2. MS-DOS style path detected: C:\Users\user\gogs-repositories\unos\test3.git/.git
    3. Preferred POSIX equivalent is: /cygdrive/c/Users/user/gogs-repositories/unos/test3.git/.git
    4. CYGWIN environment variable option "nodosfilewarning" turns off this warning.
    5. Consult the user's guide for more details about POSIX paths:
    6. http://cygwin.com/cygwin-ug-net/using.html#using-pathnames
    7. Cloning into 'C:\Users\user\AppData\Local\Temp\484264900'...
    8. fatal: '/cygdrive/d/svnroot/research/gogs/C:\Users\user\gogs-repositories\unos\test3.git' does not appear to be a git repository
    9. fatal: Could not read from remote repository.
    • 可能原因：您在系统中安装了另一种命令行工具，并且与系统默认的 CMD 有不同路径风格。
    • 解决方案：请您尝试用默认的 CMD 启动 Gogs。
    • 错误描述：Resource interpreted as Stylesheet but transferred with MIME type application/x-css
    • 可能原因：Windows 注册表中错误的值
    • 解决方案：在注册表中找到 HKEY_CLASSES_ROOT 下的 .css，并将其 Content Type 的值修改为 text/css。

    其它

    • 错误描述：页面响应非常慢，但是显示在页面底部的时间正常（低于 100 毫秒）。
    • 可能原因：这可能是由于 Nginx 尝试通过 IPv6 的方式解析 IPv4 的地址。
    • 解决方案：显式的使用 127.0.0.1 作为主机名而不是 localhost。
    • 错误描述：Error 1062: Duplicate entry 'Unknown-Mac' for key 'UQE_public_key_name'
    • 可能原因：这是由于遗留代码导致的，public_key 表之前含有唯一索引 UQE_public_key_name。
    • 解决方案：您只需删除它即可。
    • 错误描述：GLIBC_2.14 not found
    • 解决方案：尝试 sudo apt-get -t testing install libc6-dev。
    • 错误描述：[Macaron] PANIC: session(start): mkdir data: permission denied
    • 可能原因：Gogs 会在程序所在目录创建 data 子目录。
    • 解决方案：确保 Gogs 具有在相同目录创建子目录的权限。