猫猫导航部署教程

猫猫导航部署教程（GitHub + Cloudflare/Vercel 一键部署）

🐱 想快速搭建一个干净美观、可自定义的导航站？只需三步，无需服务器，无需写代码，就能上线属于你的个性化网址导航页面！

🚀 前置条件

  • 一个 GitHub 账号
  • 一个 Cloudflare 或 Vercel 账号（二选一）
  • 可选：一个域名（没有也可以用系统默认域名）
    📌 示例站点预览：https://nav.maodeyu.fun

📦 第一步：Fork 项目

  1. 登录你的 GitHub 账户
  2. 访问猫猫导航项目，点击右上角 Fork（如果喜欢，顺手点个 Star 吧 ⭐）


部署步骤截图

🔐 第二步：创建 GitHub Token（可选，用于启用 admin 界面增删改功能）

  1. 访问 https://github.com/settings/personal-access-tokens

  2. 创建一个新 token，设置为永不过期


    部署步骤截图

  3. 权限配置：

    • 只授权刚才 Fork 的仓库
    • 仅勾选：Repository permissions -> Contents（读写）和 Metadata（只读）


部署步骤截图

  1. 点击 Generate Token，复制保存下来，后面需要用

⚠️ 安全提醒：这样配置可以使 Token 只影响你授权的仓库，就算泄露风险也有限。

🌐 第三步：部署到 Cloudflare（或 Vercel）

下面以 Cloudflare 为例，Vercel 步骤基本一致。

  1. 打开 Cloudflare Dashboard

  2. 进入 Workers & Pages -> 点击 Pages 标签 -> 选择 Get Started


部署步骤截图

  1. 关联 GitHub，建议只授权你 Fork 的仓库


部署步骤截图

  1. 选择仓库，点击 Begin setup

  2. 框架选择 Vue，Build Command 填 npm run build，Output Directory 填 dist


部署步骤截图

  1. 可选：配置环境变量以启用 admin 后台功能：
1
2
3
4
5
6
VITE_ADMIN_PASSWORD=自定义管理密码
VITE_GITHUB_TOKEN=刚才generate生成的github_token
VITE_GITHUB_OWNER=你的 GitHub 用户名
VITE_GITHUB_REPO=你的仓库名（如：mao_nav）
VITE_GITHUB_BRANCH=master


部署步骤截图

  1. 点击部署，等待构建完成后，点击 Visit 即可访问！


    部署步骤截图

  2. 如需绑定自定义域名，在项目设置中添加 CNAME 记录即可：


部署步骤截图

🛠 自定义导航内容

你有两种方式修改导航内容：

✅ 方法一：通过 Admin 后台界面（推荐）

  1. 访问部署后的地址：https://你的站点域名/admin
  2. 输入你设置的 VITE_ADMIN_PASSWORD
  3. 即可在线增删分类、网址，保存后自动部署

✅ 方法二：修改代码文件

  1. 进入你的 GitHub 仓库
  2. 修改 /src/mock/mock_data.js 文件，保存提交
  3. Cloudflare/Vercel 会自动重新构建并上线

🔚 最后

这个导航项目是作者基于个人兴趣开发的。

✨ 如果你觉得它有用，欢迎 Star、Fork 支持一下，也可以留言提建议帮助优化！

❤️ 喜欢 DIY 的朋友不妨部署试试，有趣好玩又能提升动手能力。

有任何疑问欢迎留言，或在 GitHub 提 Issue。

部署愉快！🚀