个人 solo 博客搭建

很早之前就开始关注 solo 了，非常喜欢这套精美的个人博客。所以当时将项目 Git 到本地搭建了一套本地的环境，出于工作原因也没有太多的时间去整理和记录一些东西到博客中来。这段时间计划把这个博客搞起来，以后多记录些用过的技术做回顾参考用。下面就我个人搭建 solo 的过程以及其中遇到的问题做个记录。

1.准备工作

当然，如果只是单纯的想了解 solo 博客的话，可以在本地搭建一套环境即可使用。

1.1 服务器

最近阿里云在做活动，优惠力度非常大，可以购买一个自己觉得合适的服务器。配置的话如果只挂 Solo，买最低配 1G1 核 1M 即可。由于搭建 solo 需要用到 docker，建议在选择服务器的系统版本时勾选 CentOS7.0 以上的版本。购买服务器后，在服务器的安全组中添加配置规则。开放如下端口：80、443、3306、8080。

1.2 域名

比起使用 ip 访问来讲，使用域名来访问的会显得比较专业。买域名可选择的服务商有很多，如果服务器是购买的阿里云的，这里域名也是首推阿里云，在后面的备案会比较方便。然后和服务器一起便于管理。
购买域名时挑选自己喜欢的就行。也是比较幸运，我买的时候发现我的。cn 域名还在。
购买域名后，域名需要进行实名认证 ---> DNS 解析 ---> 域名备案。全部搞定之后，域名才能正常的使用。建议使用 https 安全协议来访问域名，还是那句话“显得更加专业”。这个时候就需要去申请 SSL 证书了。申请成功后即可下载对应的 SSL 证书，这里我们选择 Nginx。

PS：DNS 解析需要新增解析记录，一般进入之后会有指引按钮，点击创建即可。这一步没有做的话，会导致之后的 nginx 无法解析域名从而启动失败。

2. 安装部署

准备工作都完成了之后，就可以进行 solo 博客的安装部署环节了。

2.1 Docker（已经安装 Docker 的可跳过该环节）

首先安装 Docker，前面要求系统版本一定是要在 CentOS7.0 以上的版本，就是因为 Docker 的环境必须使用高于 3.10 的内核版本，否则 Docker 无法正常运行。

安装依赖包

sudo yum install -y yum-utils device-mapper-persistent-data lvm2

设置阿里云镜像源

sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

安装 Docker

sudo yum install docker-ce

启动 Docker

# 开机自启
sudo systemctl enable docker 
# 启动docker服务  
sudo systemctl start docker

验证 Docker 是否安装成功

docker version

设置 Docker 国内镜像源
比较常用的有网易的镜像中心和 daocloud 镜像市场，个人建议使用 daocloud，原因不做阐述。

创建或修改配置文件

vi /etc/docker/daemon.json

{ 
	"registry-mirrors": ["http://ef017c13.m.daocloud.io"],
	"live-restore": true
}

也可以使用命令直接更改（建议使用）

curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://f1361db2.m.daocloud.io

重启 Docker

sudo systemctl restart docker

安装 Docker 可视化管理界面 GUI（可选）

docker volume create portainer_data
docker run -d -p 9000:9000 -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer

看着还不错，功能也蛮齐全的，安利一波。

至此 Docker 安装配置完成

2.2 安装 MySQL

MySQL 最新版本为 8.X，建议安装较为稳定的 5.6 或 5.7 的版本。这里我选择的是 Mysql5.7.28。

拉取镜像

docker pull mysql:5.7.28

启动 MySQL 容器

docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=yourpassword -d mysql:5.7.28

查看容器是否启动成功（可通过可视化界面查看）

docker ps -a

启动成功后进入 MySQL 容器

docker exec -it mysql bash

# 进入数据库 p后面跟你的密码
mysql -uroot -pyourpassword
# 创建数据库(数据库名:solo;字符集utf8mb4;排序规则utf8mb4_general_ci) 
create database solo DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;  
# 创建solo用户
CREATE USER 'solo'@'ip' IDENTIFIED BY 'password';
# 赋予solo用户solo数据库的所有权限
GRANT ALL ON solo.* to 'solo'@'ip' IDENTIFIED BY 'password';
flush privileges;
# 出现Query OK, 1 row affected (0.00 sec)表示成功
#退出数据库
exit
#退出容器
exit

