对象存储服务

野火IM的消息分为普通消息和媒体消息。媒体消息一般比较大,发送时需要先上传媒体文件到对象存储服务器,得到一个url地址,然后再把包含这个url地址的消息发出去。野火IM社区版支持内置对象存储服务器和七牛对象存储服务器,专业版还可以选择阿里云对象存储、腾讯云对象存储、华为云对象存储、亚马逊S3、京东云存储和野火私有对象存储,专业版还可以使用野火对象存储网关来对接任意对象存储服务。客户端对使用的对象存储服务透明,不用做任何修改和配置。

1. 使用内置对象存储服务器。

修改如下配置,media.server.use_qiniu(在专业版的配置项为media.server.media_type)配置为0,这样所有媒体文件都将上传到fs目录,按照日期和类型存放。

media.server.use_qiniu 0
local.media.storage.root ../fs

特别提示:内置对象存储不是一个商业级别的对象存储服务,很多基本的对象存储功能都不支持,仅用来做快速验证和开发测试使用,特别是不支持HTTPS,这样Web的HTTPS站点就无法使用。建议使用七牛云存储,专业版客户也可以使用野火私有对象存储和其他支持的专业级别的对象存储服务。

2. 七牛服务器

去七牛官网申请存储服务,然后在同一个区域内创建至少2个桶(bucket)(一个用来保存头像/收藏等需要长期保存的桶,另外一个用来保存会话内发送的图片、文件、语音、视频等可以定期清除的桶。建议为每种媒体类型都创建一个桶,这里示例就只创建2个桶,可以参考示例为每个类型创建一个桶。另外bucket的权限要选择公开)。修改如下配置,media.server.use_qiniu配置为1,填写access_keysecret_keyserver_url为上传地址,跟您选择的区有关,请选择正确的地址(下面有地址列表)。然后为不同类型的媒体文件创建不同的bucket,并配置正确。

#专业版的开关名称是media.server.media_type,社区版的是media.server.use_qiniu
media.server.use_qiniu 1
media.server_url  up.qbox.me
media.access_key tU3vdBK5BL5j4N7jI5N5uZgq_HQDo170w5C9Amnn
media.secret_key YfQIJdgp5YGhwEw14vGpaD2HJZsuJldWtqens7i5

media.bucket_general_name media
media.bucket_general_domain http://cdn.mediaserver.com
media.bucket_image_name media
media.bucket_image_domain http://cdn.mediaserver.com
media.bucket_voice_name media
media.bucket_voice_domain http://cdn.mediaserver.com
media.bucket_video_name media
media.bucket_video_domain http://cdn.mediaserver.com
media.bucket_file_name media
media.bucket_file_domain http://cdn.mediaserver.com
media.bucket_portrait_name static
media.bucket_portrait_domain http://cdn2.mediaserver.com
media.bucket_favorite_name static
media.bucket_favorite_domain http://cdn2.mediaserver.com

一定要使用不同的bucket,至少要区分长期保存和短期保存。头像/收藏等需要长期保存,其它根据情况可能会定期清除。 bucket公开的安全性没有问题,每个文件上传会生成一长串随机数名字,基本不可能穷举到的。如果要选择私有,需要在客户端进行处理,对链接的访问加上七牛的鉴权信息,具体信息请查阅七牛的技术文档。

2.1. 选择正确的server_url

server_url对应不同的七牛存储区域,选择下表中对应区域的服务器上传地址(上传是客户端传的,但客户端模拟的服务器上传,实际上两个地址都可以用)

存储区域 地域简称 上传域名
华东 z0 服务器端上传:http(s)://up.qiniup.com
客户端上传: http(s)://upload.qiniup.com
华北 z1 服务器端上传:http(s)://up-z1.qiniup.com
客户端上传:http(s)://upload-z1.qiniup.com
华南 z2 服务器端上传:http(s)://up-z2.qiniup.com
客户端上传:http(s)://upload-z2.qiniup.com
北美 na0 服务器端上传:http(s)://up-na0.qiniup.com
客户端上传:http(s)://upload-na0.qiniup.com
东南亚 as0 服务器端上传:http(s)://up-as0.qiniup.com
客户端上传:http(s)://upload-as0.qiniup.com

2.2. 选择正确的bucket和domain

如下图所示,请绑定域名,使用绑定的域名和正确的bucket。 bucket和domain

2.3. 配置HTTPS

可以开启HTTPS增强安全性,另外如果WebIM使用了HTTPS,那么对象存储服务器也必须支持HTTPS。按照七牛网站指引,开启HTTPS功能,注意 一定不要开启强制HTTPS,因为移动端和PC端协议栈上传数据是用的HTTP方式。

然后修改配置,domain改成https地址

media.bucket_XXXX_domain https://cdn.mediaserver.com

