时光与我

我的车是自由的，但好像我不是

Fri, 17 Jul 2026 00:00:00 GMT

我的车是自由的，但好像我不是

我看似握着方向盘，可以决定去往何方，但实际上，我的身体被安全带束缚在车头里狭窄的铁盒子里。

今天跑在路上，看着方向盘和前面空荡荡的高速，脑子里突然冒出一个奇怪的念头：

这车是自由的，我不是。

今天跑了几百公里，跨了几个市，够自由了吧？想去哪一脚油门就去了。

我不是个悲观的人，今天突然就觉得，像是被这铁壳子关了禁闭——虽然没有像牢笼那么夸张，但是下了车哪也去不了，上了车不管车车去哪，我还是在铁盒子里。

三天打鱼两天晒网的例外，跑到哪玩到哪的例外——因为对于他们来说，这行真的很自由。

正经开货车的，是真的没有时间停下来看看路边风景，不想也不敢。

自由，其实我入行之前也是这么想的：想去哪去哪，想休息就休息。但真踩油门的是我，熬夜的是我，冬冷夏热的是我，看看余额嘴角一撇不敢回家的还是我。

草

真心奉劝，没入行别进来——不挣钱还特么累。想要自由的你就更别入行了，因为你的活动场地只会在车头里。

你会活成一个和铁疙瘩融为一体的、莫得感情的挣钱机器。

抽根烟，接着赶路。

这车离了我不行，我离了车活不了。就这么回事。

🚛 同行的，看完记得继续赶路

如果你是同行——你懂的。

如果还没入行——慎重。

这行没有"自由"二字，只有"熬"。

抽完这根烟，下一单已经在路上。

看，这是我年少时的头像

Sat, 11 Jul 2026 00:00:00 GMT

追忆

相信用过的人很多

我用到大学毕业的头像，虽然看着很模糊，但记忆也模糊了。

暴露年龄了，用过这头像的也暴露了。

今天闲着没事瞎JB翻相册，看到这头像后怔了征，艹，我那一去不复返的青春啊，还给我好吗？

这是我最喜欢的一个头像，承载了我那破烂青春的操蛋回忆。

用了很多年，朋友们头像三天换两个，问我咋不换头像，我说：换你妹！

回忆不能追忆，藏着吧，再想就写不下去了。

新头像

新博客新气象

本来想直接用这糊的发糊的旧头像，

但有些机械化的脑子灵光一闪，用AI修复个这玩意儿看看效果？

干！

本来想直接丢给豆包的，但是昨天我问他我帅不帅，他居然在没看到我的情况下说我帅，一切不以事实为根据的夸赞都是在撒谎，麻的，骗人精。

我直接丢给Gemini：

没胡子也修出来胡渣了？秒变大叔！连特么AI也知道我的青春不在了吗？

用！

新头像的使命

年纪大了

无论什么东西都不想换来换去了，所以，前半生的模糊回忆，继续陪伴我的后半生可好？

换头像， 完结。

Astro MDX 组件使用完全指南

Thu, 18 Jun 2026 00:00:00 GMT

import { Aside, Tabs, TabItem, Steps, Timeline, Spoiler, Icon } from 'astro-pure/user' import { GithubCard, LinkPreview } from 'astro-pure/advanced'

mdx 组件使用实例

在 Astro 中使用 .mdx 格式写文章，最大的好处是可以引入主题内置的交互组件，丰富排版。

引用示例

用到哪个组件就引用那个组件，按需选择，注意区别导入来源from 'astro-pure/user'或from 'astro-pure/advanced'。

import { Aside, Tabs, TabItem, Steps, Timeline, Spoiler, Icon } from 'astro-pure/user'
import { GithubCard, LinkPreview } from 'astro-pure/advanced'

组件总览表

| 组件名 | 导入来源 | 功能 | 典型场景 | |---|---|---|---| | Aside | astro-pure/user | 提示框（note/tip/danger 等类型） | 文中加提示、警告 | | Card | astro-pure/user | 卡片容器，可放列表/任意内容 | 信息分组展示 | | Collapse | astro-pure/user | 折叠展开块 | FAQ、隐藏细节 | | Tabs / TabItem | astro-pure/user | 选项卡切换 | 多语言/多方案对比 | | Timeline | astro-pure/user | 时间线 | 履历、版本更新记录 | | Steps | astro-pure/user | 步骤列表 | 教程操作步骤 | | CardList | astro-pure/user | 卡片列表 | 资源/链接汇总 | | Button | astro-pure/user | 按钮（支持 link / pill 样式） | 行动召唤按钮 | | Spoiler | astro-pure/user | 剧透遮挡（hover 显示） | 隐藏答案、剧透内容 | | FormattedDate | astro-pure/user | 格式化日期 | 统一日期展示 | | Label | astro-pure/user | 小标签徽章 | 状态/分类标记 | | Svg | astro-pure/user | SVG 加载器 | 内联矢量图 | | Icon | astro-pure/user | 主题内置图标（github/bilibili/rss 等 40+） | 社交链接、装饰图标 | | MdxRepl | astro-pure/user | MDX 代码演示器 | 实时预览代码渲染结果 | | Quote | astro-pure/advanced | 随机名言（支持 Quotable / 一言 API） | 页脚随机语录 | | GithubCard | astro-pure/advanced | GitHub 仓库卡片 | 展示开源项目 | | LinkPreview | astro-pure/advanced | 链接预览卡片（自动抓取 OG 信息） | 友链、推荐文章 | | QRCode | astro-pure/advanced | 二维码生成 | 扫码跳转 | | Toast | astro-pure/advanced | 轻提示 | 复制成功等反馈 | | Medium Zoom | astro-pure/advanced | 图片灯箱放大 | 文中图片点击放大 |

