手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea

Gitea 支持在 Windows 系统上安装和使用 。Gitea 本身作为一个单体应用程序,即点即用,如需长期驻留作为后台服务并开机运行就要依靠 Windows 服务工具 sc.exe 。
通过本文,你将学习到以下内容:

  • 安装 Git for Windows
  • 注册 Windows 服务
  • 启用 Gitea 内置的 SSH 服务器
  • 编辑 Windows 防火墙
环境准备服务器配置本文所采用的服务器配置如下 , 建议内存最少在 4GB 以上 。OS 版本可以是 Windows 7/8/8.1/10/11 以及 Server 2012/2016/2019/2022 , 本文优先使用 Windows Server 2022 LTSC,其他系统版本操作类似 。
OSVersionCPURAMWindows ServerLTSC 20224 Core4GBGit for WindowsGitea 执行各项 Git 操作依赖的是背后的 git 命令行工具 , 因此在 Windows 平台上你需要安装最新的 Git for Windows
下载安装包:https://gitforwindows.org
数据库Gitea 支持的数据库: SQLite、PostgreSQL、MySQL(MariaDB)、MSSQL
如果无特殊需求(例如集群化、高可用),建议一开始使用内置的 SQLite 作为数据库搭建轻量级的 Gitea 服务器,数据直接存储在文件中,备份迁移都更加方便 。
GiteaGitea 官网提供了预编译的 Windows 平台二进制程序 。
下载预编译的二进制程序:https://dl.gitea.io/gitea/
进入下载页面后,选择适合你的 Windows 平台的二进制程序 。
对于 Windows 而言 ,  windows-4.0-amd64 适用于 64 位操作系统,windows-4.0-386 即 32 位操作系统 。
另外,带有 gogit-windows 名字的 Windows 版本程序使用了 gogit 用于解决在一部分在老旧版本的 Windows 上调用 git 后端导致的性能问题 , 但 gogit 本身也依赖后端的 git 程序,同时自身功能也有局限 。换句话说,如果你的 Gitea 运行良好,性能不错,就不必尝试这个版本了 。
安装Git for Windows一般使用 Git for Windows 安装包一步步安装即可 。当然,你也要确保 git 命令始终在 Windows 环境变量 PATH 中 , 检查办法是通过终端执行 git 命令 。
PS C:\Users\Administrator> git --versiongit version 2.38.0.windows.1看到 git version 2.38.0.windows.1 说明程序调用成功,打印出了当前版本 。
如果出现没有找到 Git 命令 , 那么打开,系统设置 - 环境变量 - 系统变量 - Path,手动添加 Git 程序目录 , 例如 C:\Program Files\Git\cmd
手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea

文章插图
安装 GiteaGitea 的安装路径可以自定义,比如使用 C:\gitea 。将前面准备好的二进制程序 (例如 gitea-1.17.2-windows-4.0-amd64.exe) 重命名并复制到 C:\gitea\gitea.exe 。双击可执行程序启动 Gitea 。
手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea

文章插图
当你第一次运行 Gitea 时 , 你需要打开 http://localhost:3000 根据指引完成 Gitea 的初始化安装 。这个步骤会创建配置文件并存储到 C:\gitea\custom\conf\app.ini,稍后我们在注册 Windows 服务时会用到 。
初始配置在 Windows 中 Gitea 的 RUN_USER (以用户名运行)并不与 Windows 系统的账户系统关联(这一点与 Linux 不同),因此你可以在此处填写任意用户名,推荐填写 git
手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea

文章插图
最后,关闭 gitea.exe 窗口即结束 Gitea 主程序 , 也可以使用 Ctrl+C 结束 。
将 Gitea 注册为 Windows 服务
  1. 请以管理员身份打开命令提示符 (CMD) , 然后运行以下命令:
sc create gitea start= auto binPath= "\"C:\gitea\gitea.exe\" web --config \"C:\gitea\custom\conf\app.ini\""
请注意 , start=binPath= 等号后面有空格
  1. 启动服务
sc start gitea
  1. WIN + R打开运行窗口,输入 services.msc 并启动 Windows 服务管理工具 , 可以找到你刚新建的 Gitea 服务,单机右键可以选择 启用、停止 或更改 属性 。

手把手教你玩转 Gitea|在 Windows 系统上安装 Gitea

文章插图
如需删除服务并重新创建,则使用 sc delete 命令 。
sc delete gitea配置启用 Gitea 内置的 SSH 服务器一般情况下,Windows 系统无需额外安装 OpenSSH 服务 。Gitea 内置了一个轻量级的 Go SSH 服务器 , 安装好之后可以通过修改配置文件手动开启 。

推荐阅读