提示

兰空图床中的角色组是整个系统的核心部分之一，无论是已注册用户、游客、管理员都受角色组控制。系统安装完成以后会默认创建一个默认的角色组，同时也是游客默认组，设置为游客组的角色组会控制游客上传。并且系统只能设置一个游客组。 设置为默认组的角色组，新用户将会默认归属该角色组。

上传频率限制

在创建、编辑角色组时，「常规配置」中可以看到六个名称为限制结尾的输入框，配置及作用：

• 并发上传限制(限制上传时队列中同时上传图片数量的限制)
• 每分钟上传限制(限制一分钟内最大上传数量)
• 每小时上传限制(限制一小时内最大上传数量)
• 每天上传限制(限制24小时内最大上传数量)
• 每周上传限制(限制7天内最大上传数量)
• 每月上传限制(限制一个月内最大上传数量)

注意

上传数量限制，是代表当前时间往前推这段时间内所上传的图片数量限制。例如每周上传限制，是指七天之前到当前时间的这个范围内，而不是指本周内。

命名规则

角色组可以对上传后的图片按照命名规则表中的规则对图片的物理储存路径、文件名称进行重写，并且相同、不同的规则可以组合使用。

原图保护

提示

原图保护的作用是隐藏图片的真实 url 路径，未开启前图片是通过运行环境输出并缓存的，开启后请求该图片会通过 PHP 接管，由 PHP 处理图片的输出。

警告

原图保护功能对服务器配置要求较高，虽然有缓存驱动，原理还是从内存中读取二进制内容，且每次都将图片内容读取到内存中，对服务器内存有着比较高的要求。 这种负载压力在图片请求量(除了缩略图)过多的时候尤为明显。

图片审核

腾讯云内容安全

申请地址：https://cloud.tencent.com/product/ims

Endpoint

固定为 ims.tencentcloudapi.com 即可。

地域

• 华北地区(北京) ap-beijing
• 华南地区(广州) ap-guangzhou
• 亚太南部(孟买) ap-mumbai
• 华东地区(上海) ap-shanghai
• 亚太东南(新加坡) ap-singapore
• 美国东部(弗吉尼亚) na-ashburn
• 美国西部(硅谷) na-siliconvalley

WARNING

如果使用子用户，请授予该账户 QcloudIMSFullAccess、QcloudIMSReadOnlyAccess 权限

阿里云内容安全

申请地址：https://www.aliyun.com/product/lvwang

业务场景

业务场景对应内容安全控制台中的 -> 设置 -> 机器审核 -> 业务场景

地域

地域目前阿里云支持：

• cn-shanghai：华东2（上海）
• cn-beijing：华北2（北京）
• cn-shenzhen：华南1（深圳）
• ap-southeast-1：新加坡

WARNING

如果你使用的「子用户 AccessKey」，即 RAM 账户，请授予该账户 AliyunYundunGreenWebFullAccess 权限。

NsfwJS

TIP

此图片审核驱动需要自建，该项目地址：https://github.com/infinitered/nsfwjs

接口地址

你自建的审核接口地址
你需要使用 node 环境启动一个服务器，并适配 nsfwjs。然后上传接口必须返回以下结构：

{
    "porn": 0,
    "sexy": 0,
    "hentai": 0,
    "neutral": 0,
    "drawing": 0
}

请注意，以上所有属性值，都应该是使用 0-1 之间的数值来表示百分比。

属性名称

接口的文件属性名称，例如 image

水印配置

警告

兰空图床并不推荐使用你使用水印功能，这将可能占用大量的内存使用。如果使用了 cdn 或第三方储存，推荐使用第三方的图片处理规则来实现水印功能(或在水印功能中选择「覆盖原图」选项，选择后会直接在上传的原始图片上加上水印)。

why？

一个 3MB 的 jpeg 图片，在处理中可能会占用到 60 MB甚至更高，这是理想的状态下，但通常情况下，甚至会有可能达到 30MB 的图片。 这种图片一旦通过合成水印，加上合成水印时所使用的字体文件或图片，这将会占用大量内存，而 PHP 的默认内存限制在 128MB，会很容易导致内存溢出。

水印支持的图片格式

jpeg、jpg、png、psd、tif、bmp、webp

不支持 gif 格式的图片增加水印。psd、tif、bmp 格式的图片将会以 png 的格式输出

水印位置

水印除了支持九种固定位置外，有一个平铺的选项，会将文字、图片水印以平铺的方式合成到图片中，并且可以通过 x/y 来调整水印距离、位置、旋转角度。