1. 提示框

Aside 组件用于在文中插入醒目的提示，支持 note（默认）、tip、danger 等类型。

示例，可直接复制使用：

<Aside type='tip' title='小技巧'>
写代码前先喝口水。 
</Aside>

<Aside type='danger' title='警告'>
不要在生产服务器上跑 `rm -rf /`。
</Aside>

实际渲染效果：

2. 选项卡

Tabs 和 TabItem 组合使用，适合展示多语言或多方案的对比。

示例，可直接复制使用：

<Tabs>
  <TabItem label='npm'>
bash
npm install astro

  </TabItem>
  <TabItem label='pnpm'>
bash
pnpm add astro

  </TabItem>
  <TabItem label='yarn'>
bash
yarn add astro

  </TabItem>
</Tabs>

实际渲染效果： bash npm install astro

3. Steps —— 步骤列表

自动识别有序列表并渲染为步骤样式 示例，可直接复制使用：

<Steps>

1. 安装依赖
2. 启动开发服务器
3. 编写第一篇文章
4. 构建并部署

</Steps>

实际渲染效果：

4. Timeline —— 时间线

示例，可直接复制使用：


<Timeline events={
  [
    { date: 'August 2021', content: 'Hello' },
    { date: 'August 2022', content: '<i>World!</i>' },
  ]
} />

实际渲染效果：

更多请移步 Docs文档

💡 更多请移步 Docs文档···

Astro 博客 Frontmatter 标准模板速查

Thu, 18 Jun 2026 00:00:00 GMT

import { Aside, Tabs, TabItem, Steps, Timeline, Spoiler, Icon } from 'astro-pure/user' import { GithubCard, LinkPreview } from 'astro-pure/advanced'

md 标准模板。

字段配置与功能说明

你可以直接复制下面这里的内容：

---
title: '文章标题'                     # 【必填】显示在文章顶部及浏览器标签页
publishDate: 'May 10, 2025'          # 【必填】发布日期，前台列表按此排序。格式如 'May 10, 2025' 或 2024-01-01
updatedDate: 'June 12, 2025'         # 【可选】更新日期，显示“最后更新于”，对 SEO 友好
slug: 'my-custom-url'                # 【可选】固定网址路径，改文件名也不会导致 404（生效）
description: '文章摘要描述'           # 【必填】列表卡片简介，同时用于搜索引擎 SEO 抓取
draft: false                         # 【可选】是否为草稿。true 为草稿不显示，false 为正常发布，默认 false
tags:                                # 【可选】用于标签云和文章分类
  - 标签1
  - 标签2
language: '中文'                     # 【可选】声明本文语言，适配多语言排版
heroImage: { src: './thumbnail.jpg', color: '#9698C1' }  # 【可选】封面图配置。必须是对象！src 为同目录相对路径，color 为加载前占位色
---

正文从这里开始写...

使用说明：

代码块内#后面的内容在实际网页构建时会被自动忽略，不会显示在正文中，可删可不删。
请确保 heroImage 的 src 指向的图片（如 thumbnail.jpg）与这个 .md 文件放在同一个文件夹里。如果不需要封面图，直接把 heroImage 这一整行删掉即可。
冒号:后面必须有空格才能写代码或注释。
严禁使用 Tab 键进行缩进，tags 下面的 - 前面必须用空格。

mdx 标准模板。

MDX 的头部配置与 MD 完全一致，最大的区别在于结束的 --- 之后，可以紧跟着引入组件并在正文中使用它们。

字段配置与功能说明

你可以直接复制下面这里的内容：

