# NacrBBS轻量化论坛系统

**Repository Path**: wuaxcn/nacrbbs

## Basic Information

- **Project Name**: NacrBBS轻量化论坛系统
- **Description**: 采用前后端分离架构，后端：nodejs 前端nuxt3，界面好看，简介，轻量的一款全新的开源论坛系统
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 3
- **Created**: 2026-01-17
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nacr 轻量化论坛系统

<div align="center">

一款现代化、轻量级的开源社区论坛系统

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Node.js](https://img.shields.io/badge/Node.js-18%2B-brightgreen.svg)
![Vue](https://img.shields.io/badge/Vue-3.5%2B-42b883.svg)
![Nuxt](https://img.shields.io/badge/Nuxt-3.17%2B-00dc82.svg)




</div>

如果这个项目对你有帮助，请给个 ⭐️ Star 支持一下！


- gitee项目地址：[https://gitee.com/wuaxcn/nacrbbs](https://gitee.com/wuaxcn/nacrbbs)
- github项目地址：[https://github.com/nacrcn/nacrbbs](https://github.com/nacrcn/nacrbbs)
- 演示站：[https://bbs.nacr.cn/](https://bbs.nacr.cn/)
- QQ：21089086
- 微信：rsrx9595
- QQ群：893570125


因为是前后端分离架构，需要分别部署前端和后端服务，若您没有部署经验，可直接联系我帮忙搭建！

> 如果您有兴趣参与项目开发，欢迎联系我一起参与开发！若您有任何指点和改正意见，也欢迎提出！我们一起学习进步！


![赞赏](https://imgsbad.semoun.com/uploads/2026/01/17/696b433eb9417.jpg)
## 🤝 赞赏名单

感谢以下赞赏者对本项目的支持，你们的支持是我们持续更新的动力！

<div align="center">

| 头像 | 昵称 | 赞赏内容 | 赞赏时间 | 大佬网站 | 备注 |
|:----:|------|----------|----------|----------|------|
| <img src="https://imgsbad.semoun.com/uploads/2026/01/24/69743939be359.jpg" width="48" height="48" style="border-radius: 50%;"> | **欧内撒嘛** | 💰 20 元 | 2026-01-18 | - | |

</div>

> 📝 赞赏者列表持续更新中...  
> 💖 每一笔赞赏都是对我们最大的鼓励和支持！

---

## 📌 项目简介

Nacr 是采用前后端分离架构打造的全新轻量化论坛系统，界面简洁美观，性能卓越。基于 **Fastify + Nuxt3** 技术栈构建，提供完整的社区论坛解决方案，适用于个人博客、企业社区、技术论坛等多种场景。

### 核心特性

- 🎨 **现代化 UI** - 精美的界面设计，简洁清爽的用户体验
- ⚡ **高性能架构** - Fastify 驱动的后端 + Nuxt3 前端，极致性能
- 🔐 **完善的安全体系** - JWT 身份认证、权限管理、数据加密
- 💳 **支付系统** - 集成支付宝等多种支付方式
- 📊 **数据统计** - 丰富的后台数据可视化分析
- 📧 **邮件服务** - 完善的邮件通知和验证功能
- 🔄 **缓存优化** - Redis 缓存提升系统响应速度
- 📱 **响应式设计** - 完美适配 PC 和移动端

---

## 🎬 界面展示

### 前台论坛

![前台界面](https://imgsbad.semoun.com/uploads/2026/01/18/696c9ac53670e.png)

---


## 🛠️ 技术栈


| 技术 | 说明 | 技术 | 说明 |
|------|------|------|------|
| Node.js | 运行时环境 |Nuxt 3 | Vue 3 服务端渲染框架 |
| Fastify | 高性能 Web 框架 |Vue 3 | 前端框架 |
| MySQL | 关系型数据库 |Arco Design | UI 组件库 |
| Redis | 缓存数据库 |Pinia | 状态管理 |
| Socket.io | 实时通讯 |Monaco Editor | 代码编辑器 |
| Nodemailer | 邮件服务 |WangEditor | 富文本编辑器 |
| JWT | 身份认证 |ECharts | 数据可视化 |
| Axios | HTTP 请求 |



---

## 📦 快速开始

### 环境要求
- Node.js >= 18.0.0 | MySQL >= 5.7 | Redis >= 6.0 | npm >= 9.0.0

### 安装步骤

#### 1. 克隆项目

```bash
git clone https://github.com/nacrcn/nacrbbs.git
cd nacrbbs
```

#### 2. 安装依赖

```bash
# 后端依赖
npm install

# 前端依赖
cd web/client
npm install

cd ../admin
npm install
```

#### 3. 数据库配置

创建 MySQL 数据库并导入 `c_deft.sql` 文件：

配置数据库连接（修改 `app/config/database.json`）：

```json
{
  "host": "localhost",
  "port": 3306,
  "user": "root",
  "password": "your_password",
  "database": "nacr_forum"
}
```

#### 4. Redis 配置

配置 Redis 连接（修改 `app/config/redis.json`）：

```json
{
  "host": "localhost",
  "port": 6379,
  "password": "",
  "db": 0
}
```

#### 5. 启动后端服务

```bash
node index.js
```

后端服务默认运行在 `http://localhost:9999`

#### 6. 启动前端服务

```bash

# 修改前后台 后端API地址端口，路径分别为：
web/client/app-config.js
web/admin/app-config.js
# 将apiBase改为您自己的后端服务地址即可

# 启动前台
cd web/client
npm run dev

# 启动后台（新终端）
cd web/admin
npm run dev

注意：前后台均为nuxt3项目 端口都为3000，打包后请前往index.mjs更改端口，否则可能导致端口冲突
```
默认后台账号：`admin` / 密码：`123456`

---

## 📦 详细的图文教程

[NacrBBS编译教程](https://bbs.nacr.cn/threads/49)

[NacrBBS全开源系统 - 宝塔面板搭建教程](https://bbs.nacr.cn/threads/46)

## 📁 项目结构

```
nacrbbs/
├── app/                    # 后端核心代码
│   ├── config/            # 配置文件
│   ├── controller/        # 控制器层
│   │   ├── Admin/        # 管理员接口
│   │   ├── user/         # 用户接口
│   │   └── tourist/      # 游客接口
│   ├── imp/              # 核心实现
│   ├── library/          # 第三方库封装
│   ├── router/           # 路由定义
│   ├── safety/           # 安全中间件
│   └── scheduledTask/    # 定时任务
├── web/                   # 前端代码
│   ├── client/           # 前台用户端
│   └── admin/            # 后台管理端
├── public/               # 静态资源
├── c_deft.sql           # 数据库初始化脚本
└── index.js             # 后端入口文件
```




## 📄 开源协议

本项目采用 [MIT](LICENSE) 协议开源

---