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
+202
View File
@@ -0,0 +1,202 @@
<?php
/**
* TinyImg 2.0 API Token 契约测试(无需 Typecho、无需联网、不上传任何图片)。
* 运行:php tests/token_test.php
*
* 覆盖:
* 1. 直接加载图床 functions/token.php,测真实纯函数;
* 2. 源码级断言 functions/upload.php 的 Token 门与 ?ping=1 自检;
* 3. 源码级断言后台 Token 设置页的 CSRF / 四种操作 / 守卫说明;
* 4. 三个「故意写错的实现」反证:证明测试集能抓到真实漏洞。
*/
$stat = ['pass' => 0, 'fail' => 0];
$check = function ($name, $ok, $detail = '') use (&$stat) {
if ($ok) {
$stat['pass']++;
echo ' [PASS] ' . $name . PHP_EOL;
} else {
$stat['fail']++;
echo ' [FAIL] ' . $name . ($detail === '' ? '' : ' -> ' . $detail) . PHP_EOL;
}
};
$host = dirname(__DIR__, 2) . '/TinyImg';
$tokenFile = $host . '/functions/token.php';
$uploadFile = $host . '/functions/upload.php';
$settingFile = $host . '/admin/setting.php';
$adminClass = $host . '/functions/class/class.admin.php';
echo PHP_EOL . '1. 交付文件完整性' . PHP_EOL;
foreach (['Token 存储模块' => $tokenFile, '上传端点' => $uploadFile, '后台设置页' => $settingFile] as $label => $path) {
$check($label . '存在', is_file($path), $path);
}
require_once $tokenFile;
echo PHP_EOL . '2. Token 存储文件:编解码与守卫' . PHP_EOL;
$state = [
'token' => 'Abc_123-XYZ789abcdef',
'enabled' => 1,
'created_at' => '2026-11-04 10:00:00',
'updated_at' => '2026-11-04 11:00:00',
];
$raw = tinyimg_token_encode($state);
$decoded = tinyimg_token_decode($raw);
$check('编码首行是 <?php exit; 守卫(直接访问 URL 不会输出 Token)',
strpos($raw, '<?php exit;') === 0);
$check('JSON 载荷在第二行', count(explode("\n", trim($raw))) >= 2);
$check('解码还原 token / enabled / 时间戳',
is_array($decoded) && $decoded['token'] === $state['token']
&& $decoded['enabled'] === 1 && $decoded['created_at'] === $state['created_at']);
$check('解码拒绝没有守卫的裸 JSON', tinyimg_token_decode('{"token":"x"}') === null);
$check('解码拒绝损坏的 JSON', tinyimg_token_decode("<?php exit; ?>\n{not json") === null);
$check('解码拒绝缺少 token 字段', tinyimg_token_decode("<?php exit; ?>\n{\"enabled\":1}") === null);
$check('encode 对 enabled=0 输出 0',
strpos(tinyimg_token_encode(['token' => 'x', 'enabled' => 0]), '"enabled":0') !== false);
echo PHP_EOL . '3. Token 校验:正例 / 反例 / fail closed' . PHP_EOL;
$enabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 1];
$check('正确 Token -> 通过', tinyimg_token_verify($enabled, 'S3cr3tTokenValue_123456') === true);
$check('错误 Token -> 拒绝', tinyimg_token_verify($enabled, 'wrong') === false);
$check('空请求 -> 拒绝', tinyimg_token_verify($enabled, '') === false);
$check('未配置 Token + 空请求 -> 拒绝(不能提权)',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
$check('未配置 Token + 任意请求 -> 拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], 'anything') === false);
$check('已停用 -> 即使 Token 正确也拒绝',
tinyimg_token_verify(['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0], 'S3cr3tTokenValue_123456') === false);
$check('真实实现使用 hash_equals 恒定时间比较',
strpos(file_get_contents($tokenFile), 'hash_equals($stored, $provided)') !== false);
echo PHP_EOL . '4. 生成 / 格式 / 脱敏 / 旧配置兼容' . PHP_EOL;
$generated = tinyimg_token_generate(32);
$check('生成 64 位十六进制 Token', (bool) preg_match('/^[a-f0-9]{64}$/', $generated), $generated);
$check('两次生成不相同', tinyimg_token_generate(32) !== tinyimg_token_generate(32));
$check('格式校验接受 16~128 位合法字符', tinyimg_token_valid_format(str_repeat('a', 16)));
$check('格式校验拒绝过短', !tinyimg_token_valid_format('abc'));
$check('格式校验拒绝空格 / 引号等危险字符', !tinyimg_token_valid_format('abc def"123456') && !tinyimg_token_valid_format("a'b123456789012"));
$check('脱敏保留首尾且不含完整 Token',
strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), '************') !== false
&& strpos(tinyimg_token_mask('abcdefghijklmnopqrstuvwxyz'), 'abcdefghijklmnopqrstuvwxyz') === false);
$check('脱敏空值给出「未设置」', tinyimg_token_mask('') === '(未设置)');
$fromConfig = tinyimg_token_default(['api_token' => 'legacy-token-value']);
$check('旧版 config.php 的 api_token 会被自动接管',
$fromConfig['token'] === 'legacy-token-value' && $fromConfig['enabled'] === 1
&& $fromConfig['source'] === 'config');
$noConfig = tinyimg_token_default([]);
$check('无旧配置时默认停用(fail closed)',
$noConfig['enabled'] === 0 && $noConfig['source'] === 'none');
echo PHP_EOL . '5. 上传端点源码契约' . PHP_EOL;
$u = is_file($uploadFile) ? file_get_contents($uploadFile) : '';
$check('读取 X-TinyImg-Token 请求头', strpos($u, 'HTTP_X_TINYIMG_TOKEN') !== false);
$check('兼容 POST 字段 token', strpos($u, "\$_POST['token']") !== false);
$check('调用 tinyimg_token_load / tinyimg_token_verify',
strpos($u, 'tinyimg_token_load($config)') !== false
&& strpos($u, 'tinyimg_token_verify($tokenState, $reqToken)') !== false);
$check('校验失败明确报错,不静默回落',
strpos($u, "\$basis->re_error(") !== false && strpos($u, "'API Token 无效!'") !== false);
$check('未配置 / 已停用分别给出可诊断的报错',
strpos($u, 'API Token 未配置') !== false && strpos($u, 'API Token 上传已停用') !== false);
$check('?ping=1 缺少 Token 时直接拒绝', strpos($u, "缺少 API Token") !== false);
$check('?ping=1 成功返回版本与管理员目录',
strpos($u, "'version' => TINYIMG_VERSION") !== false
&& strpos($u, "'admin_dir'") !== false);
$check('校验通过才置 islogin', strpos($u, "\$status = 'islogin';") !== false);
$check('不带 Token 时保留原 Referer + Cookie 逻辑',
strpos($u, 'HTTP_REFERER') !== false && strpos($u, '$basis->check($config)') !== false);
$check('原有上传主体未被改写',
strpos($u, '$basis->limitnum();') !== false
&& strpos($u, "\$handle->file_max_size = '2097152'") !== false
&& strpos($u, "\$handle->process('../'.\$updir") !== false);
$check('上传端点不含旧品牌字符串', strpos(strtolower($u), 'img' . 'url') === false);
echo PHP_EOL . '6. 后台设置页与权限边界' . PHP_EOL;
$s = is_file($settingFile) ? file_get_contents($settingFile) : '';
$check('设置页复用后台登录鉴权', strpos($s, 'class.admin.php') !== false);
$check('写操作校验 Session CSRF', strpos($s, "hash_equals(\$csrf, \$_POST['csrf'])") !== false);
$check('提供重新生成 / 自定义保存 / 启停 / 清空四种操作',
strpos($s, "=== 'regenerate'") !== false && strpos($s, "=== 'save'") !== false
&& strpos($s, "=== 'toggle'") !== false && strpos($s, "=== 'clear'") !== false);
$check('页面显示 Token 且可显示/隐藏/复制',
strpos($s, 'id="ti-token"') !== false && strpos($s, 'ti-reveal') !== false
&& strpos($s, 'ti-copy') !== false);
$check('页面给出连接信息与 ping 自检示例',
strpos($s, 'X-TinyImg-Token') !== false && strpos($s, 'ping=1') !== false);
$check('后台管理类不认识 Token(Token 泄露无法进后台)',
is_file($adminClass) && strpos(file_get_contents($adminClass), 'api_token') === false);
echo PHP_EOL . '7. 测试集有效性反证(故意写错的实现)' . PHP_EOL;
// 错误实现 A:漏掉 enabled 检查 —— 管理员在后台停用 Token 后,旧 Token 仍能上传
$badNoEnabledCheck = function ($state, $provided) {
$stored = isset($state['token']) ? $state['token'] : '';
return $stored !== '' && $provided !== '' && hash_equals($stored, $provided);
};
$disabled = ['token' => 'S3cr3tTokenValue_123456', 'enabled' => 0];
$check('错误实现 A 在「已停用」状态下仍放行(真实漏洞)',
$badNoEnabledCheck($disabled, 'S3cr3tTokenValue_123456') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify($disabled, 'S3cr3tTokenValue_123456') === false);
// 错误实现 B:用 == 松散比较且不检查空值 —— 空配置 + 空请求直接提权
$badLooseCompare = function ($state, $provided) {
return $state['token'] == $provided;
};
$check('错误实现 B 在「空配置 + 空请求」下放行(真实漏洞)',
$badLooseCompare(['token' => '', 'enabled' => 1], '') === true);
$check('真实实现在同样输入下必须拒绝',
tinyimg_token_verify(['token' => '', 'enabled' => 1], '') === false);
// 错误实现 C:子串匹配当校验
$badSubstring = function ($state, $provided) {
return $provided !== '' && strpos($state['token'], $provided) !== false;
};
$check('错误实现 C 让短前缀冒充 Token 通过',
$badSubstring($enabled, substr($enabled['token'], 0, 4)) === true);
$check('真实实现必须拒绝短前缀',
tinyimg_token_verify($enabled, substr($enabled['token'], 0, 4)) === false);
echo PHP_EOL . '8. 真实文件读写(临时目录,不碰线上数据)' . PHP_EOL;
$tmp = sys_get_temp_dir() . '/tinyimg-token-test-' . bin2hex(random_bytes(4));
@mkdir($tmp . '/db', 0700, true);
if (!defined('APP')) {
define('APP', $tmp . '/');
}
$saved = tinyimg_token_save('RealFileToken_123456', true, []);
$check('保存成功', $saved[0] === true, $saved[1]);
$path = tinyimg_token_file();
$check('存储文件落在 db/ 目录', is_file($path) && basename($path) === 'tinyimg-token.php', $path);
$check('存储文件首行是 PHP exit 守卫',
strpos(file_get_contents($path), '<?php exit;') === 0);
$loaded = tinyimg_token_load([]);
$check('读回 Token 且来源标记为 file',
$loaded['token'] === 'RealFileToken_123456' && $loaded['enabled'] === 1
&& $loaded['source'] === 'file', json_encode($loaded));
$check('读回状态能通过校验', tinyimg_token_verify($loaded, 'RealFileToken_123456') === true);
$check('停用后读回状态不再放行', (function () use ($tmp) {
tinyimg_token_save('RealFileToken_123456', false, []);
return tinyimg_token_verify(tinyimg_token_load([]), 'RealFileToken_123456') === false;
})());
$check('自定义非法 Token 不会被写入', !tinyimg_token_valid_format('bad token!'));
@unlink($path);
@rmdir($tmp . '/db');
@rmdir($tmp);
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
exit($stat['fail'] === 0 ? 0 : 1);