导航

萌即是正义!时不时分享一些ACG活动记录与有趣代码的小站!

如何使用宝塔/aaPanel搭建猛男自用的维基萌博客

作者:广树·时间:2024-06-06 11:29:40·分类:其他

就如之前所说的一样,因为宝塔需要国内手机验证才能使用,使得无法使用真正的宝塔做演示。

但是有大佬指出宝塔他有个国际版叫做aaPanel,除了界面是英文,其他功能完全一样,所以这次的宝塔搭建教程就用aaPanel做替代了。

以下UI的中文译名我是凭直觉翻译的,可能会和真正的宝塔面板有出入。


项目仓库地址

https://github.com/eeg1412/wikimoeNodeJSBlog

在开始前可以先看看说明部分,当然不看问题也不大。

如果觉得好的话请不要忘记给项目点个星星⭐。


创建MongoDB

首先是安装维基萌博客依赖的数据库——MongoDB。


安装

QQ截图20240606103301.png

首先在面板的【应用商店】搜索mongodb,找到【MongoDB】并安装。

版本选择6.0,当然也可以选择7.0,只不过我这边没有详细测试过7.0,听其他大佬描述可以用。


创建集合(表)

QQ截图20240606103849.png

安装完后来到面板的【数据库】->【MongoDB】,选择【添加数据库】,这里的【添加到/Add to】一开始有可能什么都没有,重新刷新下页面就会出来。

配置可以按照截图,注意这里的DBName,我这里设置了大写,但是创建后会强制变成小写,用户名倒是可以大写的样子。

点击【确认】后,就创建好集合了。比1Panel要方便一些呢!

另外推荐点击【安全认证/Security authentication】开启密码认证。


使用Git下载维基萌博客

此处推荐使用Git克隆维基萌博客仓库,因为我会把相对比较稳定的代码推到仓库的main分支,这样每次维基萌博客有代码更新的时候只用拉取一下即可。


安装Git

如果服务器已经安装了Git的话,可以选择跳过。

以下是大多数Linux安装Git的指令:

在大多数基于Debian的Linux发行版(如Ubuntu)上,你可以使用apt-get命令来安装Git

sudo apt-get update
sudo apt-get install git

在基于Red Hat的Linux发行版(如CentOS或Fedora)上,你可以使用yum或dnf命令来安装Git:

sudo yum install git

或者

sudo dnf install git

在Arch Linux上,你可以使用pacman命令来安装Git:

sudo pacman -Sy git

请注意,这些命令需要管理员权限来运行,所以你需要在命令前面加上sudo。


克隆维基萌博客

QQ截图20240606104136.png

点击面板的【文件】,来到面板默认放网站的目录www/wwwroot,点击【终端】按钮打开终端输入:

git clone https://github.com/eeg1412/wikimoeNodeJSBlog.git

克隆维基萌博客的代码


更新维基萌博客

如果遇到维基萌博客的更新,在克隆好的目录下运行:

git pull

即可拉取最新的代码,然后停止并重新编译运行即可。


配置nodejs环境

QQ截图20240606104631.png

点击面板的【网站】->【Node 项目】->【Node版本管理】。

QQ截图20240606104652.png

安装Node的20.x的版本。

并且通过上方选项将命令行版本切换成20.x。

右侧选项应该是选择镜像地址,如果服务器在国内的话按需选择。


配置维基萌博客

维基萌博客的blog端和server端需要分别进行配置。

同时需要编译admin前端和blog端。


server端配置

回到刚才的项目所在目录,进入server文件夹,创建一个【.env】文件。

配置内容如下:

PORT="填写运行端口号"
DB_HOST="填写mongodb地址"
JSON_LIMT="JSON格式的大小限制如(50mb)"
URLENCODED_LIMT="URL编码的大小限制如(50mb)"
JWT_SECRET="JWT所用的密文"
IP2LOCATION="1为开启IP地址解析"
IP2LOCATION_FILE_NAME="地址解析用到的BIN文件,一般为IP2LOCATION-LITE-DB3.BIN,切记一定要下载【DB3.LITE】的BIN文件"
MAX_HISTORYLOGS_SIZE="日志集合的最大占用空间,单位字节默认1073741824(1GB)"