---
title: '文章标题'                     # 【必填】显示在文章顶部及浏览器标签页
publishDate: 'May 10, 2025'          # 【必填】发布日期，前台列表按此排序。格式如 'May 10, 2025' 或 2024-01-01
updatedDate: 'June 12, 2025'         # 【可选】更新日期，显示“最后更新于”，对 SEO 友好
slug: 'my-custom-url'                # 【可选】固定网址路径，改文件名也不会导致 404（生效）
description: '文章摘要描述'           # 【必填】列表卡片简介，同时用于搜索引擎 SEO 抓取
draft: false                         # 【可选】是否为草稿。true 为草稿不显示，false 为正常发布，默认 false
tags:                                # 【可选】用于标签云和文章分类
  - 标签1
  - 标签2
language: '中文'                     # 【可选】声明本文语言，适配多语言排版
heroImage: { src: './thumbnail.jpg', color: '#9698C1' }  # 【可选】封面图配置。必须是对象！src 为同目录相对路径，color 为加载前占位色
---

import { Aside } from 'astro-pure/user'   # 【关键】mdx专属！在 --- 下方引入你需要的组件

正文从这里开始写，在.mdx 中，你可以直接像写 HTML 一样使用刚刚引入的组件：

<Aside type='tip' title='这是一个提示框'>
  这里是提示框组件内部的文字内容。
</Aside>

使用说明：

代码块内#后面的内容在实际网页构建时会被自动忽略，不会显示在正文中，可删可不删。
import 语句必须紧跟在头部 --- 的下方，不能写在其他地方。
请确保 heroImage 的 src 指向的图片（如 thumbnail.jpg）与这个 .mdx 文件放在同一个文件夹里。如果不需要封面图，直接把 heroImage 那一整行删掉即可。
冒号:后面必须有空格才能写代码或注释。严禁使用 Tab 键进行缩进。

小白 1Panel + Docker 部署 Astro pure 主题博客全过程

Tue, 16 Jun 2026 00:00:00 GMT

import { Aside } from 'astro-pure/user'

本文记录了在 1Panel 环境下，使用 Docker 容器部署 Astro 的 astro-theme-pure 主题的全过程。

全程可视化操作，少量命令，部署完后添加1panel的计划任务，自动构建发布文章，

适用于只会html，而且还不会docker的小白，对，就是我，我也不会

纯记录，下次安装就会忘了踩过的坑，忘了怎么装，会的大佬不用看了。

环境准备

已安装 1Panel 的 Linux 服务器。
域名解析：建议提前在域名服务商处将 你的域名.com 和 www.你的域名.com 解析到你的服务器 IP。
已在 1Panel“应用商店”中安装并启动 OpenResty。已将主题源码下载到本地，当然，也可以直接克隆到你的服务器上。

创建静态网站与上传源码

打开 1Panel 左侧菜单 → “网站” → “创建网站”。
选择 “静态网站”。
填写信息：
- 域名配置：
  - 在“域名”一栏，点击 “批量编辑” 按钮。
  - 在弹出的文本框中输入两个域名（顺序不限）：
    你的域名.com www.你的域名.com
  - 注意：1Panel 会根据你输入的第一个域名自动生成项目目录。
    - 如果 你的域名.com 在第一行，目录为 /opt/1panel/www/sites/你的域名.com/index。
    - 如果 www.你的域名.com 在第一行，目录为 /opt/1panel/www/sites/www.你的域名.com/index。
    - 顺序均可，请记下页面下方显示的“根目录”路径，后续步骤需保持一致。
- 备注：如“Astro Blog”。
- 根目录：保持默认（1Panel 会根据第一个域名自动填入），请记下此路径。
- 启用 HTTPS（可选但推荐）：
  - 如果你的域名已解析生效，且服务器开放了 80/443 端口，你可以直接勾选此项，并选择“Let's Encrypt”来自动申请证书。
  - 如果你已有证书（如购买的证书），可勾选后选择“已有证书”并上传。
  - 注：如果暂时不确定，可以不勾选，等待网站创建完成后，在“网站设置”中再申请也可以。
点击“确认”。
打开“网站”列表，找到刚创建的网站，点击“网站目录”下的文件夹图标，进入 index 目录。
在“文件”界面：
- 点击“上传”，将主题源码压缩包上传到 index 目录。
- 选中压缩包，点击“解压”。
- 确保解压后的项目文件直接位于 index 目录下（能直接看到 package.json、astro.config.ts 等）。

创建 Node 运行环境容器

使用官方 Node 镜像作为构建环境，并设置启动命令让容器保持常驻。

打开 1Panel 左侧菜单 → “网站” → “运行环境”。
选择 “Node” → “创建运行环境”。
填写配置：
- 环境名称：自定义，如 astro-node。
- Node 版本：选择最新 LTS（如 22）。
- 项目目录：填写你在上一步“创建静态网站”时看到的根目录路径。
  - 例如：/opt/1panel/www/sites/你的域名.com/index （或其他实际生成的路径）。
  - 关键点：此处必须与静态网站的实际代码目录完全一致，否则容器无法读取源码。
