gogs安装教程

Gogs安装过程记录Gogs 是一个轻量级的自托管 Git 服务适用于资源有限的环境。以下是如何在 Ubuntu 系统上安装和配置 Gogs 的步骤。步骤 1更新系统并安装依赖更新系统包sudoaptupdatesudoaptupgrade-y安装必要的软件包sudoaptinstallgitwgetcurlvim-y步骤 2创建 Git 用户创建一个专用用户来运行 Gogssudoadduser--system--group--disabled-password--shell/bin/bash--home/home/gitgit步骤 3下载并解压 Gogs下载最新版本的 Gogswgethttps://dl.gogs.io/0.13.0/gogs_0.13.0_linux_amd64.tar.gz-P/tmp解压文件并移动到/home/gitsudotarxf /tmp/gogs_0.13.0_linux_amd64.tar.gz-C/home/gitsudochown-Rgit:git /home/git/gogs步骤 4配置 Systemd 服务创建 Systemd 服务文件sudovim/etc/systemd/system/gogs.service添加以下内容[Unit]DescriptionGogs Git ServiceAfternetwork.target[Service]UsergitGroupgitWorkingDirectory/home/git/gogsExecStart/home/git/gogs/gogs webRestartalways[Install]WantedBymulti-user.target启动并启用服务sudosystemctl daemon-reloadsudosystemctl start gogssudosystemctlenablegogs步骤 5访问 Gogs打开浏览器访问http://服务器IP:3000。按照页面提示完成安装配置包括数据库设置可选择 SQLite、MySQL 或 PostgreSQL和应用程序设置。配置注意事项数据库设置Database Settings直接选数据库类型SQLite3路径默认一般是/data/gogs.db或gogs.db✅ 优点不需要额外安装数据库最简单、最快启动⚠️ 注意不适合大规模团队10人并发高时性能一般应用基本设置General Settings1️⃣ 域名Domain 填你的服务器IP 或 域名例如192.168.1.100或git.example.com2️⃣ 应用 URLApplication URL 非常关键http://你的IP:3000/示例http://192.168.1.100:3000/⚠️ 常见错误❌ 少了端口❌ 少了最后的/❌ 写成 https但实际没配 错了会导致clone 地址错误页面跳转异常3️⃣ HTTP 端口3000 一般不要改除非端口冲突4️⃣ SSH 端口22 或 2222Docker 常用 如果你是 Docker22225️⃣ 启用注册Enable Registration建议自己用✅ 开公网服务器❌ 关防止被注册垃圾账号管理员账户设置Admin Account 必填项目建议用户名不要用 admin容易被攻击密码强密码邮箱随便填后面可以改gogs代码库迁移假设项目值旧 GogsAhttp://A:3000新 GogsBhttp://B:3000仓库test 第一步从 A 拉完整镜像 在服务器B 或你本地电脑执行都可以git clone --mirror http://A:3000/用户名/test.git执行完会得到test.git/⚠️ 注意 这个目录是“裸仓库”没有代码文件 第二步在 B 创建空仓库进入 Gogs点击“” → 新建仓库名字test❗不要勾选README.gitignoreLicense 必须是“空仓库”否则 push 会失败 第三步推送到 B核心步骤进入刚才的目录cd test.git执行git push --mirror http://B:3000/用户名/test.git 这一句做了什么git push --mirror等价于 把所有 refs 强制同步到目标仓库包括refs/heads/*分支refs/tags/*refs/remotes/*refs/notes/* 比--all更彻底 第四步验证打开 B 的 Gogs 页面看分支是否齐全 ✅看 tag 是否存在 ✅随便 clone 测试 ✅