843 字
2 分钟
使用1Panel部署Mizuki
这是博客模版 Mizuki 的 1Panel 部署教程，使用的版本是 Mizuki v9.0。对于未来版本，本教程可能会失效。
Waiting for api.github.com...
部署完成后本文章里没有提到的内容，你都可以去查阅 Mizuki Docs。
TIP✨ 例如：如何配置 Mizuki、如何发布文章等等
| 🧩 组件 | 📌 版本 / 要求 |
|---|---|
| Mizuki | v9.0 |
| 1Panel | 最新版 |
| Node.js | ≥ 22（推荐 22.21.0） |
| 包管理器 | pnpm |
| Web 服务器 | OpenResty（基于 Nginx） |
🌸 第一步 — 安装 1Panel
在终端上执行以下命令安装 1Panel：
# 下载并执行 1Panel 一键安装脚本curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sh quick_start.shTIP✨ 小贴士：安装完成后，会显示登录地址和密码，请妥善保管。
🌱 第二步 — 创建静态网站
使用安装 1Panel 后显示的登录地址和密码登录 1Panel 控制平台。打开后你将会看到以下画面：
随后在应用商店中安装 OpenResty（基于 Nginx）。
安装完成后：
- 📂 打开侧边栏的 “网站” → “网站” → “创建”
- 🌐 填入自己的域名或网站路径
- 📝 “代号” 处填写文件夹名称，或者保持默认（反正没啥影响）
- 🔒 启用 HTTPS，但这个需要提前自备 SSL 证书（可选但推荐）
🌳 第三步 — 部署并构建网站
最后阶段，博客马上部署完成了哟~
📥 部署项目代码
首先打开 系统 → 文件。
找到刚刚创建静态网站位置里的 index 文件夹：
/opt/1panel/www/sites/<刚刚填入的代号>/index/然后需要将项目代码上传或克隆至该文件夹内，这里可以直接点击 Mizuki.zip 下载项目代码。
TIP下载后可以查看
README.zh.md，里面是一些配置与使用的教程。
⚙️ 创建 Node.js 运行环境
接下来：
- 🔧 打开侧边栏的 “网站” → “运行环境” → “Node.js” → “创建”
- 🏷️ 名称（以及容器名称）自拟。选择 Node.js 的版本，推荐 22 以后的（这里我使用的是 22.21.0）
- 📁 项目目录选择刚刚打开的
index文件夹目录：/opt/1panel/www/sites/<网站代号>/index/ - 🚀 启动命令自定义：
# 使用 pnpm 启动 Mizuki 服务pnpm start
- 📦 包管理器选择 pnpm
- ✅ 确认
TIP这一步如果显示运行环境状态为 “失败”，可以把日志里的信息交给 AI 来帮助你。
打开运行环境的终端，在终端中执行命令，安装依赖并构建：
# 安装项目依赖pnpm install
# 构建生产环境静态文件pnpm build🏁 最后一步
在网站设置中，配置网站运行目录为 /dist，保存并重载。
🎀 后言
至此，你的个人博客已成功部署上线！但你的探索或许才刚刚开始。
后续对 Mizuki 的配置与修改内容，比如：如何编写文章等。都可以到 Mizuki 官方文档 中查阅。
NOTE终于搞定了！看到这里的你，已经是”准站长”了。如果中途没骂我，那说明我教程写得还不错（笑）。
如果骂了也没关系，反正你现在已经成功了。快去喝杯水，奖励一下坚持到最后的自己！
最后，期待你用文字，为这个网络小角落注入独一无二的灵魂。 ✨
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
使用1Panel部署Mizuki
https://blog.ke7chup.me/posts/guide/ 部分信息可能已经过时