🌐 全站数据
👤 我的个人数据
🛡️ 已绑定的白名单域名(全部用户,仅超级管理员)
| 用户 | 白名单条目 | 调用有效期至 |
|---|
🖼️ 待审核图标(0)
开启了「上传需审批」的账号上传的图标会先落在这里:通过后才写入图库、生成外链;拒绝则直接删除文件。
| 分类 / 文件名 | 上传者 | 提交时间 | 操作 |
|---|
⏳ 待审核注册(0)
| 用户名 | 申请时间 | 操作 |
|---|
显示名只影响前台展示,可随意用中文命名;文件夹名是图片目录名,也是外链 URL 的一部分
(/icons/<文件夹名>/<文件>)。文件夹名一旦发布就不再改动——改名会让一批外链同时失效,
所以这里只提供改显示名与排序;单个图标的别名 / 标签 / 删除请去「图标管理」。
前台顺序:用每行最左侧的 ↑ / ↓ 调整顺序,改完显示名和顺序后,点下方 保存全部 一次性生效(不影响外链)。
| 前台顺序 | 文件夹名(URL 用) | 显示名 | 图标数 |
|---|
别名是图标卡片文件名下方的浅色小字,只影响展示、不影响外链 URL。支持单个编辑别名 / 标签, 也可勾选多条后批量保存别名、批量编辑标签、批量删除(删除有二次确认弹窗,不可恢复,引用该图的外链将 404)。
| 选 | 分类 / 文件名 | 别名 | 标签 | 归属 |
|---|
🌐 公网访问及调用域名
填你给本站绑定的公网域名(要带协议,如 https://icons.example.com)。它会被用在:
图库预览里的「复制链接」、外部调用失败时提示图上的完整地址、后台「API 调用」里的示例地址。
留空则自动使用访问时的地址(内网 IP 就显示内网 IP)。
🛡️ 防盗链
这里的白名单只是规则,而「谁在引用这张图」只能靠 Referer 才能知道—— 所以 Referer 校验不能关,关了白名单就等于失效、任何人都能直接盗链。也请注意 Referer 可被伪造、 也可能被浏览器裁掉,它挡的是「随手盗链」,不是安全边界。
全局白名单 vs 个人白名单:全局白名单是站点级放行,任何来源命中都放行、不区分账号; 个人白名单是账号级授权,命中后调用量记到该账号、并受账号调用有效期约束。两者是「或」的关系, 所以全局名单越宽,个人白名单的意义越小。建议全局只放自己的主站/导航站,其余交给用户个人白名单。
🔒 私密图标 /private
私密图标走独立路径 /private/<文件>(与 /icons 并列),只有超级管理员登录后才会在图库分组中出现。
外部调用只认这份独立白名单(与上面的防盗链白名单互不影响),且空 Referer 一律拒绝。
CDN 侧还需给 /private/* 配套缓存与边缘校验,操作流程见仓库 deploy/edgeone/PRIVATE-ROUTING.md。
⏳ 调用权限有效期
🔔 管理员通知 Webhook
留空则一条通知都不会发(服务启动日志会提示一次)。填好后点「发送测试通知」确认能收到;修改后记得点底部「保存全部设置」。 「站内信」事件外发的正文含发信人与留言内容,收到后到「站内信」页签回复用户。
📧 邮件发送(SMTP)
支持任意标准 SMTP 邮箱:QQ 邮箱 smtp.qq.com:465、163 邮箱 smtp.163.com:465、Gmail smtp.gmail.com:465、
腾讯企业邮 smtp.exmail.qq.com:465、腾讯云 SES smtp.qcloudmail.com:465 等。
多数个人邮箱需在邮箱设置里生成「授权码」作为 SMTP 密码;企业/服务商邮箱按其文档填发信地址与密码。
端口 465 为 SSL 加密(推荐);若服务商只给 587,请填 587(STARTTLS)。启用后用于站内信邮件提醒、重置密码等。
📊 Umami 网站统计(可选)
Umami 是开源、隐私友好的网站访问统计工具(可自托管,也可用官方云)。填入后会在图库、后台、宣传页自动注入统计脚本,
用于查看访问量、来源、热门图标等;两项都填才会生效,留空即关闭统计。原环境变量 UMAMI_URL /
UMAMI_SITE_ID 仍作兜底,此处保存后以后台值为准。
📄 页脚信息(图库底部悬浮栏)
站点名称、logo、版权与作者信息为固定内容,不提供修改入口;仅致谢与备案信息可编辑。
📝 操作日志
记录登录、注册、上传、删除、用户与设置变更等关键操作。最少保留 30 天(不可低于 30),可按需要延长。
注册审批
前台自助注册的账号默认为仅调用且不可登录,需在这里审核通过后才能使用(通过时按站点设置的默认时长赋予调用有效期)。
| 用户名 | 申请时间 | 操作 |
|---|
新建账号
角色:超级管理员 全部权限;上传+调用 可调用并管理图标;仅调用 只能读取/调用图标。所有登录用户都可以上传图标到已有分类——但是否要审核可按账号单独设置(默认需要审核,超级管理员账号免审)。
| 用户名 | 角色 | 上传审批 | 白名单上限 | 状态 | 调用有效期至 | 创建者 | 操作 |
|---|
操作日志
加载中…
| 时间 | 级别 | 操作者 | 操作 | 详情 | IP |
|---|
日志最少保留 30 天;保留天数与单文件大小上限在「站点设置 → 操作日志」中调整。
✉️ 发信给管理员
留言会自动通过管理员通知 Webhook 推送到外部渠道;管理员回复后,可在下方「我的来信」中查看。
📥 用户来信
| 状态 | 来自 | 内容 | 时间 | 操作 |
|---|
📨 我的消息(系统通知 / 管理员回复)
暂无消息,需要帮助就在上方给管理员留言。
📤 发件箱(系统自动通知留档)
注册欢迎、审核结果、权限变更等系统通知会在此留存一份,与用户收到的是同一条记录。
| 类型 | 收件人 | 内容 | 时间 |
|---|
curl "…/api/icons.json"
…/icons/<分类>/<文件>
加载中…
curl -X POST "…/api/uploads" -H "Authorization: Bearer <TOKEN>" …
你的账号是仅调用权限:图标列表与直链读取本身是公开的,不需要 Token; Token 只在程序化写入(上传图标)时才有意义。需要上传请联系管理员开通。
我的头像
支持 PNG / JPG / WebP / GIF,≤ 2MB。
修改密码
我的防盗链白名单
把你导航页所在的域名加进来,这些网站就能引用本站图标(图床外链)。支持:
example.com(含子域)、*.example.com(一级子域)、
*.*.example.com(二级子域)、公网 IP(如 115.1.1.1)。每行一条。
如果只需要局域网访问,也请填写你的公网 IP(无需端口)——防盗链按 Referer 的主机判断,填公网 IP 即可放行来自该网络的调用。
这是账号级白名单,与站点设置里的全局白名单同时生效(命中任一即放行,调用量记到你名下)。
支持一次添加多条:一行一条,或用逗号 / 分号 / 空格分隔,系统会自动去重并在上限内添加。
已用 0 / 5 条(上限由管理员调整)
🔔 我的通知 Webhook
设置你自己的通知渠道(企业微信/飞书/钉钉机器人等)。当你收到站内信通知——如注册欢迎、图标审核结果(含拒绝原因)、 权限变更、调用有效期变更等——系统会把通知同时 POST 一份到这里。留空则只发站内信、不推送。 格式兼容企业微信机器人 text 消息。
✨ 猜你喜欢 · 推荐流
开启后进入图库默认展示「猜你喜欢」:根据全站调用热度、你的浏览 / 复制 / 下载记录动态推荐约一屏图标, 每天都会有一点新面孔,不用每次都从全部图标里找。关闭后图库默认回到「全部」。
👀 访客能做什么
- 浏览全部分类和图标、使用中文/模糊搜索。
- 点开图标只能下载原图——外链地址、复制链接对访客隐藏,图床调用仅对登录用户开放。
- 看不到「上传图标」按钮。
- 想用图床?点右上角「控制台」注册一个账号(默认仅调用权限,需管理员审核通过)。
🖼️ 上传图标(需「上传+调用」权限)
- 仅调用账号没有上传权限:图库右上角「上传图标」打开后会提示「该账号暂无上传权限」,需要管理员在「用户管理」把角色改为「上传+调用」。
- 有上传权限时:图库右上角「上传图标」→ 选一个已有分类 → 点击/拖拽图片(可多选,单个 ≤ 5MB,一次 ≤ 50 个)→ 在文件列表中逐张填写别名(选填)。
- 重名文件自动加序号(如
logo-1.png);若管理员给你的账号开启了上传审核,上传会先提交到待审队列,审核通过后才出现在图库(看板里能看到「我的待审图标」数量)。 - 归属管理:你上传的图标在预览里有「编辑别名」和「删除」按钮,管理员也可以编辑/删除;分类与标签管理仍是管理员专属。
- 自定义头像:个人设置 → 我的头像,支持 PNG/JPG/WebP/GIF(≤2MB)。
🔗 图床外链(核心用法)
- 登录后点开任意图标即可看到外链地址
/icons/<分类>/<文件>,复制到你的导航页。 - 在「个人设置 → 我的防盗链白名单」加入你导航页的域名/IP(支持
*.example.com、*.*.example.com泛域名),白名单匹配的网站才能加载图片。 - 调用有效期:账号的图床调用权限有有效期(默认一年,站点设置里可改默认值)。到期后你的白名单外链会 403,在「个人设置/看板」可以看到到期时间,联系管理员续期即可。
⚙️ 个人设置
- 修改密码(需旧密码)。
- 维护白名单(默认 5 条上限,管理员可调)。
- 「看板」可查看全站数据与你的个人数据(上传数、调用量、白名单、有效期)。
🚀 快速起步
- 首次部署后用默认账号登录:
admin / iconsplus(登录后立即在「用户管理」改密码)。 - 在「站点设置 → 公网访问及调用域名」填上你的公网域名(如
https://icons.example.com), 复制出来的外链、调用失败提示图里的地址才会是正确的。 - 在「站点设置」配置:防盗链、调用有效期默认时长、管理员通知 Webhook、Umami 统计、页脚信息(致谢/ICP 备案/公安网安备案;站点名称、logo、版权与作者已固定不可改)。
- 在「用户管理」给家人/朋友建账号或审批注册申请;「分类管理」改显示名与排序;「标签管理」维护标签与排序;「图标管理」批量改别名/标签或删除图标。
- 往
icons/下丢图标即可(文件夹名就是分类),前台自动出现。
🗂️ 分类管理
- 改显示名:只改前台展示的文字,不影响外链,随时可改。
- 文件夹名不再支持重命名:它是外链 URL 的一部分,改名会让一批已发布链接同时 404。
确需换目录名,请在宿主机
icons/下新建目录、把文件移过去,再通知使用者更新引用。 - 单个图标的别名 / 标签 / 删除在「图标管理」页操作,删除不可恢复。
- 也可以直接在宿主机
icons/目录增删文件,服务自动识别(缩略图自动对账)。
✅ 上传审核(按账号)
- 「用户管理」表格里每个账号都有上传审批下拉:需要审核(默认)/ 直接进图库。超级管理员账号始终免审。
- 需要审核的账号上传后,文件先进入暂存区(
data/pending-uploads/),图库看不到、也没外链; 在「看板 → 待审核图标」里可预览、通过或拒绝。 - 通过后文件才写入
icons/<分类>/,同时记录归属、生成默认别名与缩略图;拒绝则直接删除。 - 待审队列上限 300 个,避免有人反复上传把磁盘塞满。
✉️ 站内信(联系管理员)
- 控制台 →「站内信」页签给管理员留言(最多 1000 字),消息会自动通过管理员通知 Webhook 推送到外部渠道。
- 管理员在同一个页签的「用户来信」里直接回复;你发过的消息与回复都留在「我的来信」里,随时查看。
🌐 公网访问及调用域名
- 「站点设置」里的公网域名用于拼完整外链地址:图库预览的「复制链接」、后台「API 调用」示例、 以及外部调用 404 时提示图上的 URL。
- 留空则退回浏览器当前访问地址——内网 IP 部署时复制出来就是内网地址,所以正式对外用建议填上。
🏷️ 图标别名与标签
- 图库卡片上:文件名会去掉
.png/.jpg等扩展名显示,下面一行浅色小字是别名。 - 存量图标首次启动会自动生成默认别名(写入
data/iconmeta.json);别名只是展示,不影响外链 URL。 - 「图标管理」页可按分类/关键词筛选,勾选多条后批量保存别名、批量编辑标签或批量删除(删除有二次确认弹窗);单个图标也可在图库预览里点「编辑别名 / 编辑标签」。
- 普通用户只能编辑自己上传图标的别名与标签,超级管理员可编辑全部。
- 「标签管理」支持 ↑ / ↓ 自定义前台顺序,与分类排序同款交互。
📊 Umami 网站统计
- Umami 是开源、隐私友好的网站访问统计工具,可自托管也可用官方云(
cloud.umami.is);用来看访问量、来源、热门图标等,不收集个人敏感信息。 - 在 Umami 里添加网站拿到 Website ID,再到「站点设置 → Umami 网站统计」填 服务地址(如
https://cloud.umami.is,不要带/script.js)与 网站 ID,两项齐全后保存即生效。 - 脚本以
<script defer src="…/script.js" data-website-id="…">注入图库、后台与宣传页;留空任一字段即关闭统计。环境变量UMAMI_URL/UMAMI_SITE_ID作为未配置时的兜底。
🔔 管理员通知 Webhook
- 「站点设置」里填一个 webhook 地址(如企业微信/钉钉/自建通知机器人),保存后点「发送测试通知」验证。
- 收到通知的事件:用户注册申请(
register.request)、注册通过(register.approved)、图标直传(icon.upload)、待审提交(icon.pending)、审核通过(icon.approved)。POST JSON,含event/username/category等字段。 - 收不到通知先看这里:地址是否留空(留空 = 完全不发)、修改后是否点了「保存全部设置」、测试通知是否成功。服务启动日志里出现「adminWebhook 未配置」就说明地址是空的。
⏳ 调用权限有效期
- 「站点设置」里设默认时长(天),注册审核通过、新建账号时按此赋予。
- 「用户管理」表格里每个账号可单独修改有效期(输天数从今天起算,或输具体日期,或填 clear 取消限制)。
- 到期账号的白名单外链立即 403(看板「已绑定的白名单域名」会标注有效期);登录、浏览、上传不受影响。
☁️ EdgeOne CDN 配置指引
- ① 边缘函数触发规则:EdgeOne 控制台 → 边缘函数 → 打开防盗链函数 → 触发规则:域名
iconsplus.325hub.top,路径三条/icons/*、/thumbs/*、/private/*(if 条件到上限就新开一条规则,HOST 条件保留),改完「保存并发布」。 - ② 缓存规则:规则引擎 → 新建规则:Host = 图库域名 且 URL path 正则匹配
^/(icons|thumbs)/→ 节点缓存 TTL 30 天 + 强制缓存、浏览器缓存 30 天(文件名带内容 hash,可放心长缓存)。 - ③ 私密图标不要配边缘缓存:实测强制缓存会把私密图按 URL 缓存,命中缓存后 Referer 校验被绕过(任何人拿到 URL 都能看到)。私密图保持「不缓存 / 每次回源」,由源站守卫校验;私密图数量少、流量小,回源开销可忽略。如果之前配过
^/private/的缓存规则,请删除并在「缓存刷新」里清掉对应 URL。 - ④ 私密白名单:「站点设置 → 🔒 私密图标」填允许调用的域名后缀(与边缘函数里的
PRIVATE_SUFFIXES保持一致,两处都要改)。 - 验证:白名单页面
<img>引用图标,刷新几次后响应头EO-Cache-Status出现HIT即缓存生效;空 Referer / 非白名单域名请求/private/*应为 403。
展开查看完整代码(173 行,勿直接在此编辑)
/**
* icons+ · EdgeOne 边缘防盗链函数(Edge Functions)
* ------------------------------------------------------------------
* 作用:在 EdgeOne 边缘节点校验 Referer,盗链请求直接返回「品牌化 SVG 图」,
* 正常请求才回源/命中缓存。这样即使图片已被缓存,盗链也拿不到真图。
*
* 为什么必须用边缘函数:规则引擎的「HTTP 应答」只能返回 html/json/plain/xml
* 且 body ≤ 2KB,无法吐出 image/svg+xml 图片;边缘函数可返回任意 Content-Type。
*
* 部署位置:EdgeOne 控制台 → 站点 325better.cn / 325hub.top → 边缘函数 →
* 打开已有函数 → 全量替换为本文件内容 → 部署 → 配置触发规则:
* 域名:iconsplus.325hub.top
* 路径:/icons/* 与 /thumbs/* 与 /private/* (三条)
* 最后「保存并发布」。
*
* 维护:普通 Referer 白名单改 ALLOW_SUFFIXES;
* 私密图标白名单改 PRIVATE_SUFFIXES(两边各管各的,后缀匹配)。
*/
'use strict';
// ── 普通图片防盗链(/icons/* 与 /thumbs/*)──────────────────────────
// 允许引用的 Referer 域名后缀(后缀匹配:325hub.top 同时覆盖 iconsplus. 和 www.)
// 若以后又启用老域名引用,把 '325better.cn' 加进数组即可。
const ALLOW_SUFFIXES = ['325hub.top'];
// 空 Referer 是否放行(与应用 .env 的 HOTLINK_ALLOW_EMPTY_REFERER=true 保持一致)
// 说明:浏览器地址栏直接打开图片、部分隐私场景不会带 Referer,放行以免误伤。
const ALLOW_EMPTY_REFERER = true;
// ── 私密图标防盗链(/private/*,比普通防盗链严格)────────────────────
// 独立白名单:只有这些后缀的页面可以 <img> 引用私密图标。
// 注意两点:
// 1. 必须包含站点自身域名 '325hub.top',否则超管在图库里的预览也会被边缘拦截;
// 2. 这份名单与「站点设置 → 🔒 私密图标」的源站白名单相互独立,
// 在应用里加减域名后,这里要同步改一次并重新发布。
// 空 Referer 一律拒绝(与源站 privateGuard 行为一致:地址栏直开也拿不到)。
const PRIVATE_SUFFIXES = ['325hub.top'];
// 品牌图文案(与服务端 errorPage.js 的 403 图保持同一视觉)
const BADGE = '403';
const SITE = 'icons+';
const TITLE = '图片禁止盗链';
const SUBTITLE = '该图片仅允许在 icons+ 站内显示';
const PRIVATE_TITLE = '私密图标禁止访问';
const PRIVATE_SUBTITLE = '该资源仅限白名单域名调用';
const FONT = "system-ui, -apple-system, 'Segoe UI', Roboto, 'PingFang SC', 'Microsoft YaHei', sans-serif";
const MONO = "ui-monospace, SFMono-Regular, Menlo, Consolas, 'Courier New', monospace";
function esc(s) {
return String(s == null ? '' : s).replace(/[&<>"']/g, (c) => ({
'&': '&', '<': '<', '>': '>', '"': '"', "'": '''
})[c]);
}
function clampText(s, max) {
const str = String(s || '');
return str.length > max ? str.slice(0, max - 1) + '…' : str;
}
/** 生成品牌化 403 SVG(被拒图片地址会显示在图里,方便对方排查) */
function brandSvg(reqUrl, title, subtitle) {
const url = esc(clampText(reqUrl, 76));
return `<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="800" height="440" viewBox="0 0 800 440" role="img" aria-label="${esc(title)}">
<defs>
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#fbfaff"/>
<stop offset="1" stop-color="#eef0ff"/>
</linearGradient>
<linearGradient id="mark" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#6d5efc"/>
<stop offset="1" stop-color="#4f46e5"/>
</linearGradient>
</defs>
<rect width="800" height="440" fill="url(#bg)"/>
<rect width="800" height="4" fill="url(#mark)"/>
<circle cx="742" cy="52" r="86" fill="#4f46e5" opacity="0.045"/>
<circle cx="58" cy="404" r="104" fill="#4f46e5" opacity="0.035"/>
<text x="748" y="58" text-anchor="end" font-family="${MONO}" font-size="13" letter-spacing="3" fill="#b7b4cd">${esc(BADGE)}</text>
<g>
<rect x="362" y="64" width="76" height="76" rx="17" fill="url(#mark)"/>
<path d="M400 85v34M383 102h34" stroke="#ffffff" stroke-width="8.3" stroke-linecap="round"/>
</g>
<text x="400" y="184" text-anchor="middle" font-family="${FONT}" font-size="19" font-weight="700" letter-spacing="0.6" fill="#4a3fd6">${esc(SITE)}</text>
<text x="400" y="252" text-anchor="middle" font-family="${FONT}" font-size="30" font-weight="700" fill="#1b1b2b">${esc(title)}</text>
<rect x="80" y="286" width="640" height="48" rx="12" fill="#ffffff" stroke="#e4e1f5" stroke-width="1"/>
<text x="400" y="316" text-anchor="middle" font-family="${MONO}" font-size="13" fill="#565374">${url}</text>
<text x="400" y="372" text-anchor="middle" font-family="${FONT}" font-size="13" fill="#8b88a3">${esc(subtitle)}</text>
</svg>
`;
}
/** 后缀匹配白名单:host === s 或 host 以 .s 结尾 */
function suffixAllowed(host, list) {
host = (host || '').toLowerCase();
return list.some((s) => host === s || host.endsWith('.' + s));
}
/** Referer 白名单判断:后缀匹配,空 Referer 按配置放行(普通图片用) */
function refererAllowed(ref) {
if (!ref) return ALLOW_EMPTY_REFERER;
let host;
try {
host = new URL(ref).hostname.toLowerCase();
} catch (_) {
return false; // 畸形 Referer 一律拒绝
}
return suffixAllowed(host, ALLOW_SUFFIXES);
}
/** 是否私密图标路径 */
function isPrivatePath(url) {
return url.pathname.startsWith('/private/');
}
/** 私密路径校验:空 Referer / 畸形 Referer / 白名单外 → 一律 403 */
function privateDenied(request, url) {
const ref = request.headers.get('Referer') || '';
let refHost = '';
try {
refHost = new URL(ref).hostname.toLowerCase();
} catch (_) { /* 空 host 会被 suffixAllowed 拒绝 */ }
return !suffixAllowed(refHost, PRIVATE_SUFFIXES);
}
async function handleRequest(request) {
const u = new URL(request.url);
// 私密图标 /private/*:严格模式,优先于普通防盗链判断
if (isPrivatePath(u)) {
if (privateDenied(request, u)) {
return new Response(brandSvg(u.origin + u.pathname, PRIVATE_TITLE, PRIVATE_SUBTITLE), {
status: 403,
headers: {
'Content-Type': 'image/svg+xml; charset=UTF-8',
'Cache-Control': 'no-store',
'X-Content-Type-Options': 'nosniff'
}
});
}
// 白名单内:正常回源,/private/* 的自定义 Cache TTL 规则照常生效
return fetch(request);
}
// 普通图片 /icons/* /thumbs/*:原有防盗链逻辑
if (!refererAllowed(request.headers.get('Referer'))) {
return new Response(brandSvg(u.origin + u.pathname, TITLE, SUBTITLE), {
status: 403,
headers: {
'Content-Type': 'image/svg+xml; charset=UTF-8',
'Cache-Control': 'no-store',
'X-Content-Type-Options': 'nosniff'
}
});
}
// 白名单内:正常回源,EdgeOne 的 30 天图片缓存规则照常生效
return fetch(request);
}
addEventListener('fetch', (event) => {
// 函数异常时自动回源,避免图床整体不可用
event.passThroughOnException();
event.respondWith(handleRequest(event.request));
});
⚠️ 注意事项
- 持久化:
icons/(图库)、private/(私密图标)与data/(账号、设置、白名单、调用量统计、待审核图标暂存)都要挂载/备份。 - 删除图片、拒绝上传、到期停权都不可自动恢复,重要数据定期备份。