3. 使用野火IM私有存储

野火IM专业版支持野火IM私有存储,按照说明进行部署。需要注意的是如果添加HTTPS支持,需要确保HTTP同时支持,因为协议栈内会用HTTP的方式上传(数据经过加密上传的)。

3.1. 配置HTTPS

可以开启HTTPS增强安全性,另外如果WebIM使用了HTTPS,那么对象存储服务器也必须支持HTTPS。可以使用Nginx,增加HTTPS访问功能,注意 一定不要开启强制HTTPS,因为移动端和PC端协议栈上传数据是用的HTTP方式。

然后修改配置,domain改成https地址

media.bucket_XXXX_domain https://cdn.mediaserver.com

4. 使用阿里云OSS

野火IM专业版支持阿里云对象存储,先去阿里云官网控制台开通对象存储服务。然后在同一个区域内创建至少2个桶(bucket)(一个用来保存头像/收藏等需要长期保存的桶,另外一个用来保存会话内发送的图片、文件、语音、视频等可以定期清除的桶。建议为每种媒体类型都创建一个桶,这里示例就只创建2个桶,可以参考示例为每个类型创建一个桶)。如下图所示: bucket list

点击第一个bucket,选择概览,配置endpointbucket namebucket domain到图中示例的哪些媒体类型中: endpont&domain 同样配置另外个一个桶的名称和域名到头像和收藏类型。完整配置完如下:

media.server.media_type 2
media.server_url  oss-cn-beijing.aliyuncs.com
media.server_port 80
media.server_ssl_port 443
media.access_key 0M7YVO70QPKBPWBZW5FW
media.secret_key ZrBsSST++1Qjap+Nfs3P2BujHCHDuqrsrYi0zNn8

## bucket名字及Domain
media.bucket_general_name wfcim
media.bucket_general_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_image_name wfcim
media.bucket_image_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_voice_name wfcim
media.bucket_voice_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_video_name wfcim
media.bucket_video_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_file_name wfcim
media.bucket_file_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_sticker_name wfcim
media.bucket_sticker_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_moments_name wfcim
media.bucket_moments_domain http://wfcim.oss-cn-beijing.aliyuncs.com
media.bucket_portrait_name wfcstatic
media.bucket_portrait_domain http://wfcstatic.oss-cn-beijing.aliyuncs.com
media.bucket_favorite_name wfcstatic
media.bucket_favorite_domain http://wfcstatic.oss-cn-beijing.aliyuncs.com

到这里您会发现,media.access_keymedia.secret_key还没有配置,这个是您的账户的API密钥。点击您账户的头像,选择AccessKey 管理,如果没有accesskey就创建一个。然后配置access_keysecret_key,如下图: AKSK 可以使用子用户的AccessKey,需要注意为该子用户赋予对象存储权限。

4.1. 设置访问权限

点开每个桶的设置,选择权限管理标签页,然后设置读写权限为公共读,如下图所示: 权限管理

4.2. Web用户

Web用户需要设置跨域信息,从下图进入设置 CORS

4.3. 配置HTTPS

可以开启HTTPS增强安全性,另外如果WebIM使用了HTTPS,那么对象存储服务器也必须支持HTTPS。按照阿里云网站指引,开启HTTPS功能,注意 一定不要开启强制HTTPS,因为移动端和PC端协议栈上传数据是用的HTTP方式。

然后修改配置,domain改成https地址

media.bucket_XXXX_domain https://wfcim.oss-cn-beijing.aliyuncs.com

5. 使用使用腾讯云COS

野火IM专业版支持腾讯云对象存储,先去腾讯云官网控制台开通对象存储服务。然后在同一个区域内创建至少2个桶(bucket)(一个用来保存头像/收藏等需要长期保存的桶,另外一个用来保存会话内发送的图片、文件、语音、视频等可以定期清除的桶。所有的桶都要在同一个区域内,不能分散在不同的区域。建议为每种媒体类型都创建一个桶,这里示例就只创建2个桶,可以参考示例为每个类型创建一个桶)。如下图所示: bucket list

点击第一个bucket,按照下图进行配置。注意 server_url 要配置为访问域名去掉https头和桶名的部分。 endpont&domain 同样配置另外个一个桶的名称和域名到头像和收藏类型。完整配置完如下:

media.server.media_type 5
media.server_host cos.ap-nanjing.myqcloud.com
media.server_port 80
media.server_ssl_port 443
media.access_key 0M7YVO70QPKBPWBZW5FWM7YVO70QPK
media.secret_key 1Qjap+Nfs3P2BujHCHDuqrsrYi0zNn8

