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 了。
创建仓库
编辑
编辑
编辑
就可以使用了