至此 MySQL 安装配置完成。

2.3 安装 Solo

终于到主角了。直接运行以下命令会自动 pull solo 的镜像并启动。

docker run --detach --name solo --network=host \
--env RUNTIME_DB="MYSQL" \
--env JDBC_USERNAME="****" \
--env JDBC_PASSWORD="******" \
--env JDBC_DRIVER="com.mysql.cj.jdbc.Driver" \
--env JDBC_URL="jdbc:mysql://127.0.0.1:3306/solo?useUnicode=yes&characterEncoding=UTF-8&useSSL=false&serverTimezone=UTC" \
b3log/solo --listen_port=8080 --server_scheme=http --server_host=www.chenyangjie.com.cn

参数说明：

--env RUNTIME_DB="MYSQL" 运行时数据库类型
--env JDBC_USERNAME="solo" 数据库用户名称 solo
--env JDBC_PASSWORD="password" 数据库用户 solo 的密码
--env JDBC_DRIVER="com.mysql.cj.jdbc.Driver" \ 数据库驱动
--listen_port=8080 监听端口为 8080
--server_scheme=http 访问协议为 http
--server_host=www.chenyangjie.com.cn 访问地址，有域名的写域名，没域名的写服务器外网 ip 地址

启动成功后即可通过域名或 ip:8080 访问 solo 博客了。首次访问 solo 博客会进行初始化。初始化完毕后即可使用，使用方法参照 Solo 用户指南

2.4 安装 Nginx

Nginx 这块我不太熟，这里参照下大佬的安装过程。建议查看从零开始安装 solo 博客

# 切换到服务器根目录
cd /
# 创建主目录
mkdir dockerData
# 创建文件
mkdir dockerData/nginx dockerData/nginx/conf dockerData/nginx/logs dockerData/nginx/www dockerData/nginx/ssl

dockerData/nginx/conf 存放 nginx 相关配置文件
dockerData/nginx/logs 存放 nginx 日志文件
dockerData/nginx/www 存放 nginx 访问的资源文件
dockerData/nginx/ssl 存放 ssl 证书

启动 Nginx

docker run --name nginx -p 80:80 -d --rm nginx

Nginx 启动成功并能正常访问后导出配置文件

docker cp nginx:/etc/nginx/nginx.conf /dockerData/nginx/conf/nginx.conf 导出配置文件 nginx.conf
docker cp nginx:/etc/nginx/conf.d /dockerData/nginx/conf/conf.d 导出配置为你 nginx.conf

停止 Nginx 服务

docker stop nginx 
# 会自动删除现在的 nginx 容器，然后执行如下命令重新启动一个 nginx 容器

将之前下载的 Nginx 的 SSL证书 中的 pem 文件和 key 文件放至 dockerData/nginx/ssl 目录下。
然后配置 Niginx 文件

cd /dockerData/nginx/conf/conf.d
vim default.conf

server {
    listen       443 ssl;
    server_name  localhost;
    # ssl on;

    #charset koi8-r;
    #access_log  /var/log/nginx/host.access.log  main;

    ssl_certificate /ssl/1_******************.pem;  # ssl 证书目录
    ssl_certificate_key /ssl/1_******************.key;
    ssl_session_timeout 5m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
    ssl_prefer_server_ciphers on;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }
    # ......
}
server{
  listen 80;
  server_name localhost;
  rewrite ^(.*) https://$host$1 permanent;
}

启动新的 Nginx，并使用 https 协议访问

docker stop nginx  # 停止容器
docker rm nginx # 删除容器
# 启动新的
docker run -d -p 80:80 -p 443:443 --name nginx \
-v /dockerData/nginx/conf/nginx.conf:/etc/nginx/nginx.conf \
-v /dockerData/nginx/conf/conf.d:/etc/nginx/conf.d \
-v /dockerData/nginx/ssl:/ssl/ \
-v /dockerData/nginx/www:/usr/share/nginx/html \
-v /dockerData/nginx/logs:/var/log/nginx nginx

-p 443:443 监听 443 端口，没进行备案的域名该端口可能访问不到
-v /dockerData/nginx/ssl:/ssl/ 挂载 ssl 证书目录

2.5 使用 Nginx 反向代理实现对 solo 的访问

