1313 字
7 分钟

我的第一个GitHub开源项目

我的第一个开源项目——码上导航#

项目的诞生#

为什么要做这个项目?#

说起这个项目的由来,其实很简单 —— 我自己有需求。

作为一个经常上网的人,我收藏了很多网站:工具站、学习资源、常用服务等等。浏览器书签虽然方便,但有几个问题:

  • 📱 手机和电脑不同步
  • 🔍 书签太多了找不到
  • 🌐 换个浏览器就没了
  • 👥 想分享给朋友很麻烦

我想要一个在线的导航站,随时随地都能访问。

为什么不用现成的?#

网上确实有很多导航站项目,但大多数都:

  • 需要 Node.js、Docker 等复杂环境
  • 必须用 VPS 服务器,成本高
  • 功能太多太复杂,我只想要个简单的
  • 部署配置繁琐,折腾半天

我只是想要一个简单、便宜、易部署的导航站,为什么这么难?

于是,我决定自己写一个。

项目特点#

1. 超低成本#

这可能是我最自豪的一点:2元/月就能运行!

是的,你没看错,就是 2 块钱。

  • ✅ 不需要 VPS 服务器(动辄几十上百一个月)
  • ✅ 普通虚拟主机就能跑(2元/月起)
  • ✅ 不需要域名(可以用 IP 或免费二级域名)
  • ✅ 数据库免费(虚拟主机自带)

对于学生党、个人用户来说,这个成本几乎可以忽略不计。

2. 极简部署#

我知道很多人(包括我自己)都不是运维专家,所以我把部署做到了极致简单:

5 分钟完成部署:

  1. 下载项目文件
  2. 修改数据库配置
  3. 上传到虚拟主机
  4. 访问 install.php 安装
  5. 完成!

不需要:

  • ❌ 命令行操作
  • ❌ 编译构建
  • ❌ 配置 Nginx
  • ❌ 安装依赖包

就是这么简单。

3. 纯原生开发#

技术栈:

  • 后端: PHP(纯原生,无框架)
  • 前端: 原生 JavaScript + CSS
  • 数据库: MySQL

为什么不用框架?

  • 🎯 简单:没有学习成本,代码一目了然
  • 快速:无需加载庞大的框架代码
  • 🔧 易维护:出问题容易定位和修复
  • 📦 轻量:整个项目不到 100KB

4. 功能完善#

虽然追求简单,但该有的功能一个不少:

前台功能:

  • 🎨 现代化 UI 设计
  • 📁 分类管理
  • 🔒 密码保护(敏感分类可加密)
  • 🎨 随机图标颜色
  • 📋 一键复制链接

后台功能:

  • ✏️ 分类增删改查
  • 🌐 网站批量管理
  • ⚖️ 自定义权重排序
  • 🔐 密码设置
  • 📝 描述编辑

使用体验#

部署体验#

我自己在星辰云虚拟主机上部署了一个:

  • 购买主机:1 分钟
  • 上传文件:1 分钟
  • 配置安装:1 分钟
  • 总计:3 分钟搞定

真的很快,比我想象的还要简单。

使用体验#

现在我把所有常用网站都放在了导航站上:

  • 💼 工作相关的工具站
  • 📚 学习资源
  • 🎮 娱乐网站
  • 🛠️ 开发工具

手机、电脑都能访问,再也不用担心书签丢失了。

数据说明#

很多人关心数据容量问题,我算了一下:

16MB 数据库可以存储:

  • 网站数量:10,000 - 20,000 个
  • 分类数量:100 - 200 个

对于个人使用来说,这个容量完全够用。即使是做一个小型的公共导航站,也足够了。

开源的意义#

这是我第一次开源项目,我想说说为什么要开源:

1. 帮助他人#

如果这个项目能帮助到哪怕一个人,我就觉得值得。

也许是:

  • 想要一个导航站但不知道怎么做的人
  • 想学习 PHP 开发的初学者
  • 需要一个简单项目参考的开发者

2. 学习成长#

开源让我:

  • 学会写更规范的代码
  • 学会写清晰的文档
  • 学会处理用户反馈
  • 学会持续改进项目

这些都是闭门造车学不到的。

3. 回馈社区#

我在学习编程的过程中,用过无数开源项目,从中学到了很多。

现在我也想为开源社区贡献一份力量,哪怕很小。

未来计划#

虽然项目已经可以正常使用,但我还有很多想法:

短期计划#

  • 添加网站图标自动获取功能
  • 支持自定义主题颜色
  • 优化移动端体验
  • 添加搜索功能

长期计划#

  • 支持多用户
  • 添加数据导入导出
  • 支持网站分享
  • 开发浏览器插件

当然,这些都要看时间和精力,也欢迎大家贡献代码。

项目链接#

最后#

感谢你看到这里。

如果这个项目对你有帮助,欢迎:

  • ⭐ 给个 Star
  • 🐛 提交 Issue
  • 💡 提供建议
  • 🔧 贡献代码

这是我的第一个开源项目,也许不够完美,但我会持续改进。

希望它能帮助到你,也希望能和大家一起让它变得更好。


项目地址: https://github.com/super-mortal/nav-site

联系方式: 2169702639@qq.com

开源协议: MIT


写于 2026 年 2 月 28 日

Made with ❤️ by super-mortal

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

我的第一个GitHub开源项目
https://supermortal.top/posts/daohang/
作者
mortal
发布于
2026-02-28
许可协议
已授权

目录