跳至主要内容
五折优惠 全部方案,限时优惠。起价 $2.48/mo
Docusaurus

Docusaurus

Docusaurus 是 Meta 出品的文档站点生成器。它提供版本化文档、搜索、多语言翻译,以及可逐页覆盖的 React 主题。采用 MIT 许可,GitHub 星标 65,900+。

快速概览

66k

GitHub star 数

1

页面浏览量

许可 MIT 版本 3.10.2 OS Ubuntu Server 24.04 LTS Min RAM 1 GB IP IPV6,IPV4

访问

  • 打开 Docusaurus: http://<SERVER_IP>

编辑并发布内容

1. 添加或编辑内容文件:

/opt/docusaurus/docs
/opt/docusaurus/blog
/opt/docusaurus/src/pages

2. 更新 /opt/docusaurus/docusaurus.config.js 用于站点设置、导航和主题配置。

3. 重新构建站点:

cd /opt/docusaurus && npm run build

Nginx 从以下位置提供生成的文件: /opt/docusaurus/build

重新构建后无需重启 Nginx。

重要路径

  • 项目: /opt/docusaurus
  • 文档: /opt/docusaurus/docs
  • 博客: /opt/docusaurus/blog
  • 页面: /opt/docusaurus/src/pages
  • 配置: /opt/docusaurus/docusaurus.config.js
  • 构建输出: /opt/docusaurus/build
  • Nginx 配置: /etc/nginx/sites-available/docusaurus.conf

域名与 HTTPS

1. 将你的域名指向服务器 IP 地址。

2. 编辑 Nginx 配置并替换 server_name _; 为你的域名(例如 server_name <YOUR_DOMAIN>;):

vim /etc/nginx/sites-available/docusaurus.conf

3. 测试配置:

nginx -t

4. 安装 Certbot:

apt install -y certbot python3-certbot-nginx

5. 生成 Let's Encrypt 证书:

certbot --nginx --non-interactive --agree-tos --email <YOUR_EMAIL> -d <YOUR_DOMAIN>

6. 重新加载 Nginx:

systemctl reload nginx

7. 更新 Docusaurus 站点 URL:将 url: 'http://<SERVER_IP>', 替换为 url: 'https://<YOUR_DOMAIN>', in /opt/docusaurus/docusaurus.config.js.

8. 重新构建站点:

cd /opt/docusaurus && npm run build

9. 打开浏览器,访问: https://<YOUR_DOMAIN>

注意事项

  • Docusaurus 生成静态网站,无需数据库。
  • 内容更改需要重新构建后才会公开显示。
  • 可按你的偏好修改 Docusaurus 配置和项目结构。

更多开发工具

相关应用。

立即部署 Docusaurus。 起价 $2.48/月。