archive-at-home

KO | EN

gitlite — search

#javascript #python #golang #android #machine-learning #rust #linux #nodejs #java #cli #vue #pytorch #mcp #openai

archive-at-home

(★ 19)

分布式 E-Hentai 归档链接解析系统

archive-at-home Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Archive-at-Home

一个基于 Go 的分布式 E-Hentai/ExHentai 归档链接解析系统，采用中控服务器 + 志愿者工作节点的架构。

## 核心特性

- **直接分配调度** - Server 根据节点状态选择最佳节点，直接分配任务
- **私有化缓存** - 每个用户独立缓存，7 天 TTL
- **请求合并** - 同一用户重复请求自动合并
- **GP 成本追踪** - 自动估算和记录 GP 消耗
- **令牌桶限流** - 基于 Redis 的令牌桶速率控制，支持用户等级差异化速率
- **用户系统** - 支持邮箱注册 + Telegram OAuth 登录
- **管理后台** - 独立的管理员 API，支持用户管理

## 快速开始

### 部署 Server

Server 通过 GitHub Container Registry 镜像分发（`ghcr.io/archive-at-home/archive-at-home/server`），使用 Docker Compose：

```bash
cd server
docker compose up -d
```

镜像 tag 说明：
- `latest` - 跟随 main 分支自动更新（Server 有变更即自动构建推送）
- `sha-<commit>` - 固定版本，可回滚到任意历史构建

详细配置和部署方式请参考 **[server/README.md](server/README.md)**

### 部署 Node

从 [Releases](https://github.com/Archive-At-Home/archive-at-home/releases) 下载对应平台的二进制，或使用 Docker：

```bash
cd node
# 先创建 config.yaml 配置文件
docker compose up -d
```

详细配置和部署方式请参考 **[node/README.md](node/README.md)**

### 使用 API

```bash
# 注册用户
curl -X POST http://localhost:8080/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"secret","nickname":"测试用户"}'

# 解析归档链接（使用返回的 api_key）
curl -X POST http://localhost:8080/api/v1/parse \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -H "X-Client: bot/tg-official" \
  -H "Content-Type: application/json" \
  -d '{"gallery_id":"3858751","gallery_key":"d3de60e849"}'

# X-Client 为可选请求头，用于标记调用来源，格式为大类/应用标识。
# 不传时后端会按 User-Agent 自动识别来源。
```

完整 API 文档请参考 [server/README.md](server/README.md)

## 文档

- **[Server 文档](server/README.md)** - API 文档、配置说明、部署指南
- **[Node 文档](node/README.md)** - 配置说明、部署指南、故障排查

## 鸣谢

本项目的开发得到了以下工具的帮助：

- [Claude](https://claude.ai) - Anthropic 开发的 AI 助手，协助架构设计和代码实现
- [GitHub Copilot](https://github.com/features/copilot) - AI 代码补全工具，提升开发效率

archive-at-home

archive-at-home Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

archive-at-home

archive-at-home Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README