前言

最近发现了一个比较好看的博客主题，可惜不是mx-space / Typecho的主题。
是基于一个名为 Astro 的博客引擎下的主题。
Astro-Pure 是这款主题的名字，
神奇的是，Astro-Pure主题并不需要先部署Astro之后放置在类似Theme文件夹内那样子使用，
而是直接与Astro引擎集成在了一起。
这就为我们剩下了很多配置的时间和精力，非常不错。

这是一个最初级的教程，没有涉足很多高端操作。
如果你遇到了任何问题，可以先问问AI，如果他也不会
那我也不会 (
所以一步一步按照教程来，应该不会有事的 :)

前期准备

安装1Panel

其实这一步大可以省略，因为1Panel的安装十分简单，一条命令行的事情。
我们使用1Panel主要是用来反代站点以及配置SSL，当然如果你之前就安装过类似的控制面板，那也是极好的。

我们可以通过访问 https://1panel.cn/ 来获取安装命令，或者可以直接复制下面的指令来安装

注意，最好使用root用户权限来安装1Panel。

• 由于我的系统是Ubuntu，这里展示的是Ubuntu系统的安装指令。其他系统可以前往官网获取详细指令。

  url -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

安装后就可以通过访问提示的内网网址进入控制面板了。
你还可以顺手安装OpenResty来准备访问事宜。

安装环境

升级&安装nodejs

部分代码来自DeepSeek

使用命令来升级并安装最新的、长期支持版的nodejs

# 添加NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装Node.js和npm
sudo apt install -y nodejs

验证安装​：

node -v  # 查看Node.js版本
npm -v   # 查看npm版本

​升级npm到最新版​：

sudo npm install -g npm@latest

• 由于我不会NVM管理工具啥的，所以直接全局安装得了。（应该没啥问题……吧……)

创建网站

在1Panel的网站面板，创建一个网站，并配置好SSL即可，
复制路径然后打开

cd 你的网站路径

至此，我们的前期准备工作就完成了。

安装Astro-Pure

在终端内输入以下指令来安装Astro-Pure

npm create astro@latest -- --template cworld1/astro-theme-pure

一路按回车即可，没有什么需要配置的。当然你也可以静下心来看看。

稍等片刻即可安装成功。
如果没有报错的话，整个流程下来大概是这样子的：

如果你遇到了报错之类的情况，可以cd进Astro文件夹内，使用npm install指令重新安装。 或者配置npm镜像等来解决问题，总之把报错甩给AI，它总能帮你处理的。

删除实验性功能

这个问题我研究了一大会，应该是Astro最新的版本内置了svg，但是主题使用的仍然是实验性的svg功能。
所以我的解决方法是直接删除实验性功能里的svg功能，目前没有发现有啥BUG

我们可以直接用nano来编辑 astro.config.mjs
基本在文件尾可以看到这样一串字符：

experimental: {
  svg: true,
  contentIntellisense: true
},

我们只需要将其中的 svg: true, 删除即可，变成这样：

experimental: {
  contentIntellisense: true
},

改为生成静态文件

由于我们是部署的静态页面，所以我们还要对 astro.config.mjs 配置文件里的内容继续更改
引用 https://astro-pure.js.org/docs/setup/deployment#static里的教程，
我们只需要删除两行代码就可以了，但是我在 astro.config.mjs 文件中并没有找到以下代码，可能是Astro更新后，主题教程没有及时更新导致的。

import vercelServerless from '@astrojs/vercel/serverless' // 需要删减的

export default defineConfig({
  //   ...
  adapter: vercelServerless(), // 需要删减的
  output: 'server', // 需要删减的
})

于是我在 export default defineConfig 段里找到了名为 Adapter 的"部署器"，将其中的代码注释掉即可。

注释掉：

// adapter: vercel(),
// output: 'server',

在文件头部有一行

import vercel from '@astrojs/vercel'

将其注释掉即可。然后保存并退出文件编辑。

启动Astro

当然，你可以在启动前参考
Astro-Pure的主题配置
Astro文档

来修改并配置你的站点，其中就包括头像、站点标题等等一切你希望配置的配置。

在你准备好后，就让我们开始吧。

编译静态页面

使用命令来编译静态页面，静态文件将会保存到站点目录下的主题目录中的 dist 文件夹内。

npm run build

然后稍等片刻，编译很快就会完成。

配置网站目录

进入1panel控制台，点击网站，点击配置进入到网站的设置页面。
选择网站的目录就可以了。

大功告成

恭喜，你已经完成了所有的部署
正常情况下访问你的网站域名，就可以看到你搭建的Astro博客了！！！