- 端口映射：填写 4321:4321（用于开发调试，生产环境构建不需要）。
- 启动命令（关键步骤）：
  - 选择“自定义启动命令”。
  - 填入： tail -f /dev/null
  - 解释：Astro 是静态构建，不需要常驻的 Node 服务。如果选择默认的 npm start 等命令，容器启动后会找不到服务入口并自动退出，导致你无法进入终端敲命令。tail -f /dev/null 是一个“占位”命令，能让容器保持**一直运行（Running）**的状态，这样你随时都可以通过 1Panel 进入容器终端去执行 npm run build。此命令资源占用极低，不会影响服务器性能。
点击“确认”，等待容器创建并启动。
- 确认容器状态为“运行中”。

安装依赖

为了保证在不同服务器架构下（如从 Mac 到 Linux）的兼容性，建议进行全新安装（也可直接安装）。

打开 1Panel 左侧菜单 → “容器”。
在容器列表中找到刚创建的 Node 环境容器，点击右侧 “终端”。
确认目录：进入终端后，通常会自动处于 /app 目录。你可以输入 pwd 确认。如果不在，请执行 cd /app。
依次执行以下命令：

rm -rf node_modules package-lock.json
npm install

直接安装可不执行：rm -rf node_modules 解释：删除旧依赖（可能包含不兼容的二进制文件），然后在当前容器环境中重新编译安装。

💡 提示：为什么要删除 package-lock.json？ package-lock.json 记录了本地环境的精确依赖版本。在 Docker 容器中直接复用本地锁文件可能会导致二进制文件（如 Sharp）因系统架构不同（如 Mac vs Linux）而加载失败。删除它会强制 npm 根据 package.json 在当前容器环境中重新生成锁文件，确保兼容性。

安装成功的标志：执行完毕后，如果看到类似以下输出（包含 added ... packages 和 audited ... packages），即表示安装成功：

added 685 packages, and audited 686 packages in 4m 283 packages are looking for funding run npm fund for details 6 vulnerabilities (2 low, 4 high)

注意：提示中出现的 vulnerabilities（安全漏洞）是 npm 的安全审计警告。在开发/构建阶段，这些通常不会导致构建失败，建议忽略即可，不影响后续操作。

修改构建配置为静态模式

默认 astro-theme-pure 为 Server 模式（SSR），需要改为 Static 模式。

在 1Panel 左侧菜单打开 “文件”。
进入你的项目目录（例如 /opt/1panel/www/sites/你的域名.com/index/）。
找到 astro.config.ts，点击右侧 “编辑”。
在编辑器中进行如下修改：
- 将 site 改为你的主域名（建议使用不带 www 的版本作为规范域名），例如：
  site: ‘https://timingme.com’ ,
- 将 output: 'server' 改为： output: 'static',
- 删除以下整行（Static 模式不需要适配器）：
  adapter: vercel({ imageService: true }),
- 同时删除顶部的导入语句（如果不再需要）：
  import vercel from ‘@astrojs/vercel’
点击“保存”。

远程头像域名

确认为 cravatar.cn 而不是 www.gravatar.com。如不是请修改，或自行替换为其他头像源 方法一：使用 1Panel 可视化编辑（推荐）

在 1Panel“文件”中，进入项目目录下的 public/ 文件夹。
找到 links.json，点击“编辑”。
使用编辑器的“查找/替换”功能：
- 查找：cravatar.com
- 替换为：www.gravatar.cn
保存文件。

方法二：使用命令行快速替换（可选）

进入 Node 容器的“终端”。

执行以下命令即可批量替换：

sed -i ‘s/cravatar.com/www.gravatar.cn/g’ /app/public/links.json

构建项目

回到 1Panel“容器”页面，进入 Node 容器的“终端”。
确保当前目录为 /app（通常默认就是），然后执行：
```
npm run build
```

情况 A：构建成功

如果看到末尾提示 [build] Complete!，说明一切顺利，请跳至下一步 修改网站运行目录为 dist。

情况 B：构建报错 MissingSharp

如果构建过程中报错 MissingSharp: Could not find Sharp，这是图片处理库兼容性问题。请按以下步骤修复：

1. 为什么会报错？

Sharp 是什么：Sharp 是 Node.js 中最快、最高性能的图片处理库，用于在构建时自动压缩、转换图片格式（如转 WebP）并调整尺寸，以提升网站加载速度。
报错原因：Docker 容器环境有时无法正确加载 Sharp 的预编译二进制文件（可能是因为系统架构差异或库版本过新），导致构建失败。

2. 解决方法：安装稳定版 Sharp

请在容器终端中执行以下命令，安装兼容性最好的 0.32.6 版本：

