项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- 安装 Docker 与 Docker Compose
- 能访问 ghcr.io 镜像仓库(私有包需 docker login ghcr.io)
- 本地源码运行需 Node.js 与 npm 环境
- 准备好可用的 AI 服务(OpenAI / Anthropic / Ollama 或兼容 API)的地址与密钥
安装与启动步骤
-
1获取项目源码
克隆仓库到本地;如果只想用 Docker,可不下载源码,但 Compose 文件与 .env 需来自仓库。
git clone https://github.com/AmintaCCCP/GithubStarsManager.git -
2进入项目目录
后续所有 docker-compose 命令都需要在仓库根目录执行。
cd GithubStarsManager -
3拉取预构建镜像
README 提供后端与前端两个预构建镜像,无需本地构建即可使用。
docker pull ghcr.io/amintacccp/github-stars-manager-server:latest docker pull ghcr.io/amintacccp/github-stars-manager-frontend:latest -
4启动前端与后端
使用官方推荐的拆分部署,前端容器监听 8080,后端监听 3000,数据保存在 Docker 卷中。
docker-compose up -d -
5编写自定义配置
在根目录创建 .env,设置 API 密钥、加密密钥,并可按需固定前后端镜像版本。
API_SECRET=your-secret ENCRYPTION_KEY=your-key BACKEND_IMAGE_TAG=0.8.4 FRONTEND_IMAGE_TAG=0.8.4 -
6可选单容器部署
全栈单镜像可选方案需先在根目录 .env 写入 API_SECRET,否则拒绝启动未鉴权部署。
API_SECRET=replace-with-a-long-random-secret docker compose -f docker-compose.fullstack.yml up -d -
7本地源码运行
不用 Docker 时,根目录安装依赖并启动开发构建;注意 AI 与 WebDAV 调用可能受 CORS 限制。
npm install npm run dev -
8单独运行后端
后端服务可作为 API 代理,规避浏览器 CORS 限制,供前端调用。
cd server npm install npm run dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API_SECRET | 是 | API 访问密钥,全栈单容器部署必须设置,否则不会启动 | replace-with-a-long-random-secret |
ENCRYPTION_KEY | 否 | 数据加密密钥,用于本地保存敏感信息 | your-key |
BACKEND_IMAGE_TAG | 否 | 固定后端镜像版本,默认 latest | 0.8.4 |
FRONTEND_IMAGE_TAG | 否 | 固定前端镜像版本,默认 latest | 0.8.4 |
如何确认成功
前端容器映射到 8080 端口、后端到 3000 端口,浏览器打开 8080 能进入 Web UI 即部署成功。
常见问题
Q:本地 npm run dev 时 AI 服务和 WebDAV 调用失败怎么办?
A:这是浏览器 CORS 限制导致的。改用预构建客户端、自行构建客户端,或运行后端服务(cd server && npm run dev)代理 API 请求来规避 CORS。
Q:docker pull 拉取镜像时报权限错误?
A:若镜像包为私有,先执行 docker login ghcr.io 登录,使用带 read:packages 权限的 GitHub PAT。
Q:全栈单容器 compose 启动失败?
A:该方案要求先在根目录 .env 中设置 API_SECRET,未提供时拒绝启动未鉴权的部署。
Q:如何接入自己的 AI 服务?
A:打开 Settings,新增 AI 配置,填写 endpoint 与 key,选择模型并测试连接。支持 OpenAI、Anthropic、Ollama 及任意 OpenAI 兼容 API。
Q:前端或后端能独立部署、独立升级吗?
A:可以,拆分部署仍是推荐方式,适合对前端与后端单独做版本、运维与扩容的场景。
注意事项
- 默认端口:前端 8080,后端 3000,数据持久化在 Docker 卷中。
- Docker 方式已正确处理 CORS,可直接在应用内配置任意 AI 或 WebDAV 服务地址。
- 正式 vX.Y.Z Docker 标签必须与根 package.json 中的客户端版本一致,latest 与 sha-* 为开发/追溯标签。
- 构建产物是静态站点,也可部署到 Netlify、Vercel、GitHub Pages、Cloudflare Pages 或自托管服务器。
核心亮点
- 语义搜索支持自然语言描述,找仓库不靠记关键词
- AI 自动分类和打标签,减少手动整理成本
- 集中追踪 release,重要版本更新不易漏掉
不足之处
- AI 分类和语义搜索依赖外部模型或 API,可能产生额外成本与隐私顾虑
- 项目仍在成长阶段,文档和社区生态相对有限
适用场景
- 开发者 star 了上千仓库后,想快速找回某个功能的库
- 定期跟进关注项目的版本发布和更新动态
- 把零散收藏的 GitHub 项目整理成有分类的个人知识库
替代项目
Astral、Starred、gitstars
同类项目推荐
sunshine-control-panel
开源
一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。
Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···
Stirling PDF
开源
本地部署 PDF 工具箱
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
obsidian-md2wechat
开源
一键将 Obsidian 笔记排版成公众号文章,告别手动调格式
Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown
