kingwrcy/mblog

JSON CONVERT

Online Timer

起因

之前一直用的flomo,免费版的图片只有500MB空间,再加上数据在别人那里总归有点不爽,然后又看到了Memos,支持自部署,还需要个服务器.

我这最近不是才买了群晖ds920嘛,安排上.装完了才发现电信不给80/443端口,有了公网ip也无用武之地,难受.咋办?折腾内网穿透,tailscale,***之类的?不想,毕竟还是希望能部署在公网,公网能直接访问.

然后又想到如果前后端分离,服务端在nas上,前端在各大支持静态网页的cdn上不就ok?cdn都支持绑定域名,想法很好,现实打脸.Memos我看了下,确实是前后分离,但是看https://github.com/usememos/memos/blob/main/server/embed_frontend.go#L24,%E4%BD%9C%E8%80%85%E6%8A%8A%E5%89%8D%E7%AB%AF%E7%BC%96%E8%AF%91%E5%87%BA%E6%9D%A5%E7%9A%84dist%E7%9B%AE%E5%BD%95%E7%9B%B4%E6%8E%A5%E5%B5%8C%E5%85%A5%E5%88%B0%E4%BA%86%E7%94%9F%E6%88%90%E7%9A%84go%E7%9A%84%E5%8F%AF%E6%89%A7%E8%A1%8C%E6%96%87%E4%BB%B6%E9%87%8C.

这就导致了我想前端部署在cdn,后端部署在nas上实现不了,除非自己改memos的代码,太折腾.

转念一想,就这么点microBlog的功能能有多麻烦?自己撸一个得了?(其实是给闲的).

https://github.com/kingwrcy/mblog-backend/blob/main/release.md

项目介绍

mBlog,全称micro blog.基于java+mysql.支持自部署的前后端分离的微博,可单用户使用,也可以支持多用户.

DEMO:

mblog.coo.st

mblog.cooolr.online(开放注册) 基于java+mysql,前后分离

m.kingwrcy.cn(开放注册,***评论等) 基于java+sqlite,前后不分离,内存128MB

嵌入其他博客系统

比如wordpress,hugo,https://github.com/mblog-backend/backend/tree/main/doc/static.md

tg机器人

感谢https://github.com/cooolr,%E5%BC%80%E6%BA%90%E5%9C%B0%E5%9D%80%E5%9C%A8https://github.com/mblog-backend/mblog-***-bot

浏览器插件

https://github.com/mblog-backend/browser-plugin

目前只支持Chrome浏览器

支持一键转发文本

特性

1. 支持图文混发，支持多图
2. 支持***格式链接

tg频道

Nas安装教程

图片预览

