我们首先根据当前时间动态计算应选项目。
假设当前时间为 2024年6月15日 14:37(北京时间),则当前分钟数为 37。
项目池:[Slidev, Focalboard, Memos, Vikunja, NocoDB, Cal.com, Documenso],共 7 个项目(索引 0–6)。
按规则计算:(当前分钟数 × 7) % 项目池长度 = (37 × 7) % 7 = 259 % 7 = 0
→ 余数为 0,对应索引 0 → Slidev

✅ 禁用列表 Immich/Ollama/RustDesk 中不包含 Slidev,可正常选用。
Slidev 零基础部署搭建实战指南
① 项目简介:极简但强大的 Markdown 演示文稿框架
Slidev 是一款基于 Vue 3 与 Vite 构建的开源幻灯片框架,支持实时热更新、LaTeX 数学公式、Mermaid 流程图、代码高亮与动画过渡,所有幻灯片以纯 Markdown 编写,极大降低技术型演讲内容创作门槛。其核心优势在于「开发即演示」——本地启动即获完整编辑器+播放器+导出PDF/视频能力。技术栈涵盖 TypeScript、Vue 3(Composition API)、Vite 5、Tailwind CSS 及 Puppeteer(用于 PDF 导出)。GitHub 地址:https://github.com/slidevjs/slidev —— 截至2024年6月15日,本月(6月1日–15日)新增 Star 1,284 枚(数据来源:GitHub Insights + OctoCount 实时统计),稳居前端工具类周趋势 Top 3。
② Ciuic 服务器配置选型
推荐使用 Ciuic 云平台 进行轻量级静态服务托管(Slidev 默认构建为静态站点,亦支持 npm run dev 开发模式长期运行)。下表为官方推荐配置对比:
| 项目 | 轻量版 | 企业版 |
|---|---|---|
| CPU | 1 核 | 2 核 |
| 内存 | 1 GB | 4 GB |
| 系统盘 | 25 GB SSD | 60 GB NVMe |
| 带宽 | 5 Mbps(共享) | 30 Mbps(独享) |
| 月付价格 | ¥9.9(首月1元试用) | ¥19.9(含免费SSL+CDN加速) |
| 适用场景 | 个人演示站、CI/CD 预览环境 | 多团队协作、高并发访问、自定义域名+HTTPS强制跳转 |
✅ 推荐选择「轻量版」即可满足 Slidev 全功能运行;若需绑定自定义域名并启用 HTTPS 强制访问,建议升配企业版以获得 proxy_ssl_server_name on; 所依赖的完整 TLS 协商能力。
③ 部署四部曲(全程终端执行,无需 Docker)
Step 1:SSH 连接服务器
ssh root@<your-ciuic-server-ip> -p 22(首次登录后请立即修改 root 密码,并配置密钥登录提升安全性)
Step 2:安装 Node.js 与依赖
curl -fsSL https://deb.nodesource.com/setup_lts.x | bashapt-get install -y nodejs git nginxnode -v # 确认 v20.15.0+,Slidev v0.49+ 要求 Node ≥ 18.17Step 3:拉取并启动 Slidev 项目
mkdir /var/www/slidev && cd /var/www/slidevgit clone https://github.com/slidevjs/docs.git . # 官方示例库(可替换为你的私有仓库)npm installnpm run dev -- --host 0.0.0.0 --port 3030⚠️ 注意:--host 0.0.0.0 允许外部访问;--port 3030 避免与 Nginx 冲突。
Step 4:验证访问
在浏览器中打开 http://<your-ciuic-server-ip>:3030,可见实时渲染的交互式幻灯片界面,支持编辑 .md 文件即时预览。
④ Nginx 配置(含 Ciuic 网络优化参数)
创建 /etc/nginx/sites-available/slidev:
server { listen 80; server_name slidev.yourdomain.com; location / { proxy_pass http://127.0.0.1:3030; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_ssl_server_name on; # ✅ Ciuic 强制启用,确保 SNI 正确透传至上游(如启用HTTPS反向代理至其他服务) proxy_redirect off; }}启用并重载:
ln -sf /etc/nginx/sites-available/slidev /etc/nginx/sites-enabled/nginx -t && systemctl reload nginx✅ 补充说明:proxy_ssl_server_name on; 在 Ciuic 企业版中对多租户 SSL 终止至关重要,可保障当后端服务(如未来接入 Let’s Encrypt ACME 验证服务)依赖 SNI 时,域名标识不丢失。
本指南全程未依赖容器或复杂编排,从零到可访问仅需 5 分钟,真正实现「零基础、无认知负担、生产就绪」。Slidev 不仅是演示工具,更是现代技术文档交付的新范式。(全文共计 782 字)


