零鹊图床

为零鹊文档与社区提供的图片托管服务：上传、直链、多格式复制，并与文档站编辑器打通。

图床地址： https://img.lingque.sxteam.org

能做什么

能力	说明
网页上传	拖拽、多选、Ctrl+V 粘贴剪贴板图片
直链	`https://img.lingque.sxteam.org/i/{文件名}`
一键复制	直链、Markdown、HTML、BBCode
管理后台	搜索、分页、批量删除、浏览统计
API	供零鹊文档或其它客户端程序化上传
与文档联动	在零鹊文档页面编辑器中「上传图片」自动插入 Markdown

支持格式：JPG / PNG / GIF / WebP / SVG（单张大小与频率限制见站点说明）。

快速开始

1. 打开图床并上传

访问零鹊图床
将图片拖入上传区，或点击选择文件，或在页面内 Ctrl+V 粘贴截图
若站点要求令牌，在页面填写管理员提供的 upload_token（与后台设置一致）
上传成功后复制 Markdown 或直链，粘贴到文档、帖子或配置中

2. 在零鹊文档里直接插图

管理员需先完成两侧配置：

图床后台（设置）

配置 upload_token（并告知文档编辑者，或仅后台保存）
CORS 允许来源 填写文档站地址（例如
https://doc.mcimg.com
或
https://docs.lingque.sxteam.org
）

零鹊文档后台（站点设置 → 零鹊图床）

图床 API 地址：
https://img.lingque.sxteam.org/api/upload.php
上传令牌： 与图床
upload_token
相同

配置完成后，在 页面编辑 工具栏会出现 「上传图片」，选图后自动插入

![...](https://img.lingque.sxteam.org/i/...)

。

链接格式说明

用途	示例
图片直链	`https://img.lingque.sxteam.org/i/20260614_xxxxxxxx.webp`
Markdown	`![说明文字](https://img.lingque.sxteam.org/i/xxx.webp)`
详情页	`https://img.lingque.sxteam.org/view.php?id=数字ID`
API 上传	`POST https://img.lingque.sxteam.org/api/upload.php`

站内 API 页（图床导航「API」）提供参数与返回字段说明。

API 上传（简要）

请求：

POST /api/upload.php

，

multipart/form-data

字段说明

字段	说明
`file` 或 `files[]`	图片文件
`upload_token`	未登录时必填；也可用请求头 `X-Upload-Token`

file

或

files[]

图片文件

upload_token

未登录时必填；也可用请求头

X-Upload-Token

成功返回（单图）： JSON 中

data.url

、

data.markdown

、

data.html

、

data.bbcode

等。

鉴权方式：

图床管理员已登录（Session），或
提供有效的
upload_token

权限与安全说明

匿名上传 由管理员控制：未设置
upload_token
时，通常仅管理员可上传。
上传令牌 请视为密码，勿公开到不可信页面；可在图床后台重新生成。
上传有 大小、数量、每 IP 每小时次数 限制，防止滥用。
服务器需保证
data/
（数据库）与
public/i/
（图片文件）对 Web 进程可写，否则会出现上传失败或「数据库只读」类错误。

常见问题

上传报错「数据库不可写 / readonly database」
在服务器将图床目录下

data/

、

public/i/

归属 Web 用户（如

www-data

）并赋予写权限，详见图床部署说明

DEPLOY.md

。

文档里点「上传图片」失败
检查文档站是否填写正确 API 与令牌；图床 CORS 是否包含文档站完整来源（含

https://

）。

WebP 上传失败
确认 PHP 未强制依赖未安装的扩展；当前图床使用

getimagesize

等方式校验图片，无需

fileinfo

扩展。

想换介绍文档地址
图床 管理 → 站点设置 → 零鹊文档介绍页 URL 可配置导航栏「文档」按钮链接（默认指向零鹊文档本页）。