Install on Windows

通过调整上游 Gitea Windows 安装说明，将 Gitea Enterprise 作为 Windows 服务运行。

前置要求

• Windows Server 2019 或更高版本（Windows 11 等桌面版本也可用于评估）。

• 本地管理员权限。

• 根据预期用户规模选择推荐硬件配置：

  团队规模（约）	内存	CPU 核心数	SSD 容量
  ~10 用户	2-4 GB	2-4 核	50-100 GB
  ~100 用户	4-8 GB	4-8 核	200-500 GB
  ~1000 用户	16-32 GB	8-16 核	2-5 TB

• 已安装 Git for Windows 并添加到 PATH。

• nssm（Non-Sucking Service Manager），用于将 Gitea 作为服务运行。

• （可选）用于启用高级功能的 Enterprise 许可证。参见许可证激活以申请试用，或在安装后应用许可证。

1. 创建 Gitea 目录

1. 创建 C:\gitea 用于存放程序文件，创建 C:\gitea-data 用于存放仓库和配置。

2. 在 PowerShell 中创建目录结构，并设置权限，使只有服务账户可以访问数据目录：

   @('custom','data','log') | ForEach-Object { New-Item -ItemType Directory -Path "C:\gitea-data\$_" -Force | Out-Null }
   icacls C:\gitea-data /inheritance:r
   icacls C:\gitea-data /grant "Users:(OI)(CI)(RX)"
   icacls C:\gitea-data /grant "Administrators:(OI)(CI)(F)"

   如果您计划以非管理员身份运行服务，请将 Users 替换为专用账户。

2. 下载 Enterprise 二进制文件

1. 选择您要部署的 Enterprise 版本（例如 24.6.0）。
2. 从 commitgo/gitea-ee releases 下载 gitea-ee-<version>-windows-4.0-amd64.exe，并将其放置在 C:\gitea\gitea.exe。
3. （可选）将现有的 app.ini 复制到 C:\gitea-data\custom\conf\app.ini，以复用您的配置。

3. 配置数据库（可选）

Gitea Enterprise 需要 MySQL/MariaDB 或 PostgreSQL。请提前创建数据库，并在 custom/conf/app.ini 中设置连接字符串。

MySQL / MariaDB

[database]
DB_TYPE  = mysql
HOST     = db.internal:3306
NAME     = gitea
USER     = gitea
PASSWD   = change-me-now
SSL_MODE = disable

PostgreSQL

[database]
DB_TYPE  = postgres
HOST     = db.internal:5432
NAME     = gitea
USER     = gitea
PASSWD   = change-me-now
SSL_MODE = disable

请使用 Windows Credential Manager、Secrets Manager 或您的编排工具来安全地存储密码。

4. 运行安装向导

1. 以管理员身份启动 PowerShell，第一次以交互方式启动 Gitea：

   cd C:\gitea
   .\gitea.exe web --config C:\gitea-data\custom\conf\app.ini

2. 浏览器访问 http://localhost:3000（或主机地址），完成安装向导，并将 AppDataPath 指向 C:\gitea-data。

3. 初始配置保存完成后，停止该进程。

5. 将 Gitea 安装为 Windows 服务

1. 将 nssm.exe 解压到 C:\nssm（或 PATH 中的任意目录）。

2. 注册服务：

   nssm install Gitea "C:\gitea\gitea.exe" "web" "--config" "C:\gitea-data\custom\conf\app.ini"

3. 在 NSSM 服务编辑器中：

   • 将 Startup directory 设置为 C:\gitea。
   • 在 I/O 选项下，将 Output 和 Error 重定向到 C:\gitea-data\log\gitea.log。
   • （可选）以专用服务账户运行。

4. 使用 nssm start Gitea 或通过服务（Services）MMC 管理单元启动服务。

6. 配置 HTTP/HTTPS 访问

• 使用 Windows Defender 防火墙规则或您的负载均衡器暴露 3000 和 22 端口（或您配置的 SSH 端口）。
• 如需直接提供 HTTPS 服务，请安装 TLS 证书并在 app.ini 中配置反向代理设置，或将 Gitea 置于 IIS/NGINX/Traefik 之后。

7. 安装后配置

• 请查阅上游的 Configuration Cheat Sheet，以微调 app.ini（身份验证提供商、邮件、存储后端等）。
• 编辑 C:\gitea-data\custom\conf\app.ini，然后运行 nssm restart Gitea（或重启该 Windows 服务）以应用新设置。

8. 升级与维护

• 停止 Gitea 服务，下载更新的 Enterprise 可执行文件，替换 C:\gitea\gitea.exe，然后启动服务。
• 关注 Gitea Enterprise 发行说明，及时了解 Enterprise 版本更新。
• 频繁备份 C:\gitea-data，并尽可能在预发布环境中测试升级。
• 服务运行后，按照许可证激活应用或续订 Enterprise 许可证。
• 若需要跨多台 Windows 主机横向扩展，请复用您在 Linux 上使用的共享存储、数据库和负载均衡模式，使每个节点保持无状态。

Gitea Enterprise 在各次升级中依赖一致的配置文件和目录结构，因此替换二进制文件后，现有的自动化或脚本可以继续正常工作。