建站与协作

Poetize:博客功能介绍与源码部署

  • 0 次阅读
  • 0 条评论
文章摘要

Poetize 是一套把个人博客与社交互动结合起来的前后端分离网站。它除了发布文章,还提供图片墙、收藏夹、音乐和视频展示、留言与友链等页面,可以用来整理技术笔记、记录生活、展示照片,以及维护常用资源链接。后台用于管理文章、文件和网站配置,不需要把每次更新都写进前端代码。 项目分为博客系统和 IM 聊天室两部分。博客承担内容展示与登录入口;聊天室提供朋友圈、好友和群聊等互动功能,是可选模块。只想做博客时可以先部署博客和后端,需要聊天功能时再加上聊天室,避免一次维护所有组件。 它适合愿意维护 Java、MySQL 与前端构建环境的个人站长,也适合学习 Vue 与 Spring Boot 的开发者。与单纯上传静态页面不同,Poetize 需要维护数据库、上传文件和后端服务;部署前应先确定是否需要聊天室、是否使用本地文件存储,以及准备采用开源版还是付费版。

项目介绍

Poetize 是一套把个人博客与社交互动结合起来的前后端分离网站。它除了发布文章,还提供图片墙、收藏夹、音乐和视频展示、留言与友链等页面,可以用来整理技术笔记、记录生活、展示照片,以及维护常用资源链接。后台用于管理文章、文件和网站配置,不需要把每次更新都写进前端代码。

项目分为博客系统和 IM 聊天室两部分。博客承担内容展示与登录入口;聊天室提供朋友圈、好友和群聊等互动功能,是可选模块。只想做博客时可以先部署博客和后端,需要聊天功能时再加上聊天室,避免一次维护所有组件。

它适合愿意维护 Java、MySQL 与前端构建环境的个人站长,也适合学习 Vue 与 Spring Boot 的开发者。与单纯上传静态页面不同,Poetize 需要维护数据库、上传文件和后端服务;部署前应先确定是否需要聊天室、是否使用本地文件存储,以及准备采用开源版还是付费版。

核心功能

功能

可以做什么

文章与分类

发布和管理文章,按分类、时间线等入口浏览内容,配合文章目录、搜索与归档查找资料。

图片与生活记录

使用图片墙、旅拍、表白墙等模块展示照片与生活记录,内容不局限于文字博客。

收藏与链接

通过收藏夹或百宝箱整理常用资源,使用友链页面维护相关站点入口。

音视频展示

在站点中展示音乐或视频内容;媒体文件的保存位置与可访问地址需要单独配置。

留言与互动

文章留言、站点留言等功能让访客参与交流,后台负责相应内容管理。

文件管理

管理上传文件,可使用服务器本地文件服务,也可按所选版本配置对象存储。

后台管理

管理文章与网站基础设置,查看访问统计,维护站点资源。

可选聊天室

提供朋友圈、好友和群聊;登录依赖博客系统,不是一个独立登录的聊天网站。

开源版与付费版怎么区分

开源版的重点是博客、媒体展示、后台与可选聊天室。官方 README 把商品与会员、支付对接、AI 文章生成和摘要、更多第三方登录方式等列为付费版增强功能。原参考文章把这些功能放在同一张清单里,部署开源代码时不能据此认为它们都会提供。选版本时先核对需要的具体功能,再使用对应版本的文档和配置。

技术栈与组件关系

组件

所查开源版 README 中的技术

作用

博客前端

Vue 2、Element UI

博客页面与登录入口。

聊天室前端

Vue 3、Element Plus、Naive UI

朋友圈与实时聊天界面,可选部署。

后端

Spring Boot 2.7、MyBatis-Plus、T-io

业务接口、数据访问与通信服务。

数据库

MySQL

保存文章、用户与站点业务数据。

Web 入口

Nginx

提供前端页面,并转发接口和本地文件访问。

访问链路可以理解为:浏览器先进入 Nginx,由它提供前端页面并把接口请求转给 Java 后端,后端再访问 MySQL 与文件存储。图片上传成功但页面显示不出来时,需要检查文件访问链路,不能只看数据库是否正常。

界面展示

Poetize 开源版博客首页

图 1:官方开源版博客首页,展示文章卡片、站内搜索和内容入口。

Poetize 后台文章管理

图 2:官方后台文章管理界面,可以集中查看并维护文章记录。

项目信息

项目

说明

类型

项目指南

分类

建站与协作

项目仓库

aLittleDonkey/poetize

官方入口或文档

直接访问

整理日期

2026-11-14

安装或使用条件

源码部署需要 Git、Java 开发或运行环境、与项目匹配的 Node.js 和包管理器、MySQL,以及正式访问时使用的 Nginx。具体 Java、Node.js 和 MySQL 版本先按选定代码版本的构建文件与开源版部署文档确认。数据库、文件目录和数据库账号分别为该站点单独准备;如果只部署博客,可以暂不配置聊天室。

