# 从 0 到 1：我用 WorkBuddy 搭起一个校园教学资源平台（实战全记录）

> 本文参加 #WorkBuddy开发者分享季# 活动。文中所有截图均已脱敏。

## 一、背景：一个被微信群和 U 盘撑着的"资源库"

我是一名中学老师，同时带几个班。日常最头疼的不是上课，而是**教学资源散落各处**：课件在微信群里、试题在 U 盘里、公开课视频在网盘里。想要的时候永远找不到，分享给学生还得逐个发。

我想要的其实很简单：一个**校内师生都能搜、能看、能传**的资源平台——按学科和年级分类，支持在线预览和审核，权限要分清。

问题是我只会一点前端皮毛，没有服务器预算，也不想学一整套后端。

然后我遇见了 WorkBuddy。

## 二、遇见 WorkBuddy：把"想法"翻译成"能跑的代码"

我给它的描述是：*"帮我设计一个校园教学资源平台，要零成本部署在学校 NAS 上，支持分类检索、在线预览、审核流程和四级权限。"*

它没有直接甩代码，而是先和我**梳理需求**，再一步步给方案。第一次让我觉得"AI 不是在写答案，是在和我一起把事想清楚"。

最终技术选型（全开源、零月租）：

- **前端**：Vue 3 + Vite + Element Plus
- **后端**：Node.js + Express + SQLite
- **部署**：学校 NAS（绿联云）上的 Docker，frp 内网穿透暴露公网
- **预览**：pdf.js 渲染 PDF，Office 文件经 LibreOffice 转 PDF 后预览

![screenshot_01_homepage_clean.png](https://developer.qcloudimg.com/http-save/yehe-12595092/eef4303bf72684231d6293a0e7098bb3.png)!

## 三、搭建过程：六个关键点

**1. 数据库：六张表就够**
`roles`、`users`、`categories`（自引用，支持无限级分类）、`resources`（核心表）、`albums`、`reviews`。资源表是中心，其余都围着它转。

![screenshot_03_database_er.png](https://developer.qcloudimg.com/http-save/yehe-12595092/2294694b184973f4c3fa1e4b4d55cd4c.png)

**2. 登录：JWT 鉴权**
登录接口返回 token，前端存 localStorage，每次请求带 `Authorization` 头。一个坑：JWT 中间件**必须在路由之前注册**，否则永远 401。

![图4 登录接口返回的 JWT（已脱敏）](https://developer.qcloudimg.com/http-save/yehe-12595092/fd46d814f3e85fb9300145f34a6c5a82.jpeg)!

**3. 文件上传：中文文件名是天坑**
资源多为中文名，直接存会乱码。解决：multer 保存时用随机名，原文件名单独存字段；**顺序也有坑——multer 中间件必须紧跟在路由定义前**，否则 `req.file` 是 undefined。

**4. 权限：RBAC 四级控制**
superadmin / 教师 / 学生 / 访客，用一张权限矩阵 `PERM_MATRIX` 管所有操作。学生不能删资源、访客只能看公开内容——这条在项目里救过我好几次。

**5. 部署：Docker 一把梭**
前后端打成一个镜像跑在 NAS 上，2 个容器常驻运行，镜像约 3.1GB。

![screenshot_02_docker_containers_final.png](https://developer.qcloudimg.com/http-save/yehe-12595092/e009607d372273656f7b0eaa2d9e0c10.png)

**6. 预览：Office 转 PDF**
后端调 LibreOffice 把 docx/xlsx 转 PDF，再走 pdf.js 渲染，不用让教师装 Office。

## 四、踩过的坑（挑最痛的 3 个）

1. **SQLite 并发写锁**：高峰期多人同时上传，出现 `database is locked`。解决：开 WAL 模式 + 写入队列。
2. **frp 断流**：公网偶尔连不上，加了健康检查和自动重连。
3. **权限越权**：早期 reviews 表没校验 owner，教师能改别人的审核意见——上线第二天就堵上了。

完整踩坑记录有 15 条（含 4 个重大级），篇幅有限不展开。

## 五、上线成果

平台已稳定运行，真实数据：

- 注册用户 **161 人**，资源 **240 个**，累计下载 **1554 次**
- 覆盖 16 个学科，1 条待审核

![screenshot_05_admin_dashboard_clean.png](https://developer.qcloudimg.com/http-save/yehe-12595092/0739b933e2b21885e3e558afb2626e83.png)

## 六、一点心得

1. **先想清楚再写代码**——WorkBuddy 帮我做的需求梳理，比它后来写的代码更值钱。
2. **零成本不等于零门槛**——Docker 和 frp 的学习曲线不低，但一次配好长期受益。
3. **权限和预览是校园平台的命门**，比花哨功能重要十倍。

如果你也在学校想搭类似平台，欢迎评论区交流。完整七篇系列将在我的主页，本文是压缩版。

> 标签：#WorkBuddy开发者分享季# #Vue3# #Node.js# #SQLite# #校园信息化# #Docker# #JWT# #RBAC#


我是一名中学老师，同时带几个班。日常最头疼的不是上课，而是教学资源散落各处：课件在微信群里、试题在 U 盘里、公开课视频在网盘里。想要的时候永远找不到，分享给学生还得逐个发。

从 0 到 1：我用 WorkBuddy 搭起一个校园教学资源平台（实战全记录）

后端

开发工具

架构设计

中学教师分享零成本搭建校园教学资源平台实战经验，使用WorkBuddy+Vue3+Node.js技术栈，解决教学资源分散难题。平台支持分类检索、在线预览、审核流程和四级权限，部署在学校NAS上，已稳定运行并服务161名师生。文章详细记录技术选型、数据库设计、权限控制等关键实现，以及SQLite并发、frp断流等典型问题的解决方案。

中间件

数据库

服务器

WorkBuddy 

容器

路由

SQLite

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

中学教师分享零成本搭建校园教学资源平台实战经验，使用WorkBuddy+Vue3+Node.js技术栈，解决教学资源分散难题。平台支持分类检索、在线预览、审核流程和四级权限，部署在学校NAS上，已稳定运行并服务161名师生。文章详细记录技术选型、数据库设计、权限控制等关键实现，以及SQLite并发、frp断流等典型问题...

从 0 到 1：我用 WorkBuddy 搭起一个校园教学资源平台（实战全记录）-腾讯云开发者社区-腾讯云

从 0 到 1：我用 WorkBuddy 搭起一个校园教学资源平台（实战全记录）

从 0 到 1：我用 WorkBuddy 搭起一个校园教学资源平台（实战全记录）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