Files
TinyImg/README.md
T
terry aac91aa9b6 TinyImg 2.0.0:更名、下线 SM.MS、新增后台 Token 设置页
基于 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
2026-11-05 17:30:05 +08:00

9.2 KiB
Raw Blame History

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 / 打了补丁的旧版升级

  1. 备份:整个图床目录 + config.php + db/*.db3。
  2. 把 TinyImg-2.0.0.zip 解压覆盖到站点目录(不要删除 config.php 和 db/ 里已有的 .db3)。
  3. 若你的旧 config.php 里已有 api_token,无需改动:新程序会自动接管。
  4. 浏览器打开 admin/login.php 重新登录(Cookie 盐变了)。
  5. 进入 后台 → Token 设置:确认显示旧 Token 或点「重新生成 Token」。
  6. 同步更新 Typecho 插件设置里的 Token,并用插件的「测试连接」验证。

3.2 全新安装

  1. 解压到站点根目录,访问 check.php 记录绝对路径。
  2. 访问 install.php 完成安装向导(会自动生成 config.php,并把 db/tinyimg-simple.db3 复制为 db/tinyimg.db3)。
  3. 安装完成后删除 check.php;install.php 会被自动改名为 .bak。
  4. 登录后台 → 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. 安全说明

  1. Token 只被上传端点与 ?ping=1 识别;后台管理仍只认登录 Cookie,Token 泄露无法进入后台。
  2. 比较用 hash_equals;空配置、停用、空请求一律拒绝。
  3. 全站请启用 HTTPS,避免 Token 在传输中泄露。
  4. Token 可随时在后台轮换,不必改动管理员密码;轮换后记得同步 Typecho 插件。
  5. 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 的访问来源。