防失联页插件 (AntiLossPage)

作者: kuakeba.cn

版本: 1.0.0

路径: /antiloss

📖 插件简介

防失联页插件为你的站点提供一套独立运行的精美失联页面。当主站因不可抗力（被墙、服务器故障、域名解析异常等）暂时无法访问时，用户可以通过固定路径 /antiloss 访问到防失联页面，及时获取备用域名、联系方式、公告信息等，避免用户流失。

✨ 核心特性

• 独立运行 — 不依赖主站任何模块，即使主站 PHP 挂了也能通过静态方式访问（需配合 Nginx/Apache 单独配置）
• 4套精美模板 — 极简纯净、渐变科技、暗夜模式、卡片画廊，一键切换
• 丰富联系方式 — 备用域名、QQ群、微信、Telegram、Discord、邮箱
• 响应式设计 — PC/手机/iPad 完美适配
• SEO 友好 — 纯静态 HTML 输出，加载极速
• 智能链接生成 — QQ群自动生成 qm.qq.com 加群链接，Telegram/Discord 自动补全前缀

🚀 安装与启用

1. 进入后台 → 插件管理 → 找到「防失联页」→ 点击安装
2. 安装完成后，在插件列表点击「防失联页」进入配置页
3. 启用防失联页 开关默认已打开
4. 访问 /antiloss 即可查看效果

前台访问路径

🎨 模板预览

模板1：极简纯净 (minimal)

• 白底卡片 + 浅灰渐变背景
• 紫色渐变域名按钮，悬停右移动效
• 双列联系信息网格
• 适合：正式站点、企业官网

模板2：渐变科技 (gradient)

• 紫蓝渐变背景 + 动态漂浮光斑
• 毛玻璃 (backdrop-filter) 卡片
• 状态指示呼吸灯动效
• 适合：科技博客、技术社区

模板3：暗夜模式 (dark)

• 深色网格背景 + 紫色光晕
• 红色心跳状态图标 (heartbeat 动效)
• 冷色调卡片边框
• 适合：深夜党、程序员社区

模板4：卡片画廊 (card)

• 粉红渐变 Hero 区 + 旋转光效
• 圆角白色卡片 + 悬浮上移动效
• 品牌色联系图标
• 适合：年轻向站点、娱乐社区

⚙️ 配置项说明

基本设置

站点信息

公告内容

联系方式

所有联系方式留空则不显示，填什么显示什么：

底部设置

💡 实用技巧

1. 将防失联页设为紧急入口

在 Nginx 中单独配置一个紧急入口，即使 PHP 挂了也能访问：

# 防失联页紧急入口（PHP 挂了也能用）
location ~* /emergency {
    root /path/to/zsadmin/plugins/AntiLossPage/standalone;
    try_files /antiloss.html =404;
}

2. 配合 Cloudflare 离线缓存

将 /antiloss 路径加入 Cloudflare 离线缓存，主站挂了用户依然能看到页面：

1. Cloudflare → Caching → Configuration → Offline Cache
2. 开启 "Enable offline cache"
3. 添加自定义规则：Cache Level: Cache Everything for yourdomain.com/antiloss

3. 域名解析兜底

注册 2-3 个备用域名，都指向同一个服务器 IP，在防失联页的「备用域名」中列出，主域名被墙时用户可以换备用域名访问。

4. SEO 友好

防失联页本身就是独立页面，搜索引擎正常收录。建议在主站 header 中加入：

<link rel="alternate" hreflang="zh-CN" href="https://yourdomain.com/antiloss">

📂 文件结构

AntiLossPage/
├── plugin.json                    # 插件元数据
├── AntiLossPagePlugin.php         # 插件主类
├── routes.php                     # 前后台路由
├── icon.svg                       # 插件图标（64×64 圆角渐变）
├── 使用说明.md                     # 本文档
├── controller/
│   ├── admin/
│   │   ├── Base.php              # 后台控制器基类
│   │   └── Config.php            # 后台配置控制器
│   └── front/
│       └── Index.php             # 前台展示控制器
└── view/
    ├── admin/
    │   └── config.html           # 后台配置页面
    └── front/
        ├── minimal.html          # 模板1：极简纯净
        ├── gradient.html         # 模板2：渐变科技
        ├── dark.html             # 模板3：暗夜模式
        └── card.html             # 模板4：卡片画廊

📝 更新日志

v1.0.0 (2026-10-27)

• 首个版本发布
• 提供 4 套精美模板
• 支持后台可视化配置
• 智能联系信息链接生成
• 响应式设计

🛡️ 安全提示

• 防失联页不收集任何用户信息，纯展示用途
• 所有联系方式在后台配置页录入，建议定期检查更新
• 如果站点被墙，请第一时间通过服务器面板更新防失联页中的备用域名和联系方式

© 2026 kuakeba.cn · All Rights Reserved.