主题
项目概览
Emphant 工具箱是一个纯前端的在线工具集合:88 个工具,全部在浏览器本地运行,没有账号、没有后端接口、没有上传。同一套源码产出三个站点:
tools-site/
├── pc-web/ → emphant.com 电脑 / 平板版(多页静态站)
├── mobile-web/ → emphant.com/m/ 手机版(单页 + hash 路由)
├── docs-site/ → docs.emphant.com 项目文档(VitePress)
├── blog-site/ → blog.emphant.com 技术随笔(VitePress + 博客主题)
└── deploy.sh → 一条命令构建并发布到 nginx三个站点各自解决什么问题
| 站点 | 解决的问题 | 不该放什么 |
|---|---|---|
| 工具站 | 用户「现在就要处理一段文本 / 一张图」 | 长篇教程、版本说明 |
| 文档站 | 接手仓库的人要知道「怎么跑、怎么发、为什么这样设计」 | 面向用户的工具使用教程(那在工具页里) |
| 随笔站 | 记录技术判断、踩坑过程、方案对比 | 变更日志(放文档的更新日志页) |
三者互相链接,但内容边界清晰:工具页负责转化,文档负责维护,随笔负责解释「为什么」。
技术选型
| 层 | 选择 | 理由 |
|---|---|---|
| 前端框架 | Vue 3.5 | 工具组件需要响应式表单与实时计算,Vue 的模板语法写这类组件最短 |
| 构建 | Vite 8 | 多页构建、按需 chunk、开发态友好 URL 映射都够用 |
| 手机版路由 | hash 路由 | 放在 /m/ 子目录下,不需要服务端 rewrite 配合,部署零成本 |
| 文档 / 博客 | VitePress 1.6 | Markdown 即内容、构建即静态、默认主题够用,博客用自定义主题扩展 |
| 托管 | nginx 1.28(Ubuntu) | 一台 2C4G 足够,配置文件全部在仓库里可追溯 |
| 访问统计 | GoAccess 1.9 | 直接解析 nginx 日志,生成静态面板,不需要额外服务 |
| HTTPS | Let's Encrypt + certbot | 免费、可自动续期,一个证书覆盖全部子域 |
仓库之外依赖什么
- 一台服务器:
121.43.28.40,nginx 托管全部站点。 - 三个域名:
emphant.com、docs.emphant.com、blog.emphant.com,都解析到同一台机器。 - 两个本地环境:Node 22 + npm 10(构建),Python 3 + paramiko(发布脚本)。
- 彩票数据源:中彩网与体彩官方接口,构建期抓取后写成静态 JSON,详见 工具清单。
下一步
- 想跑起来:快速开始
- 想看目录怎么分:目录结构
- 想理解线上配置:nginx 与流量分流