Sample Guide

如何写第一篇部署攻略

这一页演示的是“真正拿来发文章”的样子。你可以沿用这个结构，后面把主题换成 Nginx、Docker、VPS、前端部署、故障排查都可以。

分类：部署更新时间：2026-07-07 阅读：5 分钟

目标

一篇好的攻略文章，最重要的是让读者快速知道“这篇能不能解决我的问题”。所以开头建议直接写目标、环境和结果，而不是先铺陈背景。

这篇示例适合什么内容

环境搭建、部署记录、命令速查、问题排障、方案比较和工具清单。

你后面每多写一篇文章，只需要继续新建一个目录，并把这一篇相关的资源都放进去。

pages/
└── docker-deploy/
    ├── index.html
    ├── images/
    ├── audio/
    └── video/

小建议

攻略文章最有价值的部分，通常是“为什么这样做”和“失败时怎么排查”。这两块可以多写一点。

下面这个例子就是一个很常见的“新建文章”流程：

cp -R pages/article-template pages/docker-deploy-guide

# 编辑 pages/docker-deploy-guide/index.html
# 然后去 index.html 增加文章入口

如果你文章里要放配置文件，也可以直接这样展示：

server {
  listen 80;
  server_name example.com;

  location / {
    root /var/www/site;
    index index.html;
  }
}

音频区

适合讲解录音、访谈片段或播客补充。

视频区

适合录屏演示、安装过程或效果展示。