上传管理 - GitLab - GitLab 文档中心

Tier: 基础版，专业版，旗舰版

Offering: 私有化部署

上传代表所有可能作为单个文件发送到极狐GitLab 的用户数据。例如，头像和笔记附件就是上传。上传是极狐GitLab 功能不可或缺的一部分，因此无法禁用。

添加到评论或描述中的附件**仅**在父项目或群组被删除时才会被删除。即使上传附件的评论或资源（如议题、合并请求、史诗）被删除，附件仍保留在文件存储中。

使用本地存储#

这是默认配置。要根据您的安装方法更改本地存储上传的位置，请使用本节中的步骤：

由于历史原因，整个实例的上传（例如 [网站图标](appearance.md#customize-the-favicon)）存储在一个基础目录中，默认情况下为 `uploads/-/system`。强烈不建议在现有的极狐GitLab 安装中更改基础目录。

对于 Linux 软件包安装：

上传默认存储在 /var/opt/gitlab/gitlab-rails/uploads 中。

要更改存储路径，例如更改为 /mnt/storage/uploads，请编辑 /etc/gitlab/gitlab.rb 并添加以下行：
```
ruby
gitlab_rails['uploads_directory'] = "/mnt/storage/uploads"
```
此设置仅在您未更改 gitlab_rails['uploads_storage_path'] 目录时适用。
保存文件并重新配置极狐GitLab 以使更改生效。

对于自行编译安装：

上传默认存储在 /home/git/gitlab/public/uploads 中。

要更改存储路径，例如更改为 /mnt/storage/uploads，请编辑 /home/git/gitlab/config/gitlab.yml 并添加或修改以下行：
```
yaml
uploads:
  storage_path: /mnt/storage
  base_dir: uploads
```
保存文件并重启极狐GitLab 以使更改生效。

使用对象存储#

Tier: 基础版，专业版，旗舰版

Offering: 私有化部署

如果您不想使用安装极狐GitLab 的本地磁盘来存储上传，您可以改用如 AWS S3 的对象存储提供商。此配置依赖于已配置的有效 AWS 凭证。

详细了解如何在极狐GitLab 中使用对象存储。

对象存储设置#

本节介绍特定存储的配置格式。您应该改用统一的对象存储设置。

对于自行编译安装，以下设置嵌套在 uploads: 下，然后嵌套在 object_store: 下。在 Linux 软件包安装中，它们以 uploads_object_store_ 为前缀。

设置	描述	默认值
enabled	启用/禁用对象存储	false
remote_directory	存储上传的存储桶名称
proxy_download	设置为 true 以启用代理所有文件服务。此选项允许减少出站流量，因为它允许客户端直接从远程存储下载，而不是代理所有数据	false
connection	下面描述的各种连接选项

连接设置#

参见不同提供商的可用连接设置。

对于 Linux 软件包安装：

上传默认存储在 /var/opt/gitlab/gitlab-rails/uploads 中。

编辑 /etc/gitlab/gitlab.rb 并添加以下行，将其替换为您想要的值：

ruby
1gitlab_rails['uploads_object_store_enabled'] = true
2gitlab_rails['uploads_object_store_remote_directory'] = "uploads"
3gitlab_rails['uploads_object_store_connection'] = {
4  'provider' => 'AWS',
5  'region' => 'eu-central-1',
6  'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
7  'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
8}

如果您使用 AWS IAM 配置文件，请务必省略 AWS 访问密钥和秘密访问密钥/值对。

ruby
gitlab_rails['uploads_object_store_connection'] = {
  'provider' => 'AWS',
  'region' => 'eu-central-1',
  'use_iam_profile' => true
}

保存文件并重新配置极狐GitLab 以使更改生效。
使用 gitlab:uploads:migrate:all Rake 任务将任何现有的本地上传迁移到对象存储。

对于自行编译安装：

上传默认存储在 /home/git/gitlab/public/uploads 中。

编辑 /home/git/gitlab/config/gitlab.yml 并添加或修改以下行，确保使用适合您提供商的相应设置：

yaml
1uploads:
2  object_store:
3    enabled: true
4    remote_directory: "uploads" # 存储桶名称
5    connection: # 此块中的行取决于您的提供商
6      provider: AWS
7      aws_access_key_id: AWS_ACCESS_KEY_ID
8      aws_secret_access_key: AWS_SECRET_ACCESS_KEY
9      region: eu-central-1

保存文件并重启极狐GitLab 以使更改生效。
使用 gitlab:uploads:migrate:all Rake 任务将任何现有的本地上传迁移到对象存储。