b3log/solo

Solo Docker镜像文档

概述

Solo是一款专为程序员设计的小而美博客系统，作为B3log分布式社区的博客端节点，旨在为开发者提供简洁、高效的个人内容发布平台。该系统注重用户体验与代码质量，支持融入B3log下一代社区网络，适合构建技术分享、个人作品集展示等场景。

核心功能与特性

专为程序员优化

• 简洁直观的界面设计，专注内容创作
• 支持Markdown编辑，满足技术文档撰写需求
• 代码高亮、语法支持等开发者友好功能

丰富的定制化选项

• 多皮肤支持，包括Bubble、Casper、pinghsu、Jane、nijigen、timeline等多种风格
• 可自定义页面布局、导航菜单及功能模块
• 支持自定义域名与SEO优化

社区与集成能力

• 作为B3log分布式社区节点，支持跨平台内容同步与互动
• 集成社交分享功能，便于内容传播
• 支持评论系统与访客互动

部署与维护优势

• 轻量级架构，资源占用低
• 完善的CI/CD支持，版本更新及时
• Docker化部署，简化安装与迁移流程

使用场景

• 程序员个人博客：搭建技术分享平台，展示个人项目与经验
• 技术文档站点：用于项目文档、教程发布与管理
• 个人作品集：展示开发成果、写作作品等内容
• 小型技术社区：构建专注于特定技术领域的内容社区

部署与使用方法

Docker快速启动

bash
docker run -d \
  --name solo \
  -p 8080:8080 \
  -v /path/to/solo/data:/opt/solo/data \
  --restart=always \
  88250/solo

参数说明：

• -p 8080:8080：端口映射，将容器8080端口映射到主机8080端口
• -v /path/to/solo/data:/opt/solo/data：数据卷挂载，持久化存储博客数据
• --restart=always：容器异常退出时自动重启

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  solo:
    image: 8080:8080/solo
    container_name: solo
    ports:
      - "8080:8080"
    volumes:
      - ./solo-data:/opt/solo/data
    restart: always
    environment:
      - RUNTIME_DB=H2
      - JDBC_USERNAME=solo
      - JDBC_PASSWORD=solo
      - JDBC_DRIVER=org.h2.Driver
      - JDBC_URL=jdbc:h2:file:/opt/solo/data/h2/db;AUTO_SERVER=TRUE

启动服务：

bash
docker-compose up -d

初始配置

1. 容器启动后，通过http://localhost:8080访问博客
2. 根据引导完成初始设置（管理员账号、博客名称等）
3. 登录后台管理界面（/admin）进行主题切换、功能配置等操作

配置说明

Solo支持通过环境变量或配置文件进行个性化配置，常用配置项包括：

• 数据库配置：支持H2、MySQL等数据库，通过JDBC相关环境变量配置
• 服务器配置：端口、上下文路径等
• 邮件服务：用于评论通知、密码重置等
• 缓存配置：优化系统性能

详细配置参数请参考Solo用户指南

相关资源

• https://github.com/88250/solo
• 用户指南
• 皮肤开发指南
• B3log分布式社区

许可证

本项目采用AGPLv3开源许可证