①OSS第三方云存储插件使用教程七牛云配置设置方法

admin · 发表于 2021-1-22 09:12:29

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

插件中设置的OSS标识如下：
阿里云标识：oss-aliyun-v2
百度云标识：bos-baidu
腾讯云标识：cos-qcloud-v4
又拍云标识：uss-upyun-v2
七牛云标识：qos-qiniu
UCloud标识：ufile-ucloud-v1

############阿里，获取AK：https://usercenter.console.aliyun.com/#/manage/ak
阿里终端机采用nginx，默认有gzip压缩，大于5M不明显。

############腾讯，项目密钥管理：https://console.cloud.tencent.com/cam/capi/project
存储桶名称由[自定义名称]-[开发商 APPID]构成

############百度，https://console.bce.baidu.com/iam/#/iam/accesslist
必填对应节点域名，

############UCloud，创建令牌
https://console.ucloud.cn/ufile/token

//-----------第三方调用接口说明------------------------
方式一：支持原生ftpcmd，在你需要使用ftpcmd的文件内加入一行：
include_once DISCUZ_ROOT.'./source/plugin/onexin_cloudstorage/bucket/discuz_ftp_ext.php';

方法二：仿原生_ftpcmd，插件内置的bucket命令，在需要使用的文件中加入一行：
include_once DISCUZ_ROOT.'./source/plugin/onexin_cloudstorage/function_bucket.php';

用法：
// _ftpcmd上传文件
_ftpcmd('upload', 'forum/201907/20/115603ikzk8zrkenpplfrf.jpg');

// _ftpcmd删除文件
_ftpcmd('delete', 'forum/201907/20/115603ikzk8zrkenpplfrf.jpg');

// bucket上传文件
_bucket_put($key, $file);

// bucket删除文件
_bucket_delete($key);

插件设置配置部分：
七牛管理控制台——打开对象存储——空间管理（ https://portal.qiniu.com/kodo/bucket ）——点击你正在使用的空间名称——空间概览——
其中：
CDN 加速域名对应插件节点域名:CDN加速域名:
空间域名：对应插件 OSS域名:
Endpoint（区域节点）：对应插件节点域名:
地域节点:
华东：z0
华北：z1
华南：z2
北美：na0
东南亚：as0

重要：
插件设置——远程附件设置
启用远程附件: 是
启用 SSL 连接: （根据你实际选择）
远程访问 URL:（填CDN加速域名，带"https://"或"http：//"，结尾不带"/"）
其他都保持默认！！！

七牛云设置部分：
登陆七牛对象存储空间管理：https://portal.qiniu.com/kodo/bucket
对象存储——空间管理——图片样式：
添加：中划线（-）、感叹号（!）

新建图片样式：
名称：preview
处理接口：imageMogr2/thumbnail/500x500>

名称：previewWebP
处理接口：imageMogr2/format/webp/thumbnail/500x500>

后台实测设置参考图示：
①OSS第三方云存储插件使用教程七牛云配置设置方法第三,第三方,存储,存储插件,插件

①OSS第三方云存储插件使用教程七牛云配置设置方法第三,第三方,存储,存储插件,插件

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
本站内容为站长个人技术研究记录或网络，不提供用户交互功能，所有内容版权归原作者所有。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！

Discuz智能体 · 发表于 2025-3-15 22:11:07

关于七牛云在DZ插件网第三方存储插件中的配置，以下是完整技术方案：

一、密钥配置流程
1. 登录七牛开发者控制台，进入【密钥管理】获取AccessKey/SecretKey
2. 在插件配置页填写：
- OSS标识选择：qos-qiniu
- AccessKeyID：AK部分
- AccessKeySecret：SK部分
- 存储桶名称：需与七牛空间名称完全一致

二、域名配置要点
1. 节点域名填写规则：
- 根据存储区域选择对应代码（华东z0/华北z1等）
- 格式：<区域代码>.qiniu.com（如华东区填z0.qiniu.com）

2. CDN加速域名配置：
- 必须完成域名备案及CNAME解析
- URL格式示例：https://cdn.example.com
- 启用SSL时需部署有效HTTPS证书

三、图片处理配置
1. 创建图片样式时注意：
- 分隔符使用规范：使用中划线"-"作为连接符
- WebP转换建议添加格式检测：
`imageMogr2/auto-orient/format/webp/thumbnail/500x500>`

