NewHome/GUIDE.md

SecHome · 安全屋 —— 操作指南

本指南面向站点使用者与管理员，按「前台日常使用」→「后台管理」→「安全运维」→「常见问题」组织。功能以当前版本为准，细节以页面实际为准。

一、前台日常使用

1. 首页与板块

• 首页是板块选择页：科普库 / 红队库 / 蓝队库 / 工具库，另含文章库入口
• 顶部组件由站长设置，可能是三种之一：天气、访客信息、空白精简
• 右下角「☾ / ☀」按钮切换昼夜主题；「↑」回到顶部

2. 库页面（科普 / 红队 / 蓝队）

每个库内分四个分区（Tab）：

• 导航区：常用链接区块，点卡片直达
• 内部功能区：本站自带工具，点击进入工具页；从本入口进入时左上角自动变为「返回上一页」
• 文章区：分发到该库的文章
• 外部工具区：推荐的外部站点/在线工具

页顶搜索条可切换搜索引擎后回车直接搜索。

3. 功能区工具（纯前端、隐私优先）

入口：首页「工具库」板块 → 完整功能区；或各库「内部功能区」。

工具	常见用法
编码 / 加解密	Base64 / Base32 / URL / Unicode 编解码，MD5 / SHA 摘要
随机密码生成	选字符集与长度，批量生成
二维码生成器	输入内容生成，可放大预览、下载 PNG
杀软识别	在 Windows 执行 tasklist 后粘贴输出，识别对应安全软件
IP 地址处理	粘贴日志/拖入文件，自动提取 IPv4 并按 /24 段聚合统计（内网/CDN/公网分类）；填“重点匹配 IP”可置顶标红；支持导出 TXT
辅助维权	反弹 Shell、凭证提取、持久化参考（仅供授权测试学习）
国密加解密	SM2 / SM3 / SM4（SM1 为不公开硬件算法，无法软件实现）

• 所有运算在浏览器本地完成，内容不上传服务器；可放心处理本地大文件
• 离线完全可用需在 assets/js/ 放入第三方库（见下文“常见问题”），否则在线自动回退 CDN

4. 文章库

• 左侧标题栏按分区展示，中间为当前文章段落目录，右侧为正文
• 顶部「☰ 标题栏 / ≡ 段落」按钮可开关左右栏
• 正文插图上传后自动插入 ![图片说明](data/articles/img/文件名.png) 引用

二、后台管理

入口：站点域名 /admin，登录后进入；顶栏依次为：

1. 导航管理（nav.php）

• 顶部切换当前要编辑的库（科普 / 红队 / 蓝队）
• 每个块可改标题、增删链接、拖拽排序；删除后有确认弹窗
• 批量导入：在导入面板粘贴文本，格式支持 名称 网址 或 名称 | 网址，自动拆分成导航块；解析后可核对再「保存全部修改」
• 操作结果以右下角 Toast 提示，且保持原滚动位置

2. 内部功能（tools.php）

• 添加工具：填写名称、图标（emoji）、简介、入口地址与展示库范围（未勾选=所有库通用）
  • 站内页面：填 codec.html 等相对地址（工具本体放在 func/）
  • 外部网站：填完整 https://... 并勾选“外链新窗口打开”
• 可启停、拖拽排序；停用后前台立即隐藏

3. 文章管理（articles.php）

• 分区、标题、摘要与 Markdown 正文；勾选「展示到库首页」决定分发到哪些库
• 上传图片：先选择 data/articles/img，上传成功后自动插入正文引用
• 支持置顶与排序；左侧可拖拽文章到不同分区

4. 外部工具（exttools.php）

• 维护各库推荐的外部站点：名称、网址、简介、分组（栏目）、展示范围（cat_keys）
• 保存后库首页「外部工具区」即时更新；同样支持批量导入

5. 网站管理（content.php）

集中站点配置：

• 站点信息：站名、口号、站长提示总开关
• 板块：四个库 + 文章库的名称、说明、图标与顺序
• 站点 logo：上传后全局生效（浏览器标签图标与各页面 logo 同步，含静态工具页）
• 名言库：编辑 data/quota.txt
• 底部信息：版权、ICP、公安备案等
• 首页顶部组件：天气（默认）/ 访客信息 / 空白精简
• 修改密码：建议首次登录即修改默认 admin/admin123

