Files
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

197 lines
9.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 请补充:
```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 连接自检(给插件「测试连接」用)
```bash
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 手工验证真实上传
```bash
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、不需要联网):
```bash
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 的访问来源。