停止 solo，并移除 solo 容器（同样可以通过 Portainer 进行操作）

docker stop solo
docker rm solo

配置 Nginx 配置文件实现 Nginx 反向代理

cd /dockerData/nginx/conf/conf.d
vim default.conf

upstream backend {
    server localhost:8080; # Solo 监听端口
}
location / {
        proxy_pass http://www.chenyangjie.com.cn:8080;
	proxy_set_header  Host $http_host;		// proxy_set_header一定要进行配置
        proxy_set_header  X-Real-IP  $remote_addr;	// 不然会造成静态资源访问错误以及可
							// 能造成“Latke 配置错误”
    }
# 替换上面部分即可
# 按esc，然后输入:wq保持退出

重启 solo 容器

docker run --detach --name solo --network=host \
--env RUNTIME_DB="MYSQL" \
--env JDBC_USERNAME="****" \
--env JDBC_PASSWORD="******" \
--env JDBC_DRIVER="com.mysql.cj.jdbc.Driver" \
--env JDBC_URL="jdbc:mysql://127.0.0.1:3306/solo?useUnicode=yes&characterEncoding=UTF-8&useSSL=false&serverTimezone=UTC" \
b3log/solo --listen_port=8080 --server_scheme=https --server_host=www.chenyangjie.com.cn --server_port=

--server_scheme=http 换成 --server_scheme=https 即可
--server_port：最终访问端口，使用浏览器默认的 80 或者 443 的话值留空即可

重启 Nginx

docker restart nginx

至此个人的 solo 博客就搭建完成了。

3. 其他组件

3.1 挂载第三方皮肤

创建皮肤文件目录，如：/dockerData/solo/skins。将皮肤放到该目录下。

** tips ** Solo 默认使用的皮肤是 “Pinghsu”，务必将该皮肤加入文件目录中。

添加 solo 启动项配置，将皮肤文件目录挂载至 solo

# **tips** 这行配置一定要卸载“listen_port=”之前，否则由于无法监听到皮肤导致solo启动失败
--volume /dockerData/solo/skins/:/opt/solo/skins/ \

3.2 使用 Lute

Lute 使用指南传送门：Lute 使用指南

Lute 安装指南传送门：安装 Lute-http

添加 solo 启动配置项

# **tips** 先启动 lute 再添加下面启动配置启动 solo
--lute_http=http://127.0.0.1:8249 --lute_http=http://localhost:8249 --lute_http=

查看 solo 启动日志，启动参数 luteAvailable=true 即为 Lute 插件安装成功。

3.3 Solo 自动更新

Solo 自动更新传送门：Solo 自动更新

4. 后记

该文章仅供他人参考以及自身回顾作用，如有问题请指出，即刻进行修改。
技术参考：
Docker（一）Linux 开启你的 Docker 之旅
 linux 安装 docker
从零开始安装 solo 博客

6 回帖

个人 solo 博客搭建

欢迎来到这里！

我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。

注册关于

请输入回帖内容 ...

someone • 4 年前
作者

是在哪一步出了问题吗？
其他回帖
someone • 4 年前

也没显示什么错,就是打开网页不显示
someone • 4 年前
作者

也有可能文档写得还不够详细...
someone • 4 年前
作者

看日志吧，如果你配置了 Nginx 反向代理的话，页面不显示应该是 Nginx 启动出现了问题。如果是按照我这上面用 docker 搭建的，通过 Portainer 可以查看各个容器的日志。
查看全部回帖

1.准备工作

1.1 服务器

1.2 域名

2. 安装部署

2.1 Docker（已经安装 Docker 的可跳过该环节）

2.2 安装 MySQL

2.3 安装 Solo

2.4 安装 Nginx

2.5 使用 Nginx 反向代理实现对 solo 的访问

3. 其他组件

3.1 挂载第三方皮肤

3.2 使用 Lute

3.3 Solo 自动更新

4. 后记

相关帖子

负载均衡 [Nginx]

nginx 配置 https 重定向

ubuntu 20.04 自定义编译 Nginx 问题以及解决方法

Nginx 限速三剑客基础使用

CenterOS 部署 Solo

Docker 安装 Nginx 容器 - 完整详细版

使用 Nginx 做代理服务器实现上传限速

欢迎来到这里！