基于 ImgURL 1.x 的二次开发版本,主要变更:
1. 更名
- 项目定名为 TinyImg,源码中不再出现旧品牌字样(0 处)
- static/imgurl.js -> static/tinyimg.js
- db/imgurl-simple.db3 -> db/tinyimg-simple.db3
2. 移除 SM.MS 上传
- 删除 embed.js 中的 upload.render / smshow / deletesm
- miniup.html 去掉 SM.MS 选项卡;前台与后台导航移除入口
- sm.php、functions/sm.php、admin/smadmin.php 改为下线说明页
- admin/delete.php 移除 type=sm 分支;class.admin.php 删除 querysm()/deletesm()
3. 新增后台 Token 设置(admin/setting.php + functions/token.php)
- 生成 / 自定义 / 启用 / 停用 / 清空,全部校验 Session CSRF
- 存储于 db/tinyimg-token.php(首行 <?php exit; 守卫)
- config.php 的 api_token 仅作兼容回退,保存一次后由文件接管
- 完整 Token 不写入页面 HTML:默认只渲染掩码,点「显示/复制」时
经 POST action=reveal(同源 + CSRF + 仅登录会话)按需取回
4. 上传端点鉴权
- 统一使用 X-TinyImg-Token 请求头,hash_equals 比较,空配置 fail closed
- 新增 ?ping=1 自检,返回版本、鉴权方式、管理员目录,供写作插件测试连接
5. 版本号
- 统一为 v2.0.0(20261104),前后台页脚引用 functions/version.php
6. 兼容性修复
- class.upload.php 中 $size{...} 花括号下标改为 $size[...](PHP 8 已移除该语法)
7. 仓库整理
- .gitignore 排除 config.php / db/tinyimg-token.php / 运行时目录,
保留 db/.htaccess 与空模板 db/tinyimg-simple.db3
- .gitattributes 统一 LF
9.2 KiB
9.2 KiB
TinyImg 2.0.0
TinyImg 是一款简单、纯粹的图床程序,使用 PHP + SQLite 3 开发,开箱即用。 2.0.0 是基于 1.40 的定制版:更名、去掉第三方图床上传、加入后台可视化 API Token 管理。
1. 本次变更一览
| # | 变更 | 说明 |
|---|---|---|
| 1 | 程序更名 | 全站品牌改为 TinyImg,源码里不再出现旧品牌字样(含变量名、数据库文件名、静态文件名、md5 盐、外部链接) |
| 2 | 版本号 | v1.40(20181106) → v2.0.0(20261104),统一由 functions/version.php 提供 |
| 3 | SM.MS 下线 | 上传页选项卡、前台导航、后台菜单、JS 上传逻辑、回写接口、删除接口全部移除或 fail closed |
| 4 | Token 设置页 | 后台新增「Token 设置」:显示 / 隐藏 / 复制 / 重新生成 / 自定义 / 启停 / 清空,带 Session CSRF |
| 5 | Token 存储 | db/tinyimg-token.php,首行 <?php exit; 守卫,直接访问 URL 不会泄漏;兼容旧 config.php 的 api_token |
| 6 | 连接自检 | functions/upload.php?ping=1,只校验 Token 不接收文件,返回版本与管理员目录 |
| 7 | PHP 8 兼容 | 修复第三方 class.upload.php 的花括号字符串下标写法 |
| 8 | Cookie 盐 | md5("tinyimg" + 密码);升级后旧登录态失效,需重新登录 |
版本字符串只存在
functions/version.txt一处;后台关于弹窗、页脚、上传自检都读它。
2. 破坏性变更(升级前必读)
| 项 | 旧版 | 2.0.0 | 影响 |
|---|---|---|---|
| 鉴权请求头 | X- 开头的旧头 |
X-TinyImg-Token |
旧版 Typecho 插件必须同步升级,否则 Token 上传失败 |
| 管理员 Cookie 盐 | 旧盐 | md5("tinyimg" + 密码) |
已登录后台的浏览器 Cookie 失效,重新登录一次即可 |
| 数据库文件名 | 旧 .db3 |
db/tinyimg.db3 |
不影响已有站点:你服务器上的 config.php 仍指向旧文件,照常可用;全新安装才用新文件名 |
config.php 的 api_token |
唯一来源 | 兼容回退 | 首次打开「Token 设置」并保存一次后,改由 db/tinyimg-token.php 接管 |
| SM.MS | 可用 | 已关闭 | 上传页不再有该入口,历史数据仍留在库中但不再读取 |
3. 部署 / 升级
3.1 从 1.40 / 打了补丁的旧版升级
- 备份:整个图床目录 +
config.php+db/*.db3。 - 把
TinyImg-2.0.0.zip解压覆盖到站点目录(不要删除config.php和db/里已有的.db3)。 - 若你的旧
config.php里已有api_token,无需改动:新程序会自动接管。 - 浏览器打开
admin/login.php重新登录(Cookie 盐变了)。 - 进入 后台 → Token 设置:确认显示旧 Token 或点「重新生成 Token」。
- 同步更新 Typecho 插件设置里的 Token,并用插件的「测试连接」验证。
3.2 全新安装
- 解压到站点根目录,访问
check.php记录绝对路径。 - 访问
install.php完成安装向导(会自动生成config.php,并把db/tinyimg-simple.db3复制为db/tinyimg.db3)。 - 安装完成后删除
check.php;install.php会被自动改名为.bak。 - 登录后台 → Token 设置 → 生成 API Token。
3.3 Nginx 安全规则
Apache 的 db/.htaccess 已拒绝整个目录;Nginx 请补充:
location ~* \.(db3|json)$ { deny all; }
location ~* ^/(temp|upload)/.*\.(php|php5)$ { deny all; }
Token 存储文件是 .php 且首行 exit,即使规则遗漏也不会通过 URL 泄漏内容。
4. API Token 管理
4.1 后台设置页
入口:后台顶部导航或左侧「系统设置 → Token 设置」,即 admin/setting.php。
| 能力 | 说明 |
|---|---|
| 显示当前 Token | 完整值不写入页面 HTML,默认只渲染掩码(如 Secret****cdef)与长度;点「显示」/「复制」时才带 CSRF 向服务器取一次 |
| 重新生成 | 用 CSPRNG 生成 64 位十六进制串,旧 Token 立即失效 |
| 自定义 | 填入 16~128 位字母 / 数字 / _ / -,保存并启用 |
| 启用 / 停用 | 停用后带 Token 的请求一律拒绝,但网页正常上传不受影响 |
| 清空 | 删除 Token 并停用 |
| 状态信息 | 创建 / 更新时间、来源(存储文件 / 旧 config.php / 未配置)、版本号 |
所有写操作都校验 Session CSRF,且只有已登录后台的管理员可访问。
为什么默认不显示明文:设置页早期版本把 Token 直接写进
input的value属性, 于是页面源码、浏览器缓存、录屏/截图里都会长期留着可用凭证。现在的做法是 默认只输出掩码,完整值由POST action=reveal按需返回(同源、带 CSRF、 仅当前登录会话)。这条约束由tests/setting_test.php断言,包含「错误 CSRF 必须拿不到 Token」的反证。
4.2 上传接口
POST /functions/upload.php
HEADER X-TinyImg-Token: <Token>
BODY multipart/form-data,文件字段名 file
| 情况 | 行为 |
|---|---|
| Token 校验通过 | 视为管理员上传:进 admindir(默认 upload/),跳过 limitnum() 每日配额,不要求 Referer / 登录 Cookie |
| Token 错误 / 未配置 / 已停用 | 立即返回 {"code":0,"msg":"..."},fail closed,绝不静默降级为游客上传 |
| 不带 Token | 完全保留原有逻辑:Referer 校验 + 登录 Cookie 判定 + 游客配额 |
成功返回:{"code":1,"id":9,"url":"https://...","width":800,"height":600}。
4.3 连接自检(给插件「测试连接」用)
curl -sS -X POST "https://你的域名/functions/upload.php?ping=1" \
-H "X-TinyImg-Token: 你的Token"
# {"code":1,"msg":"Token 有效","name":"TinyImg","version":"v2.0.0(20261104)","admin_dir":"upload",...}
?ping=1 不接收文件、不写数据库,只验证 Token 并返回版本与管理员目录。
缺少 Token、Token 无效、Token 已停用时都会返回 code:0。
4.4 手工验证真实上传
curl -sS -X POST "https://你的域名/functions/upload.php" \
-H "X-TinyImg-Token: 你的Token" \
-F "[email protected];type=image/png"
# 正确时 url 里应含 /upload/
5. SM.MS 功能屏蔽清单
| 位置 | 处理 |
|---|---|
miniup.html |
删除 SM.MS 选项卡与文件输入,只保留本站上传 + 关于 |
tpl/user/header.php |
删除 SM.MS 导航项,外链改为站内 |
tpl/admin/left.php / header.php |
删除 SM.MS 菜单,新增 Token 设置入口 |
static/embed.js |
删除指向第三方上传 API 的 upload.render,删除 smshow / deletesm |
sm.php |
返回 HTTP 410 + 明确说明,不再渲染上传表单 |
functions/sm.php |
HTTP 410 + {"code":0,...},不载入类、不写数据库 |
admin/smadmin.php |
只显示下线说明,不再查询数据库 |
admin/delete.php |
type=sm 明确拒绝 |
functions/class/class.admin.php |
移除 querysm() / deletesm() |
upgrade.php |
不再创建 sm 表 |
历史 sm 表数据保留,不删除、不迁移。
6. 命名与版本
| 内容 | 新值 |
|---|---|
| 品牌 | TinyImg |
| 版本文件 | functions/version.txt → v2.0.0(20261104) |
| 版本常量 | TINYIMG_NAME / TINYIMG_VERSION(functions/version.php) |
| 数据库模板 | db/tinyimg-simple.db3 → db/tinyimg.db3 |
| 油猴脚本 | static/tinyimg.js(顶部 TINYIMG_BASE 改成你的站点地址) |
| Token 请求头 | X-TinyImg-Token |
| 登录 Cookie 盐 | md5("tinyimg" + 密码) |
7. 安全说明
- Token 只被上传端点与
?ping=1识别;后台管理仍只认登录 Cookie,Token 泄露无法进入后台。 - 比较用
hash_equals;空配置、停用、空请求一律拒绝。 - 全站请启用 HTTPS,避免 Token 在传输中泄露。
- Token 可随时在后台轮换,不必改动管理员密码;轮换后记得同步 Typecho 插件。
functions/api.php是保留的旧版兼容上传 API,带Access-Control-Allow-Origin: *,仍走游客配额;如不需要可直接删除或加访问限制。
8. 验证命令
在 TinyImgUploader/ 目录下执行(不需要 Typecho、不需要联网):
php tests/host_test.php # 更名 / 版本 / SM.MS 下线 / 设置页 / 静态资源
php tests/token_test.php # Token 纯函数 + 上传端点契约 + 错误实现反证
php tests/auth_test.php # Cookie 回退方案契约
php tests/util_test.php # 响应解析 / ping 地址
php tests/render_test.php # 插件侧栏与测试按钮渲染
php tests/setting_test.php # 设置页渲染:完整 Token 不入 HTML、reveal 必须校验 CSRF
# 命令行连通性自检(需要 PHP 的 curl 或 openssl 扩展)
php tools/probe.php --url=https://你的域名/functions/upload.php --token=你的Token --ping
php tools/probe.php --url=https://你的域名/functions/upload.php --token=你的Token --file=./test.png
9. 已知限制
- 上传大小仍硬编码 2 MB(
functions/upload.php的file_max_size)。 db/tinyimg-token.php需要db/目录对 Web 用户可写;不可写时设置页会给出明确错误。- 游客上传的每日配额、图片压缩、鉴黄等沿用原有逻辑,本次未改动。
?ping=1是一个 Token 有效性判据端点,请配合 HTTPS;若担心被探测,可在反向代理层限制该 URL 的访问来源。