[图片] 小而美的博客系统,专为程序员设计 [图片] [图片] [图片] [图片] [图片] [图片] 简介 Solo 是一款小而美的开源博客系统,专为程序员设计。 Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动。 这是一种全新的网络社区体验,让热爱记录和分享的你不再感到 ..

Solo 用户指南

本贴最后更新于 234 天前,其中的信息可能已经时移世改

Solo

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





        

💡 简介

Solo 是一款小而美的开源博客系统,专为程序员设计。

Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动。

这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!
具体细节请浏览 B3log 构思

🗃 案例

✨ 功能

🎨 界面

开始使用

start

后台首页

console

编辑文章

post

选择皮肤

skins

前台界面

Bubble

Casper

pinghsu

Jane

nijigen

timeline

🍱 皮肤

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

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

🛠️ 安装

本地试用

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

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

请注意:我们不建议通过 war 发布包或者源码构建部署,因为这样的部署方式在将来有新版本发布时升级会比较麻烦。
这两种方式请仅用于本地试用,线上生产环境建议通过 Docker 部署。

Docker 部署(推荐方案)

获取最新镜像

docker pull b3log/solo

启动容器

启动参数说明:

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

日志配置

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

--volume ~/log4j.properties:/opt/solo/WEB-INF/classes/log4j.properties

皮肤配置

如果要使用其他皮肤,可以挂载目录 skins(里面需要包含所需使用的所有皮肤,官方所有皮肤可从这里下载):

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

版本升级

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

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

Docker Compose

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

ARM/树莓派镜像

docker pull clinan/solo

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 $host:$server_port;
        proxy_set_header  X-Real-IP  $remote_addr;
        client_max_body_size  10m;
    }
}

感谢 @Clinan 提供。

📜 文档

🏘️ 社区

📄 授权

Solo 使用 GNU Affero General Public License, Version 3 开源协议。

🙏 鸣谢


初始化后

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

信息配置

签名档

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

参数设置

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

导入 Markdown

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

备份

安全第一,血泪的教训 😢

其他一些特性

多用户

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

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 构思的一部分实现,请大家积极参与进来 🙏

自动同步 GitHub 仓库

自动同步仓库包含了两个功能:

  1. 每 24 小时定时拉取用户 GitHub 账号下的公有仓库,然后生成一篇文章并在加入到导航中,实际效果请参看这里
  2. 每 24 小时定时导出用户的公开文章到用户的 GitHub 仓库(solo-blog),实际效果请参考这里

FAQ

服务器内存太小?

可以考虑使用内嵌的 H2 数据库代替 MySQL。如果一台服务器上要部署多个 Solo,可以考虑通过 war 包方式将它们部署到同一个 Tomcat/Jetty 中运行。

但建议还是进行内存升级,然后使用 Docker 和 MySQL 部署,这样不仅可以通过更新镜像进行平滑升级,还能使用 MySQL 相关工具更方便地进行数据库运维。

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

请参考这里进行配置。

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

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

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

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

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

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

proxy_set_header  X-Real-IP  $remote_addr;

如何插入广告展位?

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

Solo 会一直维护下去么?

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

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

当然,也欢迎大家一起来学习、折腾 Solo 程序本身,因为开源项目参与者越多,说明这个项目生命力越旺盛 ❤️

结语

如果你在使用 Solo 过程中碰到问题或者有需求要提,欢迎跟帖,我们会在第一时间回复。另外,如果你想对 Solo 进行定制开发,请参考 Solo 从设计到实现

展开
  • Solo

    Solo 是一款小而美的开源博客系统,专为程序员设计。

    Solo 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动。

    这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!
    具体细节请浏览 B3log 构思

    820 引用 • 6146 回帖 • 681 关注
  • 安装

    你若安好,便是晴天。

    74 引用 • 979 回帖
  • 文档
    51 引用 • 1036 回帖 • 1 关注
51 引用
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 个人博客教程 开源博客系統 Solo 2.9.6 发布,大量细节优化 使用 Azure App Service 免费计划部署 Solo 博客过程记录 开源博客 Solo 安装详细教程及注意事项 开源博客系統 Solo 2.9.7 发布,新皮肤 Jane
优质回帖
  • sq8852161 2

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

269 回帖
请输入回帖内容...
  • cier

    不知道是不是 bug,启动代码里改 root.setContextPath("/")没有问题,
    local.properties 里改 contextPath 总是出现静态资源无法访问问题(不用 nginx),我也试了设置 staticPath 或者不设置各种情况,都出现问题。
    对了,我是直接 eclipse 启动 Starter 的 main 函数启动的。

    1 回复
  • 其他回帖
  • alanfans

    1l

  • meikaiyipian

    2L

  • xjtushilei

    3l

  • 查看更多回帖