Forks

本地 Git 仓库管理与镜像加速工具 — Web 界面管理 GitHub/Gitee 仓库，局域网内加速克隆。

English | 中文

目录

• 界面预览
• 功能特性
• 技术栈
• 快速开始
• 镜像加速克隆
• Docker 部署
• MCP 集成
• 配套工具
• 项目结构
• License

界面预览

首页仪表盘 — 仓库统计、快捷操作、今日热门趋势

仓库列表 — 搜索、筛选、批量操作，卡片展示仓库描述

仓库详情 — 文件浏览、信息面板、DeepWiki/ZRead 快捷链接

代码查看 — 多语言语法高亮、Markdown 渲染、文件树导航

作者 — 按作者聚合查看仓库

GitHub 趋势 — 按语言、时间范围筛选，已收藏仓库自动标注

活动记录 — 操作日志追踪

设置 — 代理、Token、MCP 工具列表、趋势同步配置

功能特性

• 仓库管理 — 添加、克隆、拉取、重置 GitHub/Gitee 仓库
• 批量操作 — 批量克隆未克隆的仓库，扫描本地目录自动导入
• 文件浏览 — 在线浏览仓库文件树和文件内容（多语言语法高亮、Markdown 渲染、图片/音视频预览）
• 状态监控 — 实时查看克隆进度、更新差异、提交历史
• 镜像加速 — 内置 Git Smart HTTP 服务，局域网内可从本服务加速克隆
• MCP 集成 — 暴露 MCP 工具接口，支持 Claude Code、Cursor 等 AI 客户端直接操作仓库
• 代理支持 — HTTP/SOCKS5 代理，支持按平台独立配置
• 数据统计 — 仓库和作者的统计仪表盘，操作日志追踪

技术栈

层	技术
后端	Go 1.25、Gin、SQLite (modernc)、Cobra
前端	Vue 3、Naive UI、CodeMirror、Pinia、ECharts
构建	Vite 7、go:embed
部署	Docker、GitHub Actions

快速开始

环境要求

• Go 1.25+
• Node.js ^20.19.0 或 >=22.12.0（仅前端开发需要）

构建

# 构建前端
cd web && npm install && npm run build && cd ..

# 构建后端（会将前端嵌入二进制）
go build -o forks

运行

./forks serve                # 默认监听 :8080
./forks serve -p 9090        # 指定端口
./forks serve --token xxx    # 启用 Token 认证

环境变量：

变量	说明	默认值
FORKS_PORT	服务端口	8080
FORKS_ADDRESS	监听地址	0.0.0.0
FORKS_HOME	数据目录	~/.cicbyte/forks/
FORKS_REPO_PATH	仓库存储路径	交互式输入
TZ	时区	UTC

优先级：命令行参数 > 环境变量 > 默认值。首次运行会提示输入仓库存储路径。

前端开发

cd web && npm install && npm run dev
# 开发服务器 http://localhost:3000，自动代理 API 到 :8080

镜像加速克隆

Forks 内置 Git Smart HTTP 协议服务，部署后局域网内其他机器可直接从本服务克隆已缓存的仓库，无需访问外网。

# 直接 git clone（克隆后 origin 会指向镜像地址）
git clone http://<server-ip>:8080/git/github/author/repo.git

# 推荐使用 forks-cli 工具（自动修正 remote 地址）
forks-cli clone http://<server-ip>:8080/git/github/author/repo.git

Docker 部署

使用预构建镜像（推荐）

docker run -d \
  -p 8080:8080 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  ghcr.io/cicbyte/forks:latest

使用 docker-compose.yml：

docker compose up -d

自行构建

docker build -t forks .
docker run -d -p 8080:8080 -v ./data:/data forks

MCP 集成

通过 MCP (Model Context Protocol) Streamable HTTP 暴露工具接口，AI 客户端可直接操作仓库。

端点： http://<server>:8080/mcp

可用工具：

工具	功能
list_repos	列出仓库（支持搜索/筛选/分页）
add_repo	添加仓库
get_repo	获取单个仓库详情
update_repo_info	更新仓库远程信息
get_stats	获取仓库统计信息
list_repo_files	列出仓库文件结构
read_repo_file	读取仓库文件内容
get_trending	获取 GitHub 趋势仓库列表

认证方式与 API 相同，使用 Bearer Token。

配套工具

forks-cli

独立 CLI 工具，提供镜像加速克隆、批量备份、趋势浏览等功能。详见 cicbyte/forks-cli。

安装：

# Go install
go install github.com/cicbyte/forks-cli@latest

# 或从 GitHub Releases 下载二进制

首次配置：

forks-cli config set server http://<server-ip>:8080
forks-cli config set token <your-token>    # 如果服务端启用了认证

主要命令：

# 镜像加速克隆（支持简写、原始 URL、镜像地址）
forks-cli clone torvalds/linux
forks-cli clone https://github.com/torvalds/linux
forks-cli clone http://<server-ip>:8080/git/github/torvalds/linux.git

# 批量备份（支持并发数和目录配置）
forks-cli backup -d /data/backup -c 10

# 浏览 GitHub 趋势（支持语言、时间范围筛选）
forks-cli trending --language go --since weekly
forks-cli trending --language python --spoken-language zh --refresh

# 打开 Web UI
forks-cli website

# 查看版本
forks-cli version

全局选项：

# 输出格式：table（默认）、json、jsonl
forks-cli trending --format json
forks-cli backup --format jsonl

配置优先级： 环境变量 > 命令行参数 > 配置文件（~/.cicbyte/forks-cli/config/config.yaml）

项目结构

├── main.go              # 入口，嵌入 web/dist
├── cmd/
│   ├── root.go          # CLI 根命令，数据库和日志初始化
│   └── serve.go         # HTTP 路由和业务逻辑
├── common/              # 全局变量（DB、日志文件）
├── models/              # 数据结构定义
├── utils/               # 配置、GitHub API、MCP 服务、工具函数
├── assets/              # 嵌入资源桥接
└── web/                 # Vue 3 前端
    └── src/
        ├── api/         # API 调用封装
        ├── views/       # 页面组件
        ├── components/  # 通用组件
        ├── stores/      # Pinia 状态管理
        └── router/      # 路由配置

License

MIT