夜雨聆风学习资料网

ARTICLE · 1367467

项目源码|技术派 paicoding 开源社区|Spring Boot + Thymeleaf · 文章专栏评论 · React

项目源码|技术派 paicoding 开源社区|Spring Boot + Thymeleaf · 文章专栏评论 · React

想做一套带文章、专栏和评论的技术社区,再配一个运营后台,技术派就能直接上手。后端是 Spring Boot,前台用 Thymeleaf 把页面直接渲染出来,管理端是独立的 React 后台。本机只要 MySQL 8 和 Redis,第一次启动会自动建表并写入演示数据。本篇在本机实跑通过:浏览首页、打开文章、看专栏、搜索,再从后台发布一篇自己写的测试文章,前台立刻能打开。售价 80 积分,下载区是清理过的源码包和中文部署说明。

社区后端的许可文件是 Apache License 2.0,管理端的许可文件是 MIT License。包里两份都保留,请一并留下。站内已经发过一篇小型社区 OpenIsle,那是 Vue 3 的论坛。本篇不是又一个论坛:前台不是 Vue,主线是文章、专栏教程、评论,再加一套运营后台。

4 步上手

  1. 装好环境
    :JDK 8、11 或 17 均可(编译目标是 1.8),再加 Maven、MySQL 8、Redis 7。管理端另外需要 Node 18。
  2. 改库配置
    :打开 paicoding-web/src/main/resources-env/dev/application-dal.yml,确认库名是 pai_coding,把 MySQL 口令改成你自己的。先开 Redis,再开 MySQL。不要事先建一个空库。
  3. 启动社区
    :在社区源码根目录执行 mvn -pl paicoding-web -am -DskipTests package,再跑启动类 QuickForumApplication。第一次启动会自动建表。打开 http://127.0.0.1:8080。
  4. 启动后台
    :进入管理端目录,npm install 后 npm run dev,打开 http://127.0.0.1:3301。登录后立刻改密码,再发一篇自己写的测试文章。

能做什么

  • 首页文章流水
    :打开前台就能看到推荐和文章列表。已实测。
  • 文章详情
    :点进一篇文章,看正文、分类和标签。已实测。
  • 专栏频道
    :专栏是按教程顺序组织起来的一组文章。已实测打开专栏页。
  • 关键字搜索
    :默认没开 Elasticsearch,走数据库搜索就够用。已实测。
  • 运营后台
    :数据统计、文章管理、专栏配置。已实测。本机从后台发布了一篇自写测试文章,前台立刻能打开。
  • 派聪明 AI、微信扫码登录、知识星球登录、付费文章与支付、Elasticsearch 全文检索、RabbitMQ、MongoDB、小程序、付费教程多版本:支持但本篇未实测。

Thymeleaf:用模板把页面直接渲染出来的技术。前台不是 Vue,打开 8080 就能看页面。

Liquibase:启动时自动建表、写入演示数据的工具。第一次启动不必手工导入 SQL。

技术栈(压缩)

  • 社区后端:Spring Boot 2.7 + JDK 8(本机用 JDK 17 编过)+ MyBatis-Plus + MySQL 8 + Redis 7
  • 前台:Thymeleaf 直出页面
  • 管理端:React 18 + TypeScript + Vite + Ant Design 5

本机实跑(已跑通)

详细命令见包里的 DEPLOY.txt。下面按操作顺序看。

看这里:打开 http://127.0.0.1:8080 就是前台首页。中间是文章流水,左侧是分类,右侧是推荐。列表里已经能看到后面从后台发出去的测试文章。
看这里:从首页点进一篇演示文章,就是详情页。左边是正文,右边是目录。本机没有配置公众号,所以没有走前台扫码登录。
看这里:打开 /column 就是专栏频道。一列就是一套按顺序排好的教程。点进去可以按章节阅读。
看这里:在搜索框输入「远影」,进入 /search?key=远影。默认没开全文检索,走的是数据库搜索。结果里只有自己发的那篇测试文章。
看这里:打开分类「后端」,同类文章会列在一起。测试文章也挂在这个分类下。
看这里:管理端开发地址是 http://127.0.0.1:3301。登录页如果预填了账号,先清空再输入。默认账号密码写在管理端 README 里,正文不写。登录后立刻改密。
看这里:登录后先进入数据统计。上面是用户、文章、阅读这些汇总数字,下面是访问趋势。管理端是 Hash 路由,地址栏里会看到 #/statistics/index,这是正常的。
看这里:文章管理里按标题搜索「远影实测」,只看到刚发布的那一篇,状态是「已发布」,短链是 yuanying-paicoding-test-article。
看这里:专栏配置页可以改专栏封面、顺序和上下架。本机打开了自带的演示专栏,没有再新建。
看这里:回到前台,打开 /yuanying-paicoding-test-article,就是刚在后台发出去的测试文章。标题是「远影实测:技术派社区后台发布测试文章」,发布时间是 2026-11-17 09:22(北京时间)。这就是后台发文、前台可见的闭环。

实测结果

  • 环境就绪后,mvn -pl paicoding-web -am -DskipTests package 大约 26 秒;第一次启动大约 8 秒,自动建库建表。
  • 管理端 npm install 大约 27 秒,开发服务很快就能打开。
  • 首页、文章详情、专栏、搜索、分类都返回正常。后台统计、文章列表、专栏配置都能打开。
  • 从后台发布的测试文章,前台搜索和分类页立刻能找到。

本机踩坑(压缩)

  • 旧文档仍写模块名 forum-web、库名 paicoding。实际模块是 paicoding-web,库名是 pai_coding,以配置文件为准。
  • 必须先开 Redis,否则后端起不来或登录异常。
  • 如果事先建了一个空的 pai_coding,初始化可能去查还不存在的 Liquibase 表而报错。删掉这个空库,让程序自己创建。
  • 管理端是 Hash 路由,请走 http://127.0.0.1:3301/login#/… 这种地址。
  • 图片默认存在 /tmp/storage/,请确保目录可写。

用之前请注意

  • 仅供学习。上线前务必更换数据库口令、密码盐和登录签名密钥。包里这几项已经改成占位符。
  • 管理员登录后立刻改密,不要继续用演示账号。
  • 前台默认登录是公众号扫码,本机没有公众号时,不要把「前台用户登录并评论」当成必过。
  • 不要把知识星球、官方便收费内容或派聪明云端能力,写成这份开源包里就能直接用。

包里是社区源码、管理端源码、两份许可文件、许可说明和中文 DEPLOY.txt。已去掉或替换公众号二维码、社群码、知识星球海报、官方 logo 和官方界面截图。

原文:https://yuanyinglight.com/2584.html

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料