# bzdh

**Repository Path**: king_nd/bzdh

## Basic Information

- **Project Name**: bzdh
- **Description**: 白泽导航
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-02
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <h1>🌌 白泽导航系统</h1>
  <p>Baize Navigation System</p>
  
  <p>
    <a href="#">
      <img src="https://img.shields.io/badge/Node.js-18+-339933?style=flat-square&logo=nodedotjs&logoColor=white" alt="Node.js" />
    </a>
    <a href="#">
      <img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker" />
    </a>
    <a href="#">
      <img src="https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat-square&logo=mysql&logoColor=white" alt="MySQL" />
    </a>
    <a href="#">
      <img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License" />
    </a>
  </p>
  
  <p>
    <strong>一个极简主义、赛博朋克风格的个人导航与书签管理系统</strong>
  </p>
</div>

---

## 📖 项目简介

**白泽导航 (Baize Navigation)** 是一个轻量级的个人导航系统，旨在帮助用户高效管理常用网站和工具。它采用独特的赛博朋克/科幻风格 UI 设计，结合 3D 粒子背景动画，提供沉浸式的视觉体验。

不仅外观酷炫，更提供了强大的后台管理功能，支持分类管理、站点增删改查、状态监控等实用特性。

## ✨ 核心特性

| 功能模块 | 描述 |
| :--- | :--- |
| **🎨 极致 UI** | 赛博朋克风格设计，配合 Three.js 打造的 3D 粒子动态背景，科技感十足。 |
| **📱 响应式布局** | 完美适配桌面端与移动端，随时随地访问您的导航。 |
| **🛠️ 后台管理** | 内置功能完善的后台管理系统，支持可视化管理站点链接与分类。 |
| **🔒 安全可靠** | 支持管理员登录认证，保障后台数据安全。 |
| **🔍 搜索过滤** | 前台支持实时筛选，后台支持多条件搜索，快速定位目标站点。 |
| **🐳 容器化部署** | 提供 Docker Compose 一键部署方案，内置数据库与自动备份策略。 |

## 🚀 快速开始

### 方式一：Docker 一键部署（推荐）

无需安装 Node.js 和 MySQL 环境，仅需 Docker 即可运行。

```bash
# 1. 拉取代码
git clone <your-repo-url>
cd nav-system

# 2. 启动服务
docker-compose up -d

# 3. 访问系统
# 前台首页: http://localhost:3002
# 后台管理: http://localhost:3002/admin.html
```

### 方式二：本地开发运行

<details>
<summary>点击展开详细步骤</summary>

1. **环境要求**
   - Node.js (v14+)
   - MySQL (v5.7+)

2. **安装依赖**
   ```bash
   npm install
   ```

3. **配置环境**
   复制 `.env.example` 为 `.env` 并填入数据库信息：
   ```ini
   DB_HOST=localhost
   DB_USER=root
   DB_PASSWORD=your_password
   ...
   ```

4. **启动服务**
   ```bash
   npm start
   ```
</details>

## 📂 目录结构

```
nav-system/
├── 📂 public/           # 前端静态资源 (HTML, CSS, JS)
├── 📂 docs/             # 项目文档 (部署、开发指南)
├── 📂 scripts/          # 运维脚本
├── server.js            # 后端服务入口 (Express)
├── db.js                # 数据库连接配置
└── ...
```

## 🔗 文档链接

- [部署文档 (Deployment Guide)](./docs/DEPLOYMENT.md)
- [开发文档 (Development Guide)](./docs/DEVELOPMENT.md)

## 📄 许可证

本项目采用 MIT 许可证开源。