Docusaurus 一键快速部署个人博客
最新回答
我自有舟渡
2026-10-23 13:38:41
使用阿里云云开发平台通过Docusaurus一键快速部署个人博客的步骤如下：
一、通过云开发平台快速创建初始化应用- 创建应用模版：访问一键创建Docusaurus应用模版链接，根据指引快速生成Docusaurus站点。
- 查看仓库：创建完成后，可在GitHub中查看到新增的Docusaurus仓库。
克隆项目到本地
确保已安装Git和Node.js（未安装可前往Node官网下载）。
执行以下命令克隆项目：
git clone + 项目地址cd Docusaurusgit checkout feature/1.0.0npm installnpm run start启动服务后，浏览器访问3000端口即可看到默认页面。
项目结构说明
my-website├── blog/ # 存放博客文章（Markdown格式）├── docs/ # 存放文档（Markdown格式）├── src/│ ├── css/ # 自定义CSS文件（如custom.css）│ └── pages/ # 自定义页面（React语法）├── static/ # 静态资源（如图片）├── docusaurus.config.js # 站点配置文件├── package.json # Node.js工程配置└── sidebars.js # 文档侧边栏配置关键目录：
/blog/：存放博客文章，文件名为日期-标题.md格式。
/src/pages/：自定义页面，默认包含index.js（首页）。
/static/img/：静态图片资源。
配置为博客模式
修改docusaurus.config.js，将presets配置调整为博客优先：
presets: [ [ "@docusaurus/preset-classic", { blog: { path: "./blog", routeBasePath: "/" # 博客作为首页 } } ]];可选操作：
删除或重命名src/pages/index.js以避免冲突。
在navBar配置中删除docs相关链接（如{ to: "docs/doc1", label: "Docs" }）。
发表第一篇博客
在/blog/目录下创建Markdown文件（如2019-05-30-welcome.md），文件头部需包含元数据：
---id: welcometitle: Welcomeauthor: 作者名tags: [标签1, 标签2]---内容截断：若需隐藏部分内容，添加<!--truncate-->注释。
上传代码
git add .git commit -m '更新说明'git push日常环境部署
在云开发平台应用详情页面，点击日常环境的「部署」按钮。
部署完成后，状态显示为绿色「已部署」，点击访问部署网站查看效果。
- 配置自定义域名并上线
步骤1：在线上环境的「部署配置」-「自定义域名」中填写域名（如company.workbench.fun），复制API网关地址。
步骤2：在域名管理平台（如阿里云）添加CNAME记录：
记录类型：CNAME
主机记录：二级域名（如company）
记录值：粘贴API网关地址
- 步骤3：返回云开发平台，点击线上环境的「部署」按钮完成上线。CNAME生效后，通过自定义域名（如company.workbench.fun）访问博客。
- 一键创建Docusaurus应用模版
- 参考教程
- 云开发2周年活动（参与游戏部署赢取奖品）
通过以上步骤，即可完成从本地开发到云端部署的全流程，快速搭建个人博客。
热门标签
