TinyImgUploader 2.0.0:Typecho 1.3 图片上传插件(对接 TinyImg 图床)

在撰写文章 / 页面的右侧栏增加图片上传窗口,选图后上传到自建 TinyImg
图床,并把 Markdown 链接插入编辑器光标处。

主要功能
1. 侧栏卡片 + 弹窗上传
   - 挂在 admin/write-post.php 与 write-page.php 的 option 钩子
   - 支持点选、拖入、Ctrl+V 粘贴,上传前可预览
   - 用 getSelection / replaceSelection 插入光标处并触发 input 事件,
     草稿自动保存与实时预览都能同步

2. 三种图床鉴权方式
   - token(默认):X-TinyImg-Token 请求头,未配置则明确拒绝
   - admin:模拟图床后台登录 Cookie(无需改图床,但凭证等价于后台密码)
   - guest:游客上传,图片进 temp/ 并受每日配额限制
   - token / admin 两种模式强制服务端代理,凭证绝不下发浏览器

3. 「测试连接」按钮
   - 读取输入框当前值,无需先保存
   - 经博客同源 Action(带 CSRF)调用图床 functions/upload.php?ping=1
   - 返回图床版本、鉴权方式与管理员目录,并比对是否落在 upload/

4. 为什么必须走服务端代理
   - 实测图床 upload.php 不返回 Access-Control-Allow-Origin,
     浏览器从博客后台直接 POST 会被同源策略拦截

5. 服务端校验
   - 登录态 + 用户组(可选「仅管理员」) + CSRF 令牌
   - 上传大小上限、getimagesize 真实图片头校验(拦 SVG / 伪装脚本)
   - 未认出管理员身份时返回 warn,前端不自动关闭弹窗

6. 附带工具与测试
   - tools/probe.php:命令行连通性自检(只读探测 / 真实上传 / 目录判定)
   - tools/cookie.php:本地计算图床管理员 Cookie 值,不联网
   - tests/:六组共 207 项,含故意错误实现的反证

版本:2.0.0
This commit is contained in:
terry
2026-11-05 17:33:44 +08:00
parent 33e9371f00
commit 8ac51d3160
14 changed files with 3398 additions and 2 deletions
+73
View File
@@ -0,0 +1,73 @@
<?php
use TypechoPlugin\TinyImgUploader\Util;
require_once __DIR__ . '/../Util.php';
/**
* 生成管理员登录 Cookie(回退方案;纯本地计算,不联网、不上传任何东西)。
*
* php tools/cookie.php 管理员账号 '明文密码'
* php tools/cookie.php 管理员账号 --md5=32位十六进制值
*
* 依据 TinyImg/functions/class/class.user.php:
* login(): $password = md5("tinyimg" . $admin['password']); setcookie("password", $password, ...);
* check(): $config['user'] . md5("tinyimg" . $config['password']) === $_COOKIE['user'] . $_COOKIE['password']
*
* 推荐把输出的 32 位值填进插件设置,而不是明文密码:这样数据库里不存密码明文。
*/
if (PHP_SAPI !== 'cli') {
exit('仅允许在命令行运行' . PHP_EOL);
}
$args = array_slice($argv, 1);
$user = '';
$secret = '';
foreach ($args as $arg) {
if (strpos($arg, '--md5=') === 0) {
$secret = substr($arg, 6);
} elseif ($arg === '--help' || $arg === '-h') {
echo "用法:php tools/cookie.php 管理员账号 '明文密码'\n"
. " php tools/cookie.php 管理员账号 --md5=32位值\n\n"
. "只做本地 md5 计算,不会访问图床、不会上传图片。\n"
. "注意:明文密码写在命令行会留在 shell 历史里,用完后建议清理历史。\n";
exit(0);
} elseif ($user === '') {
$user = $arg;
} elseif ($secret === '') {
$secret = $arg;
}
}
if ($user === '' || $secret === '') {
exit("缺少参数。用法:php tools/cookie.php 管理员账号 '明文密码'(或 --help)\n");
}
if (!preg_match('/^[a-f0-9]{32}$/i', $secret)) {
echo "提示:检测到明文密码,将按 md5(\"tinyimg\" . 密码) 计算 Cookie 值。\n\n";
}
$cookie = Util::adminCookie($user, $secret);
if ($cookie === null) {
exit("账号或密码为空,无法生成 Cookie\n");
}
echo "=== TinyImg 2.0 管理员登录 Cookie(回退方案) ===" . PHP_EOL . PHP_EOL;
echo '图床管理员账号 : ' . $user . PHP_EOL;
echo 'password Cookie 值 : ' . $cookie['password'] . PHP_EOL;
echo '完整 Cookie 头 : ' . Util::mergeCookie('', $cookie) . PHP_EOL;
echo PHP_EOL;
echo "填到插件设置:" . PHP_EOL;
echo ' 图床管理员账号 = ' . $user . PHP_EOL;
echo ' 图床管理员密码 / 登录 Cookie 值 = ' . $cookie['password'] . PHP_EOL;
echo PHP_EOL;
echo "验证(会真实上传 1 张图片,请在博客服务器或本机有 curl 扩展时执行):" . PHP_EOL;
echo ' php tools/probe.php --url=https://你的图床/functions/upload.php --file=./test.png'
. ' --admin-user=' . $user . ' --admin-secret=' . $cookie['password'] . PHP_EOL;
echo PHP_EOL;
echo "本工具不联网;Cookie 值等同于图床登录凭证,请勿提交到公开仓库。\n";
echo "注意:TinyImg 2.0 已把 Cookie 盐改为 tinyimg,升级后旧 Cookie 会失效,需重新登录。\n";
echo "推荐用默认的 API Token 模式:到图床后台「Token 设置」生成,填进插件设置并点「测试连接」。\n";