![]([***]

![]([***]

![]([***]

Docker镜像

• https://hub.docker.com/r/kingwrcy/mblog

• https://github.com/kingwrcy/mblog-front

• https://hub.docker.com/r/kingwrcy/mblog-front

---

• https://github.com/kingwrcy/mblog-backend

• https://hub.docker.com/r/kingwrcy/mblog-backend

大体功能如下:

• 基本的文字/图片/文件等输入,支持标签
• 支持对历史博文/标签修改
• 支持单/多用户,支持开启/关闭注册/评论/点赞
• 支持博文 登录用户/所有人/只有自己 可见
• 支持按照标签,时间,内容,可见性进行搜索
• 支持标签管理(一键改标签,删除无用标签等)
• 支持上传图片(目前支持本地文件存储和七牛云,S3)
• 支持开发者使用api token
• 响应式设计,支持pc和手机,支持夜间模式
• 支持RSS
• 支持markdown语法
• 支持emoji表情
• 前后端分离,前端和后端域名可以不一致,可以后端部署在nas上,前端部署在cdn.
• 同时也支持前后不分离,支持使用MySQL或者Sqlite

待开发的功能

• 支持sqlite v1.0.8已支持
• 争取提供前后不分离版本 v1.0.8已支持
• 提供chrome插件,一键转发到mblog
• 提供可自部署的tg机器人,一键转发到mblog 已经由https://github.com/cooolr%E5%B8%AE%E5%BF%99%E5%AE%9E%E7%8E%B0%E4%BA%86,%E6%AC%A2%E8%BF%8E%E8%AF%95%E7%94%A8
• ......

使用到的框架

服务端

• Springboot
• Mybatis-Flex
• SaToken

前端

• Vue3
• Vite
• https://github.com/unocss/unocss
• NaiveUI

部署

https://github.com/kingwrcy/mblog-backend/blob/main/doc/gui_install.md

服务端

因为一些原因,mysql需要5.7以上

数据库记得提前建好,对应的账号得有create table的权限

数据库记得提前建好,对应的账号得有create table的权限

需要注意的

• 初始用户名密码是admin/a***

• 登录成功后可以在 用户设置 页面修改密码.

• 在设置 - 系统设置中,需要设置服务端域名,安全域名(也就是前端域名,逗号分割,只有配置在这里的,才会允许跨域调用.没配置的,不支持跨域.前端会报错)

• 其中服务端域名是在生成RSS内容,和本地上传文件时启用.

• 写内容时,只有第一行的 以 # 开头的才会被解析为 标签,第二行以及后面的,不解析.

• AllInOne 安装可以参看 根目录下的docker-compose.yml,里面包含了前端,后端和MySQL 8.

MYSQL 5.7注意事项

因为开发是在8.0.33的版本上开发的,没想到5.7里mysql要求timestamp类型必须有值,所以直接在5.7上运行,会报错.

解决办法:

1. Docker启动mysql的,看https://github.com/kingwrcy/mblog-backend/blob/main/docker-compose.yml,%E5%9C%A8command%E4%B8%AD%E5%8A%A0%E4%B8%8A '--explicit_defaults_for_timestamp=ON'
2. 非Docker启动的,找到MYSQL 5.7的配置文件,在[mysqld]下方加入explicit_defaults_for_timestamp = 1
3. 删掉已存在的数据里的所有的表和数据,再次启动后端,会自己重建的,记得数据库不能删除,是所有的表和数据删除.

宝塔面板安装

感谢 @lzhang ,教程在此 ,图文并茂,大家有需要的参考下.

源码安装

1. git clone git@github.com:kingwrcy/mblog-backend.git
2. 更改application.properties文件中的数据库相关信息和前端域名(配置跨域)
3. 在项目根目录下执行mvn clean package，需要java>=17和maven>=3.9.1
4. 打包出来的Jar文件在服务器执行java -jar xxx.jar

Docker安装

docker run --volume=${PWD}/mblog:/opt/mblog \
--publish=你要映射的后端端口,必填:38321 \
--restart=always \
--name=mblog-backend \
--detach=true \
--env MYSQL_USER=数据库用户名,必填 \
--env MYSQL_PASS=数据库密码,必填 \
--env MYSQL_URL=数据库地址:端口,必填,前面没有http(s) \
--env MYSQL_DB=数据库名称,必填) \
--env MBLOG_FRONT_DOMAIN=mblog前端地址(配置跨域使用的,带http(s),有端口带端口,docker启动的这里是宿主机的IP,必填) \
kingwrcy/mblog-backend:latest

前后不分离,并且使用sqlite的版本:

docker run --volume=${PWD}/mblog:/opt/mblog \
--publish=你要映射的后端端口,必填:38321 \
--restart=always \
--name=mblog-backend \
--detach=true \
--env DB_TYPE=-sqlite \
kingwrcy/mblog:latest

• 其中--volume=${PWD}/upload:/opt/mblog/upload是图片在本地存储才需要挂载的,如果是七牛云之类的,不需要挂载.
• 其中sqlite版本的数据库位置在镜像的/opt/mblog/data.sqlite,需要映射出来,不然重启数据就丢失了
• 数据库相关的记得更改
• 映射的端口自己需要就改
• 其中MBLOG_FRONT_DOMAIN如果前后端域名+端口全部一致,可以不用配置,如果不一致,哪怕端口不一致,也需要配置,如:https://mblog-front.com
• 开启了API文档的,API文档访问地址为http://服务端IP:服务端端口/api.html

前端安装

源码安装

1. git clone git@github.com:kingwrcy/mblog-front.git
2. 更改.env.docker文件中的VITE_BASE_URL内容为你的服务端地址,有端口的端口也要加上,如:https://mblog-server.com:2023
3. 更改.env.docker文件中的VITE_MBLOG_VERSION内容版本号,自定义,如v1.0.5
4. yarn i && yarn build-only --mode=docker 需要Node版本>=v18
5. 打包出来的dist目录就可以传到cdn了

自己部署前端的注意事项

由于使用了vue-router的 HTML5 Mode,所以需要在服务器的nginx上写入一条配置. 详情参见HTML5 Mode

如果不配置的话,直接访问详情页,登录页等页面会404,站内跳转的不受影响.

用Docker安装的不需要这个步骤,我已经在Dockerfile中处理过了.

Docker安装

docker run \
--publish=你要映射的前端端口,必填:80 \
--restart=always \
--name=mblog-front \
--detach=true \
--env MBLOG_SERVER_URL=mblog服务端地址,带http(s),有端口带端口,docker启动的这里是宿主机的IP,必填 \
kingwrcy/mblog-front:latest