在信息爆炸的时代,我们每天需要访问各种网站、工具和服务。如何快速找到所需资源,提高工作效率?今天我要向大家介绍一个我开发的开源项目——Go Nav,一个简洁高效的个人/团队导航站解决方案。
🙋 什么是 Go Nav?
Go Nav 是一个基于现代前端技术栈构建的导航站项目,采用 Next.js 16、React 19、HeroUI v3 和 Tailwind CSS v4 开发。它最大的特点是配置驱动,通过简单的 JSON 文件即可管理整个站点的内容和布局,无需编写代码就能创建个性化的导航页面。
😁 在线体验
想要先看看效果?可以访问以下链接:
💻 效果预览

🚀 核心特性
1. 双模式部署,灵活适应不同场景
Go Nav 支持两种部署形态:
Server 模式:保留完整的后台管理功能(
/admin)、API 接口、图片上传和备份还原能力,适合自用或团队维护,推荐使用 Docker 部署。Static 模式:导出纯静态前台页面,适合 GitHub Pages、对象存储、CDN 等无需后台的场景。
2. 强大的配置驱动
通过 data/nav.json 和 data/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