npm install --save sharp@0.32.6

3. 验证安装

执行完命令后，如果看到 added 56 packages, changed 1 package，说明安装成功。可以执行以下命令静默验证（无输出即成功）：

node -e “require(‘sharp’)”

4. 重新构建

安装成功后，再次执行构建命令：

npm run build

此时应该能看到 generating optimized images 的日志，并显示图片压缩比例（例如 before: 253kB, after: 14kB），最后提示 [build] Complete!。

修改网站运行目录为 dist

让静态网站真正指向构建好的 dist 目录。

打开 1Panel 左侧菜单 → “网站”。
在网站列表中，找到你创建的静态网站，点击 “设置”。
切换到 “网站目录” 标签页。
在 “运行目录” 处，从下拉列表选择或手动输入：
- /dist
点击“保存”或“保存并重载”。

现在，访问你的域名将看到 Astro 构建后的静态网站内容，且头像应正常显示。

配置 HTTPS（如果在第一步未完成）

如果你在第一步创建网站时没有勾选“启用 HTTPS”，可以在这里补充配置。

在网站“设置”→ “HTTPS” 页面。
选择 “申请 Let’s Encrypt 证书”。
建议开启 “HTTP 自动跳转到 HTTPS”。

后续更新流程

发布新文章或修改配置时，只需重复以下步骤：

在 1Panel“文件”中，将 Markdown 文件上传到 content/blog 目录，或修改 src/site.config.ts 等配置。
进入 Node 容器“终端”，执行：
```
npm run build
```
静态网站指向的是 dist 目录，构建完成后刷新浏览器即可看到更新内容。

（可选）本地开发调试

如果你希望在开发时实时预览，可以使用映射的 4321 端口进行调试。请注意：本步骤依赖已安装的依赖（node_modules），在执行前请确保已按照“安装依赖”章节完成安装，否则会提示 astro: not found。

本地开发调试的用途与定位

用途：用于开发过程中快速看到修改效果，支持文件变化时自动刷新页面（热重载），便于调试布局、样式与交互。不应用于对外提供访问服务。
与生产部署的区别：
- 本地调试执行 npm run dev，启动的是 Astro 的开发服务器，仅用于开发与预览，不适合长期或对外运行；Astro 官方明确说明开发服务器仅用于本地开发。
- 生产部署执行 npm run build，生成优化的静态文件到 dist 目录，再由 OpenResty 对外提供服务。这是线上正式访问的方式。

操作步骤

进入 Node 容器的“终端”。
执行启动命令：
```
npm run dev
```
你会看到类似 Local: http://localhost:4321/ 的提示。
在浏览器中访问 http://你的服务器IP:4321，即可看到实时预览效果。

注意：开发服务器仅供临时调试使用，生产环境请始终使用 npm run build + 静态站点的方式对外提供服务。

计划任务

设置计划任务会自动监测blog目录的文章变化，你所写的md格式文章都要放在这里，构建生成纯静态文章显示在你的博客前台。有变动就触发构建命令发布文章，所以，你想发布或修改文章后还要敲一遍命令才能发布成功吗？？？反正我不想。

添加shell计划命令，把下面代码贴进去，自动检测时间设置为5分钟，ai推荐的5分钟，咱也不知道合不合理，但我改成了10分钟，反正平时发文章后也不急着看到效果，因为你在编辑markdown文章时已经预见或已经看到了效果，这里只负责构建。如果真急的话，5分钟你也嫌长。真急的话，计划任务能手动点执行，立刻就能看到效果。

注意：

1.只有当blog目录下的文件有变动，这个计划任务命令才会触发构建，这个目录以外的任何文件有变动就不能执行了，手动也不行！

2.下面代码配置的路径和域名记得修改，人和人是不一样的，所以人和人的网站路径和域名也不一定一样的：


#!/bin/bash
set -e

# ===== 配置区域 =====
CONTAINER_NAME="astro"
# 宿主机上的项目根目录
PROJECT_DIR="/opt/1panel/www/sites/你的域名.com/index"
# 监控的博客文章目录
WATCH_DIR="$PROJECT_DIR/src/content/blog"
# 日志文件
LOG_FILE="/tmp/astro-build.log"
# 时间戳文件
STAMP_FILE="/tmp/astro-blog-stamp"
# 锁文件 (防止并发构建)
LOCK_FILE="/tmp/astro-build.lock"
# =====================

