我的第一个GitHub开源项目
我的第一个开源项目——码上导航
项目的诞生
为什么要做这个项目?
说起这个项目的由来,其实很简单 —— 我自己有需求。
作为一个经常上网的人,我收藏了很多网站:工具站、学习资源、常用服务等等。浏览器书签虽然方便,但有几个问题:
- 📱 手机和电脑不同步
- 🔍 书签太多了找不到
- 🌐 换个浏览器就没了
- 👥 想分享给朋友很麻烦
我想要一个在线的导航站,随时随地都能访问。
为什么不用现成的?
网上确实有很多导航站项目,但大多数都:
- 需要 Node.js、Docker 等复杂环境
- 必须用 VPS 服务器,成本高
- 功能太多太复杂,我只想要个简单的
- 部署配置繁琐,折腾半天
我只是想要一个简单、便宜、易部署的导航站,为什么这么难?
于是,我决定自己写一个。
项目特点
1. 超低成本
这可能是我最自豪的一点:2元/月就能运行!
是的,你没看错,就是 2 块钱。
- ✅ 不需要 VPS 服务器(动辄几十上百一个月)
- ✅ 普通虚拟主机就能跑(2元/月起)
- ✅ 不需要域名(可以用 IP 或免费二级域名)
- ✅ 数据库免费(虚拟主机自带)
对于学生党、个人用户来说,这个成本几乎可以忽略不计。
2. 极简部署
我知道很多人(包括我自己)都不是运维专家,所以我把部署做到了极致简单:
5 分钟完成部署:
- 下载项目文件
- 修改数据库配置
- 上传到虚拟主机
- 访问 install.php 安装
- 完成!
不需要:
- ❌ 命令行操作
- ❌ 编译构建
- ❌ 配置 Nginx
- ❌ 安装依赖包
就是这么简单。
3. 纯原生开发
技术栈:
- 后端: PHP(纯原生,无框架)
- 前端: 原生 JavaScript + CSS
- 数据库: MySQL
为什么不用框架?
- 🎯 简单:没有学习成本,代码一目了然
- ⚡ 快速:无需加载庞大的框架代码
- 🔧 易维护:出问题容易定位和修复
- 📦 轻量:整个项目不到 100KB
4. 功能完善
虽然追求简单,但该有的功能一个不少:
前台功能:
- 🎨 现代化 UI 设计
- 📁 分类管理
- 🔒 密码保护(敏感分类可加密)
- 🎨 随机图标颜色
- 📋 一键复制链接
后台功能:
- ✏️ 分类增删改查
- 🌐 网站批量管理
- ⚖️ 自定义权重排序
- 🔐 密码设置
- 📝 描述编辑
使用体验
部署体验
我自己在星辰云虚拟主机上部署了一个:
- 购买主机:1 分钟
- 上传文件:1 分钟
- 配置安装:1 分钟
- 总计:3 分钟搞定
真的很快,比我想象的还要简单。
使用体验
现在我把所有常用网站都放在了导航站上:
- 💼 工作相关的工具站
- 📚 学习资源
- 🎮 娱乐网站
- 🛠️ 开发工具
手机、电脑都能访问,再也不用担心书签丢失了。
数据说明
很多人关心数据容量问题,我算了一下:
16MB 数据库可以存储:
- 网站数量:10,000 - 20,000 个
- 分类数量:100 - 200 个
对于个人使用来说,这个容量完全够用。即使是做一个小型的公共导航站,也足够了。
开源的意义
这是我第一次开源项目,我想说说为什么要开源:
1. 帮助他人
如果这个项目能帮助到哪怕一个人,我就觉得值得。
也许是:
- 想要一个导航站但不知道怎么做的人
- 想学习 PHP 开发的初学者
- 需要一个简单项目参考的开发者
2. 学习成长
开源让我:
- 学会写更规范的代码
- 学会写清晰的文档
- 学会处理用户反馈
- 学会持续改进项目
这些都是闭门造车学不到的。
3. 回馈社区
我在学习编程的过程中,用过无数开源项目,从中学到了很多。
现在我也想为开源社区贡献一份力量,哪怕很小。
未来计划
虽然项目已经可以正常使用,但我还有很多想法:
短期计划
- 添加网站图标自动获取功能
- 支持自定义主题颜色
- 优化移动端体验
- 添加搜索功能
长期计划
- 支持多用户
- 添加数据导入导出
- 支持网站分享
- 开发浏览器插件
当然,这些都要看时间和精力,也欢迎大家贡献代码。
项目链接
- GitHub: https://github.com/super-mortal/nav-site
- 在线演示: 即将上线
- 问题反馈: GitHub Issues
最后
感谢你看到这里。
如果这个项目对你有帮助,欢迎:
- ⭐ 给个 Star
- 🐛 提交 Issue
- 💡 提供建议
- 🔧 贡献代码
这是我的第一个开源项目,也许不够完美,但我会持续改进。
希望它能帮助到你,也希望能和大家一起让它变得更好。
项目地址: https://github.com/super-mortal/nav-site
联系方式: 2169702639@qq.com
开源协议: MIT
写于 2026 年 2 月 28 日
Made with ❤️ by super-mortal
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
Mortal