光鸭网盘运维

版本 v1.0.6· 张先生 · 52 次获取 · 运维

开启后站内附件、图片、视频等上传均走光鸭云盘接口；后台可短信登录并监控登录状态。

¥29.99

一次购买，永久使用

详情介绍

一、插件简介

光鸭网盘上传（guangya）将站点 图片、媒体、附件 等上传统一到 光鸭云盘 API：存储文件 ID，前台通过本站代理 /guangya/file/{id} 访问。后台提供 短信验证码登录、Token 刷新、登录状态监控与历史附件同步。

默认关闭（enabled 默认 0），需登录光鸭账号后再开启上传。

前台入口：无独立页面；上传时自动走光鸭（各插件上传钩子）

后台入口：插件列表 → 光鸭网盘（/admin/guangya）

二、核心能力

能力	说明
统一上传	`handleUpload` 接管 `UploadedFile`，返回 `storage=guangya`
分类目录	图片 `zsens-images`、媒体 `zsens-media`、附件 `zsens-attachments`
文件代理	`/guangya/file/:id` 代理读取；`/guangya/url/:id` 获取直链信息
短信登录	手机号 + 验证码登录光鸭账号
Token 维护	自动刷新 `access_token`；过期告警（可邮件通知）
附件同步	将历史本地附件批量同步到光鸭
上传日志	`guangya_upload_log` 记录 file_id 与场景
删除联动	`handleUploadDelete` 删除远程文件

集成插件： 社区上传、附件（attachment）、音频（audio）、编辑器等调用统一上传钩子时生效。

三、依赖与安装

建议环境：

PHP 可出网访问光鸭 API

服务器 CA 证书正常（插件自带 certs/cacert.pem）

（可选）邮件插件用于 Token 失效通知

安装步骤：

应用中心安装「光鸭网盘上传」

进入 插件列表 → 光鸭网盘

使用 手机号 + 短信验证码 登录光鸭账号

确认登录状态为正常、Token 未过期

在应用中心开启 启用光鸭上传

配置三类上传目录名（可选）

测试发帖插图、附件上传是否返回 /guangya/file/... 地址

数据表：

guangya_upload_log：上传记录

四、应用中心基础配置

路径：应用中心 → 光鸭网盘上传 → 配置

配置项	说明	建议
启用光鸭上传	开启后站内上传走光鸭；需先在后台菜单登录	登录成功后再开
图片上传目录	光鸭内文件夹名（编辑器插图、头像等）	zsens-images
媒体上传目录	音视频	zsens-media
附件上传目录	文档、压缩包等	zsens-attachments

更多 Token、登录状态、通知邮箱等保存在插件 config JSON 中，由后台「光鸭网盘」页维护，不在 configSchema 表单列出。

五、后台重点配置

路径：插件列表 → 光鸭网盘

功能	说明
短信登录	发送验证码 → 填写验证码登录
登录状态	展示手机号、昵称、Token 过期时间、设备 ID
刷新 Token	手动 `refresh`
保存 Token	手动粘贴 access/refresh token（高级）
保存设置	通知邮箱、冷却时间等
退出登录	清除 Token
同步附件	批量将本地附件上传到光鸭
同步进度	`syncStatus` 查询进度

登录成功后插件会在光鸭侧 自动创建 配置的上传目录并缓存 parent_id。

六、前台用户流程

站长在后台完成光鸭登录并 启用光鸭上传

用户在前台正常发帖、上传图片/附件/音视频

文件上传至光鸭对应目录，返回代理 URL 如 /guangya/file/xxx

浏览器访问代理 URL 由本站转发光鸭内容

用户无额外操作步骤。

七、后台审核与运维

任务	说明
Token 巡检	关注后台过期提示；配置邮件通知
定期刷新	系统自动 `tryAutoRefresh`；失败需重新登录
同步历史	大站点分批执行「同步附件」
目录变更	改目录名后会在光鸭新建目录并更新 parent_id

八、特殊说明

8.1 路由

前台：

方法	路径	说明
GET	`/guangya/file/:id`	文件代理
GET	`/guangya/url/:id`	URL 信息

后台：

方法	路径	说明
GET	`/admin/guangya`	登录与监控页
POST	`/admin/guangya/sendCode`	发送短信验证码
POST	`/admin/guangya/login`	验证码登录
POST	`/admin/guangya/refresh`	刷新 Token
POST	`/admin/guangya/sync`	开始同步
GET	`/admin/guangya/syncStatus`	同步进度
POST	`/admin/guangya/logout`	退出