# 0. 清理函数
cleanup() {
    rm -f "$LOCK_FILE"
    }
    trap cleanup EXIT

    # 1. 检查锁文件
    if [ -f "$LOCK_FILE" ]; then
        echo "$(date) 检测到已有构建任务在运行，跳过本次执行。" >> "$LOG_FILE"
            exit 0
            fi
            touch "$LOCK_FILE"

            # 初始化时间戳文件
            [ -f "$STAMP_FILE" ] || touch "$STAMP_FILE"

            # 2. 【重点修改】检查是否有文件更新 (包含图片)
            NEW_FILE=$(find "$WATCH_DIR" -type f \
              \( -name '*.md' -o -name '*.mdx' \
                -o -name '*.jpg' -o -name '*.jpeg' \
                  -o -name '*.png' -o -name '*.gif' \
                    -o -name '*.webp' -o -name '*.svg' \
                      -o -name '*.avif' \) \
                        -newer "$STAMP_FILE" 2>/dev/null | head -1)

                        if [ -z "$NEW_FILE" ]; then
                          # 这一步就是刚才导致“秒成功”但没有变化的原因
                            exit 0
                            fi

                            echo "$(date) =============================" >> "$LOG_FILE"
                            echo "$(date) 检测到新文件: $NEW_FILE，开始在容器内构建..." >> "$LOG_FILE"

                            # 3. 备份旧的 dist 目录
                            BACKUP_DIR="$PROJECT_DIR/dist_backup"
                            rm -rf "$BACKUP_DIR"
                            if [ -d "$PROJECT_DIR/dist" ]; then
                                cp -r "$PROJECT_DIR/dist" "$BACKUP_DIR"
                                    echo "$(date) 已备份旧版本" >> "$LOG_FILE"
                                    fi

                                    # 4. 执行构建
                                    docker exec "$CONTAINER_NAME" sh -c "cd /app && npm run build" >> "$LOG_FILE" 2>&1

                                    # 5. 检查结果
                                    if [ $? -eq 0 ]; then
                                        echo "$(date) ✅ 构建成功！" >> "$LOG_FILE"
                                            touch "$STAMP_FILE"
                                                rm -rf "$BACKUP_DIR"
                                                    echo "$(date) 流程结束。" >> "$LOG_FILE"
                                                    else
                                                        echo "$(date) ❌ 构建失败！正在回滚..." >> "$LOG_FILE"
                                                            if [ -d "$BACKUP_DIR" ]; then
                                                                    rm -rf "$PROJECT_DIR/dist"
                                                                            mv "$BACKUP_DIR" "$PROJECT_DIR/dist"
                                                                                    echo "$(date) ✅ 已回滚。" >> "$LOG_FILE"
                                                                                        fi
                                                                                            touch "$STAMP_FILE"
                                                                                                exit 1
                                                                                                fi

常见问题

Q1: 构建时报错 `Failed to load remote image ... The request was redirected.`

A: 某些远程图片在构建时发生重定向，Astro 的图片优化无法跟随。解决：参考教程 修复远程头像域名问题 章节进行替换。

Q2: 构建成功，但访问网站白屏或样式丢失。

检查 astro.config.ts 中 site 是否填写正确。
检查“网站目录 → 运行目录”是否设置为 /dist。
确认 dist 下是否包含 _astro 等资源目录。

Q3: Node 容器里 `npm install` 报错。

A: 建议在容器内执行 rm -rf node_modules 彻底清理旧依赖后，再执行 npm install。

Q4: 创建 Node 容器后，状态一直显示“已停止”或“重启中”。

A: 这是启动命令配置错误导致的。请检查容器配置，确保勾选了“自定义启动命令”并填写了 tail -f /dev/null。

Q5: 容器一直运行会不会占用很多资源？

A: 不会。tail -f /dev/null 命令仅仅维持一个空闲进程，几乎不占用 CPU 和内存，且数据盘已经映射到宿主机，对磁盘占用也无额外消耗。

Q6: 在容器终端执行 `npm run dev` 提示 `astro: not found`？

A: 这表示依赖未安装或被删除。请在容器终端中先执行 npm install，然后再运行 npm run dev。

Q7: 构建时提示 `MissingSharp: Could not find Sharp`？

A: 这是因为缺少图片处理库。请参考教程 构建项目 章节中的“情况 B”部分，执行 npm install --save sharp@0.32.6 即可解决。

本教程已根据实际部署与优化，配置修改采用 1Panel 可视化完成，命令行仅用于构建与替换操作。

小白宝塔换 1Panel，重装 WebOS

Tue, 16 Jul 2024 00:00:00 GMT

小白宝塔换 1Panel，重装 WebOS

本文记录一次完整的迁移实践：把原本部署在宝塔面板上的 WebOS（网盘系统）无损迁移到 1Panel。适合和我一样——"用的是 1Panel，但就是不会 Docker"的 1Panel 专业版用户。

大神可以直接看官方宝塔部署方式，本文给的是"小白换面板"的兜底思路。

写在前面