其中几个需要注意的配置

DB_HOST

需要填写上面配置好的MongoDB信息。

比如我在上面配置的MongoDB数据库名是wikimoeblog,用户名是wikimoeBlog,密码是password,那么对应的地址就是:

DB_HOST=mongodb://wikimoeBlog:password@127.0.0.1:27017/wikimoeblog


JWT_SECRET

这个参数必须要复杂且随机,因为关系到账号安全。


IP2LOCATION

如果不用解析IP地理位置的话务必设为0,否则找不到对应数据库是会出错的!


IP2LOCATION_FILE_NAME

解析IP地址所用数据库的文件名。

关于 IP2LOCATION 文件:

  • 请自行在IP2Location Lite网站注册下载 BIN 文件。
  • 注意一定要选择【DB3.LITE】 IP-COUNTRY-REGION-CITY 的 BIN 文件,如果网站有 IPv6 需求的话可以下载 IPv6 的 BIN 文件,IPv6 的 BIN 文件已经包含 IPv4。
  • 下载的 BIN 文件请放在 server/utils/ip2location 目录下


其他配置

其他可以按照自己的需求或者直接参照同目录下的sample.env即可。

PORT=3000
DB_HOST=mongodb://mongodb:27017
JSON_LIMT=50mb
URLENCODED_LIMT=50mb
JWT_SECRET=your_jwt_secret
IP2LOCATION=0
IP2LOCATION_FILE_NAME=
MAX_HISTORYLOGS_SIZE=1073741824


blog端配置

和server端差不多的步骤,来到blog文件夹,创建一个【.env】文件。

NUXT_API_DOMAIN="填写API的HTTP地址,如:http://localhost:3006"
GOOGLE_ADSENSE_ID="如果需要设置谷歌广告,填写谷歌广告ID"
GOOGLE_ADSENSE_TEST_MODE="是否启用测试模式 1 为启用,0 为不启用"
GOOGLE_ADSENSE_POST_DETAIL_BT="文章底部广告,填写格式为:ad-slot,ad-format,ad-layout-key"
SWR_ENABLED="设置为1时打开SWR缓存,将会消耗大量内存提升访问速度"
SWR_CACHE_MAXAGE="SWR缓存时间,单位秒,默认10秒"
SWR_CACHE_STALEMAXAGE="staleMaxAge的时间,单位秒,默认3600秒"
CACHE_MAX_PAGE="开启SWR时的缓存页面数量,默认10个页面"
CACHE_TTL="缓存的过期时间,单位毫秒,默认60000毫秒"
SHOW_LOADING="是否显示进入网站时的读取动画,需要时为1"

这里需要注意的配置如下:

NUXT_API_DOMAIN

这里是设置反代到server API的域名。

如果上面server配置的PORT是3000的话,那么

NUXT_API_DOMAIN=http://localhost:3000


GOOGLE_ADSENSE_ID

如果有谷歌广告的话,这里需要填写谷歌广告的ID,没有就留空。


GOOGLE_ADSENSE_POST_DETAIL_BT

如果有谷歌广告并且想在文章设置广告的话,需要按照顺序填写【ad-slot,ad-format,ad-layout-key】

这几个参数的获取途径可以在谷歌广告的【广告】->【按广告单元】下面自己分配的广告单元,点击【获取代码】可以看到对应的参数:

image-bye37acw.png

按照顺序将等号后面的字符串填入即可。


其他配置

其他配置可以按需填写对应的数值,或者直接填写同目录下的【sample.env】默认配置也是可以的。

NUXT_API_DOMAIN=http://localhost:3000
GOOGLE_ADSENSE_ID=
GOOGLE_ADSENSE_TEST_MODE=
GOOGLE_ADSENSE_POST_DETAIL_BT=
SWR_ENABLED=1
SWR_CACHE_MAXAGE=10
SWR_CACHE_STALEMAXAGE=3600
CACHE_MAX_PAGE=10
CACHE_TTL=60000
SHOW_LOADING=1


