NavSphere:一款免费开源的网址导航系统

NavSphere 是一款免费开源的网址导航系统,基于 Next.js 15 构建,专为个人和团队提供网址书签管理和导航门户解决方案。该源码利用 GitHub 作为数据存储后端,提供安全、可靠的导航数据管理体验,帮助我们构建网址导航平台。

功能特性

🚀 现代技术栈:Next.js 14 + React 18 + TypeScript + Tailwind CSS
🔐 GitHub 认证:基于 NextAuth.js 的 GitHub OAuth 安全登录
📊 Git 数据存储:使用 GitHub 仓库作为数据后端,版本可控
📱 响应式设计:移动优先的设计理念,完美适配各种设备
🌓 主题切换:内置深色/浅色主题支持
🎯 拖拽排序:直观的拖拽界面,轻松管理导航项目
🔍 智能搜索:快速定位和访问导航项目
📱 PWA 支持:渐进式 Web 应用体验
🌐 多语言支持:中英文界面切换
⚡ 边缘计算:Cloudflare Pages 部署,全球加速
🔌 浏览器插件:配套浏览器扩展,一键收藏网站到导航

下载地址

开源地址: https://github.com/tianyaxiang/NavSphere
在线演示:https://dh.leti.ltd

效果图

图片[1]-NavSphere:一款免费开源的网址导航系统-十一张

后台支持分类管理、站点管理。站点的分类管理,目前支持一级、二级分类。

图片[2]-NavSphere:一款免费开源的网址导航系统-十一张

部署方法

以下是主要的两种部署方法:一键部署到 Vercel 和 Docker 部署。

一键部署到Vercel

1、克隆项目

git clone https://github.com/tianyaxiang/NavSphere.git
cd NavSphere

2、使用 pnpm 安装依赖

pnpm install

3、创建 .env.local 文件并配置以下环境变量:

cp .env.example .env.local

环境变量:

# GitHub OAuth App 配置
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_SECRET=your-github-client-secret

# GitHub 仓库配置  
GITHUB_OWNER=your-github-username
GITHUB_REPO=your-repo-name
GITHUB_BRANCH=main

# NextAuth 配置
NEXTAUTH_URL=http://localhost:3000/api/auth
NEXT_PUBLIC_API_URL=http://localhost:3000

4、部署到Vercel

●访问 Vercel Dashboard 网站:https://vercel.com/dashboard
●点击 “New Project” 并选择您克隆的仓库
●在 Vercel 项目设置中添加环境变量(同上)
●部署完成后,需要在 GitHub OAuth App 设置中更新回调地址:https://your-project-name.vercel.app/api/auth/callback/github

Docker部署

1、克隆项目:

git clone https://github.com/tianyaxiang/NavSphere.git
cd NavSphere

2、配置环境变量,创建 .env.local 文件并配置所需的环境变量(同上)

cp .env.example .env.local
# 编辑 .env.local 文件,配置必要的环境变量

3、构建 Docker 镜像:

docker build -f docker/Dockerfile -t navsphere:latest .

4、使用 Docker Compose 启动服务:

# 开发环境
docker-compose -f docker/docker-compose.yml up -d

# 生产环境
docker-compose -f docker/docker-compose.prod.yml up -d

5、检查服务状态

# 查看容器状态
docker-compose -f docker/docker-compose.yml ps

# 查看日志
docker-compose -f docker/docker-compose.yml logs -f

# 停止服务
docker-compose -f docker/docker-compose.yml down

不管选择哪种部署方式,成功部署后,都可以通过浏览器访问应用:

●如果是 Vercel,使用您的 Vercel 域名
●如果是本地或 Docker,访问地址:http://localhost:3000

温馨提示:本文最后更新于2025-11-08 23:48:16,某些文章具有时效性,若有错误或下载地址失效,请在文末评论区留言
© 版权声明
THE END
如果觉得这篇文章对您有帮助,可以收藏本网址,方便下次访问!
点赞13 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容