Y
yophon/gopan
★ 2·更新 2026-11-19
在 GitHub 查看 ↗直链 · 无中转页
我们没有可直接复制的安装命令,也没有公开的远端端点,所以不出配置。上面那条命令仅供参考,不是我们能担保的可复制命令——编一条出来比不给更糟。 各客户端的接法 →
- ★ 数取值
- 2 ★ · yophon/gopan · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 收录自 punkpeye/awesome-mcp-servers 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-18 · 最近见到 2026-11-20 · 共见到 3 次 · 被 3 个来源列出
- 评分构成
- 综合分 300 · 2 ★ · 3 个来源 · mcp
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
yophon/gopan;我们收录于 2026-11-18;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# gopan
以下摘录自该仓库的 README(片段)
简体中文 · English
自部署云盘。Go + GraphQL + Postgres + MinIO 后端,单二进制交付,2 核 2G 的 VPS 就能跑。三个客户端:Vue 3 网页、Kotlin + Jetpack Compose 的安卓原生 App、Windows 桌面端(Tauri)。
内置 AI 助手:网页、桌面端、安卓 App 里都能用,找文件、读文档、整理、建分享;改动先确认,也能整轮交给服务器跑。
自带 Remote MCP:Claude、ChatGPT、Codex 等 Agent 经 OAuth 2.1 接入,在你授权的范围里找、读、整理、分享网盘里的文件;文件字节不经过 MCP,Agent 做的每次改动都能在「动态」里按来源撤回。各客户端怎么接见 docs/MCP.md · 客户端接入,给 Agent 的用法说明见 Agent Skill。
在线实例: (跑在 2 核 2G 的 VPS 上,精简档部署)
当前版本与每一版改了什么见 CHANGELOG(站点的 /app 页面与 App 的「更新日志」展示的就是它);功能全貌见 12 · 产品说明。
## 架构
mermaid
flowchart LR
Browser["浏览器 · Vue 3 SPA"]
Browser -- "GraphQL /query (元数据与编排)" --> GQL
Browser 分片直传 / 直取" .-> MinIO
Android["安卓 App · Compose"] -- "GraphQL /query" --> GQL
Android (后台续传)" .-> MinIO
Agent["Agent · MCP Host"] -- "Streamable HTTP /mcp OAuth 2.1 / API Key" --> MCP
Agent Agent 自主传输" .-> MinIO
DAV["Finder · rclone · WebDAV 客户端"] -- "WebDAV /dav 应用密码" --> REST
subgraph Gopan["gopan · Go 单二进制"]
GQL["gqlgen"] --> Service["service 业务层"]
MCP["Remote MCP · OAuth server"] --> Service
REST["HTTP:/dav · /pack · /arc · /x/:token · /sub · /md · /api/img · /s/:token · /api/app · /healthz"] --> Service
Worker["worker pool 缩略图 · 转 PDF · hash 校验 · 文字提取 · 压缩包目录 · GC"]
Jobs["后台任务 runner 离线下载 · 解压 · 剪藏 · 订阅"]
Embed["embed 前端静态资源"]
end
Service --> PG[("PostgreSQL 元数据 · 事务 · 递归 CTE")]
Service --> MinIO[("MinIO blobs/{sha256} 内容寻址")]
Worker --> MinIO
Worker --> GT["Gotenberg (office → PDF,可关)"]
Worker --> FF["ffmpeg(exec)"]
Worker --> PT["pdftotext(exec)"]
Jobs --> MinIO
Jobs -. "离线下载 · 订阅 · 剪藏(挡内网)" .-> Web(("外部网站"))
Service -. "推送(挡内网)" .-> Push(("ntfy · Bark · Telegram · Webhook"))
要点:主传输路径字节流不过 Go——浏览器、安卓 App 和 Agent 都拿预签名 URL 直传/直取 MinIO。显式例外只有流式 zip(/pack、/mcp-download)、协议决定必须中转的 WebDAV PUT/GET、几 MB 的安卓安装包(/api/app/android/),v3.3 的离线下载(服务器替你从源站拉)与压缩包(解压、/arc 预览包里的单个文件),以及 v3.4 的直链(/x/,经 Go 才能记流量、按上限拦、吊销即时生效)、图床上传与字幕转换,都有并发闸。文件按 SHA-256 内容寻址,全站同内容物理只存一份(秒传),配额按逻辑大小各记各的。类型从数据库到组件不断链:sqlc(SQL→Go)、gqlgen(schema→resolver)、GraphQL Code Generator(schema→TS),改一处两端编译报错。
## 快速开始
### 部署(用预构建镜像)
一台有公网 IP 的 Linux 主机(2G 内存够用)、一个解析到它的域名、Docker 与 compose 插件。镜像由 GitHub Actions 构建,机器上不编译(只有 linux/amd64):
bash
git clone https://github.com/yophon/gopan.git /opt/gopan && cd /opt/gopan
cp .env.example .env && vi .env # 填域名与两个密码,选部署档位,取消 GOPAN_IMAGE 的注释
mkdir -p secrets && openssl rand -base64 48 > secrets/jwt_secret
chown 10001:10001 secrets/jwt_secret && chmod 400 secrets/jwt_secret && chmod 600 .env
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d --no-build
选档(自带 Caddy 自动证书,还是交给宿主 nginx)、反代约定、升级、备份与恢复、排障都在 09 · 上线手册。
### 开发
bash
make dev-env # compose 起 postgres/minio/gotenberg
make dev-server # 后端 :8080(自动跑迁移)
make dev-web # 前端 :5173(proxy → 8080)
make gen # 改了 schema.graphqls / db/queries 后重新生成三件套
make test # go test + vet(集成测试需 TEST_DB_URL)
make build # 前端构建 + embed → server/gopan 单二进制
生产运行只需要 server/gopan 二进制 + GOPAN_DB_URL + GOPAN_JWT_SECRET(≥32 字节),配置项见 doc/08。
安卓 App 与桌面端连哪个站点是打包时定的:照 client.env.example 在仓库根建 client.env(不进 git)写上自己实例的地址,两端都读它(doc/18「自部署」)。
## 设计文档
浏览器上传的 staging 隔离、配额复核、失败恢复和升级兼容说明见 15 · 上传一致性修复。
Agent 接入与远程 MCP 工具见 docs/MCP.md(各客户端的接法在客户端接入一节),给 Agent 的用法说明见 skills/gopan/。
全部设计文档在 doc/:
自部署云盘。Go + GraphQL + Postgres + MinIO 后端,单二进制交付,2 核 2G 的 VPS 就能跑。三个客户端:Vue 3 网页、Kotlin + Jetpack Compose 的安卓原生 App、Windows 桌面端(Tauri)。
内置 AI 助手:网页、桌面端、安卓 App 里都能用,找文件、读文档、整理、建分享;改动先确认,也能整轮交给服务器跑。
自带 Remote MCP:Claude、ChatGPT、Codex 等 Agent 经 OAuth 2.1 接入,在你授权的范围里找、读、整理、分享网盘里的文件;文件字节不经过 MCP,Agent 做的每次改动都能在「动态」里按来源撤回。各客户端怎么接见 docs/MCP.md · 客户端接入,给 Agent 的用法说明见 Agent Skill。
在线实例: (跑在 2 核 2G 的 VPS 上,精简档部署)
当前版本与每一版改了什么见 CHANGELOG(站点的 /app 页面与 App 的「更新日志」展示的就是它);功能全貌见 12 · 产品说明。
## 架构
mermaid
flowchart LR
Browser["浏览器 · Vue 3 SPA"]
Browser -- "GraphQL /query (元数据与编排)" --> GQL
Browser 分片直传 / 直取" .-> MinIO
Android["安卓 App · Compose"] -- "GraphQL /query" --> GQL
Android (后台续传)" .-> MinIO
Agent["Agent · MCP Host"] -- "Streamable HTTP /mcp OAuth 2.1 / API Key" --> MCP
Agent Agent 自主传输" .-> MinIO
DAV["Finder · rclone · WebDAV 客户端"] -- "WebDAV /dav 应用密码" --> REST
subgraph Gopan["gopan · Go 单二进制"]
GQL["gqlgen"] --> Service["service 业务层"]
MCP["Remote MCP · OAuth server"] --> Service
REST["HTTP:/dav · /pack · /arc · /x/:token · /sub · /md · /api/img · /s/:token · /api/app · /healthz"] --> Service
Worker["worker pool 缩略图 · 转 PDF · hash 校验 · 文字提取 · 压缩包目录 · GC"]
Jobs["后台任务 runner 离线下载 · 解压 · 剪藏 · 订阅"]
Embed["embed 前端静态资源"]
end
Service --> PG[("PostgreSQL 元数据 · 事务 · 递归 CTE")]
Service --> MinIO[("MinIO blobs/{sha256} 内容寻址")]
Worker --> MinIO
Worker --> GT["Gotenberg (office → PDF,可关)"]
Worker --> FF["ffmpeg(exec)"]
Worker --> PT["pdftotext(exec)"]
Jobs --> MinIO
Jobs -. "离线下载 · 订阅 · 剪藏(挡内网)" .-> Web(("外部网站"))
Service -. "推送(挡内网)" .-> Push(("ntfy · Bark · Telegram · Webhook"))
要点:主传输路径字节流不过 Go——浏览器、安卓 App 和 Agent 都拿预签名 URL 直传/直取 MinIO。显式例外只有流式 zip(/pack、/mcp-download)、协议决定必须中转的 WebDAV PUT/GET、几 MB 的安卓安装包(/api/app/android/),v3.3 的离线下载(服务器替你从源站拉)与压缩包(解压、/arc 预览包里的单个文件),以及 v3.4 的直链(/x/,经 Go 才能记流量、按上限拦、吊销即时生效)、图床上传与字幕转换,都有并发闸。文件按 SHA-256 内容寻址,全站同内容物理只存一份(秒传),配额按逻辑大小各记各的。类型从数据库到组件不断链:sqlc(SQL→Go)、gqlgen(schema→resolver)、GraphQL Code Generator(schema→TS),改一处两端编译报错。
## 快速开始
### 部署(用预构建镜像)
一台有公网 IP 的 Linux 主机(2G 内存够用)、一个解析到它的域名、Docker 与 compose 插件。镜像由 GitHub Actions 构建,机器上不编译(只有 linux/amd64):
bash
git clone https://github.com/yophon/gopan.git /opt/gopan && cd /opt/gopan
cp .env.example .env && vi .env # 填域名与两个密码,选部署档位,取消 GOPAN_IMAGE 的注释
mkdir -p secrets && openssl rand -base64 48 > secrets/jwt_secret
chown 10001:10001 secrets/jwt_secret && chmod 400 secrets/jwt_secret && chmod 600 .env
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d --no-build
选档(自带 Caddy 自动证书,还是交给宿主 nginx)、反代约定、升级、备份与恢复、排障都在 09 · 上线手册。
### 开发
bash
make dev-env # compose 起 postgres/minio/gotenberg
make dev-server # 后端 :8080(自动跑迁移)
make dev-web # 前端 :5173(proxy → 8080)
make gen # 改了 schema.graphqls / db/queries 后重新生成三件套
make test # go test + vet(集成测试需 TEST_DB_URL)
make build # 前端构建 + embed → server/gopan 单二进制
生产运行只需要 server/gopan 二进制 + GOPAN_DB_URL + GOPAN_JWT_SECRET(≥32 字节),配置项见 doc/08。
安卓 App 与桌面端连哪个站点是打包时定的:照 client.env.example 在仓库根建 client.env(不进 git)写上自己实例的地址,两端都读它(doc/18「自部署」)。
## 设计文档
浏览器上传的 staging 隔离、配额复核、失败恢复和升级兼容说明见 15 · 上传一致性修复。
Agent 接入与远程 MCP 工具见 docs/MCP.md(各客户端的接法在客户端接入一节),给 Agent 的用法说明见 skills/gopan/。
全部设计文档在 doc/:
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/yophon-gopan/)
- 来源
- awesome · https://github.com/yophon/gopan
- 按领域浏览
- MCP 服务
- Traction
- 2 ★
- 收录来源
- 3 个独立来源
- 收录于
- 今天
更多 MCP 服务器
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。