「代码仓库」如何调整 Gitea 仓库的文件上传限制

在使用 Gitea 管理代码仓库时，默认的文件上传限制（3MB）可能无法满足实际需求。比如需要上传大型设计文件、数据库备份或项目打包文件时，经常会遇到 "文件过大" 的错误提示。本文将详细介绍如何修改 Gitea 的上传配置，解除这一限制。

了解 Gitea 的上传限制机制

Gitea 对仓库文件上传有多重限制，包括：

• 单个文件的大小上限（默认 3MB）

• 单次上传的文件数量（默认 5 个）

• 允许上传的文件类型（可自定义）

这些限制通过配置文件进行管理，默认情况下为了服务器安全和性能稳定，设置了相对严格的参数。但在内部团队协作场景中，往往需要根据实际需求调整这些数值。

修改配置文件的具体步骤

1. 找到配置文件位置

Gitea 的核心配置文件为app.ini，通常位于安装目录下的custom/conf文件夹中。不同安装环境的路径可能不同：

• Windows 系统：如C:\app\gitea\custom\conf\app.ini

• Linux 系统：常见路径为/var/lib/gitea/custom/conf/app.ini或/opt/gitea/custom/conf/app.ini

建议使用 Notepad++、VS Code 等文本编辑器打开，避免使用系统自带的记事本（可能导致格式问题）。

2. 添加上传配置参数

在app.ini文件的末尾添加以下配置块：

[repository.upload]
; 启用文件上传功能（默认已开启）
ENABLED = true
; 临时存储路径，默认在重启时会自动清理
TEMP_PATH = data/tmp/uploads
; 允许上传的文件类型，留空表示允许所有类型
ALLOWED_TYPES =
; 单个文件最大尺寸（单位：MB），这里设置为1GB
FILE_MAX_SIZE = 1024
; 单次上传最多文件数量，调整为10个
MAX_FILES = 10

配置说明：

• FILE_MAX_SIZE：根据需要设置，1024 代表 1GB，512 代表 512MB

• MAX_FILES：建议根据团队协作习惯调整，过多可能影响上传效率

• ALLOWED_TYPES：如需限制类型，可填写.zip,.pdf,image/*等，多个值用逗号分隔

3. 重启 Gitea 服务

修改配置后需要重启服务才能生效：

• Windows 服务模式：在 "服务" 管理界面找到 Gitea 服务，右键选择 "重启"

• 命令行启动：先关闭运行中的 Gitea 进程，再重新执行启动命令（如gitea web）

• Docker 部署：使用docker restart [容器名]命令重启容器

验证配置是否生效

重启完成后，可通过以下方式验证：

1. 进入任意仓库，点击 "上传文件" 按钮

2. 尝试上传一个超过原限制（如 5MB）的文件

3. 检查是否能成功上传，同时测试单次上传多个文件的场景

如果配置生效，原本因大小或数量受限的文件将能正常上传。若仍有问题，建议检查配置文件的语法是否正确（如是否遗漏分号、括号是否匹配），或查看 Gitea 的运行日志排查错误。

注意事项

1. 服务器存储考虑：提高上传限制后，需确保服务器有足够的存储空间，尤其是允许上传大文件时

2. 性能影响：单次上传大量大文件可能占用较多带宽和系统资源，建议根据服务器配置合理设置

3. 安全风险：放宽文件类型限制可能带来安全隐患，生产环境建议明确指定ALLOWED_TYPES

4. 配置备份：修改配置前建议备份原app.ini文件，以便出现问题时恢复

通过以上设置，Gitea 的文件上传功能将更贴合实际业务需求，特别适合需要频繁在仓库中共享大型文件的团队使用。如果后续需要再次调整，只需修改对应参数并重启服务即可。