使用soka博客主题部署到宝塔,搭建自己的博客网站
2025年11月29日
1013字

前言

为什么会选择soka博客主题搭建,主要是因为静态博客的架构,静态站点的优势这里我就不讲了,主要还是看着好看…

soka博客主题官网:Soak博客主题 —— 溯源而进,化古为新 - 赵阿卷

👍支持正版作者,尊重他人劳动成果!

一、环境配置

1.需要你有一台服务器1h1g即可ps:新手建议购买境外服务器,防止后续无法访问

2.需要你有一个域名ps:域名需要自己购买,如果使用国内的服务器,域名还需要备案

3.服务器安装宝塔,并配置好Nginx + PHP环境

4.需要带可以思考的脑子

因为阿卷大大在本地环境配置方面已经写的很全面了,所以我这里就不再重复了,直接按照主题文档进行操作即可

Soak主题使用手册

这里补充一个官方文档未提到的一点,在本地依赖安装完成,执行:

My terminal window
npm run dev

的时候会出现以下报错 报错演示

该问题的解决方式就是复制一份content.example文件夹,重命名为content。复制一份config.example文件夹,重命名为config 在执行

My terminal window
npm run dev

就可以完美本地运行 报错演示

如何部署到宝塔,绑定域名并申请SSL

这个是官方文档中未提到的,如果你有过部署静态站点的经验那么你也就学会了如何将项目部署到宝塔上 首先需要你已经完成了soka主题的本地修改,并上传到你的Github仓库里面,如果你还未进行到这一步请看官方的文档 https://docs.qq.com/aio/DT2RKRm9LbExuQWRs?p=EP9snbu4KYdRLp70TUMrVU

已经按照上面的步骤操作完毕之后,我们先打开宝塔----添加站点----选择Git部署----输入你的域名

宝塔操作

记好下面Git提供商的SSH Key 复制下来,打开你的Github找到你刚才发布的git仓库,找到右上角 Code 按钮 选择SSH,然后点击复制

Github

打开宝塔页面,把刚才复制的gie仓库地址粘贴到这里,下面的分支填写main(这是soka主题推送仓库的默认分支,如果你单独修改过的话请按实际情况填写)

Github

这里先不要点击确定!先把刚才保存的SSH key 填写到Github----Settings----SSH and GPG keys----New SSH key

Github

点击确定等待即可,至此你的soka博客主题已经在宝塔上部署完成啦!

SSL申请

直接在宝塔上面一件申请,找到你刚才添加的网站,点击SSL,然后找到下图页面,直接点击申请就好啦

Github

结束

如果你使用的是国内服务器,在同步Github仓库的时候提示报错,那么很可能是你的服务器运营商把Github给墙了,解决办法就是把 deployjs 文件下里的仓库地址,换成国内的gitee码云,然后重复上面的操作即可。

本次教程到此就结束啦,如果文章内有任何不懂的或者错误的地方,欢迎大家讨论和指正~

补充

部署完成之后你会发现你的码云项目和你的网站更新并不同步,那么我们可以使用宝塔自带的Webhook 脚本来达成实时更新的目的

Github

如上图所示,点击添加,把下面这段代码进行修改,然后保存

#!/bin/bash
echo ""
#输出当前时间
date --date='0 days ago' "+%Y-%m-%d %H:%M:%S"
echo "Start"
#git分支名称
branch="main"
#git项目路径
gitPath="/www/wwwroot/laogoua.com"
#git 仓库地址
gitHttp="https://gitee.com/laogoua/dogs-blog.git"
#gitHttp="http://192.168.2.20/llh/$1.git" //多仓库的时候
echo "Web站点路径:$gitPath"
#判断项目路径是否存在
if [ -d "$gitPath" ]; then
cd $gitPath
#判断是否存在git目录
if [ ! -d ".git" ]; then
echo "在该目录下克隆 git"
sudo git clone $gitHttp gittemp
sudo mv gittemp/.git .
sudo rm -rf gittemp
fi
echo "拉取最新的项目文件"
#sudo git reset --hard origin/$branch
git remote add origin $gitHttp
git branch --set-upstream-to=origin/$branch $branch
sudo git reset --hard origin/$branch
sudo git pull $gitHttp 2>&1
echo "设置目录权限"
sudo chown -R www:www $gitPath
echo "End"
exit
else
echo "该项目路径不存在"
echo "新建项目目录"
mkdir $gitPath
cd $gitPath
#判断是否存在git目录
if [ ! -d ".git" ]; then
echo "在该目录下克隆 git"
sudo git clone $gitHttp gittemp
sudo mv gittemp/.git .
sudo rm -rf gittemp
fi
echo "拉取最新的项目文件"
#sudo git reset --hard origin/$branch
sudo git pull gitHttp 2>&1
echo "设置目录权限"
sudo chown -R www:www $gitPath
echo "End"
exit
fi

脚本文件中的项目目录、git地址、git分支名替换成自己的就完成啦,不过这个脚本也是我在网上找的,可能有点不太适用现在的宝塔版本,等后续有更好的我在更新

# soka博客
# 搭建教程