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:
@@ -0,0 +1,211 @@
|
||||
<?php
|
||||
|
||||
/**
|
||||
* TinyImg 后台 Token 设置页验收测试(桩环境渲染,不需要图床运行、不联网)。
|
||||
* 运行:php tests/setting_test.php
|
||||
*
|
||||
* 这个文件存在的理由:设置页最初把完整 Token 直接写进 input 的 value 属性,
|
||||
* 页面源码、浏览器缓存、截图里都会留有明文。现在改成「默认只输出掩码,
|
||||
* 点显示/复制时带 CSRF 向服务器取一次」。下面的断言把这条约束固定住,
|
||||
* 并且验证错误 CSRF 拿不到 Token —— 否则谁都能用一个 GET 读到凭证。
|
||||
*/
|
||||
|
||||
$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;
|
||||
}
|
||||
};
|
||||
|
||||
$root = dirname(__DIR__, 2);
|
||||
$host = $root . '/TinyImg';
|
||||
$php = PHP_BINARY;
|
||||
|
||||
if (!is_file($host . '/admin/setting.php')) {
|
||||
fwrite(STDERR, '找不到图床源码:' . $host . '/admin/setting.php' . PHP_EOL);
|
||||
exit(1);
|
||||
}
|
||||
|
||||
// 沙箱放在项目内而不是系统临时目录:Windows 下 shell_exec 走 cmd.exe,
|
||||
// 系统临时目录常带 8.3 短名或重定向,容易出现「命令没执行、stdout 为空」。
|
||||
$sandbox = dirname(__DIR__) . '/.ti_setting_tmp';
|
||||
$sessDir = $sandbox . '/sess';
|
||||
|
||||
/** 递归删除临时目录 */
|
||||
function setting_rm($dir)
|
||||
{
|
||||
if (!is_dir($dir)) {
|
||||
return;
|
||||
}
|
||||
$it = new RecursiveIteratorIterator(
|
||||
new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS),
|
||||
RecursiveIteratorIterator::CHILD_FIRST
|
||||
);
|
||||
foreach ($it as $f) {
|
||||
$f->isDir() ? @rmdir($f->getPathname()) : @unlink($f->getPathname());
|
||||
}
|
||||
@rmdir($dir);
|
||||
}
|
||||
|
||||
setting_rm($sandbox);
|
||||
foreach (['admin', 'functions/class', 'tpl/admin', 'db', 'sess'] as $d) {
|
||||
@mkdir($sandbox . '/' . $d, 0777, true);
|
||||
}
|
||||
|
||||
// 复制被测文件与依赖
|
||||
copy($host . '/admin/setting.php', $sandbox . '/admin/setting.php');
|
||||
copy($host . '/functions/token.php', $sandbox . '/functions/token.php');
|
||||
copy($host . '/functions/version.php', $sandbox . '/functions/version.php');
|
||||
copy($host . '/functions/version.txt', $sandbox . '/functions/version.txt');
|
||||
copy($host . '/tpl/admin/header.php', $sandbox . '/tpl/admin/header.php');
|
||||
copy($host . '/tpl/admin/left.php', $sandbox . '/tpl/admin/left.php');
|
||||
copy($host . '/tpl/admin/footer.php', $sandbox . '/tpl/admin/footer.php');
|
||||
|
||||
// 桩:替代后台登录校验,只提供页面需要的 $config / $database / $pic
|
||||
file_put_contents($sandbox . '/functions/class/class.admin.php', <<<'PHP'
|
||||
<?php
|
||||
$config = ['user' => 'demo-admin', 'domain' => 'https://img.example.com/', 'admindir' => 'upload'];
|
||||
$database = null;
|
||||
$pic = null;
|
||||
PHP
|
||||
);
|
||||
|
||||
// 场景驱动:通过命令行参数控制 GET / POST、Token 状态、CSRF 是否正确
|
||||
file_put_contents($sandbox . '/driver.php', <<<'PHP'
|
||||
<?php
|
||||
$sandbox = __DIR__;
|
||||
chdir($sandbox . '/admin');
|
||||
|
||||
define('APP', $sandbox . '/');
|
||||
require_once $sandbox . '/functions/token.php';
|
||||
|
||||
$case = isset($argv[1]) ? $argv[1] : 'empty';
|
||||
$csrf = isset($argv[2]) ? $argv[2] : 'good';
|
||||
|
||||
if ($case === 'empty') {
|
||||
tinyimg_token_save('', false, ['user' => 'demo-admin']);
|
||||
} elseif ($case === 'enabled') {
|
||||
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
|
||||
} elseif ($case === 'disabled') {
|
||||
tinyimg_token_save('SecretTokenValue0123456789abcdef', false, ['user' => 'demo-admin']);
|
||||
}
|
||||
|
||||
$_SERVER['REQUEST_METHOD'] = $case === 'reveal' ? 'POST' : 'GET';
|
||||
|
||||
if ($case === 'reveal') {
|
||||
tinyimg_token_save('SecretTokenValue0123456789abcdef', true, ['user' => 'demo-admin']);
|
||||
session_id('tisettingtest');
|
||||
session_start();
|
||||
$_SESSION['tinyimg_csrf'] = 'CSRF_GOOD';
|
||||
session_write_close();
|
||||
|
||||
$_POST['action'] = 'reveal';
|
||||
$_POST['csrf'] = $csrf === 'good' ? 'CSRF_GOOD' : 'CSRF_BAD';
|
||||
session_id('tisettingtest');
|
||||
}
|
||||
|
||||
require $sandbox . '/admin/setting.php';
|
||||
PHP
|
||||
);
|
||||
|
||||
/** 在沙箱里跑一个场景,返回标准输出 */
|
||||
$run = function ($case, $csrf = 'good') use ($php, $sandbox, $sessDir) {
|
||||
// Windows 的 shell_exec 走 cmd.exe,不认 escapeshellarg 生成的单引号,必须用双引号;
|
||||
// 否则命令根本不会执行、stdout 为空,看起来像「页面没输出」。
|
||||
$q = function ($value) {
|
||||
return DIRECTORY_SEPARATOR === '\\'
|
||||
? '"' . $value . '"'
|
||||
: escapeshellarg($value);
|
||||
};
|
||||
|
||||
$cmd = $q($php)
|
||||
. ' -d session.save_path=' . $q($sessDir)
|
||||
. ' -d display_startup_errors=0 -d display_errors=1 -d error_reporting=E_ALL '
|
||||
. $q($sandbox . '/driver.php')
|
||||
. ' ' . $q($case) . ' ' . $q($csrf);
|
||||
|
||||
return (string) shell_exec($cmd);
|
||||
};
|
||||
|
||||
$TOKEN = 'SecretTokenValue0123456789abcdef';
|
||||
|
||||
echo PHP_EOL . '1. 未设置 Token 时的渲染' . PHP_EOL;
|
||||
|
||||
$empty = $run('empty');
|
||||
$check('页面正常输出(无 Fatal / Parse error)',
|
||||
$empty !== '' && stripos($empty, 'Fatal error') === false && stripos($empty, 'Parse error') === false,
|
||||
substr(trim($empty), 0, 120));
|
||||
$check('显示「未设置」状态', strpos($empty, '未设置') !== false);
|
||||
$check('无 Token 时「显示 / 复制」按钮禁用',
|
||||
substr_count($empty, 'id="ti-reveal"') === 1 && preg_match('/id="ti-reveal"\s+disabled/', $empty) === 1);
|
||||
$check('页面有「重新生成 Token」入口', strpos($empty, '重新生成 Token') !== false);
|
||||
$check('页面有「填入自定义 Token」表单',
|
||||
strpos($empty, 'name="custom_token"') !== false);
|
||||
|
||||
echo PHP_EOL . '2. 已启用时的渲染(核心安全约束)' . PHP_EOL;
|
||||
|
||||
$enabled = $run('enabled');
|
||||
$check('页面正常输出', $enabled !== '' && stripos($enabled, 'Fatal error') === false);
|
||||
$check('状态显示「已启用」', strpos($enabled, '已启用') !== false);
|
||||
$check('【关键】完整 Token 不出现在 HTML 中', strpos($enabled, $TOKEN) === false,
|
||||
'在页面源码里找到了完整 Token');
|
||||
$check('只输出掩码', strpos($enabled, 'Secret***') !== false);
|
||||
$check('掩码同时写入 value 与 data-masked',
|
||||
substr_count($enabled, 'data-masked') >= 1 && strpos($enabled, 'value="Secret***') !== false);
|
||||
$check('长度信息可见(便于核对,不泄露内容)', strpos($enabled, '长度 32 位') !== false);
|
||||
$check('没有 Token 时按钮 disabled,有 Token 时不 disabled',
|
||||
preg_match('/id="ti-reveal"\s+disabled/', $enabled) !== 1);
|
||||
$check('页面有脱敏视图说明', strpos($enabled, '完整值不写入页面') !== false);
|
||||
|
||||
echo PHP_EOL . '3. 已停用时的渲染' . PHP_EOL;
|
||||
|
||||
$disabled = $run('disabled');
|
||||
$check('状态显示「已停用」', strpos($disabled, '已停用') !== false);
|
||||
$check('停用时按钮仍可用(Token 还在,只是不接受上传)',
|
||||
preg_match('/id="ti-reveal"\s+disabled/', $disabled) !== 1);
|
||||
$check('停用时也不泄露完整 Token', strpos($disabled, $TOKEN) === false);
|
||||
|
||||
echo PHP_EOL . '4. 按需取回(reveal)受 CSRF 保护' . PHP_EOL;
|
||||
|
||||
$revealOk = $run('reveal', 'good');
|
||||
$revealBad = $run('reveal', 'bad');
|
||||
|
||||
$jsonOk = json_decode($revealOk, true);
|
||||
$check('CSRF 正确时返回 JSON', is_array($jsonOk) && isset($jsonOk['code']) && $jsonOk['code'] === 1,
|
||||
substr(trim($revealOk), 0, 120));
|
||||
$check('CSRF 正确时能拿到完整 Token',
|
||||
is_array($jsonOk) && isset($jsonOk['token']) && $jsonOk['token'] === $TOKEN);
|
||||
$check('CSRF 错误时不返回任何 Token',
|
||||
strpos($revealBad, $TOKEN) === false && strpos($revealBad, '"token"') === false,
|
||||
'错误 CSRF 竟然拿到了 Token');
|
||||
$check('CSRF 错误时不是合法 JSON 成功响应',
|
||||
!(is_array(json_decode($revealBad, true)) && isset(json_decode($revealBad, true)['token'])));
|
||||
|
||||
echo PHP_EOL . '5. 反证:错误实现必须被这些断言抓住' . PHP_EOL;
|
||||
|
||||
// 反证 A:像最初那样直接把 token 放进 value
|
||||
$badRender = '<input type="password" value="' . $TOKEN . '" readonly>';
|
||||
$check('反证 A:把明文写进 value 的实现会被「不含完整 Token」断言否掉',
|
||||
strpos($badRender, $TOKEN) !== false);
|
||||
$check('反证 A 同时说明该断言不是恒真', strpos($badRender, $TOKEN) !== false
|
||||
&& strpos($enabled, $TOKEN) === false);
|
||||
|
||||
// 反证 B:reveal 不做 CSRF 校验(任何请求都能读)
|
||||
$badReveal = function ($csrfOk) use ($TOKEN) {
|
||||
return json_encode(['code' => 1, 'token' => $TOKEN], JSON_UNESCAPED_UNICODE);
|
||||
};
|
||||
$check('反证 B:不校验 CSRF 的实现会在「错误 CSRF」场景泄露 Token',
|
||||
strpos($badReveal(false), $TOKEN) !== false);
|
||||
$check('反证 B 对照:真实实现在错误 CSRF 下没有泄露',
|
||||
strpos($revealBad, $TOKEN) === false);
|
||||
|
||||
setting_rm($sandbox);
|
||||
|
||||
echo PHP_EOL . str_repeat('-', 56) . PHP_EOL;
|
||||
echo '结果:' . $stat['pass'] . ' 通过 / ' . $stat['fail'] . ' 失败' . PHP_EOL;
|
||||
exit($stat['fail'] === 0 ? 0 : 1);
|
||||
Reference in New Issue
Block a user