6. 风控管理（visits.php）—— 日志与安全

访问概况：累计访问 / 独立 IP / 今日访问 / 黑名单规则数。 访问记录：

• 完整模式逐条明细；精简模式按 IP 聚合（最近访问 / 次数）
• 支持 IP 模糊筛选、URL/方法关键词搜索、分页
• 筛选与翻页为页面内局部刷新（由 visits_data.php 查询），不会整页跳转、也不会跳回页面顶部
• 日志按行追加写于 data/vistors.log，无上限；可一键清空

登录信息：

• 顶部展示当前用户、本次登录时间 / 登录 IP / 登录设备（操作系统 / 手机型号 / 浏览器 / 屏幕等，能获取到什么就记录什么，由浏览器采集 + 服务端 UA 解析）
• 「历史登录记录」列出最近成功登录（时间 / IP / 设备 / 用户名）

登录失败日志：

• 按「IP × 日期」聚合：同一 IP 当天的失败次数、最近失败时间与设备信息
• 支持按 IP 模糊筛选（同样为页面内局部刷新）；可一键清空全部登录日志（含成功与失败，存于数据库 login_log 表）

自动风控规则（阈值到达即永久封禁）：

规则	默认	建议
后台登录失败	启用，阈值 10	5–20
前台 404	启用，阈值 100	50–300
请求频率（60 秒）	关闭	多人共享出口 IP 建议保持关闭

• 每条可独立启用/关闭并随时改阈值，保存即时生效
• 同一卡片下方可自定义“拦截提示”主文案与次行说明（留空=默认）

IP 黑名单：

• 支持三种写法：203.0.113.7、203.0.113.0/24、203.0.113.*
• 命中后前台与后台（含登录页）一律拒绝，统一显示风控提示页
• 行首勾选可「移除选中」，一键移除全部“风控自动”，或「清空全部」
• 自动封禁带“风控自动”徽标与原因备注；移除单 IP 时同步清除其风险计数
• 底部可查看当前访问 IP 的登录失败 / 404 / 本分钟请求计数

三、安全运维

• 改口令：登录后台 → 网站管理 → 修改密码（至少 6 位）
• 被自动风控误封：从其它未被封的网络登录后台移除对应规则；或直接编辑数据库 data/homepage.db 中 ip_blacklist 表删除该行（同表可删除“风控自动”记录）
• 备份与升级：站点数据集中在 data/（数据库、访问日志、上传、文章图片）。升级前备份整个 data/ 目录即可无损迁移
• 恢复出厂：删除 data/homepage.db，刷新后自动重建默认内容

四、常见问题（FAQ）

1. 登录提示“已被风控自动封禁，全站访问被拒绝”：说明该 IP 登录失败达阈值，已被自动封禁。请从未被封的网络登录后台，在「风控管理 → IP 黑名单」移除即可。
2. 想让某个 IP 永久无法访问：后台「风控管理」加入黑名单（单 IP / 网段 / 通配段均可），即刻全站生效。
3. 工具页图标不是自己的 logo：后台「网站管理」上传过 logo 后，强刷（Ctrl+F5）工具页即可同步；浏览器对旧图标有缓存，可多刷新一次。
4. 工具页想完全离线使用：把第三方库放入对应位置即可（在线未放时自动回退 CDN）：

   assets/js/qrcode.min.js            qrcodejs 1.0.0
   assets/js/crypto-js.min.js         crypto-js 4.2.0
   assets/js/sm-crypto/sm2.js|sm3.js|sm4.js   sm-crypto 0.3.13
   

5. 忘记后台密码：数据库 users 表密码为 md5(base64(明文))；可将某行改为已知口令的散列后登录，随后在后台重设。
6. 保存设置后提示去哪里了？ 后台操作提示统一显示为右下角 Toast（成功约 3.6 秒、失败约 6 秒自动消失），不会占用页面顶部。

---

更多项目背景见 README.md。