一、准备工作

1. 安装 Git:Gitea 依赖 Git 进行代码管理,所以首先需要确保系统中安装了 Git。

下载地址:https://git-scm.com/downloads/win

2. 安装数据库(可选)

默认情况下,Gitea 使用 SQLite 作为内置的轻量级数据库,但如果需要,可以安装 MySQL 或 PostgreSQL 数据库来提升性能和扩展性。

二、安装 Gitea

1. 下载 Gitea:Gitea | gitea

2. 移动到安装目录:将下载的 Gitea 二进制文件移动到您希望安装的目录,比如 C:\Gitea

3. 将文件重命名为 gitea.exe,方便管理

4. 创建必要的目录

mkdir C:\Gitea\data
mkdir C:\Gitea\log
mkdir C:\Gitea\custom

三、运行 Gitea

1. 打开 PowerShell,进入到 Gitea 的安装目录,运行以下命令启动 Gitea:

C:\Gitea\gitea.exe web

2. 在浏览器访问http://localhost:3000

四、配置 Gitea

1. 一般配置选择默认

2. 创建管理员账号

五、设置为服务(可选)

为了方便 Gitea 在每次开机时自动运行,可以将 Gitea 设置为 Windows 服务

1. 下载NSSM工具:NSSM - the Non-Sucking Service Manager

2. 将 nssm.exe 文件放到一个目录中,比如 C:\nssm\nssm.exe

3. 注册 Gitea 服务。打开命令提示符或 PowerShell,输入以下命令:

C:\nssm\nssm.exe install Gitea

        这将打开一个 GUI 窗口,填写以下信息:

        1.)Path:选择 C:\Gitea\gitea.exe

        2.)Startup directory:填写 C:\Gitea

        3.)Arguments:填写 web

 4. 使用命令启动 Gitea 服务:

nssm start Gitea

补充:

问题一:数据库设置无效,Error 1045

Windows 搭建 Gitea-LMLPHP

数据库设置无效: Error 1045 (28000): Access denied for user 'gitea'@'localhost' (using password: YES),这个错误表示 MySQL 数据库无法验证 gitea 用户的身份。这个错误通常是因为用户名或密码错误,或者用户权限不足。以下是解决此问题的一些步骤:

1. 检查用户名和密码

mysql -u gitea -p

2. 创建 MySQL 用户并赋权

mysql -u root -p
#创建用户,your_password 替换为您想要的密码
CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'your_password';

#赋予权限,Gitea 数据库名为 gitea_db
GRANT ALL PRIVILEGES ON gitea_db.* TO 'gitea'@'localhost';

#刷新权限
FLUSH PRIVILEGES;

#确认权限
SHOW GRANTS FOR 'gitea'@'localhost';

3. 检查 MySQL 绑定地址。如果 gitea 用户的权限是针对 localhost 的,而 Gitea 尝试通过其他方式连接(比如使用服务器的 IP 地址),也会导致权限问题

4. 检查防火墙设置。确保数据库端口没有被防火墙阻挡,尤其是在不同机器上运行 Gitea 和 MySQL 的情况下

问题二:数据库设置无效,Error 1049

Windows 搭建 Gitea-LMLPHP

数据库设置无效: Error 1049 (42000): Unknown database 'gitea_db',表示 MySQL 数据库中不存在名为 gitea_db 的数据库。要解决这个问题,您需要确保数据库已经创建。以下是详细的解决步骤:

1. 登录 MySQL

mysql -u root -p

2. 创建数据库

CREATE DATABASE gitea_db;

3. 确认数据库已创建

SHOW DATABASES;

4. 赋予用户权限

GRANT ALL PRIVILEGES ON gitea_db.* TO 'gitea'@'localhost';
FLUSH PRIVILEGES;

5. 测试连接。如果可以成功连接并进入数据库,说明设置是正确的。

mysql -u gitea -p gitea_db

问题三:配置 Gitea 使用 163 邮箱

1. 获取 SMTP 服务密码

1.)登录 163 邮箱网页端

2.)进入设置 -> POP3/SMTP/IMAP 选项,启用 SMTP 和 POP3/IMAP 服务

3.)生成一个授权码,记下该授权码,后面会在配置中使用

2. 配置 Gitea 邮件设置

打开 Gitea 的配置文件 custom/conf/app.ini,并找到 [mailer] 部分。如果没有该部分,可以手动添加。然后按照以下配置进行设置:

10-07 08:00