在配置 Gitea 时，邮件服务的设置是必不可少的，尤其是在需要注册确认、通知提醒等功能时。本文将详细介绍如何在 Gitea 中配置邮件功能，以确保您的系统能够正确发送邮件。

一、找到 Gitea 的配置文件

Gitea 的邮箱配置通常位于 app.ini 文件中。此文件通常可以在以下路径中找到：

System (C:) > Gitea > custom > conf > app.ini

可以使用文本编辑器（例如记事本或 VS Code）打开该文件进行修改。

二、配置邮件服务

在 app.ini 文件中找到 [mailer] 配置段落。默认情况下，这部分内容可能是：

[mailer]
ENABLED = false

将其改为如下内容，以启用邮件功能：

[mailer]
ENABLED        = true
FROM           = your_email@163.com
PROTOCOL       = smtps
SMTP_ADDR      = smtp.163.com
SMTP_PORT      = 587
USER           = your_email@163.com
PASSWD         = `your_password`

说明：

• ENABLED: 设置为 true 启用邮件服务。
• FROM: 发送邮件的邮箱地址，建议与 USER 保持一致。
• PROTOCOL: 使用的协议，通常为 smtps 或 smtp。
• SMTP_ADDR: SMTP 服务器地址，这里以网易邮箱为例，设置为 smtp.163.com。
• SMTP_PORT: SMTP 服务器端口，通常为 587 或 465。
• USER: 用于登录 SMTP 服务器的用户名，即您的邮箱地址。
• PASSWD: 邮箱密码，建议使用应用专用密码以提高安全性。

注意：如果您的邮箱服务提供了应用专用密码功能，建议使用应用专用密码来代替邮箱登录密码，以增加安全性。

三、保存并测试配置

完成配置后，保存 app.ini 文件，并重启 Gitea 服务使配置生效。您可以通过以下步骤测试邮件功能：

1. 注册新用户：尝试注册一个新用户，查看是否能收到确认邮件。
2. 邮件通知：在 Gitea 中进行项目相关的操作，查看是否能收到通知邮件。

四、排查常见问题

1. SMTP 认证失败

   • 检查邮箱地址和密码是否正确。
   • 确保邮箱支持 SMTP，并且已启用 SMTP 功能。

2. 端口问题

   • 某些网络环境可能会阻止特定端口，尝试更改为常用的 465 或 587 端口。

3. 安全设置

   • 某些邮箱（如 Gmail）可能需要启用 “允许不太安全的应用” 访问权限，或者生成应用专用密码。

五、总结

通过正确配置 Gitea 的邮箱功能，您可以确保用户可以顺利收到注册确认邮件、项目通知等。这对于提高用户体验和系统的可用性至关重要。如果在配置过程中遇到问题，可以参考 Gitea 官方文档或联系邮箱提供商获取帮助。