Go Nav:打造你的专属导航站,简洁高效且功能强大

作者:doxwant 发布时间: 2026-05-14 阅读量:25 评论数:0

在信息爆炸的时代,我们每天需要访问各种网站、工具和服务。如何快速找到所需资源,提高工作效率?今天我要向大家介绍一个我开发的开源项目——Go Nav,一个简洁高效的个人/团队导航站解决方案。

🙋 什么是 Go Nav?

Go Nav 是一个基于现代前端技术栈构建的导航站项目,采用 Next.js 16React 19HeroUI v3Tailwind CSS v4 开发。它最大的特点是配置驱动,通过简单的 JSON 文件即可管理整个站点的内容和布局,无需编写代码就能创建个性化的导航页面。

😁 在线体验

想要先看看效果?可以访问以下链接:

💻 效果预览

1778754532819.jpg

🚀 核心特性

1. 双模式部署,灵活适应不同场景

Go Nav 支持两种部署形态:

  • Server 模式:保留完整的后台管理功能(/admin)、API 接口、图片上传和备份还原能力,适合自用或团队维护,推荐使用 Docker 部署。

  • Static 模式:导出纯静态前台页面,适合 GitHub Pages、对象存储、CDN 等无需后台的场景。

2. 强大的配置驱动

通过 data/nav.jsondata/website.json 两个文件,你可以轻松管理:

  • 站点信息、SEO 设置

  • 导航分类和网站链接

  • 搜索引擎配置

  • 广告位和插件

  • 主题和布局选项

3. 多级导航与智能搜索

  • 多级导航:分类支持递归嵌套,二级分类自动以标签页展示

  • 站内搜索:前端本地搜索支持标题、描述、标签和分类名命中

  • 外部搜索引擎:可配置百度、Bing、Google 等搜索 URL

4. 完善的后台管理

Server 模式下提供功能丰富的后台管理界面,支持:

  • 网站信息、分类、站点的可视化编辑

  • 图片上传(支持 png、jpg、gif、webp、ico 格式)

  • 完整的 ZIP 备份和还原功能

  • 无用素材清理

5. Docker 友好

项目内置 Dockerfile、Compose 配置和发布脚本,镜像自带默认数据。容器启动时会智能处理数据目录:

  • 如果用户挂载的目录为空,会自动初始化默认数据

  • 如果用户已有数据文件,会优先使用用户数据,不会覆盖

🏃 快速开始

本地开发

git clone https://github.com/dengxiwang/go-nav.git
cd go-nav
pnpm install
pnpm dev

开发服务默认运行在 http://localhost:3000,后台入口为 http://localhost:3000/admin

Docker 部署

# 使用默认数据
docker run -d \
  --name go-nav \
  --restart unless-stopped \
  -p 3000:3000 \
  -e ADMIN_USER=admin \
  -e ADMIN_PASS=your-secure-password \
  -e SESSION_SECRET=your-long-random-string \
  -v "$(pwd)/go-nav-data:/app/data" \
  doxwant/go-nav:latest

🧮 技术架构

Go Nav 采用了现代化的技术栈:

  • Next.js 16:提供优秀的 SSR/SSG 能力和开发体验

  • React 19:最新的 React 版本,带来更好的性能和新特性

  • HeroUI v3:美观的 UI 组件库

  • Tailwind CSS v4:原子化 CSS 框架,实现快速样式开发

  • Jotai:轻量级状态管理方案

  • TypeScript:提供完整的类型安全

🎉 社区支持

如果你在使用过程中遇到问题,或者想要与其他用户交流经验,欢迎加入我们的 QQ 交流群:727809499

✍️ 开源协议

Go Nav 基于 MIT License 开源,你可以自由使用、修改和商用,只需保留原始项目署名信息即可。

结语

Go Nav 不仅仅是一个导航站,更是一个展示你数字生活的方式。无论你是个人用户想要整理自己的常用网站,还是团队需要一个内部资源门户,Go Nav 都能提供简洁高效的解决方案。

如果你觉得这个项目对你有帮助,欢迎在 GitHub 上给个 star,或者扫码支持项目继续发展!

GitHub 地址https://github.com/dengxiwang/go-nav

评论