# beike

**Repository Path**: dtzhuwen/beike

## Basic Information

- **Project Name**: beike
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: ISC
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 集体备课网址发布系统

<p align="center">
  <img src="https://img.shields.io/badge/Node.js-18+-green.svg" alt="Node.js">
  <img src="https://img.shields.io/badge/Express-5.x-blue.svg" alt="Express">
  <img src="https://img.shields.io/badge/License-ISC-yellow.svg" alt="License">
</p>

<p align="center">
  <b>安全、便捷的集体备课地址发布平台</b>
</p>

---

## ✨ 功能特性

### 🔐 安全访问控制
- **🌐 IP 白名单机制**
  - 支持精确 IP 地址：`192.168.1.100`
  - 支持 CIDR 网段：`192.168.1.0/24`
  - 支持通配符格式：`192.168.1.*`

- **🔑 动态密码验证**
  - 基于当前日期时间生成
  - 格式：`YYMMDDHHMM`（年月日时分）
  - 每分钟自动更新，安全可靠

### 📝 内容发布管理
- **📢 安全发布页面** - 密码验证后可发布新地址
- **🖥️ 实时展示页面** - 展示最新地址和发布时间
- **📊 发布历史记录** - 自动记录到日志文件

### ⚙️ 系统管理
- **📋 IP 白名单管理** - 可视化添加/删除 IP
- **📈 访问日志查看** - 记录所有访问请求
- **📱 响应式设计** - 完美适配桌面和移动设备

---

## 🚀 快速开始

### 1️⃣ 安装依赖
```bash
npm install
```

### 2️⃣ 启动服务
```bash
node index.js
```

### 3️⃣ 访问系统
- 🌐 **展示页**：http://localhost:3000
- 🔐 **发布页**：http://localhost:3000/publish

---

## 📖 页面说明

| 页面 | 地址 | 功能 | 访问权限 |
|------|------|------|----------|
| 🏠 展示页 | `/` | 查看最新集体备课地址 | IP 白名单 |
| 📝 发布页 | `/publish` | 发布新的备课地址 | IP 白名单 + 动态密码 |
| ⚙️ 白名单管理 | `/whitelist` | 管理 IP 白名单 | IP 白名单 + 动态密码 |
| 📊 日志查看 | `/logs` | 查看访问日志 | IP 白名单 + 动态密码 |

---

## 🔧 动态密码说明

动态密码基于当前系统时间生成，格式为：**YYMMDDHHMM**

| 时间 | 密码示例 | 说明 |
|------|----------|------|
| 2025年3月15日 14:30 | `2503151430` | 年月日时分 |
| 2025年3月15日 14:31 | `2503151431` | 每分钟更新 |

> 💡 **提示**：密码每分钟变化，请使用当前时间的密码进行验证

---

## 🛡️ IP 白名单格式

支持三种格式的 IP 地址配置：

| 格式 | 示例 | 允许的 IP 范围 |
|------|------|----------------|
| 📍 精确 IP | `192.168.1.100` | 仅该 IP |
| 🌐 CIDR 网段 | `192.168.1.0/24` | 192.168.1.0 - 192.168.1.255 |
| ⭐ 通配符 | `192.168.1.*` | 192.168.1.0 - 192.168.1.255 |

---

## 📁 项目结构

```
jitibeikefabu/
├── 📄 index.js              # 主应用文件
├── 📦 package.json          # 项目依赖配置
├── ⚙️  config.json           # 系统配置文件
├── 📂 logs/                 # 日志目录
│   └── log_YYYY_MM_DD.txt  # 每日访问日志
├── 📖 README.md             # 本文件
├── 🚀 DEPLOY.md             # 部署文档
└── 🏃 RUN.md                # 运行文档
```

---

## 💻 技术栈

<p align="center">
  <img src="https://img.shields.io/badge/Backend-Node.js+Express-339933?style=for-the-badge&logo=node.js" alt="Backend">
  <img src="https://img.shields.io/badge/Frontend-HTML+CSS+JS-E34F26?style=for-the-badge&logo=html5" alt="Frontend">
  <img src="https://img.shields.io/badge/Storage-JSON+Text-000000?style=for-the-badge" alt="Storage">
</p>

- **后端框架**：Node.js + Express 5.x
- **前端技术**：原生 HTML + CSS + JavaScript
- **数据存储**：JSON 配置文件 + 文本日志文件

---

## 🎯 使用场景

- ✅ 学校内部集体备课地址发布
- ✅ 企业内部会议链接分享
- ✅ 需要 IP 限制和简单密码验证的信息发布场景

---

## 📋 系统要求

| 项目 | 要求 |
|------|------|
| Node.js | 18.x 或更高版本 |
| 操作系统 | Windows / Linux / macOS |
| 内存 | 最低 128MB |
| 磁盘空间 | 最低 50MB |

---

## 📚 详细文档

- 📖 **[DEPLOY.md](DEPLOY.md)** - 部署指南（含 Nginx、PM2 配置）
- 🏃 **[RUN.md](RUN.md)** - 运行文档（含故障排查）

---

## 🔒 安全特性

1. **多层访问控制**
   - 🌐 网络层：IP 白名单限制
   - 🔑 应用层：动态密码验证

2. **数据保护**
   - 💾 配置文件本地存储
   - 📁 日志文件按日期归档
   - 🛡️ 无数据库存储，降低攻击面

3. **安全传输**
   - 🔒 支持 HTTPS 部署（通过 Nginx 反向代理）
   - ⚠️ 建议生产环境启用 SSL

---

## 📄 许可证

本项目采用 [ISC License](LICENSE) 开源许可证

---

<p align="center">
  <b>⭐ 如果这个项目对您有帮助，欢迎点个 Star ⭐</b>
</p>