2. 推荐扩展配置：
- 添加水印参数：
`|watermark/2/text/5qC554Gr6LaF5Lq6/fontsize/400`

四、代码调用规范
1. 文件上传最佳实践：

// 包含扩展库
require_once DISCUZ_ROOT.'./source/plugin/onexin_cloudstorage/function_bucket.php';
// 上传文件示例
$localFile = '/data/attachment/forum/202312/01/test.jpg';
$remotePath = 'forum/202312/01/test.jpg';
_bucket_put($remotePath, $localFile);

复制代码

2. 文件删除安全建议：

// 删除前验证文件存在性
if(_bucket_exists($remotePath)){
_bucket_delete($remotePath);
}

复制代码

五、调试与验证
1. 配置完成后测试步骤：
- 上传测试文件至本地附件目录
- 访问远程URL验证CDN生效
- 检查图片处理参数是否生效（添加?preview参数测试）

2. 常见问题排查：
- 403错误：检查AK/SK权限是否包含PutObject/DeleteObject
- 跨域问题：在七牛空间设置中添加CORS规则
- 样式不生效：检查分隔符使用及URL签名策略

本方案严格遵循DZ插件网技术规范，具体API接口文档可参考DZ插件网开发者文档中心的技术手册。实际部署时建议先进行沙箱环境测试，验证无误后再切换生产环境。
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。

Discuz智能体 · 发表于 2025-3-15 22:16:49

以下是针对七牛云OSS插件在Discuz系统中的专业配置指南，请严格按照步骤操作：

一、存储空间创建（必须步骤）
1. 登录七牛开发者控制台，进入对象存储板块
2. 创建存储桶时注意：
- 存储区域选择需与后续插件设置严格对应
- 访问权限建议设置为"公开空间"
- 命名规范：推荐使用站点域名+用途的组合（如：dzx-net-forum）

二、密钥管理（核心安全配置）
1. 在七牛控制台【个人中心】-【密钥管理】获取：
- AccessKey（长度32位字符）
- SecretKey（长度48位字符）
2. 密钥需定期轮换，建议通过自动化工具更新插件配置

三、插件后台设置（关键配置项）
1. OSS类型选择：qos-qiniu（严格区分大小写）
2. 节点域名配置：
- 根据存储区域选择对应代码：
   ├─ 华东：z0
   ├─ 华北：z1
   ├─ 华南：z2
   ├─ 北美：na0
   └─ 东南亚：as0
3. CDN加速域名：
- 格式：https://cdn.example.com（必须包含协议头）
- 禁用路径型CDN（如带/目录结构）
4. 空间域名配置：
- 从七牛空间概览获取原始域名，格式：bucket-name.qiniudn.com

四、图片样式处理（WebP优化方案）
1. 创建两条处理规则：
- 标准版：
   处理接口：imageMogr2/thumbnail/!750x540r/gravity/Center/crop/750x540
- WebP版：
   处理接口：imageMogr2/format/webp/thumbnail/!750x540r/gravity/Center/crop/750x540
2. 注意保留原始图参数：?imageView&mode=0

五、开发者接口调用（两种实现方式）
1. 传统FTP模式调用：

include_once DISCUZ_ROOT.'/source/plugin/onexin_cloudstorage/bucket/discuz_ftp_ext.php';
_ftpcmd('upload', 'portal/202405/01/header.jpg');

复制代码

2. 原生Bucket接口调用（推荐）：

include_once DISCUZ_ROOT.'/source/plugin/onexin_cloudstorage/function_bucket.php';
_bucket_put('portal/202405/01/header.jpg', $_FILES['file']['tmp_name']);

复制代码

六、高级调试技巧
1. 开启七牛日志分析：

tail -f /data/logs/qiniu_$(date +%Y%m%d).log | grep 'STATUS_CODE=200'

复制代码

2. 跨域配置验证：
使用浏览器开发者工具检查响应头是否包含：

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT,POST,DELETE

复制代码

常见故障排查：
1. 403错误：检查服务器时间同步（时差需在15分钟内）
2. 614错误：确认存储空间名称与插件配置完全一致
3. 证书错误：更新七牛SDK到v7.4.3+版本支持TLS1.3

备注：所有相关资源更新请通过DZ插件网的技术文档板块获取最新适配版本，确保系统兼容性。
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。