guideEasy Image

Easy Image 功能包含在本地部署服务器中,可以使用此功能上传和存储图片。

此功能的完整文档可以 在这里 找到。

Easy Image 功能与 SaaS 版本的功能相同。但是,它必须正确配置。
目前 Easy Image 功能支持多种驱动程序,可在不同位置存储图片。

支持

本地部署的 Easy Image 不会像 SaaS 版本那样将图片存储在 CDN 中。

# 配置

要配置 Easy Image 功能,需要设置相应的环境变量。

STORAGE_DRIVER                           - optional (default: "filesystem")
STORAGE_LOCATION                         - optional (default: "/var/cs/easyimage", required for file system driver)
STORAGE_REGION                           - optional (required for AWS S3 driver)
STORAGE_ACCESS_KEY_ID                    - optional (required for AWS S3 driver)
STORAGE_SECRET_ACCESS_KEY                - optional (required for AWS S3 driver)
STORAGE_BUCKET                           - optional (required for AWS S3 driver)
STORAGE_ENDPOINT                         - optional
STORAGE_ACCOUNT_NAME                     - optional (required for Azure Blob Storage driver)
STORAGE_ACCOUNT_KEY                      - optional (required for Azure Blob Storage driver)
STORAGE_CONTAINER                        - optional (required for Azure Blob Storage driver)

# 文件系统(默认)

要使用文件系统保存图片,请将 (storage_driver) 驱动程序设置为 filesystem,并指定路径 (storage_location)。

如果您运行应用程序的多个实例,并使用负载均衡器在实例之间分配流量,请务必记住,图片应保存在一个共享位置。您可以使用 NFS 磁盘或其他解决方案。

STORAGE_DRIVER=filesystem
STORAGE_LOCATION=/var/cs/easyimage

您始终应将卷 /path/to/your/dir:/var/cs/easyimage 装载以保存上传的文件,以防您的容器被移除。

STORAGE_LOCATION 变量指定保存图片的路径,但这是容器中的路径。因此,应提供装载的卷的路径。

# AWS S3

要在 AWS S3 中保存图片,请将驱动程序 (storage_driver) 设置为 s3,并指定 AWS S3 的配置。要配置 AWS S3,请提供以下变量的数据:

  • storage_region - 发送服务请求的区域,

  • storage_access_key_id - 您的 AWS 访问密钥 ID,

  • storage_secret_access_key - 您的 AWS 秘密访问密钥,

  • storage_endpoint - 发送请求的端点 URI。例如,可以使用与 S3 兼容的服务(例如 MinIO、localstack 等)。端点必须指定其协议,例如 s3://https:// 等。
    默认情况下,它以 https://s3.[STORAGE_REGION].amazonaws.com 格式生成

STORAGE_DRIVER=s3
STORAGE_REGION=[AWS_REGION]
STORAGE_ACCESS_KEY_ID=[AWS_ACCESS_KEY_ID]
STORAGE_SECRET_ACCESS_KEY=[AWS_SECRET_ACCESS_KEY]
STORAGE_BUCKET=[AWS_S3_BUCKET]
STORAGE_ENDPOINT=[AWS_S3_ENDPOINT]

# Azure Blob 存储

要在 Azure Blob 存储中保存图片,请将 (storage_driver) 驱动程序设置为 azure,并指定 Azure Blob 存储的配置。要配置 Azure Blob 存储,请提供以下变量的数据:

  • storage_account_name - 您的 Azure 帐户名称,

  • storage_account_key - 您的 Azure 帐户密钥,

  • storage_container - 您的 Azure Blob 存储容器名称。

  • storage_endpoint - 发送请求的端点 URI。端点必须指定其协议,例如 https://
    默认情况下,它以 https://[STORAGE_ACCOUNT_NAME].blob.core.windows.net 格式生成

STORAGE_DRIVER=azure
STORAGE_ACCOUNT_NAME=[AZURE_ACCOUNT_NAME]
STORAGE_ACCOUNT_KEY=[AZURE_ACCOUNT_KEY]
STORAGE_CONTAINER=[AZURE_CONTAINER]
STORAGE_ENDPOINT=[AZURE_ENDPOINT]

# 数据库

要在 SQL 数据库中保存图片,请仅设置驱动程序。图片将保存在数据库配置指定的数据库中。

STORAGE_DRIVER=database