【Win10 部署私有 Git 服务器 (Gogs) 完全指南】

• 官网下载：https://dl.gogs.io/
• GitHub 仓库：https://github.com/gogs/gogs
• 官方安装文档：Install from Binary

• 用于将 Gogs 注册为 Windows 系统服务，实现开机自启。
• 下载地址：https://nssm.cc/download

• 若遇疑难，可参考知乎、CSDN 或博客园的相关部署文章（如“Windows下如何搭建属于自己的git服务器”）。

以管理员身份打开命令提示符（CMD）或 PowerShell。

进入 Gogs 的脚本目录：

cd D:\\tools\\gogs\\scripts\\windows

执行安装脚本：

install-as-service.bat

注：此脚本通常会自动调用 NSSM 进行服务注册。如果脚本执行失败，也可手动使用 nssm install gogs 命令进行图形化配置。

验证服务：打开 Windows“服务”管理器，查找名为 gogs 的服务，确保其状态为“正在运行”。

• 基础 URL：根据实际访问 IP 修改（如 http://192.168.1.100:3000/）。
• SSH 端口：默认是 22。如果 Windows 已开启 OpenSSH 服务，建议修改为其他端口（如 2222）以避免冲突。

确认用户 ID： 登录 Gogs 网页，查看目标用户的个人主页 URL，或直接查询数据库 user 表。 假设目标用户 rady 的 ID 为 1，新用户 yf 的 ID 为 2。

修正仓库所有者 (repository 表)： 将特定仓库的所有者 ID 修改为正确的用户 ID。

— 示例：将名为 'demo' 的仓库所有者设为 ID 为 1 的用户
UPDATE "repository"
SET "owner_id" = 1,
"lower_name" = 'demo',
"name" = 'demo',
"description" = 'demo测试',
"is_bare" = 0
WHERE "lower_name" = 'demo';

修正关注关系 (watch 表)： 确保关注记录的用户 ID 与仓库所有者一致。

UPDATE "watch"
SET "user_id" = 1
WHERE "repo_id" = (SELECT "id" FROM "repository" WHERE "lower_name" = 'demo');

修正动态记录 (action 表)： 修复时间线和动态反馈中的用户引用。

UPDATE "action"
SET "user_id" = 1, "repo_user_name" = 'rady'
WHERE "repo_id" = (SELECT "id" FROM "repository" WHERE "lower_name" = 'demo');

批量修复脚本示例： 如果有多个仓库需要迁移给新用户（例如用户 ID 7，用户名 op）：

— 修改仓库所有者
UPDATE "repository" SET owner_id = 7 WHERE lower_name = 'bat-samples';

— 修改关注记录
UPDATE "watch" SET user_id = 7
WHERE repo_id = (SELECT id FROM "repository" WHERE lower_name = 'bat-samples');

— 修改动态记录
UPDATE "action" SET user_id = 7, repo_user_name = 'op'
WHERE repo_id = (SELECT id FROM "repository" WHERE lower_name = 'bat-samples');

添加协作者权限： 如果需要给用户赋予特定仓库的写入权限，需同时在 access 和 collaboration 表中插入记录。

— 模式 2 代表写权限 (Write)，模式 1 代表读权限 (Read)
INSERT INTO "access" ("user_id", "repo_id", "mode") VALUES (2, 579, 2);
INSERT INTO "collaboration" ("user_id", "repo_id", "mode") VALUES (2, 579, 2);

权限不足 (HTTP 403)

• 原因：当前使用的 Git 账号没有该仓库的写入权限，或者密码/Token 认证失败。
• 解决：
  • 检查 Gogs 网页端该用户是否有仓库的“写”权限。
  • 如果是 HTTPS 推送，尝试重新输入密码或使用 Personal Access Token。
  • 检查是否开启了双重验证（2FA），若开启必须使用 Token 而非密码。

推送包过大导致超时

• 原因：一次性推送的文件过多或单个文件过大，导致 Nginx/IIS/Gogs 内部超时限制。
• 解决：
  • 分批提交：不要一次性推送大量历史提交，尝试分多次推送。
  • 调整配置：修改 Gogs 的 app.ini 配置文件，增加上传限制和超时时间。

  [server]
  MAX_UPLOAD_SIZE = 1024 ; 单位 MB

  [repository]
  DISABLE_HTTP_GIT = false

  • 检查 Web 服务器：如果前端使用了 Nginx 反向代理，需同步调整 client_max_body_size。

SSH 密钥问题

• 原因：如果使用 SSH 协议推送，本地公钥未正确添加到 Gogs 账户设置中。
• 解决：
  • 在 Gogs 网页端 -> 设置 -> SSH/GPG 密钥，添加本地的 id_rsa.pub 内容。
  • 确保本地 SSH 客户端使用的是正确的私钥（可通过 ssh -T git@your-server-ip -p 2222 测试连接）。