猫猫导航部署教程（GitHub + Cloudflare/Vercel 一键部署）
🐱 想快速搭建一个干净美观、可自定义的导航站？只需三步，无需服务器，无需写代码，就能上线属于你的个性化网址导航页面！
🚀 前置条件
- 一个 GitHub 账号
- 一个 Cloudflare 或 Vercel 账号（二选一）
- 可选：一个域名（没有也可以用系统默认域名）
📌 示例站点预览：https://nav.maodeyu.fun
📦 第一步：Fork 项目
step_01.png
🔐 第二步：创建 GitHub Token（可选，用于启用 admin 界面增删改功能）
创建一个新 token，设置为永不过期
step_02.png
-
权限配置：
- 只授权刚才 Fork 的仓库
- 仅勾选：Repository permissions -> Contents（读写）和 Metadata（只读）
step_03.png
- 点击 Generate Token，复制保存下来，后面需要用
⚠️ 安全提醒：这样配置可以使 Token 只影响你授权的仓库，就算泄露风险也有限。
🌐 第三步：部署到 Cloudflare（或 Vercel）
下面以 Cloudflare 为例，Vercel 步骤基本一致。
进入 Workers & Pages -> 点击 Pages 标签 -> 选择 Get Started
step_04.png
- 关联 GitHub，建议只授权你 Fork 的仓库
step_05.png
选择仓库，点击 Begin setup
框架选择 Vue，Build Command 填
npm run build，Output Directory 填dist
step_06.png
- 可选：配置环境变量以启用 admin 后台功能：
VITE_ADMIN_PASSWORD=自定义管理密码
VITE_GITHUB_TOKEN=刚才generate生成的github_token
VITE_GITHUB_OWNER=你的 GitHub 用户名
VITE_GITHUB_REPO=你的仓库名（如：mao_nav）
VITE_GITHUB_BRANCH=master
step_07.png
- 点击部署，等待构建完成后，点击 Visit 即可访问！
step_08.png
- 如需绑定自定义域名，在项目设置中添加 CNAME 记录即可：
step_09.png
🛠 自定义导航内容
你有两种方式修改导航内容：
✅ 方法一：通过 Admin 后台界面（推荐）
- 访问部署后的地址：
https://你的站点域名/admin - 输入你设置的
VITE_ADMIN_PASSWORD - 即可在线增删分类、网址，保存后自动部署
✅ 方法二：修改代码文件
- 进入你的 GitHub 仓库
- 修改
/src/mock/mock_data.js文件，保存提交 - Cloudflare/Vercel 会自动重新构建并上线
🔚 最后
这个导航项目是作者基于个人兴趣开发的。
✨ 如果你觉得它有用，欢迎 Star、Fork 支持一下，也可以留言提建议帮助优化！
❤️ 喜欢 DIY 的朋友不妨部署试试，有趣好玩又能提升动手能力。
有任何疑问欢迎留言，或在 GitHub 提 Issue。
部署愉快！🚀
