✅ 轻量免配置 ✅ 免费开源 ✅ 支持私人仓库 + 团队协作附:从安装到服务化全流程截图,新手也能一次成功!

89 阅读3分钟

 1. 安装 Git

Gogs 依赖于 Git 来管理代码仓库,所以你得先安装 Git。

  • 访问 Git 官方下载页面
  • 依据你的系统架构(32 位或者 64 位)选择合适的安装程序并下载。
  • 运行下载好的安装程序,按照安装向导的提示完成安装。安装过程中,建议保持默认选项,不过要确保在 “调整 PATH 环境变量” 这一步选择 “使用 Git 和可选的 Unix 工具从命令提示符”,这样就能在命令行中使用 Git 命令了。

2. 下载 Gogs

  • 访问 Gogs 官方发布页面​编辑
  • 下载适用于 Windows 的二进制文件,一般选择 gogs_x.x.x_windows_amd64.zip(64 位系统) 或者 gogs_x.x.x_windows_386.zip(32 位系统),这里的 x.x.x 代表版本号。
  • 把下载的压缩包解压到你想安装 Gogs 的目录,例如 C:\gogs​编辑

路径不能有中文

3. 配置数据库

Gogs 支持多种数据库,如 SQLite、MySQL、PostgreSQL 等。这里以 SQLite 为例,它无需额外配置,适合初学者和小型项目。

  • 在解压后的 C:\gogs 目录下,找到 custom 文件夹(若不存在则创建),然后在 custom 文件夹中创建 conf 文件夹。
  • 在 conf 文件夹中创建 app.ini 文件,内容如下:

ini

APP_NAME = Gogs
RUN_MODE = prod

[server]
PROTOCOL = http
DOMAIN = localhost
HTTP_PORT = 3000
ROOT_URL = http://localhost:3000/

[database]
DB_TYPE  = sqlite3
PATH     = data/gogs.db

4. 启动 Gogs

  • 打开命令提示符或者 PowerShell,切换到 Gogs 的安装目录,例如:

bash

cd C:\gogs

  • 运行以下命令启动 Gogs:

bash

gogs.exe web

若看到类似如下输出,就表明 Gogs 已成功启动:

plaintext

2024/10/15 14:32:38 [T] Custom path: C:\gogs\custom
2024/10/15 14:32:38 [T] Log path: C:\gogs\log
2024/10/15 14:32:38 [I] Gogs 0.13.0
2024/10/15 14:32:38 [I] Build Time: 2024-01-01 12:00:00 UTC
2024/10/15 14:32:38 [I] Run Mode: Production
2024/10/15 14:32:38 [I] Listen: http://localhost:3000

如果出现报错

 ​编辑

就用powershell运行  

​编辑

出现如图则说明运行正常 

5. 完成初始化配置

  • 打开浏览器,访问 http://localhost:3000,会看到 Gogs 的初始化配置页面。​编辑
  • 按照页面提示完成配置,主要包括数据库设置(这里选择 SQLite 时保持默认即可)、管理员账号设置等。​编辑
  • 点击 “安装 Gogs” 按钮,等待安装完成。​编辑

6. 配置为 Windows 服务(可选)

若想让 Gogs 在系统启动时自动运行,可以将其配置为 Windows 服务。

  • 打开命令提示符(以管理员身份运行),切换到 Gogs 安装目录。
  • 运行以下命令安装服务:

bash

gogs.exe serv -install

  • 运行以下命令启动服务:

bash

gogs.exe serv -start

通过以上步骤,你就能在 Windows 系统上成功安装并运行 Gogs 了。

创建仓库

​编辑

​编辑

​编辑

就可以使用了