基于 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
197 lines
9.2 KiB
Markdown
197 lines
9.2 KiB
Markdown
# 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 的访问来源。
|