blog端编译

在blog目录点击【终端】运行:

yarn --version

查看yarn是否已经安装。

如果提示不存在yarn的话,请自行通过npm安装yarn

npm install -g yarn

确认完yarn后运行:

yarn install

安装依赖。

期间可能会收到这样的信息:

QQ截图20240606105209.png

大致意思是是否允许匿名收集信息给nuxt,按照自己情况选择yes或者no吧。

安装完成后运行:

yarn run build

进行编译。


admin管理前端编译

进入admin目录,点击【终端】,运行:

yarn install

安装依赖,完成后运行:

yarn run build

进行编译。


设置站点

QQ截图20240606110147.png

点击面板【网站】->【Node项目】-> 【添加Node项目】,分别设置管理端和博客端站点。


设置管理端

QQ截图20240606110331.png

管理端站点配置可以参照上面这张图片。

目录直接选择项目的【server】目录。

端口填写【server】目录【.env】文件中的PORT配置。

Node版本选择v20.x。

域名按照自己的实际情况填写。

添加后会自动给管理端安装依赖并运行。


设置博客端

QQ截图20240606110826.png

博客端的目录则在项目【blog】目录下的【build】。

启动命令选择【start-linux】。

端口填写3007。

Node版本选择v20.x

其他配置按需填写。

添加后会自动给管理端安装依赖并运行。


设置站长账号

还是通过面板的【文件】选项,进入项目的【server】目录,打开【终端】,输入:

yarn run create-user 账号 密码 昵称

创建站长账号,这里需要注意:

  • 用户名仅支持半角小写英文和数字
  • 密码必须 4 位以上且包含大小写、数字和符号(!@#$%^&*)


博客管理后台配置

QQ截图20240604103827.png

通过【管理后台域名/admin】,输入上面设置的站长账号和密码进入管理后台。

点击【设置】->【网站设置】,将这里所有的必填项都设置上

其他配置也可以适当设置以下。

QQ截图20240604104344.png

最后通过【博客域名】,就可以看到博客页面啦!


优化配置nginx

对于宝塔/aaPanel的nginx,需要一些设置来优化。


优化媒体文件访问

QQ截图20240606112645.png

点击博客端的【配置】->【配置文件】,添加配置:

location /content {
    proxy_pass http://localhost:3006;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;
    add_header X-Cache $upstream_cache_status;
}

location /upload {
    proxy_pass http://localhost:3006;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header REMOTE-HOST $remote_addr;
    add_header X-Cache $upstream_cache_status;
}

其中端口号【3006】是管理端的端口,按照自己实际的管理端端口设置。

这段配置的目的是防止出现音频文件无法在safari上播放,原理就是让附件直接走nginx的反代。

QQ截图20240606112336.pngQQ截图20240606112603.png

设置后可以看到mp4文件的访问状态从200变成了206,就代表成功了。


优化api访问

如果是使用CDN的话,千万不要添加这条配置!

博客端的api部分也可以添加下面的配置来优化api访问:

QQ截图20240606112820.png

# 反代api,如果有CDN的话记得修改X-Forwarded-For
location /api/blog {
    proxy_pass http://127.0.0.1:3006;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header REMOTE-HOST $remote_addr;
    add_header X-Cache $upstream_cache_status;
}

其目的是让访问API的【X-Forwarded-For】信息强制更换成访客IP,防止管理后台IP显示不准确的情况。

#宝塔#aaPanel
侧边栏
最新评论
广树
2024-06-13
@老张博客:🤭没有被罚款喔,请大佬放心
老张博客
2024-06-13
翘班不怕被罚款呀
广树
2024-06-12
@YuanMoe:不,你已经没有沙发了
YuanMoe
2024-06-12
沙发
广树
2024-06-12
@mikusa:是的,整活类作品还是要靠动画这种形式。
正在攻略

圣兽之王.jpg

传颂之物

PSN奖杯卡

PSN奖杯卡

赞助商广告