Solo 用户指南

Solo

小而美的博客系统,专为程序员设计





English

💡 简介

Solo 是一款小而美的开源博客系统,专为程序员设计。Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动(具体细节请浏览 B3log 构思 - 分布式社区网络)。

这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!

欢迎到 Solo 官方讨论区了解更多。同时也欢迎关注 B3log 开源社区微信公众号 B3log开源

b3logos.png

🗃 案例

https://hacpai.com/top/solo

✨ 功能

🎨 界面

开始使用

start.png

后台首页

console.png

编辑文章

post.png

选择皮肤

skins.png

前台界面

pinghsu.png

Bubble.png

nijigen.png

timeline.png

Casper.png

Jane.png

🍱 皮肤

目前内置的皮肤如下,可点击进行预览:

欢迎在这里推荐好看的皮肤,我们会尽量进行制作。

🛠️ 安装

Solo 支持“动静两用”:

本地运行

本地运行主要用于试用或者生成静态站点,生成静态站点的用法请参考这里

(视频演示教程请看这里 https://www.bilibili.com/video/BV1tK411n7R3

下载最新的 Solo 包解压,进入解压目录执行:

如果你有 Java 开发环境,可参考这里通过源码构建运行。

Docker 部署

Docker 方式部署是动态博客用法,主要用于在服务器上部署动态博客。

(视频演示教程请看这里 https://www.bilibili.com/video/BV1Yk4y1q7rV

获取最新镜像

docker pull b3log/solo

启动容器

注意:对于如下命令,如果你不确定如何使用 \ 来进行换行,就不要换行了,一行内写完整条命令。

启动参数说明:

完整启动参数的说明可以使用 -h 来查看。

日志配置

默认通过 log4j2 将日志打印到标准输出流,可以通过 docker logs solo 进行查看。如果需要覆盖 log4j 配置,可通过挂载文件实现:

--volume ~/log4j2.xml:/opt/solo/log4j2.xml

挂载第三方皮肤

如果需要使用第三方皮肤,可以挂载目录 skins,目录结构请参考原版 skins:

--volume ~/skins/:/opt/solo/skins/

版本升级

  1. 拉取最新镜像
  2. 重启容器

可参考这里编写一个重启脚本,并通过 crontab 每日凌晨运行来实现自动更新。

Docker Compose

请参考这里,感谢 @liumapp 提供。

NGINX 反代

upstream backend {
    server localhost:8080; # Solo 监听端口
}

server {
    listen       80;
    server_name  88250.b3log.org; # 博客域名

    access_log off;

    location / {
        proxy_pass http://backend$request_uri;
        proxy_set_header  Host $http_host;
        proxy_set_header  X-Real-IP $remote_addr;
        client_max_body_size  10m;
    }
}

请务必配置

proxy_set_header  Host $http_host;
proxy_set_header  X-Real-IP $remote_addr;

否则访问页面可能会出现“Latke 配置错误”或者样式异常;统计在线访客功能会不正常。

📜 文档

🏘️ 社区

📄 授权

Solo 使用 木兰宽松许可证, 第 2 版 开源协议。

🙏 鸣谢


初始化后

初始化成功后请务必查看自动发布的第一篇文章,里面有一些必要的操作,请务必完成。然后请到管理后台 -> 工具 -> 偏好设定中进行一下博客的细节配置。

信息配置

签名档

最多可以配置 3 个签名档,发布文章的时候选择一个使用,可以使用 HTML 和脚本进行配置。

参数设置

下面是一些比较有特色或重要的参数:

导入 Markdown

请参考 Solo 支持 Hexo/Jekyll 数据导入

备份

安全第一,血泪的教训 😢

手动备份

社区端备份

可在工具 - 偏好设定 - 参数设置中勾选“备份所有文章到社区”,开启后将每隔 24 小时自动备份所有文章(包括草稿和加密文章)到社区,具体细节请参考 Solo 拉取 GitHub 仓库和自动备份

GitHub 备份

可在工具 - 偏好设定 - 参数设置中填写 GitHub token,填写后将每隔 24 小时自动备份公开文章(不包括草稿和加密文章)到你的 GitHub 仓库 solo-blog,具体细节请参考 solo-blog 仓库同步功能回来了

其他一些特性

多用户

可以几个用户同时使用一个博客发布文章,主要用在团队博客这个场景。权限方面做了简单隔离,非管理员用户可以看到其他用户的博文/评论列表,但是不能进行操作。

RSS/Atom/Sitemap

提供两种订阅供稿:Atom 1.0、RSS 2.0:

不要用浏览器直接打开,请通过阅读器查看。另外,Solo 也能生成全站文章的 sitemap.xml。

前台皮肤切换

通过 URL 带参(比如 http://88250.b3log.org/?skin=Finding )来确定渲染使用的皮肤。

使用场景举例:

  1. 只有在首页( / )会取参数 skin=xxx
  2. 如果带有就记录到 Cookie 里面,如果带有 skin=default 或皮肤不存在则清空 Cookie
  3. 如果要切换成后台默认的皮肤,在首页带参 skin=default

站外相关文章

“站外相关文章”指的是其他人使用 Solo 发布的文章,该文章含有与你的文章相同的标签。该功能主要是为了加强各个 Solo 博客之间的互动性,让博客访问者可以更有效地访问到相关的内容。

这是 B3log 构思的一部分实现,请大家积极参与进来 🙏

FAQ

为什么要“捆绑”登录黑客派账号?

Solo 和 Pipe 的定位是 B3log 分布式社区的博客端节点,并不是通常意义上的独立博客,所以账号体系需要进行统一,否则带来的问题会很多,这也是一路下来探索的,具体经历细节请看这里

在 Solo v3 之前一直是独立账号体系,但经过长时间验证效果并不理想:

这两个问题是矛盾的,所以为了解决它需要将账号在 B3log 网络中进行唯一化。一开始的设计方案是通过公私钥(类似区块链的钱包原理),但这个方案在现阶段过于复杂,用户使用门槛有点高所以暂时放弃了。公私钥的方案在星火项目里进行过测试验证,技术上应该没问题,以后的鱼塘项目可能会采用这个方案。

所以再次重申一下,Solo 和 Pipe 是 B3log 分布式社区的博客端节点。举个最容易理解的例子,这就好比某些厂商的软件,没有这个厂商的账号是用不了的。打通其他网络的方案是在博客端或者社区端接入其他网络的账号,目前已经在黑客派上接入 GitHub 登录(可在账号设置中绑定),Solo 可通过 GitHub token 来将文章同步到自己的仓库,避免整个 B3log 网络过度封闭内卷。

最后,希望目前加入到 B3log 的用户是认可这个设计的,如果不认可的话其实就没必要加入使用了,节省自己时间同时也能保护 B3log。当然,不排除以后设计还会有所变化,欢迎参与思考讨论,谢谢。

服务器内存太小?

可考虑使用 Solo 的静态站点支持,本地写作完成后导出静态站点,发布 GitHub Pages 等服务。

如果还是想使用动态博客的话,可使用内嵌的 H2 数据库代替 MySQL。但建议还是进行内存升级,然后使用 Docker 和 MySQL 部署,这样不仅可以通过更新镜像进行平滑升级,还能使用 MySQL 相关工具更方便地进行数据库运维。

如何打 jar 包部署?

请在 pom.xml 中搜索 maven-assembly-plugin 的注释进行配置即可。请注意:使用 jar 运行不支持:

建议尽量不要打 jar 部署,服务器上请通过 Docker 部署。

获取社区文件存储服务上传凭证异常?

请参考这里进行配置。

如何引入自定义静态资源,比如 .mp3?

请通过 NGINX 反代静态资源实现。

如何获得更好的 Markdown 渲染效果?

Solo 默认是使用内建的 flexmark 进行 md 渲染,可能对有的场景下的渲染效果不是很好。如果你想要获得更好的 md 渲染效果请参考这里

为什么在线访问计数一直都是 1?

在线访问计数是通过访问者 IP 去重的,每 10 分钟定时刷新一次。如果用了反向代理,请在代理配置部分加入客户端地址标头。比如 NGINX 需要加入如下配置:

proxy_set_header  X-Real-IP  $remote_addr;

如何插入广告展位?

可通过签名档、公告栏中插入 HTML、JS 代码来实现。

如何放置备案信息?

可通过在页脚配置中插入 HTML、JS 代码来实现。

如何使用 jsDelivr CDN 来加速?

启动时加入命令行参数:

--static_server_scheme=https
--static_server_host=cdn.jsdelivr.net
--static_server_port=
--static_path=/gh/88250/solo/src/main/resources

请注意,以上配置仅支持内置皮肤,如果挂载了第三方皮肤的话请按需调整。

Solo 会一直维护下去么?

Solo 的第一个版本发布于 2010 年,永不断更 😼

Solo 从第一版开始就支持平滑升级,从 v3.0.0 开始支持跨版本升级。在程序升级、数据兼容迁移方面我们做了很多工作。另外,Solo 还支持将数据导出成多种格式,所有的这些努力为的就是让大家能够免去后顾之忧,将精力更多放在创作和分享上。

结语

如果你在使用 Solo 过程中碰到问题或者有需求要提,欢迎跟帖,我们会在第一时间回复;如果你对 Solo 开发方面感兴趣,请参考 Solo 从设计到实现

  • Solo

    Solo 是一款小而美的开源博客系统,专为程序员设计。Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动(具体细节请浏览 B3log 构思 - 分布式社区网络)。

    这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!

    1192 引用 • 9136 回帖 • 631 关注
  • 安装

    你若安好,便是晴天。

    103 引用 • 1147 回帖 • 2 关注
  • 文档
    51 引用 • 1225 回帖 • 1 关注
77 引用
Solo | 优雅的使用 Solo 静态博客 使用 Solo 静态站点功能部署站点到 gitee 上的 Pages 关于 solo 皮肤一直 404 从零开始搭建 solo 个人博客系统 2019 年 11 月 17 日深夜有感 从零开始安装 solo 博客 通过 solo 快速搭建个人博客 (Mariadb 数据库) Solo 网站安装教程 适用于 Solo / Bolo 的清新高级主题 —— Sakura | 移植自 WordPress 主题 Solo 博客搭建之路 解决 Solo 主题 Bubble 主页背景图片加载慢的问题 新皮肤 solo-nexmoe 适用于 Solo / Bolo 的清新高级主题 —— Sakura | 移植自 WordPress 主题 solo 使用 docker 部署,加载页面图片过慢的问题 使用 docker-compose 一键启动 bolo 博客 你们的服务器啥配置啊? GitHub 图床的正确用法,通过 jsDelivr CDN 全球加速 个人 solo 博客搭建 升级到 3.8.0 后:Latke 配置错误 solo 页面无法正常加载 Solo v3.6.8 发布,编辑器支持所见即所得模式 为什么我 solo 博客生成的 rss.xml 显示不正常? solo 写博客的时候公式好像不能预览 通过宝塔面板搭建最新版 3.6.7 solo 博客(目测应该是最简单的搭建方法) 从零开始安装 solo 博客 感谢 Solo,开源万岁。从无到有全记录。 Solo 用户指南 Docker 方式部署 Solo 博客系统全流程 Docker 方式部署 Solo 博客系统全流程 solo 504 连接超时,怎么破? solo_Tomcat 转 docker 并升级 (问题好多!) solo 开发环境问题 solo 开发环境问题 solo 开发环境问题 Solo 用户指南 Solo v3.4.0 发布,自动同步 GitHub 仓库 搭建 Solo 博客:安装部署 V3.2 升级到 V3.3 页面出现排版错乱的情况 centos7.4 上部署 solo 开源博客系統 Solo v2.9.9 发布,同步 GitHub 仓库 开源博客系統 Solo v2.9.8 发布,支持阿里云 OSS solo 不能安装问题 solo 博客升级之后!样式全丢了!!! solo 版本升级, 不覆盖自身样式 请问各位大神一个关于静态页面的问题,在线求教 Java 开源博客 Solo 2.4.0 发布 Solo 用户指南 Solo 用户指南 solo 访问问题 Solo 的这个评论验证码是不是太难辨别了 solo 默认不支持表格语法吗 搭建 Solo 开发环境 为什么将 solo 的包解压运行后是这样的 Java 开源博客 Solo 2.1.0 发布 Java 开源博客 Solo 2.2.0 发布 Java 开源博客 Solo 2.3.0 发布 Java 开源博客 Solo 2.4.0 发布 使用 docker 搭建 solo 博客系统 Java 开源博客 Solo 2.5.0 发布 Java 开源博客 Solo 2.6.0 发布 Java 开源博客 Solo 2.7.0 发布 Java 开源博客 Solo 2.8.0 发布 Java 开源博客 Solo 2.9.0 发布,支持后台文章搜索 Java 开源博客 Solo 2.9.1 发布,支持 PJAX [博客] 在阿里云上部署 solo 博客 Java 开源博客 Solo 2.9.2 发布,看板娘来了 阿里云部署 solo 博客 Java 开源博客 Solo 2.9.3 发布,可指定移动端皮肤 Java 开源博客 Solo 2.9.4 发布,新皮肤加数据库重构 Java 开源博客 Solo 2.9.5 发布,大量细节优化 开源博客系統 Solo 2.9.6 发布,大量细节优化 使用 Azure App Service 免费计划部署 Solo 博客过程记录 开源博客 Solo 安装详细教程及注意事项 开源博客系統 Solo 2.9.7 发布,新皮肤 Jane

赞助商 我要投放

优质回帖
  • sq8852161 2

    加油。这是个很棒的开源项目。我对比了很多 Java 开源博客。最终还是剧的 solo 是最棒的。尤其是,solo 是一个生态。让孤独的码农有了家的感觉。

  • csfwff 1

    登录后有个管理按钮
    地址是 /admin-index.do#main

  • ihewro 1

    既然账号和社区网络是连通的,我觉的可以考虑 社区注册一个账号就可以自动生成自己的博客。这样用户使用门槛很低。

    用户可以选择不同的付费,有不同的图片存储空间,文字实际上没有多大空间,这样的话更有利于整个 blog 生态与社区的生态绑定

    自动生成的博客支持绑定已经备案的域名。类似于 farbox 博客

319 回帖
请输入回帖内容 ...
  • 88250

    我不会 PowerShell 🤣

    3 回复
  • InkDP

    image.png

    • 正常这儿应该只有一个 >,所以你需要手敲代码运行代码,或者一行一行的复制
    2 回复
  • a15572875965

    貌似 是感觉语法不太对,一直报语法错误,网上也没有专门 windows 的语法。没玩过 docker😂

  • a15572875965

    我在本地电脑上 用 ideal 可以跑起来,然后打包 jar 文件,执行就没反应了,😂

    1 回复
  • a15572875965

    image.png 原来是不支持 windows。。。才发现,桑心

  • a15572875965

    最后还是用 tomcat+war 发布成功了。。第一次接触 Java,总算没白搞!!!

  • a15572875965

    想请问一下,博客的后台管理页面路径是啥呀,文档中貌似没写 😂

    1 回复
  • csfwff 1

    登录后有个管理按钮
    地址是 /admin-index.do#main

    1 回复
  • a15572875965

    谢谢~~~找到了!🙏

  • Agent99

    所以 docker windows 部署不行吗

    1 回复
  • a15572875965

    恩的。docker 上 solo 的文件只支持 Linux

  • LainNetWork

    请问一下有 CDN 的配置吗?比如静态资源自动传七牛云之类的? (((刚刚在文档里找到惹,谢谢

  • jnuff-u

    是啊,莫名其秒的问题...同样的步骤执行了好几次,一直提示 latke init failed,最后莫名其妙的启动了 😂

  • fennylv

    首次启动成功后 访问报错如下:
    image.png

    一直在下面这个页面,请问这个要修改哪里呢?
    image.png

    1 操作
    fennylv 在 2019-10-12 11:24:48 更新了该回帖
  • fennylv

    你好 这个问题解决了吗 碰到同样问题

    1 回复
  • 88250

    看上去是你的服务器和社区网络不通造成的,请尽量使用国内服务器。

    1 回复
  • fennylv
    该回帖仅作者和楼主可见
    1 回复
  • 88250

    目前我在外面不方便排查,如果是社区服务器阻止的可能是出发了防火墙规则,晚上看下是否解封。

    1 回复
  • fennylv
    该回帖仅作者和楼主可见
  • yc654084303

    网站备案号最好能写入,因为现在网站回查,会暂停完整解析

    1 回复
  • hubowestlife

    👍

  • LainNetWork

    D 大,我遇到一个问题,我在服务器 B 的 docker 里布置了 solo,在服务器 A 上用 Nginx 反向代理到服务器 B。现在我正在给 solo 升级 https,但是即使我在 latke.properties 里设置了:
    serverScheme=https
    staticServerScheme=https
    但依旧有部分资源链接还是 http 状态,比如
    /manifest.json
    后台管理中的
    image.png
    请问是哪里没配置吗?

    1 回复
  • 88250

    Docker 部署的话启动带参数 --server_scheme=https,不要改配置文件。

    1 回复
  • LainNetWork

    嗯。。刚刚试了一下,现在可以了 😂 谢啦!

  • naturalCloud

    建议开发自定义用户名密码登录的功能,不非得依赖 GitHub 登录。

    1 回复
  • yifabukeshoushi

    建议增加一个文章置顶的功能

    1 回复
  • 88250

    有置顶功能的,谢谢。

  • Luzandbeing

    怎么 新增分类啊?

    1 回复
  • 88250

    在分类管理处进行添加。

  • PSDLGD

    获取 GitHub 用户信息异常,请从源站重新登录 这是什么情况

    1 回复
  • winecos 1 评论
    该回帖仅作者和楼主可见
    可参考这里
    88250
  • ibywind

    @88250 你好,我尝试修改 latke.properties 中的端口为 8081 , 因为之前 nginx 代理 配置的 solo 是 8081,但是 一直报错 端口占用。查看 core.jar 源码也只是 打印异常信息并未 打印 占用端口,请问下这个问题有什么好的解决办法吗 ?

    1 回复
  • 88250

    不建议修改配置文件,可通过启动参数配置:

    • 监听端口 --listen_port
    • 访问端口 --server_port
    1 回复
  • ibywind

    @88250 不好意思,打扰了 我又看了下源码 ,找到了 通过 命令行传参的方式 设置端口。谢谢您的支持。

  • ibywind

    是的,我看了下源码明白了。修改了下 启动脚本,然后看到了 使用指南。这里粘贴出来给大家

    下面是我的 run.sh 放到根目录 就行

    echo "starting solo...."
    Java -cp "lib/*:." org.b3log.solo.Server --listen_port=8081
    

  • liunian-zy

    windows 下启动后在生成静态站点的时候会提示 Do not support this feature while running in Jar

    1 回复
  • 88250

    感谢反馈,问题已经修复。请拉取最新代码构建,zip 发布包要等 v4.0.0 才会更新了。

    1 回复
  • liunian-zy

    好的~

  • liunian-zy
    该回帖仅作者和楼主可见
    1 回复
  • 88250

    麻烦贴一下完整命令

    1 回复
  • liunian-zy
    该回帖仅作者和楼主可见
  • liunian-zy 1 评论

    在本地发布文章后,生成的静态站点里的文章还是使用的本地域名,没有使用手动输入的域名。

    本地环境:win10+ 源码编译运行

    【补充】

    我简单看了下源码,因为 Java 不是很懂,所以我做了一个简单粗暴的测试,我发布了两篇文章,然后在数据表里将其中一篇文章的地址去掉 .html 后缀,此时再生成静态站点的话,去掉后缀的文章代码中域名就是正确的,另一个则是错误的,如果只发布一篇文章,即使去掉后缀也是生成错误的域名。具体原因没有细扣,坐等作者答复 😄

    【再次补充】

    又测试了几次,发现总是发布的最后一篇文章里的域名是错误的,查看日志发现最后发布的文章是第一个进行静态生成的,大概可以得出第一个生成的文章是有问题的。

    1 回复
    2 操作
    liunian-zy 在 2020-02-28 17:00:54 更新了该回帖
    liunian-zy 在 2020-02-28 16:42:30 更新了该回帖
    收到,稍后排查,我这现在停电了 😂
    88250
  • 88250

    刚刚再次进行了修复,麻烦试试看,辛苦辛苦 🙏

    1 回复
  • liunian-zy

    已经 ok 了。还有个感觉可以优化一下的,就是静态站点输入框那里的地址可否存储一下,或是 ck 或是数据库,这样不用每次都输入域名,在测试中发现有时候是会有上一次是输入数据的,有时候没有,不知道是代码里没写这个功能还是我个人原因。

    1 回复
  • 88250

    收到,已做优化:在浏览器 localStorage 保存最近一次输入的域名,代码已经提交 🍇

  • liunian-zy

    在管理后台(或者前台总之带上 skin 参数)进行预览皮肤后,即使没有设置该皮肤,前台也会变成刚刚预览的皮肤。经过测试发现应该是预览皮肤时留存在 ck 中的 skin 值导致的,新开浏览器窗口访问是无影响的。(带着皮肤参数访问你的博客再刷新也是如此哦~本来以为只是我自己本地的环境导致)

    1 回复
  • 88250

    这是个特性 😄

    1 回复
请输入回帖内容 ...