## bucket名字及Domain
media.bucket_general_name wfim-1256xxxxxx
media.bucket_general_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_image_name wfim-1256xxxxxx
media.bucket_image_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_voice_name wfim-1256xxxxxx
media.bucket_voice_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_video_name wfim-1256xxxxxx
media.bucket_video_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_file_name wfim-1256xxxxxx
media.bucket_file_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_sticker_name wfim-1256xxxxxx
media.bucket_sticker_domain https://wfim-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_moments_name wfstatic-1256xxxxxx
media.bucket_moments_domain https://wfstatic-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_portrait_name wfstatic-1256xxxxxx
media.bucket_portrait_domain https://wfstatic-1256xxxxxx.cos.ap-nanjing.myqcloud.com
media.bucket_favorite_name wfstatic-1256xxxxxx
media.bucket_favorite_domain https://wfstatic-1256xxxxxx.cos.ap-nanjing.myqcloud.com

到这里您会发现,media.access_keymedia.secret_key还没有配置,这个是您的账户的API密钥。点击您账户的头像,如下图,找到对应的AK和SK: AKSK 可以使用子用户的AccessKey,需要注意为该子用户赋予对象存储权限。

5.1. 设置访问权限

点开每个桶的设置,选择权限管理标签页,然后设置读写权限为公共读,如下图所示: 权限管理

5.2. Web用户

Web用户需要设置跨域信息,从下图进入设置 CORS

5.3. 使用HTTPS

腾讯云默认是可以HTTPS和HTTP,移动端和PC上传使用HTTP,下载可以用HTTPS。注意不要改成强制HTTPS。

6. 使用使用华为云OBS

野火IM专业版支持华为云对象存储,在同一个区域内创建至少2个桶(bucket)(一个用来保存头像/收藏等需要长期保存的桶,另外一个用来保存会话内发送的图片、文件、语音、视频等可以定期清除的桶。所有的桶都要在同一个区域内,不能分散在不同的区域。建议为每种媒体类型都创建一个桶,这里示例就只创建2个桶,可以参考示例为每个类型创建一个桶)。如下图所示: bucket list

点击第一个bucket,按照下图进行配置。 endpont&domain 同样配置另外个一个桶的名称和域名到头像和收藏类型。完整配置完如下:

media.server.media_type 6
media.server_host obs.cn-north-4.myhuaweicloud.com
media.server_port 80
media.server_ssl_port 443
media.access_key 0M7YVO70QPKBPWBZW5FWM7YVO70QPK
media.secret_key 1Qjap+Nfs3P2BujHCHDuqrsrYi0zNn8

## bucket名字及Domain
media.bucket_general_name wfc-media
media.bucket_general_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_image_name wfc-media
media.bucket_image_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_voice_name wfc-media
media.bucket_voice_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_video_name wfc-media
media.bucket_video_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_file_name wfc-media
media.bucket_file_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_sticker_name wfc-media
media.bucket_sticker_domain https://wfc-media.obs.cn-north-4.myhuaweicloud.com
media.bucket_moments_name wfc-static
media.bucket_moments_domain https://wfc-static.obs.cn-north-4.myhuaweicloud.com
media.bucket_portrait_name wfc-static
media.bucket_portrait_domain https://wfc-static.obs.cn-north-4.myhuaweicloud.com
media.bucket_favorite_name wfc-static
media.bucket_favorite_domain https://wfc-static.obs.cn-north-4.myhuaweicloud.com

到这里您会发现,media.access_keymedia.secret_key还没有配置,这个是您的账户的API密钥。点击您账户的头像,选择我的凭证,点访问密钥,新增访问密钥 AKSK

6.1. 设置访问权限

点开每个桶的设置,选择权限管理标签页,然后设置读写权限为公共读,如下图所示。也可以再创建桶时选择公开读: 权限管理

6.2. Web用户

Web用户需要设置跨域信息,从下图进入设置 CORS

6.3. 使用HTTPS

华为云默认是可以HTTPS和HTTP,移动端和PC上传使用HTTP,下载可以用HTTPS。注意不要改成强制HTTPS。

7. 使用亚马逊S3和京东云

同其他云存储一样,配置ak/sk,然后创建合适的桶,IM服务配置中需要配置正确的region。

8. 使用野火对象存储网关

专业版IM服务还可以使用野火对象存储网关来对接其它任意类型的存储服务,比较常见的FastDFS,HDFS或者其它云服务等等。实现的方法是上传时上传到网关,网关再对接到客户选定的存储服务。具体使用方法请按照野火对象存储网关说明部署对接。

9. 对象存储的安全性

请参考文件存储的安全性问题

10. 使用其它服务器

如果上述选择都不符合您的需要,你也可以使用任意其他OSS。实现方法就是在客户端上传文件到自己的应用服务器,然后再调用sdk发送消息。

2018 © wildfirechat.net 京ICP备18060403号-1 all right reserved,powered by Gitbook该文件修订时间: 2024-10-01 07:37:50

results matching ""

    No results matching ""