我是尊贵的 1Panel 专业版用户 😂，所以把宝塔换成 1Panel 这件事一直拖到今天才做。下面这份流程是在 @啊范总 的指导下跑通的，全程零踩坑（除了我自己的两个）。如果你也打算换面板，照着做就行。

一、备份（迁移前必做）

⚠️ 顺序很重要：先把下面的 5 项备份到本地，再动服务器。

| # | 备份内容 | 备注 | |---|---|---| | 1 | 宝塔 SQL 数据库 | 下载到本地 | | 2 | WebOS 内的所有文件 | 记住原路径，恢复时要回到原处 | | 3 | 直链公钥 + 直链私钥 | ⭐ 最重要，不备份会导致所有直链失效 | | 4 | 专业版授权信息 | 没有花钱的可跳过 | | 5 | SSL 的 key 和 pem | 省的重新申请/下载 |

二、重装（1Panel 环境搭建）

步骤 1：服务器基础环境

安装好服务器系统
跑一遍系统更新（apt update && apt upgrade 或 yum update）

步骤 2：安装 1Panel

按 1Panel 官方文档一键安装即可。

步骤 3：在 1Panel 里安装基础服务

✅ OpenResty（反向代理）
✅ MySQL
✅ Redis
❓ 若 WebOS 用不上 SQL/Redis，可跳过对应那项

步骤 4：创建静态网站

在 1Panel → 网站 → 创建静态站点（先空着，稍后会用）。

步骤 5：上传 WebOS 安装文件

进 1Panel 打开网站设置
找到"网站根目录"路径
把 WebOS 安装包文件上传到该目录下

步骤 6：按 WebOS 官方"宝塔部署方式"安装

走 WebOS 官方教程 → 宝塔部署那一节。

步骤 7：恢复数据库

在 1Panel 数据库里导入你第 1 步备份的 SQL 文件。

步骤 8：配置 SSL 与反向代理

在 1Panel 里给网站绑 SSL（用第 1 步备份的 key 和 pem）。

填反向代理时：

✅ 按 WebOS 官方"宝塔部署方式"教程填
⚠️ 1Panel 反向代理里那个匹配规则 ~* 不要改
🟰 "前端请求路径" = "代理目录"
📄 1Panel 里这个配置叫"源文"

步骤 9：恢复专业版授权

进 WebOS 后台：

数据库恢复后，如果你之前买了专业版，授权会自动恢复。但系统会提示"授权过期"——**直接点"更新授权"**就行了。

步骤 10：恢复用户文件

把你第 1 步备份的所有文件，原封不动上传到原路径。

步骤 11：⭐ 恢复直链公钥私钥（关键步骤）

很多人就是栽在这里 🔥。关键点：

❌ 不要在 WebOS 的 设置 → 系统 里改 zlPublic / zlPrivate——改了无效。

✅ 正确做法：

进 1Panel
找到 WebOS 安装目录
打开这个文件：

/api/rootPath/start_config.json

Markdown 语法支持

Wed, 26 Jul 2023 08:00:00 GMT

基本语法

Markdown 它是一种轻量级且易于使用的语法，用于为您的写作设计风格。

标题

文章内容较多时，可以用标题分段：

# 标题 1

## 标题 2

## 大标题

### 小标题

标题预览会打乱文章的结构，所以在此不展示。

粗斜体

_斜体文本_

**粗体文本**

**_粗斜体文本_**

预览：

斜体文本

粗体文本

粗斜体文本

链接

文字链接 [链接名称](http://链接网址)

预览：

文字链接链接名称

行内代码

这是一条 `单行代码`

预览：

这是一条 行内代码

代码块

```js
// calculate fibonacci
function fibonacci(n) {
  if (n <= 1) return 1
  return fibonacci(n - 1) + fibonacci(n - 2)
}
```

预览：

// calculate fibonacci
function fibonacci(n) {
  if (n <= 1) return 1
  return fibonacci(n - 1) + fibonacci(n - 2)
}

当前使用 shiki 作为代码高亮插件，支持的语言请参考 shiki / languages。

行内公式

这是一条行内公式 $e^{i\pi} + 1 = 0$

预览：

这是一条行内公式 $e^{i\pi} + 1 = 0$

公式块

$$
\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x) e^{-2\pi i x \xi} \, dx
$$

预览：

$$ \hat{f}(\xi) = \int_{-\infty}^{\infty} f(x) e^{-2\pi i x \xi} , dx $$

当前使用 KaTeX 作为数学公式插件，支持的语法请参考 KaTeX Supported Functions。

图片

![CWorld](./123.webp)

预览：

删除线

~~删除线~~

预览：

~~删除线~~

列表

普通无序列表

- 1
- 2
- 3

预览：

普通有序列表

1. GPT-4
2. Claude Opus
3. LLaMa

预览：

GPT-4
Claude Opus
LLaMa

