一个简洁、纯HTML静态的个人导航站,支持深浅色切换和多搜索引擎。
- 🎨 简约现代风格
- 🌓 深浅色主题切换
- 🔍 多搜索引擎支持
- 📱 响应式设计,适配移动端
- ⚡ 纯静态页面,极速加载
- 📂 分类管理,支持自定义分组
- 🐳 Docker 容器化部署
- 🔧 灵活配置,支持环境变量和配置文件
- 🏷️ 动态标题,根据配置自动更新页面标题
- 🔍 搜索功能,快速查找导航链接
- ⚡ 性能优化,图标懒加载和缓存机制
- 🎯 SEO友好,支持自定义meta信息
创建 docker-compose.yml 文件:
services:
xg-nav:
image: verky/xg-nav:latest
container_name: xg-nav
ports:
- "26180:80" # 可自定义端口
environment:
# - SITE_TITLE=网站标题
# - SITE_DESCRIPTION=网站描述
# - COPYRIGHT=版权信息,支持HTML(留个项目地址呗~)
- CARD_CONTENT=0 # 0=显示描述信息,1=显示链接URL
# - SHOW_FAVICON=1 # 1=显示favicon图标,0=不显示
restart: unless-stopped
volumes:
- ./data:/usr/share/nginx/html/datadocker run -d \
--name xg-nav \
-p 26180:80 \
-v $(pwd)/data/data:/usr/share/nginx/html/data \
--restart unless-stopped \
verky/xg-nav:latest$(pwd)/data 替换为实际路径
如需自定义网站信息,可添加环境变量:
docker run -d \
--name xg-nav \
-p 26180:80 \
-e SITE_TITLE="网站标题" \
-e SITE_DESCRIPTION="网站描述" \
-e COPYRIGHT="版权信息,支持HTML" \
-e CARD_CONTENT=0 \ # 0=显示描述信息,1=显示链接URL
-e SHOW_FAVICON=1 \ # 1=显示favicon图标,0=不显示
-v $(pwd)/data:/usr/share/nginx/html/data \
--restart unless-stopped \
verky/xg-nav:latest下载整项目放到网站运行目录,确保index.html在根目录下!
编辑根目录下的 config.json 文件:
SITE_TITLE:"网站标题"SITE_DESCRIPTION:"网站描述"COPYRIGHT:"版权信息,支持HTML"CARD_CONTENT: 0 (0=显示描述信息,1=显示链接URL)SHOW_FAVICON: 1 (1=显示favicon图标,0=不显示)
配置优先级:环境变量 > config.json > 内置默认值
编辑 data/links.txt 文件来管理导航链接,每行一个链接,格式为:
网站名称,描述,URL,分类
示例:
小鸽志,个人技术博客分享,https://www.xiaoge.org,博客
淘宝,中国最大购物平台,https://www.taobao.com,购物
GitHub,全球最大代码托管平台,https://github.com,开发工具
分类说明:
- 支持中文分类名称
- 相同分类的链接会自动分组显示
- 如果不指定分类,默认归类为"未分类"
Docker部署说明:首次启动容器时,如果映射的 ./data 目录中没有 links.txt 文件,系统会自动创建一个包含示例链接的文件。
导航站内置了强大的搜索功能:
- 🔍 实时搜索:输入关键词即时显示匹配结果
- 🎯 多字段匹配:支持按网站名称、描述、分类搜索
- ⚡ 快速响应:优化的搜索算法,毫秒级响应
- 🔄 智能过滤:自动过滤空白和特殊字符
支持深浅色主题无缝切换:
- 🌞 浅色主题:简洁明亮的白色主题
- 🌙 深色主题:护眼的深色主题
- 💾 记忆功能:自动保存用户的主题偏好
- 🎨 平滑过渡:主题切换带有流畅的动画效果
- ⚡ 图标懒加载:只加载可见区域的图标,提升页面加载速度
- 🗄️ 缓存机制:智能缓存配置和链接数据
- 📱 响应式设计:完美适配各种设备尺寸
- 🔧 代码优化:精简的代码结构,最小化资源占用
部署完成后,访问 http://localhost:26180 即可使用导航站。
- ✨ 新增Favicon可选显示功能,支持通过配置控制图标显示或隐藏
- 🎯 优化布局对齐,隐藏图标时标题与描述文本完美对齐
- 🔄 更换为Yandex Favicon服务,提升国内访问稳定性
- 🐛 修复了点击导航卡片同时打开2个链接的问题
- ✨ 优化了点击事件处理机制,不再请求弹出窗口权限
- 🎯 新增动态favicon图标功能,自动获取并显示网站图标
- ⚡ 优化图标加载机制,预分配空间防止页面布局抖动
- 🔧 完善图标加载失败时的降级处理
- 🎉 项目初始发布
- 🎨 实现简约现代的UI设计
- 🌓 支持深浅色主题切换
- 📂 实现分类管理功能
- 🐳 提供Docker容器化部署方案
- ✨ 新增搜索功能,支持实时搜索导航链接
- 🎯 优化主题切换机制,提升用户体验
- ⚡ 实现图标懒加载,显著提升页面加载性能
- 🔧 优化代码结构,提高可维护性
- 🏷️ 新增动态标题功能,根据配置自动更新
- 🐛 修复若干已知问题,提升稳定性