NavSphere：网址导航源码，免费开源搭建导航网站

NavSphere（网址导航源码）简介

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

主要特色功能如下：

• 现代技术栈：项目采用 Next.js 14、React 18、TypeScript 和 Tailwind CSS，确保了良好的性能和用户体验。
• GitHub 认证：通过 NextAuth.js 实现的 GitHub OAuth 安全登录，确保用户数据的安全性。
• 响应式设计：移动优先的设计理念，使得平台在各种设备上都能完美适配。
• 主题切换：内置深色和浅色主题，用户可以根据个人喜好进行切换。
• 拖拽排序：直观的拖拽界面，便于管理导航项目。
• 智能搜索：快速定位和访问导航项目，提高工作效率。
• 多语言支持：提供中英文界面切换，满足不同用户的需求。

NavSphere（网址导航源码）官网及教程

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

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

一键部署到 Vercel

1、克隆项目：

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

2、安装依赖，使用 pnpm 安装依赖（推荐使用 pnpm）：

pnpm install

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

GITHUB_ID=your-github-client-id GITHUB_SECRET=your-github-client-secret GITHUB_OWNER=your-github-username GITHUB_REPO=your-repo-name GITHUB_BRANCH=main NEXTAUTH_URL=http://localhost:3000/api/auth NEXT_PUBLIC_API_URL=http://localhost:3000

4、部署到 Vercel：

• 登录到 Vercel。
• 点击 “New Project” 并选择您克隆的仓库。
• 在部署过程中，配置所需的环境变量。
• 部署完成后，更新 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 文件并配置所需的环境变量（同上）。

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

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

• 如果是 Vercel，使用您的 Vercel 域名。
• 如果是本地或 Docker，访问 http://localhost:3000。