# blog-xianyu

**Repository Path**: bule-lin/blog-xianyu

## Basic Information

- **Project Name**: blog-xianyu
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-19
- **Last Updated**: 2025-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自用博客 Ver 0.01

这是一个基于 Node.js 和 Vue.js 构建的个人博客系统。

## ✨ 项目特点

- **单一超级用户**: 整个系统围绕一个超级用户进行设计，确保了管理上的简洁与安全。
- **首次运行安全设置**: 首次部署时，系统会强制要求注册超级用户，杜绝了无主应用状态。
- **Markdown 原生支持**: 直接使用 Markdown 语法撰写和编辑文章，集成了功能丰富的编辑器。
- **实时 UI 自定义**:
    - **颜色与滤镜**: 自由选择网站的背景滤镜颜色及其不透明度。
    - **毛玻璃效果**: 通过滑块实时调节背景和文章卡片的模糊程度，打造个性化视觉效果。
    - **深色模式**: 一键切换浅色与深色主题，适应不同阅读环境。
- **灵活的背景与图标**: 支持使用外部图床链接自定义网站背景和浏览器图标。
- **现代化技术栈**: 采用前后端分离架构，Vue.js 驱动的前端带来如丝般顺滑的交互体验。
- **安全优先**: 内置 JWT 用户认证、密码哈希加密等安全策略。

## 🚀 快速开始

### 1. 安装依赖

在项目根目录，运行相应的自动化安装脚本。脚本会自动为您安装后端和前端的所有依赖项。

- **Windows 用户**:
  ```bash
  install.bat
  ```
- **Linux / macOS 用户**:
  ```bash
  chmod +x install.sh
  ./install.sh
  ```

### 2. 启动项目

安装完成后，您有两种模式可以启动项目：

#### 方式一：生产模式 (推荐)

运行位于项目根目录的一键启动脚本。它会自动构建前端并以一体化模式启动服务器。

- **Windows 用户**:
  ```bash
  start-production.bat
  ```
- **Linux / macOS 用户**:
  ```bash
  chmod +x start-production.sh
  ./start-production.sh
  ```
> 整个博客系统将运行在 `http://localhost:3001`，并且不包含任何开发者工具。

#### 方式二：开发模式 (用于二次开发)

如果您需要进行二次开发，请打开 **两个** 终端窗口，分别运行以下命令：

- **启动后端服务**:
  ```bash
  cd backend
  npm start
  ```
- **启动前端开发服务器**:
  ```bash
  cd frontend
  npm run dev
  ```
> 前端应用将运行在 `http://localhost:5173` (或终端提示的其他端口)。

### 3. 开始使用

- 在浏览器中打开对应的地址。
- **首次运行**: 系统将引导您进入注册页面以创建您的超级用户账户。
- **日常使用**: 创建账户后，您将被引导至登录页面。登录后即可开始管理您的博客！