手把手教你玩转 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\""

经验总结扩展阅读