访问
- 打开 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 配置和项目结构。