列表里可以继续嵌套语法

引用

> 枪响，雷鸣，剑起。繁花血景。

预览：

枪响，雷鸣，剑起。繁花血景。

引用里也可以继续嵌套语法。

换行

markdown 分段落是需要空一行的。

如果不空行
就会在一段

第一段

第二段

预览：

如果不空行就会在一段

第一段

第二段

分隔符

如果你有写分割线的习惯，可以新起一行输入三个减号--- 或者星号 ***。当前后都有段落时，请空出一行：

---

预览：

高级技巧

行内 HTML 元素

目前只支持部分段内 HTML 元素效果，包括 <kdb>  ，如

键位显示

使用 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Del</kbd> 重启电脑

预览：

使用 Ctrl + Alt + Del 重启电脑

粗斜体

<b> Markdown 在此处同样适用，如 _加粗_ </b>

预览：

Markdown 在此处同样适用，如加粗

其他 HTML 写法

折叠块

<details><summary>点击展开</summary>它被隐藏了</details>

预览：

表格

| 表头1 | 表头2 |
| ----- | ----- |
| 内容1 | 内容2 |

预览：

| 表头1 | 表头2 | | ----- | ----- | | 内容1 | 内容2 |

注释

在引用的地方使用 [^注释] 来添加注释。

然后在文档的结尾，添加注释的内容（会默认于文章结尾渲染之）。

[^注释]: 这里是注释的内容

预览：

在引用的地方使用 ^注释来添加注释。

然后在文档的结尾，添加注释的内容（会默认于文章结尾渲染之）。

To-Do 列表

- [ ] 未完成的任务
- [x] 已完成的任务

预览：

[ ] 未完成的任务
[x] 已完成的任务

符号转义

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 \_ \# \* 进行避免。

\_不想这里的文本变斜体\_

\*\*不想这里的文本被加粗\*\*

预览：

_不想这里的文本变斜体_

**不想这里的文本被加粗**

内嵌 Astro 组件

See User Components and Advanced Components for details.

时光与我

我的车是自由的，但好像我不是

我的车是自由的，但好像我不是

🚛 同行的，看完记得继续赶路

看，这是我年少时的头像

追忆

新头像

新头像的使命

Astro MDX 组件使用完全指南

mdx 组件使用实例

引用示例

组件总览表

1. 提示框

2. 选项卡

3. Steps —— 步骤列表

4. Timeline —— 时间线

Astro 博客 Frontmatter 标准模板速查

md 标准模板。

字段配置与功能说明

使用说明：

mdx 标准模板。

字段配置与功能说明

使用说明：

小白 1Panel + Docker 部署 Astro pure 主题博客全过程

目录

环境准备

创建静态网站与上传源码

创建 Node 运行环境容器

安装依赖

修改构建配置为静态模式

远程头像域名

构建项目

情况 A：构建成功

情况 B：构建报错 MissingSharp

1. 为什么会报错？

2. 解决方法：安装稳定版 Sharp

3. 验证安装

4. 重新构建

修改网站运行目录为 dist

配置 HTTPS（如果在第一步未完成）

后续更新流程

（可选）本地开发调试

本地开发调试的用途与定位

操作步骤

计划任务

常见问题

Q1: 构建时报错 Failed to load remote image ... The request was redirected.

Q2: 构建成功，但访问网站白屏或样式丢失。

Q3: Node 容器里 npm install 报错。

Q4: 创建 Node 容器后，状态一直显示“已停止”或“重启中”。

Q5: 容器一直运行会不会占用很多资源？

Q6: 在容器终端执行 npm run dev 提示 astro: not found？

Q7: 构建时提示 MissingSharp: Could not find Sharp？

小白宝塔换 1Panel，重装 WebOS

小白宝塔换 1Panel，重装 WebOS

写在前面

一、备份（迁移前必做）

二、重装（1Panel 环境搭建）

步骤 1：服务器基础环境

步骤 2：安装 1Panel

步骤 3：在 1Panel 里安装基础服务

步骤 4：创建静态网站

步骤 5：上传 WebOS 安装文件

步骤 6：按 WebOS 官方"宝塔部署方式"安装

步骤 7：恢复数据库

步骤 8：配置 SSL 与反向代理

步骤 9：恢复专业版授权

步骤 10：恢复用户文件

步骤 11：⭐ 恢复直链公钥私钥（关键步骤）

Markdown 语法支持

基本语法

标题

粗斜体

链接

行内代码

代码块

行内公式

公式块

图片

删除线

Q1: 构建时报错 `Failed to load remote image ... The request was redirected.`

Q3: Node 容器里 `npm install` 报错。

Q6: 在容器终端执行 `npm run dev` 提示 `astro: not found`？

Q7: 构建时提示 `MissingSharp: Could not find Sharp`？