安装与使用步骤

  1. 从当前 Gitee 主仓库取得开源代码,保存本次使用的提交或版本。GitHub 仓库已声明代码合并到主仓库且不再维护,后续更新以 Gitee 为入口。

  2. 先初始化后端:新建 MySQL 数据库与应用账号,把同一份代码中的 poetry.sql 导入新库,在 application.yml 的 datasource 中填写自己的数据库地址、库名和凭据。

  3. 在开发环境启动后端入口 PoetryApplication,查看启动日志,先排除数据库连接、表结构与配置读取错误。

  4. 进入博客前端目录安装依赖并启动开发服务,使用终端实际输出的地址访问页面。先确认文章页面和登录入口能调用后端。

  5. 需要聊天室时,在对应的 Vue 3 前端目录单独安装依赖并启动,从博客登录后进入聊天室验证身份衔接。

  6. 本地流程跑通后,按开源版部署文档构建前后端并配置 Nginx。最后完成后台设置,测试发布文章、上传文件和重新登录,再把站点提供给其他用户。

1. 获取源码并确认版本

git clone https://gitee.com/littledokey/poetize.git
cd poetize
git rev-parse HEAD

保留最后一条命令输出的提交号。前端、后端、数据库初始化 SQL 和部署配置来自同一份代码,排查问题时才容易确认具体版本。正式部署说明见 POETIZE 开源版部署文档。

2. 初始化数据库与后端

在数据库工具中创建独立数据库和应用账号,再执行仓库内的 poetry.sql。这份 SQL 是初始化文件,已有站点更新时不要重新导入来替代数据库迁移。

修改后端 application.yml 的数据源配置,逐项核对数据库主机、端口、数据库名称、用户名和密码。如果后端与 MySQL 不在同一台主机或同一个运行环境,localhost 指的是后端所在环境,不能直接当作数据库地址。

启动 PoetryApplication 后先查看日志。出现连接拒绝时查 MySQL 地址和监听状态,认证失败时查应用账号和授权,提示表不存在时确认 SQL 是否导入了正在连接的数据库。后端持续运行且数据库访问正常后,再启动前端。

3. 启动博客与可选聊天室

在博客前端目录,也就是该模块 package.json 所在位置执行:

npm install
npm run serve

这两条是官方 README 给出的本地开发命令。执行目录应是前端模块,而不是随意选取仓库根目录;终端显示的访问地址才是本地开发服务实际地址。

聊天室是另一个前端模块,需要在其目录单独执行相同命令,不能只启动博客就认为聊天室已经运行。使用现有代码中的包管理方式和依赖约束,遇到安装问题先看 Node.js 版本与依赖报错,不直接升级全部依赖。

先用博客验证首页、文章列表与登录;再从博客的“联系我”等入口进入聊天室,检查登录信息是否衔接。

4. Nginx 与文件访问

开发服务用于本地调试;正式访问时按选定版本的部署文档生成前端构建产物并部署后端,由 Nginx 提供网页、接口转发和文件访问。接口前缀、后端端口、上传目录与文件 URL 应从同一版本的配置中核对,不能混用其他教程的路径。

官方 README 特别提到:本地启动时,没有 Nginx 文件代理可能导致上传后的文件无法访问。遇到图片空白,先在浏览器中打开图片的实际 URL,区分地址错误、404、权限错误和 HTTPS 页面加载 HTTP 资源等情况,再检查 Nginx 路由及文件目录。

选择本地存储时需要保存并备份上传目录;改用对象存储时,需要同时配置保存位置和访问域名,不能只改上传端而保留旧文件访问地址。

5. 后台设置与首次使用

后端与博客前端连通后,在当前站点地址后进入 /admin。原文的 http://localhost/admin 是本机示例,部署在服务器上应使用自己的站点地址。

进入配置管理,设置网站名称、基础展示内容和所需的邮件参数。官方 README 说明邮箱账号、邮箱授权码等部分配置修改后可能需要重启 Java 服务。

依次发布一篇测试文章、上传一张测试图片、检查前台分类与文章详情,再用普通用户身份验证登录和留言。启用了聊天室的站点继续验证好友或群聊流程。检查图片时用文件的访问链接打开一次,避免只凭后台“上传成功”判断文件链路正常。

配置与常见问题

  • 前端打开但没有文章:先确认 Java 后端已启动,检查浏览器接口请求的地址和返回状态,再核对 Nginx 接口转发;有页面不等于后端连接正常。

  • 图片上传后不能显示:核对文件是否确实保存、生成的文件 URL 是否正确,以及 Nginx 文件代理是否指向相同目录。

  • 博客登录正常但聊天室未登录:先检查是否从博客入口进入,再核对两个前端的域名、接口与身份传递配置。

  • 修改邮件配置仍无效果:核对邮箱授权码与发信参数,再按版本说明重启后端并检查邮件发送日志。

  • 找不到支付、会员或 AI 生成功能:先确认是否属于付费版增强功能,不通过反复修改开源版配置寻找未包含的模块。

更新与备份

至少保存 MySQL 数据库备份、上传文件或对象存储数据、后端配置、Nginx 配置,以及正在运行的代码提交号和构建产物。恢复时数据库与文件应成套核对:只恢复数据库,可能留下文章正文里的失效图片链接;只恢复文件,也不能恢复文章和用户数据。

更新前先备份,再阅读目标版本说明,检查是否有 SQL 变更以及前后端配置变化。保留原构建产物便于回退;涉及数据库结构变化时,代码回退与数据库恢复需要一起考虑。

参考资料

配图:POETIZE 项目官方仓库,按 AGPL-3.0 保留许可;图片仅等比例缩小和压缩。