使用账号登录;不同角色可用功能不同。
| 用户 | 白名单条目 | 调用有效期至 |
|---|
开启了「上传需审批」的账号上传的图标会先落在这里:通过后才写入图库、生成外链;拒绝则直接删除文件。
| 分类 / 文件名 | 上传者 | 提交时间 | 操作 |
|---|
| 用户名 | 申请时间 | 操作 |
|---|
显示名只影响前台展示,可随意用中文命名;文件夹名是图片目录名,也是外链 URL 的一部分
(/icons/<文件夹名>/<文件>)。文件夹名一旦发布就不再改动——改名会让一批外链同时失效,
所以这里只提供改显示名与排序;单个图标的别名 / 标签 / 删除请去「图标管理」。
前台顺序:用每行最左侧的 ↑ / ↓ 调整,立即生效(不影响外链)。
| 前台顺序 | 文件夹名(URL 用) | 显示名 | 图标数 | 操作 |
|---|
别名是图标卡片文件名下方的浅色小字,只影响展示、不影响外链 URL。支持单个编辑别名 / 标签, 也可勾选多条后批量保存别名、批量编辑标签、批量删除(删除有二次确认弹窗,不可恢复,引用该图的外链将 404)。
| 选 | 分类 / 文件名 | 别名 | 标签 | 归属 |
|---|
标签用于图库的筛选与预览弹窗展示,每个图标最多 5 个。 系统已预置一批常用标签,你可以在下面新增自定义标签;删除预设标签等于停用(图标上的该标签会一并摘掉)。 图标具体挂哪些标签,在图库打开预览 →「编辑标签」里调整。
前台顺序:用每行最左侧的 ↑ / ↓ 调整,保存后前台筛选面板与标签编辑器都按这个顺序展示。
| 前台顺序 | 标签 | 类型 | 使用量 | 操作 |
|---|
填你给本站绑定的公网域名(要带协议,如 https://icons.example.com)。它会被用在:
图库预览里的「复制链接」、外部调用失败时提示图上的完整地址、后台「API 调用」里的示例地址。
留空则自动使用访问时的地址(内网 IP 就显示内网 IP)。
这里的白名单只是规则,而「谁在引用这张图」只能靠 Referer 才能知道—— 所以 Referer 校验不能关,关了白名单就等于失效、任何人都能直接盗链。也请注意 Referer 可被伪造、 也可能被浏览器裁掉,它挡的是「随手盗链」,不是安全边界。
全局白名单 vs 个人白名单:全局白名单是站点级放行,任何来源命中都放行、不区分账号; 个人白名单是账号级授权,命中后调用量记到该账号、并受账号调用有效期约束。两者是「或」的关系, 所以全局名单越宽,个人白名单的意义越小。建议全局只放自己的主站/导航站,其余交给用户个人白名单。
私密图标走独立路径 /private/<文件>(与 /icons 并列),只有超级管理员登录后才会在图库分组中出现。
外部调用只认这份独立白名单(与上面的防盗链白名单互不影响),且空 Referer 一律拒绝。
CDN 侧还需给 /private/* 配套缓存与边缘校验,操作流程见仓库 deploy/edgeone/PRIVATE-ROUTING.md。
留空则一条通知都不会发(服务启动日志会提示一次)。填好后点「发送测试通知」确认能收到;修改后记得点底部「保存全部设置」。 「站内信」事件外发的正文含发信人与留言内容,收到后到「站内信」页签回复用户。
Umami 是开源、隐私友好的网站访问统计工具(可自托管,也可用官方云)。填入后会在图库、后台、宣传页自动注入统计脚本,
用于查看访问量、来源、热门图标等;两项都填才会生效,留空即关闭统计。原环境变量 UMAMI_URL /
UMAMI_SITE_ID 仍作兜底,此处保存后以后台值为准。
站点名称、logo、版权与作者信息为固定内容,不提供修改入口;仅致谢与备案信息可编辑。
前台自助注册的账号默认为仅调用且不可登录,需在这里审核通过后才能使用(通过时按站点设置的默认时长赋予调用有效期)。
| 用户名 | 申请时间 | 操作 |
|---|
角色:超级管理员 全部权限;上传+调用 可调用并管理图标;仅调用 只能读取/调用图标。所有登录用户都可以上传图标到已有分类——但是否要审核可按账号单独设置(默认需要审核,超级管理员账号免审)。
| 用户名 | 角色 | 上传审批 | 状态 | 调用有效期至 | 创建者 | 操作 |
|---|
留言会自动通过管理员通知 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 地址。每行一条。
这是账号级白名单,与站点设置里的全局白名单同时生效(命中任一即放行,调用量记到你名下)。
已用 0 / 5 条(上限由管理员调整)
logo-1.png);若管理员给你的账号开启了上传审核,上传会先提交到待审队列,审核通过后才出现在图库(看板里能看到「我的待审图标」数量)。/icons/<分类>/<文件>,复制到你的导航页。*.example.com、*.*.example.com 泛域名),白名单匹配的网站才能加载图片。admin / iconsplus(登录后立即在「用户管理」改密码)。https://icons.example.com),
复制出来的外链、调用失败提示图里的地址才会是正确的。icons/ 下丢图标即可(文件夹名就是分类),前台自动出现。icons/ 下新建目录、把文件移过去,再通知使用者更新引用。icons/ 目录增删文件,服务自动识别(缩略图自动对账)。data/pending-uploads/),图库看不到、也没外链;
在「看板 → 待审核图标」里可预览、通过或拒绝。icons/<分类>/,同时记录归属、生成默认别名与缩略图;拒绝则直接删除。.png / .jpg 等扩展名显示,下面一行浅色小字是别名。data/iconmeta.json);别名只是展示,不影响外链 URL。cloud.umami.is);用来看访问量、来源、热门图标等,不收集个人敏感信息。https://cloud.umami.is,不要带 /script.js)与 网站 ID,两项齐全后保存即生效。<script defer src="…/script.js" data-website-id="…"> 注入图库、后台与宣传页;留空任一字段即关闭统计。环境变量 UMAMI_URL / UMAMI_SITE_ID 作为未配置时的兜底。register.request)、注册通过(register.approved)、图标直传(icon.upload)、待审提交(icon.pending)、审核通过(icon.approved)。POST JSON,含 event/username/category 等字段。iconsplus.325hub.top,路径三条 /icons/*、/thumbs/*、/private/*(if 条件到上限就新开一条规则,HOST 条件保留),改完「保存并发布」。^/(icons|thumbs)/ → 节点缓存 TTL 30 天 + 强制缓存、浏览器缓存 30 天(文件名带内容 hash,可放心长缓存)。^/private/ 的缓存规则,请删除并在「缓存刷新」里清掉对应 URL。PRIVATE_SUFFIXES 保持一致,两处都要改)。<img> 引用图标,刷新几次后响应头 EO-Cache-Status 出现 HIT 即缓存生效;空 Referer / 非白名单域名请求 /private/* 应为 403。/**
* 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/(账号、设置、白名单、调用量统计、待审核图标暂存)都要挂载/备份。